1. Inicio
  2. Documentos
  3. NS CTe (English)
  4. CTe Issue
  5. Processing Status

Processing Status

This service is used to consult the processing status of a CT-e previously sent for processing by the CT-e Issuance Method.

URL

3.00 version

Production CT-e 3.00 and CT-e OS: POST https://cte.ns.eti.br/cte/issueStatus/300

Input data
FieldOccurrenceDescriptionNotes
X-AUTH-TOKEN1-1User access token
nsNRec1-1Receipt number by NS CT-e API
CNPJ1-1Issuer CNPJOnly in 3.00 version
tpAmb1-1CT-e authorization environment type: 1 - Production, 2 - Homologation
Request example

CT-e processing status request

curl -X POST 
\-H "Content-Type: application/json"
\-d '{
      "X-AUTH-TOKEN":"...", 
      "nsNRec":"431000008742554", 
      "CNPJ":"07364617000135", 
      "tpAmb": "2"
     }' \
https://cte.ns.eti.br/cte/issueStatus/300
Returned data
FieldDescriptionData TypeOccurrenceParentNotes
statusProcessing status codeInt1-1
motivoProcessing status literal descriptionString1-1
chCTeCT-e access keyInt0-1Only when status = 200 or -4
cStatSituation code of the processing statusInt1-1Only when status = 200
xMotivoSituation code literal description at SefazString0-1Only when status = 100
nProtCT-e authorization protocol numberString0-1
dhRecebtoDate and time of receipt of the CT-e by SefazSefaz Standard: YYYY-MM-DDTHH:MM:SS+UTC
E.g.: 2016-06-13T15:04:10-02:00
xmlCT-e distribution XMLString0-1Only when cStat = 100
erroObject containing error information that occurredObject0-1Only when status = -4
cStatError status codeInt1-1erro
xMotivoError literal descriptionString1-1erro
Return examples

Successful return

{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chCTe": "44444444444444444444444444444444444444444444",
    "cStat": "100",
    "xMotivo": "Autorizado o uso do CT-e",
    "nProt": "143170000931396",
    "dhRecbto": "2017-11-10T11:58:52-02:00",
    "xml": "<?xml version=..."
}

Return with error

//Example 1: 
 
{
    "status": -6,
    "motivo": "Não foi possível carregar as informações do CT-e",
    "chCTe": "44444444444444444444444444444444444444444444",
    "erro": {
        "cStat": 999,
        "xMotivo": "Documento não Localizado no Banco de Dados"
    }
}
 
//Example 2:
 
{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chCTe": "44444444444444444444444444444444444444444444",
    "cStat": "228",
    "xMotivo": "Rejeição: Data de Emissao muito atrasada",
    "dhRecbto": "2017-11-10T11:58:00-02:00"
}
Return codes
CodeDescription
200CT-e consultation carried out successfully
-2Mandatory fields not informed in the request
-4It was not possible to load the CT-e information. Please, verify the "erro" object to identify the reason
-6Document already received, but still without processing status. Please, consult the processing status of the informed nsNRec

Como podemos ajudar?