Acompanhe as novidades, melhorias e novos módulos da API Frota162.
OUTUBRO 2026
O tempo limite da consulta de CNH passa a ser de 60 segundos antes de retornar `504`. Consultas mais lentas nos órgãos oficiais, que antes expiravam, agora são concluídas normalmente.
Tempo limite da consulta ampliado para 60 segundos, na consulta individual e em cada item do lote
Configure o timeout do seu cliente HTTP com pelo menos 60 segundos, com uma pequena margem (por exemplo, 70 segundos)
Quando o limite é atingido, o comportamento não muda: `504` com o header `Retry-After` na consulta individual e `status: error` no item do lote
O Guia de e-CRLV passa a documentar as rotas para acompanhar uma solicitação de emissão e baixar o documento, por identificador da solicitação ou pela placa do veículo.
`GET /v2/crlv/requests/{requestId}` retorna o status da solicitação (`pending`, `in_progress`, `completed` ou `failed`) e, quando concluída, o documento com a URL de download do PDF
`GET /v2/crlv/vehicles/{carPlate}` retorna o último e-CRLV emitido para o veículo e a solicitação em andamento, quando existirem
A URL de download é temporária e vale por 1 hora; consulte novamente para obter uma URL nova
Em caso de falha na emissão, o campo `failure` traz um código e uma mensagem públicos
Os webhooks de multas (evento frame) e notificações (evento notification) agora incluem o campo treated, que indica se o cliente marcou o registro como tratado na plataforma.
O campo `treated` é booleano e fica dentro do bloco do evento (`frame.treated` e `notification.treated`); nunca vem `null`
Registros novos sempre chegam com `false`; quando a tratativa muda, o valor novo chega no webhook de atualização
O status do recurso e a justificativa da tratativa continuam fora do payload
Mudança aditiva: nada foi removido nem renomeado. Só quem valida o schema de forma estrita precisa aceitar a chave nova
Quando o serviço de consulta não responde dentro do tempo limite, a consulta individual de CNH passa a retornar `504 Gateway Timeout` em vez de `500` genérico.
Resposta `504` com `type` `gateway-timeout` e o header `Retry-After` (em segundos) indicando quando tentar novamente
É uma falha temporária: retente com backoff, respeitando o `Retry-After`
Consultas que terminam em `504` não são cobradas
No lote, o comportamento não muda: o item com falha continua como `status: error`
Novo CPF no sandbox (`41837592691`) para simular o cenário
O webhook de multas (evento frame) agora inclui o campo linkFrame com a URL do documento oficial da infração emitido pelo órgão autuador.
O campo `linkFrame` traz a URL direta para visualização e download do documento oficial da infração
Quando o documento ainda não estiver disponível no órgão autuador, o campo virá como `null`
O campo `link` continua sendo a URL do boleto de pagamento da multa, sem alterações no seu comportamento