← InicioFleetPay / Schema

VeiculoPedagio

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.

operadorastringObligatorio

Operadora que respondió. Se devuelve deliberadamente para que el dato guardado en tu base conserve su origen.

"sem_parar" · "conectcar" · "veloe" · "move_mais"

placastringObligatorio

La matrícula consultada, normalizada en mayúsculas y sin separadores.

tem_tagbooleanObligatorio

Indica si el vehículo tiene un tag de peaje, es decir, si utiliza la vía automática.

Es una respuesta, no una inferencia: no deduzca que no tiene tag porque identificador_tag sea nulo.

identificador_tagstring | nullOpcional

Código del tag. Solo se incluye para vehículos con tag; siempre es null cuando tem_tag es false.

proprietariostring | nullOpcional

Quién figura en el registro del vehículo de la operadora.

descricaostring | nullOpcional

Marca, modelo y categoría, tal como los devuelve la operadora.

eixosinteger | nullOpcional

minimum2

maximum10

habilitado_vale_pedagiobooleanObligatorio

Indica si se puede emitir un vale de peaje para este vehículo.

Es independiente de tem_tag. El vale tradicional no requiere tag y un vehículo con tag puede estar bloqueado por la operadora.

verificacaostringOpcional

simulada cuando FleetPay generó la respuesta sin una operadora contratada. Su ausencia indica una verificación real.

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

{
  "type": "object",
  "required": [
    "operadora",
    "placa",
    "tem_tag",
    "habilitado_vale_pedagio"
  ],
  "properties": {
    "operadora": {
      "type": "string",
      "enum": [
        "sem_parar",
        "conectcar",
        "veloe",
        "move_mais"
      ],
      "description": "A operadora que respondeu. Ecoada de propósito: o dado gravado na sua base carrega\na origem.\n"
    },
    "placa": {
      "type": "string",
      "description": "A placa consultada, normalizada em maiúsculas e sem separador."
    },
    "tem_tag": {
      "type": "boolean",
      "description": "Se o veículo carrega tag de pedágio — ou seja, se passa pela via automática.\n\nÉ **resposta**, não inferência: não deduza a ausência de tag de `identificador_tag`\nvir nulo.\n"
    },
    "identificador_tag": {
      "type": [
        "string",
        "null"
      ],
      "description": "O código da tag. Só acompanha quem tem tag — vem `null` sempre que `tem_tag` é\n`false`.\n"
    },
    "proprietario": {
      "type": [
        "string",
        "null"
      ],
      "description": "Quem o operador tem no cadastro do veículo."
    },
    "descricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Marca, modelo e categoria, como o operador os devolve."
    },
    "eixos": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 2,
      "maximum": 10
    },
    "habilitado_vale_pedagio": {
      "type": "boolean",
      "description": "Se dá para emitir Vale-Pedágio para este veículo.\n\n**Pergunta independente de `tem_tag`.** O vale tradicional não exige tag, e um\nveículo com tag pode estar bloqueado pelo operador.\n"
    },
    "verificacao": {
      "type": "string",
      "description": "`simulada` quando a resposta foi gerada pela FleetPay, sem operador contratado.\nAusente significa verificação real.\n"
    }
  }
}