Módulo Multas e Notificações

Gerencie a responsabilização de condutores por multas e notificações de trânsito. A API permite vincular o condutor responsável a uma infração no sistema Frota162 e atualizar dados financeiros de uma multa.

O que é "vincular um condutor"

Esses endpoints registram internamente quem era o condutor responsável pelo veículo no momento da infração. Isso não equivale à indicação formal ao órgão de trânsito — esse processo é realizado pelo módulo de Indicação de Motoristas da API v2.

As multas e notificações chegam à sua conta automaticamente via integração com os órgãos de trânsito. O papel deste módulo é permitir que você identifique o condutor responsável e atualize informações de pagamento.

Vinculação automática via viagens

Se você registrar viagens com condutor e intervalo de datas, a vinculação acontece automaticamente — sem precisar chamar os endpoints abaixo para cada infração.

Vincular condutor à multa

Registra o condutor responsável por uma multa específica no sistema.

PUT /key/tickets/indicate-driver

Campo	Tipo	Obrigatório	Descrição
ticket_id	integer	Sim	ID da multa
driver_id	integer	Sim	ID do condutor

curl -X PUT \
  https://apidev.v1.frota162.com.br/key/tickets/indicate-driver \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ticket_id=100' \
  -d 'driver_id=15'

Resposta

{
  "message": "Condutor indicado com sucesso",
  "error": false
}

Vincular condutor à notificação

Registra o condutor responsável por uma notificação de trânsito específica no sistema.

PUT /key/notifications/indicate-driver

Campo	Tipo	Obrigatório	Descrição
notification_id	integer	Sim	ID da notificação
driver_id	integer	Sim	ID do condutor

curl -X PUT \
  https://apidev.v1.frota162.com.br/key/notifications/indicate-driver \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'notification_id=200' \
  -d 'driver_id=15'

Resposta

{
  "message": "Condutor indicado com sucesso",
  "error": false
}

Atualizar multa

Permite atualizar o valor de enquadramento e a data de pagamento de uma multa.

PUT /key/tickets/{multa_id}/update

Campo	Tipo	Descrição
framing_amount	number	Valor do enquadramento
payment_date	string	Data de pagamento (YYYY-MM-DD)

curl -X PUT \
  'https://apidev.v1.frota162.com.br/key/tickets/100/update' \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'framing_amount=293.47' \
  -d 'payment_date=2024-03-15'

Resposta

{
  "ticket": { ... },
  "error": false
}

Receber multas em tempo real

Além de consultar via API, você pode receber novas multas e atualizações de status instantaneamente via webhooks. Isso elimina a necessidade de polling.

Consulte o Guia de Webhooks para configurar sua URL de destino e entender os eventos disponíveis.

---