← InicioFleetPay / Schema

ContraCteGeradoResumo

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 · uuidObligatorio

UUID del contra-CT-e (aceptado en GET /fiscal/cte/{cte_uuid} y /dacte).

source_cte_keystring | nullOpcional

Clave de acceso (44 caracteres) del CT-e de la contratante que dio origen al documento.

leg_refstring | nullOpcional

Etiqueta del tramo informada en el lote, cuando corresponda.

tp_cteintegerObligatorio

Finalidad SEFAZ (ide/tpCTe): 0 Normal, 1 Complemento de valores.

0 · 1
tp_cte_rotulostringObligatorio

Normal o Complemento de valores.

chave_cte_complementadostring | nullOpcional

Clave de 44 dígitos del contra-CT-e complementado (<infCteComp><chCTe>) cuando tp_cte = 1.

tipo_servicointegerObligatorio

ide/tpServ grabado en el documento (1 subcontratación, 2 redespacho, 3 redespacho intermediario).

0 · 1 · 2 · 3
tipo_servico_rotulostringObligatorio
access_keystring | nullOpcional

Clave de acceso de 44 dígitos del contra-CT-e en SEFAZ.

numberinteger | nullOpcional
seriesstring | nullOpcional
freight_valuenumber | nullOpcional

Valor total de la prestación (vTPrest) declarado en el contra-CT-e.

protocolstring | nullOpcional
cstatstring | nullOpcional
reasonstring | nullOpcional
batch_idstring | null · uuidOpcional

UUID del lote (POST /fiscal/cte-subcontratacao/lote) que generó este contra-CT-e, cuando se emite en lote.

authorized_atstring | null · date-timeOpcional
created_atstring | null · date-timeOpcional
Definición JSON Original (Descripciones en Portugués)
{
  "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"
    }
  }
}