API: motoristas

Liste, crie e atualize motoristas.

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

Lista motoristas da empresa autenticada.

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

Body

Campo	Tipo	Descrição
namereq	string	Nome completo.
phonereq	string	Telefone E.164 (+5511...).
cpfreq	string	CPF, somente dígitos.
cnh_number	string	Número da CNH.
cnh_category	enum(A,B,C,D,E)	Categoria.
cnh_expires_at	ISO date	Data de vencimento.
has_mopp	boolean	Possui certificado MOPP.

bash

curl -X POST https://freteflow.fr.com.br/api/public/v1/drivers \
  -H "X-API-Key: ff_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "João Silva",
    "phone": "+5511999999999",
    "cpf": "12345678900",
    "cnh_category": "E",
    "has_mopp": true
  }'

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

Retorna um motorista por id.

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

Atualiza campos do motorista. Aceita os mesmos campos de criação (todos opcionais).

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

Inativa o motorista (soft delete: status = inativo).

POST/api/public/v1/drivers/bulkAuth: API key

Cria até 200 motoristas em uma única chamada. Body: { "items": [...] }. Duplicados por CPF retornam em conflicts sem interromper o lote.

Importação em lote por planilha

Para cargas iniciais grandes, use a importação CSV/XLSX disponível em /drivers. O template inclui validação de CPF, CNH e detecção de duplicidades.