Pular para conteúdo

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.