1. Home
  2. NS CTe Nova Estrutura
  3. Eventos
  4. Consulta do Status do Evento

Consulta do Status do Evento

Na nova estrutura de CT-e, todos os eventos precisam fazer a consulta de status após receber o nsRec.

CamposOcorrênciaDescriçãoObservação
X-AUTH-TOKEN1-1Token de Acesso do usuário
tpEvento1-1Preencher com:
Cancelamento: "canc"
Carta de correção: "cce"
Insucesso na entrega: "IECTE"
Deve ser informada apenas uma das opções de preencher, por requisição.
tpAmb1-1Produção = "1"
Homologação: "2"
nSeqEvento1-1Número sequencial do evento.Sempre informar o valor "1", em caso de ser uma carta de corrção o número sequencial pode ser informado até a 999, mas lembre-se a emissão de um número anula o outro.
nRecNúmero do recibo pela API NS CT-e

Exemplo de requisição

{
   "X-AUTH-TOKEN": "...", 
    "tpEvento": "CANC",
    "chCTe": "43260407364617000135570000142465951000028057",
    "nSeqEvento": 1,
    "nsRec": "7ec60c44-ccf3-47db-bda8-8195e8fe795a"
}

Exemplo de retorno

{
    "status": 200,
    "motivo": "CT-e cancelado com sucesso",
    "retEvento": {
        "cStat": 135,
        "xMotivo": "Evento registrado e vinculado a CT-e",
        "chCTe": "43160612936100000005570000000010841000010620",
        "dhRegEvento": "2026-06-28T07:56:35-03:00",
        "nProt": "143160000339043"
    },
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoCTe versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/cte\">...</procEventoCTe>"
}

How can we help?