Pular para o conteúdo principal
Changelog

Atualizações

Acompanhe as novidades, melhorias e novos módulos da API Frota162.

AGOSTO 2026

Redesign do Portal — busca local, tema escuro e Guia de Integração reorganizado

O Portal de Documentação ganha uma nova cara e uma navegação repensada. A sidebar do Guia de Integração foi reorganizada para refletir como você usa a API — módulos agrupados por domínio em vez de versão, guias separados de conteúdo de consulta e ajuda reunida num lugar só. Tudo isso com identidade visual renovada, tema escuro aprimorado e busca própria na navbar.

  • Busca local na navbar — encontra qualquer página do portal direto pelo teclado, sem depender de serviço externo

  • Novo tema escuro e identidade visual baseada no Frota DS aplicada a todas as páginas de conteúdo

  • Introdução, Primeiros Passos e Ambientes & URLs fundidos em uma única página de entrada, eliminando a confusão entre rotas da API e rotas da plataforma

  • Visão geral de Autenticação incorporada ao guia HMAC — o conteúdo repetido saiu, os três headers ficam explicados onde você usa

  • Módulos agrupados por domínio: Consulta de CNH aparece junto de Condutores e Indicação de condutores junto de Multas, com badge Beta para itens da API V2

  • Nova seção Referência reunindo Paginação e Rate Limiting v2 — conteúdo de consulta rápida separado dos guias passo a passo

  • Nova seção Ajuda reunindo FAQ e Suporte

  • Renomeações para alinhar vocabulário: "Indicação de Motoristas" agora é "Indicação de condutores", e o módulo de multas é "Multas e notificações"

  • JWT Bearer sai da sidebar — disponível apenas na API V2 futura; HMAC segue como autenticação da v1

Correção dos event_type de débito no Guia de Webhooks

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

JULHO 2026

Consulta de CNH em lote — Beta na API v2

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`

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

Consulta de CNH — Beta na API v2

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

  • Beta — entre em contato para testar

Mostrando 5 de 10

Novidades e breaking changes também serão comunicados por e-mail aos clientes cadastrados. Para sugerir funcionalidades ou reportar problemas, entre em contato em suporte@frota162.com.br.