Carga de Histórico
As concessionárias deverão enviar ao SERPRO os registros históricos desde o início da operação.
A carga histórica será realizada em duas fases:
Fase 1 - Carga Principal
Contemplará todos os registros históricos gerados até a data de corte (DD/MM/2026).
Fase 2 - Carga Complementar
Contemplará os registros gerados após a data de corte (DD/MM/2026) até a data de integração da API.
Importante: a data de corte é utilizada exclusivamente para definir quais registros devem compor cada fase da carga histórica. Ela não deve ser confundida com os prazos de entrega dos arquivos ao SERPRO.
O prazo para entrega dos arquivos da Fase 1 será até 11/08/2026.
O período para entrega dos arquivos da Fase 2 será de 12/08/2026 a 14/08/2026.
Os registros enviados na carga histórica que estiverem com status Em Processamento, Pendente de Pagamento ou Vencido, e que sofram alterações antes de sua efetiva importação pela aplicação, deverão ser atualizados posteriormente por meio da API.
Os registros oriundos da carga histórica com status Em Processamento não serão cancelados automaticamente pela API após o 7º dia. Essa exceção tem como objetivo acomodar o intervalo de tempo entre o recebimento do arquivo pelo SERPRO e a efetiva carga dos registros na aplicação. Após a efetiva carga do registro na aplicação, a concessionária terá até 7 dias para atualizar sua situação.
Não deverão ser incluídas placas fictícias (fakes) nos arquivos de carga histórica.
O envio de notificações aos usuários será iniciado somente após o lançamento da funcionalidade de Pedágio Eletrônico no aplicativo da CNH. A data de lançamento será definida pela Senatran.
A bilhetagem em ambiente de produção terá início em 21/07/2026.
Formato do Arquivo
Arquivos csv, separados por ; com '' para string, null para campo nulo, utf-8, com quebra de linha ao final da linha (chr(10) o Enter), sem cabeçalho, conforme abaixo:
-
para os registros de passagem/pagamento:
cnpjconcessao;passagemId;modeloCobranca;dataHoraEntrada;dataHoraSaida;localPorticoEntrada;localPorticoSaida;placa;idClassificacao;tag;mdfe;operadoraTag;dataHoraAtualizacaoPassagem;status;valorCobrado;dataHoraLimitePagamento;statusTag;statusPagamento;dataHoraPagamento;tipoCobranca;operadorPagamento;valorPago;dataHoraAtualizacaoPagamentoFormato dos campos conforme documentação: Interfaces de Eventos - Sistema de Pedágio Eletrônico Senatran
Atualização por ID
Para atualizar passagens já enviadas, deve ser utilizado um arquivo CSV sem cabeçalho, contendo somente um UUID (passagemId) por linha. Esse arquivo é processado separadamente dos arquivos da carga histórica.
Cada passagem localizada volta à situação Ativa, sem indicação de cancelamento. Quando houver pagamento associado, ele volta à situação Em Processamento. As datas de atualização dos registros também são renovadas.
Quebra do Arquivo
-
Os arquivos podem ser gerados por mes/ano, semestre/ano, ano.
-
Também podem ser todos os registros do período ou separados por pagos e não pagos.
-
Importante: referenciar no nome do arquivo seu conteúdo.
passagem_pagamento_anosemestre_situacao.csv
passagem_pagamento_anomes_situacao.csv
passagem_pagamento_ano_situacao.csv
onde:
situacao: pago, naopago ou todos
ano: AAAA
semestre: S1 ou S2
mes: MM
Forma de Envio
-
Concessão (cnpj) deve estar com o cadastro no Credencia com situação "Aguardando Autorização" ou situação superior.
-
E_cnpj deve estar configurado no navegador.
-
Em homologação deve ser feito upload de uma amostra para que sejam realizadas validações iniciais sobre o formato das informações do arquivo.
-
A aplicação automaticamente compacta o arquivo csv ao fazer o upload.