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

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

accessCodestringRequired

qrcodestringRequired

inputstringRequired

Responses

200

Operação bem sucedida

application/json

Responsenumber

404

Não encontrado

post

/api/receipt/create

HTTPcURLJavaScriptPython

POST /api/receipt/create HTTP/1.1
Host: apim.niiw.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "accessCode": "text",
  "qrcode": "text",
  "input": "text"
}

1

---

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.............."
}