Consultar Situação do CT-e

Através do serviço de Consulta Situação do CT-e é possível obter a informação de qual o estado atual do CT-e no banco de dados da Sefaz.

Esta funcionalidade é muito utilizada em casos onde é necessário verificar a existência e validade de um CT-e, assim como obter informações sobre os eventos ocorridos com o mesmo (ex.: alteração de valores por Cartão de Correção Eletrônica).

URL

Versão 3.00

Produção: POST https://cte.ns.eti.br/cte/stats/300

Dados de entrada

Campo	Descrição	Tipo	Ocorrência	Observação
X-AUTH-TOKEN	Token de acesso do usuário	A	0-1
licencaCnpj	CNPJ da licença interessada em consultar a situação do CT-e	N	0-1	Utilizado para identificar o certificado digital que deverá ser utilizado. Se não for enviado, o CNPJ será extraído da chave enviada no campo chCTe
chCTe	Chave de acesso do CT-e	N	1-1
tpAmb	Tipo do ambiente de autorização do CT-e 1 - Produção; 2 - Homologação	N	1-1

Exemplo de requisição

Consulta de situação

curl -X POST 
    \-H "Content-Type: application/json" 
    \-d '{ 
          "X-AUTH-TOKEN": "...", 
          "licencaCnpj": "99999999999999", 
          "chCTe": "43160734593613900019557000000010891022310638", 
          "tpAmb": "2"
          }' \
    https://cte.ns.eti.br/cte/stats/300

Dados retornados

Campo	Descrição	Observação
Status	Código de status do processamento
Motivo	Descrição literal do status de processamento
retConsSitCTe	Objeto contendo os dados do protocolo de autorização do CT-e e todos os eventos vinculados.	Somente em status = 200

Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo":   "Consulta realizada com sucesso",
    "retConsSitCTe": {
        "tpAmb":   "2",
        "verAplic":   "RS20191021102414",
        "cStat":   "100",
        "xMotivo":   "Autorizado o uso do CT-e",
        "cUF":   "43",
        "protCTe": {
            "infProt": {
                "Id":   "CTe143200000138854",
                "tpAmb":   "2",
                "verAplic":   "RS20200626095146",
                "chCTe":   "43200907364617000135570000000112041000000235",
                "dhRecbto":   "2020-09-03T16:26:30-03:00",
                "nProt":   "143200000138854",
                "digVal":   "8RGNcKssGvRQlm1kT3u6NvdWh6I=",
                "cStat":   "100",
                "xMotivo":   "Autorizado o uso do CT-e"
            },
            "versao":   "3.00"
        },
        "versao":   "3.00"
    }
}

cStats Retornados

De acordo com o código de cStat principal, que é retornado no objeto protCTe, é possível definir a situação do documento.

Abaixo segue uma tabela com os valores que podem ser retornados, podendo haver outros retornos conforme a necessidade da sefaz.

Código	Retorno
100	Documento autorizado
101	Documento cancelado
110	Documento denegado

Códigos de retorno

Código	Descrição
200	Consulta realizada com sucesso
-400	Chave do CT-e ou Tipo do Ambiente não informados
-3	Chave de acesso inválida
-6	Erro ao realizar a consulta. Verifique o retorno para identificar o motivo.

NS CTe

URL