Este serviço é utilizado para consultar o status de processamento de um CT-e enviado anteriormente para processamento pelo método de Emissão de CT-e.
URL
Versão 3.00
Produção CT-e 3.00 e CT-e OS: POST https://cte.ns.eti.br/cte/issueStatus/300
Dados de entrada
| Campos | Ocorrência | Descrição | Observação |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de Acesso do usuário | |
| nsNrec | 1-1 | Número do recibo pela API NS CT-e | |
| CNPJ | 1-1 | CNPJ do Emitente | Apenas na versão 3.00 |
| tpAmb | 1-1 | Tipo do ambiente de autorização do CT-e: 1 - Produção, 2 - Homologação |
Exemplo de requisição
Requisição de status de processamento de CT-e
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
Dados retornados
| Campo | Descrição | Tipo | Ocorrência | Pai | Observação |
|---|---|---|---|---|---|
| status | Código de status de processamento | N | 1-1 | ||
| motivo | Descrição literal do status de processamento | A | 1-1 | ||
| chCTe | Chave do CT-e | N | 0-1 | Somente em status 200 ou -4 | |
| cStat | Código de situação do status de processamento | N | 1-1 | Somente em status 200 | |
| xMotivo | Descrição literal do código de processamento na Sefaz | A | 0-1 | Somente em status 200 | |
| nProt | Número do protocolo de autorização do CT-e | A | 0-1 | Somente em cStat 100 | |
| dhRecbto | Data e hora de recebimento do CT-e pela Sefaz | Somente em cStat 100 - Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS Ex.: 2020-04-13T15:04:10-02:00 |
|||
| xml | XML de distribuição do CT-e | A | 0-1 | Somente em cStat 100 | |
| erro | Objeto contendo as informações de erro ocorrido | O | 0-1 | Somente em status -4 | |
| cStat | Código de status do erro | N | 1-1 | erro | |
| xMotivo | Descrição literal do erro | A | 1-1 | erro |
Exemplos de retorno
Retorno com sucesso
{
"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=..."
}
Retorno com erro
//Exemplo 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"
}
}
//Exemplo 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"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta do CT-e realizada com sucesso |
| -2 | Campos obrigatórios na requisição não informados |
| -4 | Não foi possivel carregar as informações do CT-e. Por favor verifique o objeto erro para identificar o motivo |
| -6 | Documento já recebido, porém ainda sem status de processamento, por favor consulte o status de processamento do NSNRec informado. |