idstringObrigatórioChave de acesso do CT-e; é o identificador público do recurso.
pattern"^\\d{44}$"Descrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.
access_keystringObrigatóriopattern"^\\d{44}$"numberinteger | nullOpcionalseriesstring | nullOpcionalmodelstringObrigatórioModelo do documento; sempre 57 para CT-e.
service_typeinteger | nullOpcionaltpServ do CT-e de origem: 0 normal, 1 subcontratação, 2 redespacho, 3 redespacho
intermediário, 4 serviço vinculado a multimodal (este não admite contra-CT-e).
service_type_labelstring | nullOpcionalRótulo legível do service_type — ex.: Normal, Subcontratação; null quando o XML
não traz tpServ.
issuerobjectObrigatóriosenderobjectOpcionalrecipientobjectOpcionalcargoobjectOpcionalsource_service_valuenumber | nullOpcionalO vTPrest de quem emitiu — referência, nunca o seu preço. O valor do trecho
subcontratado é negociação que este XML não presenciou.
nfe_access_keysarrayOpcionalChaves das NF-e que o CT-e de origem transporta.
carrier_roleobjectObrigatóriocarrier_role_labelstringOpcionalallows_counter_ctebooleanObrigatórioSe este documento admite um contra-CT-e seu. true apenas quando carrier_role é
subcontracted, o documento ainda não originou contra-CT-e e o tipo de serviço da
origem o admite (um CT-e vinculado a multimodal, service_type 4, não admite).
statusobjectObrigatóriostatus_labelstringOpcionalcounter_cte_idstring | null · uuidOpcionalUUID do contra-CT-e que este documento originou, quando já houver um.
originstringObrigatórioPor qual porta o documento entrou. api é a entrega pelo seu sistema.
received_countintegerObrigatórioQuantas vezes este mesmo documento foi entregue.
minimum1first_received_atstring | null · date-timeOpcionallast_received_atstring | null · date-timeOpcionaladdressesobjectOpcionalEndereços completos das partes. Só na consulta por chave.
Definição JSON Completa
{
"type": "object",
"required": [
"id",
"access_key",
"model",
"issuer",
"carrier_role",
"allows_counter_cte",
"status",
"origin",
"received_count"
],
"properties": {
"id": {
"type": "string",
"pattern": "^\\d{44}$",
"description": "Chave de acesso do CT-e; é o identificador público do recurso."
},
"access_key": {
"type": "string",
"pattern": "^\\d{44}$"
},
"number": {
"type": [
"integer",
"null"
]
},
"series": {
"type": [
"string",
"null"
]
},
"model": {
"type": "string",
"description": "Modelo do documento; sempre `57` para CT-e."
},
"service_type": {
"type": [
"integer",
"null"
],
"description": "`tpServ` do CT-e de origem: 0 normal, 1 subcontratação, 2 redespacho, 3 redespacho\nintermediário, 4 serviço vinculado a multimodal (este não admite contra-CT-e).\n"
},
"service_type_label": {
"type": [
"string",
"null"
],
"description": "Rótulo legível do `service_type` — ex.: `Normal`, `Subcontratação`; `null` quando o XML\nnão traz `tpServ`.\n"
},
"issuer": {
"$ref": "#/components/schemas/InboundCteParty"
},
"sender": {
"$ref": "#/components/schemas/InboundCteParty"
},
"recipient": {
"$ref": "#/components/schemas/InboundCteParty"
},
"cargo": {
"$ref": "#/components/schemas/InboundCteCargo"
},
"source_service_value": {
"type": [
"number",
"null"
],
"description": "O `vTPrest` de quem emitiu — **referência, nunca o seu preço**. O valor do trecho\nsubcontratado é negociação que este XML não presenciou.\n"
},
"nfe_access_keys": {
"type": "array",
"description": "Chaves das NF-e que o CT-e de origem transporta.",
"items": {
"type": "string",
"pattern": "^\\d{44}$"
}
},
"carrier_role": {
"$ref": "#/components/schemas/InboundCteCarrierRole"
},
"carrier_role_label": {
"type": "string"
},
"allows_counter_cte": {
"type": "boolean",
"description": "Se este documento admite um contra-CT-e seu. `true` apenas quando `carrier_role` é\n`subcontracted`, o documento ainda não originou contra-CT-e e o tipo de serviço da\norigem o admite (um CT-e vinculado a multimodal, `service_type` 4, não admite).\n"
},
"status": {
"$ref": "#/components/schemas/InboundCteStatus"
},
"status_label": {
"type": "string"
},
"counter_cte_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "UUID do contra-CT-e que este documento originou, quando já houver um."
},
"origin": {
"type": "string",
"description": "Por qual porta o documento entrou. `api` é a entrega pelo seu sistema."
},
"received_count": {
"type": "integer",
"minimum": 1,
"description": "Quantas vezes este mesmo documento foi entregue."
},
"first_received_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"last_received_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"addresses": {
"type": "object",
"description": "Endereços completos das partes. Só na consulta por chave.",
"properties": {
"issuer": {
"$ref": "#/components/schemas/InboundCteAddress"
},
"sender": {
"$ref": "#/components/schemas/InboundCteAddress"
},
"recipient": {
"$ref": "#/components/schemas/InboundCteAddress"
}
}
}
}
}