Pular para conteúdo

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)