idstringObligatorioClave de acceso del CT-e; es el identificador público del recurso.
pattern"^\\d{44}$"Las descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
access_keystringObligatoriopattern"^\\d{44}$"numberinteger | nullOpcionalseriesstring | nullOpcionalmodelstringObligatorioModelo del documento; siempre 57 para CT-e.
service_typeinteger | nullOpcionaltpServ del CT-e de origen: 0 normal, 1 subcontratación, 2 redespacho, 3 redespacho intermedio, 4 servicio vinculado al transporte multimodal (este no admite contra-CT-e).
service_type_labelstring | nullOpcionalEtiqueta legible de service_type, por ejemplo Normal, Subcontratação; null cuando el XML no incluye tpServ.
issuerobjectObligatoriosenderobjectOpcionalrecipientobjectOpcionalcargoobjectOpcionalsource_service_valuenumber | nullOpcionalEl vTPrest de quien emitió el documento: una referencia, nunca tu precio. El valor del tramo subcontratado se negocia por separado y no está representado en este XML.
nfe_access_keysarrayOpcionalClaves de las NF-e de la carga transportada según el CT-e de origen.
carrier_roleobjectObligatoriocarrier_role_labelstringOpcionalallows_counter_ctebooleanObligatorioIndica si este documento permite que emitas un contra-CT-e. true solo cuando carrier_role es subcontracted, el documento aún no ha generado un contra-CT-e y el tipo de servicio de origen lo permite (un CT-e vinculado al transporte multimodal, service_type 4, no lo permite).
statusobjectObligatoriostatus_labelstringOpcionalcounter_cte_idstring | null · uuidOpcionalUUID del contra-CT-e generado a partir de este documento, cuando existe.
originstringObligatorioCanal por el que se recibió el documento. api indica una entrega desde tu sistema.
received_countintegerObligatorioCantidad de veces que se entregó este mismo documento.
minimum1first_received_atstring | null · date-timeOpcionallast_received_atstring | null · date-timeOpcionaladdressesobjectOpcionalDirecciones completas de las partes. Solo disponibles al consultar por clave de acceso.
Definición JSON Original (Descripciones en Portugués)
{
"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"
}
}
}
}
}