← InicioFleetPay / Schema

CteTripInput

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.

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

Lo que recibe el conductor por este viaje, en reales brasileños. Es el importe que el CIOT declara a la ANTT (vlrFrete) y la transferencia que registra el sistema financiero, nunca el precio cobrado al tomador, que corresponde a valores.total del CT-e.

Opcional en la mayoría de los casos. Si se omite, la transferencia se calcula según la regla del conductor (porcentaje sobre el flete, tarifa diaria o importe por entrega, según el tramo que cubre el código postal de destino de la NF-e), y el CIOT declara ese importe.

Pasa a ser obligatorio cuando no es posible calcularlo, y el CIOT queda pendiente hasta que se informe: la regla del conductor es "Valor Informado pela Empresa" (importe informado por la empresa), el conductor no tiene una regla de transferencia vinculada o ningún tramo de la regla cubre el código postal de destino.

Definición JSON Original (Descripciones en Portugués)

{
  "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
    }
  }
}