1. Inicio
  2. Documentos
  3. NS NF3e (English)
  4. NF3-e Issue Process
  5. Check Issue Process Status

Check Issue Process Status

This service is used to check the processing status of an NF3-e previously sent for processing using the NF3-e Issuance Method.


Production: POST https://nf3e.ns.eti.br/v1/nf3e/issue/status

Input Data
FieldOccurrenceData TypeParentDescription
X-AUTH-TOKEN1-1StringSoftware house access token
CNPJ1-1IntCNPJ of the NF3-e issuer
nsNRec1-1IntReceipt log number of the issue process
Request Example

Check processing status request

curl -X POST \
-H "Content-Type: application/json" \
-d '{"X-AUTH-TOKEN":"YOUR_TOKEN", "CNPJ": "11111111111111", "nsNRec": 1}' \
Returned Data
FieldDescriptionOccurrenceData TypeParentNotes
statusProcessing status code1-1Int
motivoLiteral description of the processing status1-1String
chNF3eNF3-e access key1-1Int
cStatNF3-e processing status code at Sefaz0-1IntOnly when status = 200
xMotivoLiteral description of the NF3-e processing status code at Sefaz 0-1StringOnly when status = 200
nProtNF3-e authorization protocol number at Sefaz0-1IntOnly when cStat = 100
dhRecbtoDate and time of receipt of NF3-e by Sefaz0-1DateOnly when status = 200
consultarNSNRecnsNRec of the same document authorized or pending consultation0-1IntThis field can appear when status = 200 and cStat = 539, if we have an nsNRec pending consultation or from the same authorized document. If you receive this field, check the processing status again with its value
xmlNF3-e distribution XML0-1StringOnly when cStat = 100
erroObject containing error information in case the request cannot be carried out successfully0-1ObjectOnly when status is different from 200
Error Object Details
FieldDescriptionOccurrenceData TypeParent
cStatError status code1-1Int
xMotivoLiteral description of the error1-1String
Response Examples

Successful response

    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chNF3e": "43191207364617000135660000000000101834241950",
    "cStat": "100",
    "xMotivo": "Autorizado o uso da NF3e ",
    "nProt": "143190000000010",
    "dhRecbto": "2019-12-06T15:56:29-03:00",
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><nf3eProc versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/nf3e\"><NF3e><infNF3e versao=\"1.00\" Id=\"NF3e43191207364617000135660000000000101834241950\">...</nf3eProc>"

Response with an error

    "status": -2,
    "motivo": "Nao foi possivel carregar o status da NF3-e",
    "erro": {
        "cStat": 0,
        "xMotivo": "Documento não localizado em nosso banco de dados"
Return Codes
200Consultation made successfully
-2It was not possible to load the processing status of the NF3-e. Check the "erro" object for more information

Como podemos ajudar?