Mensagens de Erros
Erros de passagens
Pórtico {UUID} não encontrado, inativo ou não vinculado à concessionária.
Data de entrada não pode ser posterior à data de saída
Placa {placa} não encontrada no sistema Renavam para a passagem {UUID}.
Veículo sem possuidor na base Renavam.
Passagem cancelada não pode ser atualizada.
A passagem não pode ser atualizada enquanto o pagamento estiver na situação {situação}.
A Passagem não pode ser atualizada com alteração dos campos: {campos}
A data/hora de atualização da passagem é anterior à última atualização registrada.
Dados inválidos na passagem: {detalhes}.
Os possíveis detalhes dessa última mensagem são:
- idConcessionaria: ID da concessionária é obrigatório
- idPassagemExterno: ID da passagem é obrigatório
- modeloCobranca: Modelo de cobrança é obrigatório
- dataHoraEntrada: Data/hora de entrada é obrigatória
- localPorticoEntrada: Pórtico de entrada é obrigatório
- placa: Placa deve estar no formato AAA9999 ou AAA9A99
- classificação: Classificação é obrigatória
- status: Situação da passagem é obrigatória
Quando houver várias violações, elas são ordenadas e unidas por ;.
Exemplo: Dados inválidos na passagem: classificacao: Classificação é obrigatória; tag: TAG deve ter no máximo 10 caracteres.
Erros de pagamentos
Passagem não encontrada para pagamento: {UUID}.
Passagem cancelada não permite inclusão ou alteração de pagamento.
Operador de pagamento {UUID} não encontrado, inativo ou não vinculado à concessionária.
Transição da situação do pagamento não permitida: {situação atual} → {nova situação}.
Pagamento não pode ser atualizado da situação {situação atual} para {nova situação} com alteração dos campos: {campos}.
Os campos alterados podem ser:
- valorCobrado (<valor atual> → <novo valor>)
- dataHoraLimitePagamento (<data atual> → <nova data>)
- Ambos, separados por , .
Dados inválidos no pagamento: {detalhes}.
Os possíveis detalhes são:
- passagem: ID da passagem é obrigatório
- idConcessionaria: ID da concessionária é obrigatório
- valorCobrado: Valor cobrado é obrigatório
- valorCobrado: Valor cobrado não pode ser negativo
- dataHoraLimitePagamento: Data/hora limite de pagamento é obrigatória
- statusPagamento: Situação do pagamento é obrigatória
- dataHoraPagamento: Data/hora do pagamento não pode estar no futuro
- dataHoraPagamento: Data/hora do pagamento é obrigatória quando o pagamento estiver pago
- tipoCobranca: Tipo de cobrança é obrigatório
- valorPago: Valor pago é obrigatório quando o pagamento estiver pago
- dataHoraAtualizacao: Data/hora de atualização é obrigatória
Também podem ser combinados, por exemplo:
Dados inválidos no pagamento: dataHoraPagamento: Data/hora do pagamento é obrigatória quando o pagamento estiver pago; valorPago: Valor pago é obrigatório quando o pagamento estiver pago.
Persistência dos dados
Requisições de Passagem/Pagamento que retornam status HTTP diferente de 200/201 não são incluídas/atualizadas na base de dados.
Registros de Passagem/Pagamento que retornam pelo webhook "sucesso": false, não são incluídas/atualizadas na base de dados.
Placa não encontrada no sistema Renavam
A partir de 12/08/2026 (tarde), as ocorrências em que o sistema Renavam não localizar a placa informada passarão a ser tratadas como processamento concluído com sucesso.
Quando ocorrer a situação abaixo:
Placa {placa} não encontrada no sistema Renavam para a passagem {UUID}.
O comportamento será:
O registro será incluído na base de dados.
O webhook retornará:
{
[...]
"sucesso": true,
"motivo": "Placa {placa} não encontrada no sistema Renavam para a passagem {UUID}."
}
Comportamento anterior (até 12/08/2026 - manhã):
O registro não era incluído na base de dados.
O webhook retornava:
{
[...]
"sucesso": false,
"motivo": "Placa {placa} não encontrada no sistema Renavam para a passagem {UUID}."
}
Impacto: consumidores do webhook que utilizam exclusivamente o campo sucesso para determinar falhas deverão ajustar suas integrações. A condição "placa não encontrada no sistema Renavam" deixará de ser considerada um erro de processamento e passará a ser informativa, sendo detalhada no campo motivo. Essa alteração permitirá que a concessionária efetue a correção da placa em até 7 dias.