← InicioFleetPay / Schema

CotarVpoRequest

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.

VpoPontoParada ↗

origemstringObligatorio

Código postal (con o sin guion) o nombre de ciudad/dirección de salida.

minLength3

maxLength150

destinostringObligatorio

Código postal (con o sin guion) o nombre de ciudad/dirección de llegada.

minLength3

maxLength150

eixosintegerObligatorio

Cantidad total de ejes del vehículo comercial o conjunto.

minimum2

maximum10

placastring | nullOpcional

Matrícula del vehículo comercial (formato Mercosur o brasileño antiguo).

maxLength10

modalidadestring | nullOpcional

Modalidad de ruta solicitada (planejada: ruta directa optimizada; estendida: ruta con tolerancia para desvíos; customizada: plazas específicas).

"planejada" · "estendida" · "customizada"

pontos_paradaarray | nullOpcional

Puntos intermedios del viaje, en el orden en que pasa el vehículo, entre origem y destino. La operadora no acepta una polilínea: la ruta se traza mediante puntos de parada. Cada punto puede ser una ciudad (cidade, en formato "Ciudad, Estado") o un par latitude/longitude en grados decimales (por ejemplo, vértices relevantes de un trazado propio). Si un punto incluye ciudad y coordenadas, prevalece la ciudad. Utiliza este campo para pasar por una carretera específica o reproducir la ruta de tu planificador. Sin este campo, la operadora elige el trayecto entre origen y destino.

VpoPontoParada ↗

maxItems20

tipo_rotastring | nullOpcional

Criterio de la operadora para trazar la ruta principal entre los puntos.

"mais_rapida" · "mais_curta"

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

{
  "type": "object",
  "required": [
    "origem",
    "destino",
    "eixos"
  ],
  "properties": {
    "origem": {
      "type": "string",
      "minLength": 3,
      "maxLength": 150,
      "description": "CEP (com ou sem hífen) ou nome da cidade/endereço de partida."
    },
    "destino": {
      "type": "string",
      "minLength": 3,
      "maxLength": 150,
      "description": "CEP (com ou sem hífen) ou nome da cidade/endereço de chegada."
    },
    "eixos": {
      "type": "integer",
      "minimum": 2,
      "maximum": 10,
      "description": "Quantidade total de eixos do veículo comercial ou conjunto."
    },
    "placa": {
      "type": "string",
      "maxLength": 10,
      "nullable": true,
      "description": "Placa do veículo comercial (padrão Mercosul ou antigo)."
    },
    "modalidade": {
      "type": "string",
      "enum": [
        "planejada",
        "estendida",
        "customizada"
      ],
      "nullable": true,
      "description": "Modalidade de rota pretendida (`planejada`: rota direta otimizada; `estendida`: rota com tolerância para desvios; `customizada`: praças específicas)."
    },
    "pontos_parada": {
      "type": "array",
      "nullable": true,
      "maxItems": 20,
      "description": "Pontos intermediários da viagem, **na ordem em que o veículo passa**, entre `origem` e `destino`.\nA operadora não aceita polyline: a rota é traçada por pontos de parada, e cada ponto pode ser uma\ncidade (`cidade`, no formato \"Cidade, UF\") **ou** um par `latitude`/`longitude` em graus decimais\n(vértices relevantes de um traçado próprio, por exemplo). Se um ponto trouxer cidade e coordenadas,\nvale a cidade. Use-o para forçar o trajeto por uma rodovia específica ou reproduzir a rota do seu\nroteirizador. Sem este campo a operadora escolhe o trajeto entre origem e destino.\n",
      "items": {
        "$ref": "#/components/schemas/VpoPontoParada"
      }
    },
    "tipo_rota": {
      "type": "string",
      "enum": [
        "mais_rapida",
        "mais_curta"
      ],
      "nullable": true,
      "default": "mais_rapida",
      "description": "Critério da operadora para traçar a rota principal entre os pontos."
    }
  }
}