← InícioFleetPay / Schema

CteTripInput

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.

trip_starts_atstring | null · dateOpcional

trip_ends_atstring | null · dateOpcional

trip_distance_kminteger | nullOpcional

minimum0

maximum99999

cargo_sh_codestring | nullOpcional

pattern"^\\d{4}$"

cargo_type_codeinteger | nullOpcional

minimum1

maximum12

toll_valuenumber | null · doubleOpcional

minimum0

fuel_valuenumber | null · doubleOpcional

minimum0

driver_freight_valuenumber | null · doubleOpcional

O que o motorista recebe por esta viagem, em reais. É o valor que o CIOT declara à ANTT (vlrFrete) e o repasse que o financeiro registra — nunca o preço cobrado do tomador, que é o valores.total do CT-e.

Opcional na maioria dos casos. Omitido, o repasse é calculado pela regra do motorista (percentual sobre o frete, diária ou valor por entrega, conforme a faixa que cobre o CEP de destino da NF-e), e é esse número que o CIOT declara.

Passa a ser obrigatório quando não há de onde calcular, e o CIOT fica pendente até ser informado: a regra do motorista é "Valor Informado pela Empresa", o motorista não tem regra de repasse vinculada, ou nenhuma faixa da regra cobre o CEP de destino.

Definição JSON Completa

{
  "type": [
    "object",
    "null"
  ],
  "properties": {
    "trip_starts_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "trip_ends_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "trip_distance_km": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0,
      "maximum": 99999
    },
    "cargo_sh_code": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^\\d{4}$"
    },
    "cargo_type_code": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "maximum": 12
    },
    "toll_value": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "minimum": 0
    },
    "fuel_value": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "minimum": 0
    },
    "driver_freight_value": {
      "description": "O que o **motorista** recebe por esta viagem, em reais. É o valor que o CIOT\ndeclara à ANTT (`vlrFrete`) e o repasse que o financeiro registra — nunca o preço\ncobrado do tomador, que é o `valores.total` do CT-e.\n\n**Opcional na maioria dos casos.** Omitido, o repasse é calculado pela regra do\nmotorista (percentual sobre o frete, diária ou valor por entrega, conforme a faixa\nque cobre o CEP de destino da NF-e), e é esse número que o CIOT declara.\n\nPassa a ser **obrigatório** quando não há de onde calcular, e o CIOT fica pendente\naté ser informado: a regra do motorista é \"Valor Informado pela Empresa\", o\nmotorista não tem regra de repasse vinculada, ou nenhuma faixa da regra cobre o CEP\nde destino.\n",
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "exclusiveMinimum": 0
    }
  }
}