Módulos

Multas e Notificações

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 por cada infração e atualize informações de pagamento — manualmente, um a um, quando necessário.

Se você já registra viagens, a vinculação do condutor acontece sozinha; este módulo é a alternativa para os casos em que a viagem não cobre o período da infração.

2 min de leituraVale para v1

O que dá para fazer

Ação	Endpoint	Quando usar
Vincular condutor à multa	PUT /key/tickets/indicate-driver	Indicar quem dirigia na hora da infração
Vincular condutor à notificação	PUT /key/notifications/indicate-driver	Indicar condutor de uma notificação
Atualizar multa	PUT /key/tickets/{multa_id}/update	Atualizar valor de enquadramento e/ou data de pagamento

Antes de começar

Todas as chamadas usam os três headers de autenticação: Authorization, Key e cache-control. Ainda não tem as credenciais? Veja os Primeiros passos.

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.

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

PUT/key/tickets/indicate-driver

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

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

PUT/key/notifications/indicate-driver

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

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

PUT/key/tickets/{multa_id}/update

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

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.

---

Próximos passos

ViagensVincule condutores a veículos

Associe condutores a veículos em intervalos de datas.

CondutoresGerencie condutores

Cadastre e gerencie os condutores da sua frota.

WebhooksReceba eventos em tempo real

Configure webhooks para receber multas e notificações instantaneamente.