Acompanhe as novidades, melhorias e novos módulos da API Frota162.
AGOSTO 2026
12 ago 2026
Correção dos event_type de débito no Guia de Webhooks
WebhooksBreakingNovo
O Guia de Webhooks publicava os valores IPVA, DPVAT e LICENCIAMENTO como event_type, mas o payload entregue usa DEBITOS-IPVA, DEBITOS-DPVAT e DEBITOS-LICENCIAMENTO — em UPPERCASE com prefixo DEBITOS-. Se você implementou o roteamento de eventos de débito seguindo a documentação anterior, seu handler provavelmente nunca dispara: o evento chega, não encontra match e é descartado em silêncio. Confira seus handlers e atualize a comparação para o valor exato.
Correção dos valores de event_type para DEBITOS-IPVA, DEBITOS-DPVAT e DEBITOS-LICENCIAMENTO no exemplo de payload e no cabeçalho do TabItem de tributos
Adicionado alerta: débitos são os únicos event_type em UPPERCASE com prefixo DEBITOS- — não aplicar toLowerCase() nem normalizar antes do match
Documentado que o webhook de débito dispara apenas na criação do registro — updated_at sempre chega null
Removida referência a caminho de arquivo interno e nome de função que haviam vazado no conteúdo publicado
Nova entrada de FAQ: "Meu handler de eventos de débito nunca dispara" com explicação do problema e código de correção
O módulo de Consulta de CNH ganha a consulta em lote: envie uma lista de documentos em uma única requisição e receba um resultado por item. Ideal para onboarding em massa e reconciliação de base, sem precisar de uma chamada por condutor.
Consulta de vários CPFs ou números de CNH em uma única requisição (até 50 por lote)
Falha parcial por item — um documento não localizado ou com erro não interrompe os demais
Resposta com resultado por item (found / not_found / error) e um resumo consolidado (summary)
Mesma autenticação HMAC da API v1, sem necessidade de novas credenciais
Webhook de Multas — novo campo `paid` no bloco `payment`
Webhooks
O payload do webhook de Multas (event_type "frame") passa a incluir o campo booleano `paid` no bloco `payment`, indicando se a multa consta como paga. Mudança aditiva — nenhuma integração existente quebra.
Novo campo `payment.paid` (boolean) — fonte de verdade para saber se a multa foi paga
Use `paid` em vez de inferir o pagamento por `at`/`amount`: `paid` pode vir `true` com `at: null` e `amount: 0`
Sem ação obrigatória para quem já recebe o webhook — o campo é adicional
A API v2 ganha o módulo de Consulta de CNH: valide a habilitação de um condutor em tempo real, por CPF ou número da CNH, recebendo os dados da carteira e do condutor na mesma requisição. Disponível somente entrando em contato.
Consulta síncrona por CPF ou número da CNH, com resposta na mesma requisição
Dados da habilitação e do condutor, com campos estendidos conforme a UF (exame toxicológico, bloqueios, exames e cursos)
Mesma autenticação HMAC da API v1, sem necessidade de novas credenciais
Ideal para onboarding de motoristas, checagens de conformidade e validação da CNH
Novidades de Webhooks — teste na plataforma e novo IP de origem
WebhooksPlataforma
Agora é possível testar seus webhooks diretamente pela plataforma Frota162, sem precisar aguardar um evento real da frota. Também adicionamos um novo IP de origem para o envio de webhooks — se você usa allowlist de IPs no firewall, é necessário liberá-lo para continuar recebendo os eventos.
Envio de eventos de teste para a URL de webhook cadastrada, direto pela plataforma
Payloads de exemplo para cada tipo de evento suportado
Visualização da resposta do seu endpoint (status e corpo) em tempo real
Validação rápida da integração antes de ir para produção
Novo IP de origem: 20.84.24.3 — ação necessária apenas para quem usa allowlist/filtro de IP no servidor