Adicionar da Nota Fiscal

Endpoint

Criação da nota fiscal através do QRCode lido do cupom fiscal

post

As notas aceitas nessa operação são NCFe, NFe e SAT de todos os estados brasileiros. Essa ação enviará a nota para a fila de processamento.

Authorizations

Body

accessCodestringrequired

qrcodestringrequired

inputstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://apim.niiw.io/api/receipt/create' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "accessCode": "text",
    "qrcode": "text",
    "input": "text"
  }'

200

404

200

1

Operação bem sucedida

---

Exemplo cURL

curl -X 'POST' \
  'https://apim.niiw.io/api/receipt/create' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJh...........' \
  -H 'Content-Type: application/json' \
  -d '{ "accessCode": "35230306057223024437590001419202251523787109" }'

Exemplo Request Body

Segue abaixo alguns exemplos e formatos permitidos na API

Código de Acesso

Somente o código de acesso da nota fiscal

{
  "accessCode":"35230306057223024437590001419202251523787109"
}

Tipo de input MANUAL

Este formato geralmente usado quando não há uma captura pela camera do celular

{
  "input": "MANUAL", 
  "accessCode":"35230306057223024437590001419202251523787109"
}

Tipo de input QRCODE com URL

Este formato geralmente ocorre pelo captura do QRCode da nota fiscal pela camera do celular

{
  "input": "QRCODE", 
  "qrcode": "https://sat.sef.sc.gov.br/nfce/consulta?p=42230909477652004850651290000241741783194505|2|1|1|7FF3A80467D56F8221C2C3E78506367FAF3236C6"
}

Tipo de input QRCODE com strings concatenadas

Este formato geralmente ocorre na leitura de notas SAT

{
  "input": "QRCODE", 
  "qrcode": "CFe35230306057223024437590001419202251523787109|20230319100758|958.53||K4r6J2dl6c1GrVcsqdx3OqqwFgz+z3Xr8U5NMAixZM4V0q8I4auMC9jgCwpW/GwCJjyGYYcJx5ihtX321AZ+XVUFs3g57nUGJhLZuda5L1whYBDy+sibSUhio6tWWD1JSFfwXKbj+UvEj/LH5onxDYRBox3nFLobaJN7LksE+EmvnhiHppJgyrQCRe/uzRidwyzbFpFtvglI/rNYxAj1rnoDhJdhkVy6M1CT9h6/1tmczGJ1oe2Mx2gxl6jF0Hc5yYF+teG/k69H32lvVvFyIP1QWDEk14lMdAnVR4Kb1+jwbQnfXIRWLzvDV+4kUAaKKNgqKkd5NVz2N38PCKiXRw=="
}

Exemplo Response Body

{
  "id": "65045.............."
}