API: veículos

Liste, crie, atualize e inative veículos da frota.

GET/api/public/v1/vehiclesAuth: API key

Lista veículos da empresa autenticada. Aceita ?limit= (máx 200).

POST/api/public/v1/vehiclesAuth: API key

Body

Campo	Tipo	Descrição
platereq	string	Placa (única por empresa).
vehicle_type	string	Tipo (truck, toco, carreta...).
renavam	string	Renavam.
brand	string	Marca.
model	string	Modelo.
year	number	Ano de fabricação.
capacity_kg	number	Capacidade em kg.
status	enum(ativo,inativo,manutencao)	Padrão: ativo.
notes	string	Observações.

bash

curl -X POST https://freteflow.fr.com.br/api/public/v1/vehicles \
  -H "X-API-Key: ff_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "plate": "ABC1D23",
    "vehicle_type": "carreta",
    "brand": "Volvo",
    "model": "FH 540",
    "year": 2022,
    "capacity_kg": 30000
  }'

GET/api/public/v1/vehicles/{id}Auth: API key

Retorna um veículo por id.

PATCH/api/public/v1/vehicles/{id}Auth: API key

Atualiza campos do veículo (todos opcionais).

DELETE/api/public/v1/vehicles/{id}Auth: API key

Inativa o veículo (soft delete: status = inativo).

Importação em lote por planilha

Para cargas iniciais, use a importação por planilha CSV/XLSX em /vehicles. O template tem as mesmas colunas do POST acima e suporta detecção de duplicidade por placa.