Atualizações
06/11/2026
Unificação dos menus Fluxo de Credenciamento e Passo a passo para credenciar em Jornada de Credenciamento
29/10/2026
Credenciamento - reestruturação do fluxo de credenciamento.
26/10/2026
Manual Técnico - Validações e Regras de Negócio: inclusão do E-Frotas no envio de notificações.
Manual Técnico - Validações e Regras de Negócio: retirado prazo de 7 dias no status em processamento; retirado cancelamento por mais de 7 dias em processamento; inclusão cópia de passagem, com status cancelada, na alteração de placa. Retirar validação de 24 horas.
25/09/2026
Inclusão de explicação técnica a respeito de atributos do tipo Timestamp (ISO-8601) para padronização da API de passagens.
16/09/2026
Inclusão Menu Suporte: link para formulário de solicitação de suporte ao Serpro.
11/09/2026
Portal Pedágio Eletrônico Senatran: inclusão de campo E-mail para Notificações de Falha do Webhook no cadastro da concessionária.
Webhook: inclusão de informações sobre o envio diário de e-mails quando forem registradas pelo menos dez falhas de comunicação com o webhook
04/09/2026
Validações e Regras de Negócio: inclusão de itens no Fluxo de Transição de Status;
Carga de Histórico: inclusão de Formato do Arquivo para Atualização por ID;
31/08/2026
Inclusão Webhook Retornos.
21/08/2026
Validações e Regras de Negócio: incluir no item Controle do status "Em Processamento" como webhook retorna sobre o cancelamento.
12/08/2026
Mensagens de Erros: correção da renderização da parte variável da mensagem. Inclusão de orientação sobre persistencia dos dados no caso placa não encontrada.
07/08/2026
Carga de Histórico: orientações sobre carga complementar e prazos.
07/08/2026
Inclusão de seção Regras de Alterações do Evento no menu Interface de Eventos com o intuito de auxiliar na interpretação do que pode ser alterado.
Webhook: alteração no tempo de retorno e no tamanho do lote. Orientação sobre não segurar requisição
Inclusão do submenu Mensagens de Erros no menu do manual técnico.
31/07/2026
Validações e Regras de Negócio: permitir o cancelamento de passagens com status de pagamento "Pendente de Pagamento" ou "Vencido" com envio de notificação ao possuidor do veículo
swagger: no GET /api-v3/passagens/{idPassagem}, inclusão do campo origemCancelamento no retorno da consulta indicando se o cancelamento foi feito pela concessionária (2) ou pelo Job (1).
23/07/2026
Domínios e Tabelas Básicas: inclusão de opção Vale Pedágio Obrigatório no Meio de Pagamento.
Roteiro Homologação: incluído informação sobre o cenário 2 ser necessário apenas às concessões que possuem modelo de cobrança viagem.
Operador de Pagamento: alteração do label Nome Fantasia para Descrição.
Portal Pedágio Eletrônico Senatran: inclusão de regras para url do Webhook
20/07/2026
Roteiro Homologação: alteração no ceário 7 indicando uma placa que não existe no revanam para realização do cenário.
Portal Pedágio Eletrônico Senatran: Pórtico: inclusão de orientação sobre o campo localização. Concessionária: inclusão referência a resolução contran
15/07/2026
Validações e Regras de Negócio: incluído explicação sobre status cancelado nos itens 11 e 12.
Roteiro Homologação: alteração do cenário 4 e 5, explicando com mais detalhes o que deve ser feito.
14/07/2026
Roteiro Homologação: inclusão da coluna críticas realizadas nos cenários. Retirado cenário 10. Alteração no texto Comprovação da interoperabilidade.
13/07/2026
Roteiro Homologação: alteração da última etapa do cenário 3, explicando com mais detalhes o que deve ser feito. ; inclusão do menu Comprovação da interoperabilidade
09/07/2026
Órgãos: alteração formulário
Portal Pedágio Eletrônico Senatran: inclusão de referências a portaria 442/2025
Executivo de Transito: retirado lista.
Carga: alteração na quebra dos arquivos.
03/07/2026
Webhook: inclusão do ip de origem 189.9.79.228:80.
29/06/2026
Webhook: inclusão do ip de origem.
26/06/2026
Carga de Histórico: atualizar prazo para envio dos arquivos; retirar necessidade de arquivos de porticos e operadores de pagamento; incluir data de início da bilhetagem; atualizar situação no credencia para acesso a url de envio dos arquivos.
Início: atualização dos links rápidos
Fluxo Credenciamento: inclusão da url do portal do Pedágio Eletrônico da Senatram em produção
Interface de Eventos: inclusão da url da api em produção
Webhook: inclusão da url da api em produção
Portal Pedágio Eletrônico Senatran: inclusão da url em produção
Inclusão menu Executivo
24/06/2026
Inclusão do menu webhook.
23/06/2026
Carga de Histórico: url para acesso em homologação
18/06/2026
Correção do parametro idPassagem nos eventos passagem e pagamento
Segurança e Autenticação: Inclusão orientações api key do webhook
Portal Pedágio Eletrônico Senatran: Inclusão api key do webhook
12/06/2026
Segurança e Autenticação: incluído orientação sobre cadeia de certificados completa para webhook
10/06/2026
Fluxo do credenciamento: incluir forma de cadastrar CPF no gov.br de homologação
Carga histórico: no formato do arquivo especificação de dataHoraAtualizacaoPagamento e dataHoraAtualizacaoPassagem que antes aparecia duplicado; inclusão de url para formato dos campos; atualização da forma de envio
Validações: reestruturação das informações e inclusão de informação sobre política de cache.
01/06/2026
swagger: inclusão de informações sobre Webhook de Notificação da Concessionária
Atualização do menu Manual Técnico/Portal Pedágio Eletrônico Senatran
Inclusão de menu passo a passo para credenciar
Inclusão de menu roteiro de homologação
Inclusão de menu carga de histórico
Inclusão de menu atualizações
Permitir alteração do campo dataHoraLimitePagamento do evento Pagamento no status Em Processamento.
Permitir alteração dos campos statusTag, dataHoraPagamento, tipoCobranca, operadorPagamento, valorPago do evento Pagamento quando muda status de Pendente de Pagamento/Vencido para Pago dentro do prazo/Pago fora do prazo.
Atualização de validações.
04/05/2026
swagger: serviço único para inclusão e alteração de passagem;
swagger: serviço único para inclusão e alteração de pagamento;
swagger: retirado hash;
swagger: inclusão retorna um location que permite consulta;
inclusão status pagamento: "Pago fora do prazo"
alteração status pagamento: de "Pago" para "Pago dentro do prazo"
inclusão de campo ordem na tabela status pagamento a ser utilizado pela CNH
inclusão de anexos da concessão no portal;
retirada lista de responsáveis do portal;
inclusão de url de pagamento e contestação no portal;
alterado id do portico e operador de pagamento para uuid String (36) nas tabelas do cadastro e nos eventos;
alterado nome dos atributos da tabela Operadoras de Tag de operadoraTagOsaId e codigoOsa para codigoOsa e nome
inclusão da tabela basica status tag, utilizada no evento pagamento (1 Liberado, 2 Bloqueado)
alterado atributo classificacao por idClassificacao no evento passagem
inclusão de obrigatoriedade para o campo dataHoraPagamento quando statusPagamento for Pago no evento pagamento
retirado duplicação de valorPago e dataHoraAtualizacao no evento de pagamento;
inclusão de novas regras de negócio:
Validação do formato, obrigatoriedade e datas.
Validação dos ids informados nos eventos se existem e correspondem ao cnpj que enviou o evento. (localPortico, operadorPagamento)
Validação dos ids informados nos eventos com as tabelas básicas (evento de passagem: modeloCobranca, classificacaoId, operadoraTag, status; evento pagamento: statusTag, statusPagamento, tipoCobranca, ).
Registro enviado dentro do prazo: verifica data e hora de entrada para modelo de cobrança do tipo passagem e data e hora de saída para modelo de cobrança do tipo viagem. Se estiver dentro das 24 horas do evento, aceita-se o registro, caso contrário, retorna erro recusando o registro.
Consulta de dados do veículo: O sistema consulta os dados do veículo para identificar o possuidor.
Processamento da notificação: O sistema fará o envio de notificações eletrônicas aos usuários através da Carteira Digital de Trânsito (CNH) e Portal de Serviço da Senatran quando: o status muda de "Em Processamento" para "Pendente de Pagamento" e a 5 dias corridos do vencimento.
Apenas registros com status de "Em Processamento" podem ter seus campos alterados.
O registro de passagem pode ficar no status "Em Processamento" por até 7 dias, período em que a concessionária pode realizar os ajustes necessários. Após o prazo, caso a concessionária não tenha atualizado o status, o sistema irá cancelar o registro, e o mesmo não poderá mais ser cobrado. Existirá nota explicativa no portal de serviços da senatran e na CNH sobre o status "Em Processamento".
O prazo de 30 dias é contado a partir da data em que o registro muda de "Em Processamento" para "Pendente de Pagamento", sendo de responsabilidade da concessionária a consistência dessa informação na data limite de pagamento.
É de responsabilidade da concessionária o fiel cumprimento de todas as disposições previstas nos dispositivos legais estabelecidos pelos órgãos competentes que regulamentam o sistema de livre passagem (Free Flow) no Brasil.
Registros cancelados não podem ser reativados.
Alterações de Status Possíveis:
| De | Para |
|---|---|
| Em Processamento | Isento |
| Em Processamento | Pago dentro do prazo |
| Em Processamento | Pendente de pagamento |
| Pendente de Pagamento | Pago dentro do prazo |
| Pendente de Pagamento | Vencido |
| Vencido | Pago fora do prazo |
31/03/2026
Inclusão de URL retorno (webhook)
Inclusão fluxo cadastramento
Inclusão diagrama de arquitetura
Alteração de id para uudi do portico e operador de pagamento
Ajustes de layout e nomenclaturas
16/10/2025
Estrutura preliminar dos principais eventos de Passagem e Pagamento em formato API (Swagger).
Visão Geral - Free Flow - Sistema de Livre Passagem
Swagger UI (apenas passagens e pagamentos)