Uma consulta veicular começa com um identificador, e boa parte das consultas falhas se explica por como ele foi escrito: um zero por uma letra O, um hífen a mais, um espaço no meio ou uma placa antiga que já não existe. Este guia resume como um veículo é identificado em cada um dos países cobertos por nossas APIs de multas e quais regras de normalização convém aplicar antes de enviar a consulta.
Argentina: dominio
Na Argentina o identificador se chama dominio, embora todo mundo diga patente. Convivem dois formatos: o anterior, de três letras e três números (ABC 123), e o do Mercosul vigente desde 2016, de duas letras, três números e duas letras (AB 123 CD). As motos usam variantes próprias com a mesma lógica. Os órgãos publicam a placa sem espaços nem hífens, e é assim que a API de multas de trânsito na Argentina a espera: maiúsculas, sem separadores, sem zeros no lugar de ós.
Brasil: placa
O Brasil usa a placa do Mercosul desde 2018, com três letras, um número, uma letra e dois números (ABC1D23), e ainda circula o formato anterior de três letras e quatro números (ABC-1234), que os sistemas convertem substituindo o segundo número pela letra equivalente. Além da placa, os trâmites usam o RENAVAM, o número do registro nacional do veículo, que a API de multas de trânsito no Brasil aceita como identificador complementar quando a fonte exige.
Chile: patente ou PPU
No Chile a placa patente única (PPU) tem quatro letras e dois números (BBBB10) no formato vigente, e duas letras e quatro números no anterior (AB1234), que continua circulando. Os sistemas oficiais aceitam a patente sem hífen nem espaço; o dígito verificador, que aparece em alguns documentos, não faz parte da patente e não deve ser enviado na consulta de multas no Chile.
México: placa e NIV
No México cada entidade emite suas placas com formatos próprios, de três letras e três ou quatro números na maioria dos estados, e com séries distintas para serviço particular, público e federal. Como o formato não é uniforme e as placas são substituídas no reemplacamento de cada entidade, muitas fontes pedem também o número de identificação veicular (NIV) para confirmar a unidade; a API de multas no México informa por entidade qual identificador cada fonte exige.
Uruguai: matrícula
O Uruguai usa uma matrícula de três letras e quatro números (ABC 1234) cuja primeira letra identifica o departamento de registro, com séries próprias para motos e veículos oficiais. O sistema único de cobrança de receitas veiculares, SUCIVE, unifica a consulta de dívidas por matrícula e padrão em todos os departamentos; a API de multas no Uruguai aceita a matrícula sem espaços.
Regras de normalização
- Converter para maiúsculas e remover espaços, hífens e pontos antes de validar.
- Substituir zeros por ós e uns por ís apenas nas posições que o formato do país define como letras, e o inverso nas numéricas.
- Validar contra o formato vigente e o anterior do país; rejeitar o que não se encaixa em nenhum antes de consultar.
- Guardar o identificador tal como o usuário escreveu e o normalizado, para explicar uma consulta falha.
O que a API retorna
Todas as APIs de multas recebem o identificador normalizado em um POST, com o país implícito na API e as jurisdições como filtro opcional, e retornam cada infração com o órgão que a registrou e o identificador tal como a fonte o publica. Um identificador com formato inválido é rejeitado antes de consultar, com o motivo, para que a correção ocorra na origem e não depois de esperar uma resposta.
