← InícioFleetPay / Schema

ContraCteGeradoResumo

Estrutura preservada do contrato versionado da API.

Descrições técnicas preservadas do contrato versionado. Exemplos de dados foram omitidos da cópia pública.

Resumo de um contra-CT-e gerado pela plataforma com seu estado atual perante a SEFAZ.

idstring · uuidObrigatório

UUID do contra-CT-e (aceito em GET /fiscal/cte/{cte_uuid} e /dacte).

source_cte_keystring | nullOpcional

Chave de acesso (44 caracteres) do CT-e da contratante que deu origem ao documento.

leg_refstring | nullOpcional

Rótulo da perna informada no lote, quando aplicável.

tp_cteintegerObrigatório

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

0 · 1
tp_cte_rotulostringObrigatório

Normal ou Complemento de valores.

chave_cte_complementadostring | nullOpcional

Chave de 44 dígitos do contra-CT-e complementado (<infCteComp><chCTe>) quando tp_cte = 1.

tipo_servicointegerObrigatório

ide/tpServ gravado no documento (1 subcontratação, 2 redespacho, 3 redespacho intermediário).

0 · 1 · 2 · 3
tipo_servico_rotulostringObrigatório
access_keystring | nullOpcional

Chave de acesso de 44 dígitos do contra-CT-e na SEFAZ.

numberinteger | nullOpcional
seriesstring | nullOpcional
freight_valuenumber | nullOpcional

Valor total da prestação (vTPrest) declarado no contra-CT-e.

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

UUID do lote (POST /fiscal/cte-subcontratacao/lote) que gerou este contra-CT-e, quando emitido em lote.

authorized_atstring | null · date-timeOpcional
created_atstring | null · date-timeOpcional
Definição JSON Completa
{
  "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"
    }
  }
}