CT-e JSON — referência de campos

Endpoint: GET /api/integration/dfe/cte/inbound/documentos · Referência OpenAPI: CT-e Public API.

Documento de referência — Dicionário campo a campo do objeto metadata retornado pelo endpoint de documentos CT-e inbound. O mesmo objeto, comprimido (Gzip+Base64), é o conteúdo do campo json quando json=true.

Endpoint: GET /api/integration/dfe/cte/inbound/documentos · Referência OpenAPI: CT-e Public API.

Convenções deste documento

emissionDatePart é a partição de data do documento (derivada de chCte), não um instante — sai como string ISO. As demais datas de negócio/auditoria (dhEmi, createdAt, updatedAt) saem como epoch milliseconds UTC. dhRecbto sai no formato ISO com offset (não foi convertido para epoch millis).
issuerType sai como o nome do enum ("INBOUND"/"OUTBOUND"), não o código numérico interno.
Os 5 papéis do CT-e (emitente/destinatário, remetente, expedidor, recebedor, tomador) aparecem sempre juntos no metadata, independentemente de qual deles é a empresa do tenant para este item (ver companyId).

1. Campos

Campo	Tipo	Descrição
`emissionDatePart`	string (ISO datetime)	Partição de data do documento (derivada de `chCte`), não um instante.
`id`	UUID	Identificador interno do registro do documento.
`customerId`	UUID	Tenant proprietário do registro.
`companyId`	UUID	Empresa (do tenant) que é parte do CT-e para este item — ver "Multiplicidade por empresa" na página do fluxo de listagem.
`externalId`	string, nullable	Identificador externo, quando fornecido na ingestão.
`issuerType`	string	`"INBOUND"` (recebido) ou `"OUTBOUND"` (emitido pelo tenant). Sempre `"INBOUND"` nesta listagem.
`dhEmi`	long (epoch ms)	Data/hora de emissão do CT-e.
`tpCte`	string	Tipo do CT-e (normal, complemento de valores, anulação, substituto).
`tpEmis`	string	Forma de emissão (normal, contingência, etc.).
`chCte`	string (44)	Chave de acesso do CT-e — chave de correlação com os eventos (ver Reconciliação de documentos e eventos CT-e inbound).
`nCT`	int	Número do CT-e.
`serie`	short	Série do CT-e.
`mod`	string	Modelo do documento: `"57"` (CT-e), `"67"` (CT-e OS) ou `"64"` (GTV-e).
`vCt`	decimal	Valor total da prestação do serviço de transporte.
`cnpjCpfEmitDest`	string	CNPJ/CPF do papel emitente/destinatário.
`xNomeEmitDest`	string	Nome/razão social do emitente/destinatário.
`cnpjCpfRemetente`	string	CNPJ/CPF do remetente da carga.
`xNomeRemetente`	string	Nome/razão social do remetente.
`cnpjCpfExpedidor`	string	CNPJ/CPF do expedidor.
`xNomeExpedidor`	string	Nome/razão social do expedidor.
`cnpjCpfRecebedor`	string	CNPJ/CPF do recebedor.
`xNomeRecebedor`	string	Nome/razão social do recebedor.
`cnpjCpfTomador`	string	CNPJ/CPF do tomador do serviço.
`xNomeTomador`	string	Nome/razão social do tomador.
`status`	string	Código de status interno (ver tabela na seção 2).
`cStat`	short, nullable	Código de status de retorno da SEFAZ (ex.: `100` = autorizado).
`xMotivo`	string, nullable	Motivo/mensagem do protocolo SEFAZ.
`nProt`	long, nullable	Número do protocolo de autorização SEFAZ.
`dhRecbto`	string (ISO datetime com offset), nullable	Data/hora de recebimento pela SEFAZ.
`createdAt`	long (epoch ms)	Quando o registro foi persistido no MI.
`updatedAt`	long (epoch ms)	Última atualização do registro.
`transmitted`	boolean	Derivado de `status` — ver seção 2.
`inProgress`	boolean	Derivado de `status` — ver seção 2.
`authorized`	boolean	Derivado de `status` — ver seção 2.
`cancelled`	boolean	Derivado de `status` — ver seção 2.

2. Códigos de `status` e os booleans derivados

status é o código interno do ciclo de vida do documento no MI (não confundir com cStat, que é o código de retorno da SEFAZ):

Código	Significado
`0`	Não processado
`1`	Importado
`2`	Em processamento
`3`	Aguardando confirmação de recebimento
`4`	Erro / abortado
`5`	Autorizado
`6`	Denegado
`7`	Cancelado
`8`	Não utilizado
`9`	Encerrado

Os quatro booleans do item são derivados desse código:

Boolean	Regra
`authorized`	`status == "5"`
`cancelled`	`status == "7"`
`inProgress`	`status` em `{"2", "3"}`
`transmitted`	`status` em `{"5", "6", "7", "8"}` — qualquer resultado final devolvido pela SEFAZ (autorizado, denegado, cancelado ou não utilizado), em contraste com pendente/erro.

3. Exemplo

{
  "emissionDatePart": "2026-01-01T00:00:00",
  "id": "0198c0de-0000-7000-8000-000000000003",
  "customerId": "0198c0de-0000-7000-8000-000000000001",
  "companyId": "0198c0de-0000-7000-8000-000000000002",
  "issuerType": "INBOUND",
  "dhEmi": 1768469400000,
  "tpCte": "0",
  "tpEmis": "1",
  "chCte": "35260111111111111111570010000000011000000015",
  "nCT": 1,
  "serie": 1,
  "mod": "57",
  "vCt": 1500.00,
  "cnpjCpfEmitDest": "11111111111111",
  "xNomeEmitDest": "Destinatario Ltda",
  "cnpjCpfRemetente": "22222222222222",
  "xNomeRemetente": "Remetente Ltda",
  "cnpjCpfExpedidor": "33333333333333",
  "xNomeExpedidor": "Expedidor Ltda",
  "cnpjCpfRecebedor": "44444444444444",
  "xNomeRecebedor": "Recebedor Ltda",
  "cnpjCpfTomador": "55555555555555",
  "xNomeTomador": "Tomador Ltda",
  "status": "5",
  "cStat": 100,
  "xMotivo": "Autorizado o uso do CT-e",
  "nProt": 135260000000001,
  "dhRecbto": "2026-01-15T09:35:00-03:00",
  "createdAt": 1768478400000,
  "updatedAt": 1768478700000,
  "transmitted": true,
  "inProgress": false,
  "authorized": true,
  "cancelled": false
}

CT-e JSON — referência de campos

Convenções deste documentoCopiar link da seção

1. CamposCopiar link da seção

2. Códigos de status e os booleans derivadosCopiar link da seção

3. ExemploCopiar link da seção

Nesta página

Convenções deste documento

1. Campos

2. Códigos de `status` e os booleans derivados

3. Exemplo