idstring · uuidObligatorioUUID del contra-CT-e (aceptado en GET /fiscal/cte/{cte_uuid} y /dacte).
Estructura preservada del contrato versionado de la API.
Las descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.
Resumen de un contra-CT-e generado por la plataforma con su estado actual ante SEFAZ.
idstring · uuidObligatorioUUID del contra-CT-e (aceptado en GET /fiscal/cte/{cte_uuid} y /dacte).
source_cte_keystring | nullOpcionalClave de acceso (44 caracteres) del CT-e de la contratante que dio origen al documento.
leg_refstring | nullOpcionalEtiqueta del tramo informada en el lote, cuando corresponda.
tp_cteintegerObligatorioFinalidad SEFAZ (ide/tpCTe): 0 Normal, 1 Complemento de valores.
0 · 1tp_cte_rotulostringObligatorioNormal o Complemento de valores.
chave_cte_complementadostring | nullOpcionalClave de 44 dígitos del contra-CT-e complementado (<infCteComp><chCTe>) cuando tp_cte = 1.
tipo_servicointegerObligatorioide/tpServ grabado en el documento (1 subcontratación, 2 redespacho, 3 redespacho intermediario).
0 · 1 · 2 · 3tipo_servico_rotulostringObligatoriostatusobjectObligatorioaccess_keystring | nullOpcionalClave de acceso de 44 dígitos del contra-CT-e en SEFAZ.
numberinteger | nullOpcionalseriesstring | nullOpcionalfreight_valuenumber | nullOpcionalValor total de la prestación (vTPrest) declarado en el contra-CT-e.
protocolstring | nullOpcionalcstatstring | nullOpcionalreasonstring | nullOpcionalbatch_idstring | null · uuidOpcionalUUID del lote (POST /fiscal/cte-subcontratacao/lote) que generó este contra-CT-e, cuando se emite en lote.
authorized_atstring | null · date-timeOpcionalcreated_atstring | null · date-timeOpcional{
"type": "object",
"required": [
"id",
"tp_cte",
"tp_cte_rotulo",
"tipo_servico",
"tipo_servico_rotulo",
"status"
],
"description": "Resumo de um contra-CT-e gerado pela plataforma com seu estado atual perante a SEFAZ.",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "UUID do contra-CT-e (aceito em `GET /fiscal/cte/{cte_uuid}` e `/dacte`)."
},
"source_cte_key": {
"type": [
"string",
"null"
],
"description": "Chave de acesso (44 caracteres) do CT-e da contratante que deu origem ao documento."
},
"leg_ref": {
"type": [
"string",
"null"
],
"description": "Rótulo da perna informada no lote, quando aplicável."
},
"tp_cte": {
"type": "integer",
"enum": [
0,
1
],
"description": "Finalidade SEFAZ (`ide/tpCTe`): `0` Normal, `1` Complemento de valores."
},
"tp_cte_rotulo": {
"type": "string",
"description": "`Normal` ou `Complemento de valores`."
},
"chave_cte_complementado": {
"type": [
"string",
"null"
],
"description": "Chave de 44 dígitos do contra-CT-e complementado (`<infCteComp><chCTe>`) quando `tp_cte = 1`."
},
"tipo_servico": {
"type": "integer",
"enum": [
0,
1,
2,
3
],
"description": "`ide/tpServ` gravado no documento (`1` subcontratação, `2` redespacho, `3` redespacho intermediário)."
},
"tipo_servico_rotulo": {
"type": "string"
},
"status": {
"$ref": "#/components/schemas/CteSituation"
},
"access_key": {
"type": [
"string",
"null"
],
"description": "Chave de acesso de 44 dígitos do contra-CT-e na SEFAZ."
},
"number": {
"type": [
"integer",
"null"
]
},
"series": {
"type": [
"string",
"null"
]
},
"freight_value": {
"type": [
"number",
"null"
],
"description": "Valor total da prestação (`vTPrest`) declarado no contra-CT-e."
},
"protocol": {
"type": [
"string",
"null"
]
},
"cstat": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"batch_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "UUID do lote (`POST /fiscal/cte-subcontratacao/lote`) que gerou este contra-CT-e, quando emitido em lote."
},
"authorized_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"created_at": {
"type": [
"string",
"null"
],
"format": "date-time"
}
}
}