Pular para conteúdo

Roteiro de Homologação

Roteiro de Homologação de Interoperabilidade

Este roteiro apresenta a estrutura de homologação para as Concessionárias comprovarem a interoperabilidade com os sistemas da SENATRAN, conforme previsto na Portaria Senatran nº 442, de 10 de junho de 2025.

Objetivo da Homologação

Comprovar a capacidade técnica da Concessionária de integrar-se completamente ao sistema da SENATRAN, operando todos os serviços disponíveis na api.

Pré-requisitos Gerais

Possuir certificado e-CNPJ válido (homologação ou produção).

Ter solicitação de credenciamento autorizada e habilitada no Credencia de Homologação.

Ter ambiente de teste.

Cenários

Cenário Objetivo Placa Resultado esperado Criticas Realizadas
1 Veículo de Passeio, com TAG, modelo de cobrança passagem Validar pagamento automático para modelo de cobrança passagem para veículo de passeio PXK3A01 Registro da passagem ativa, com classificação CAT01, com informações de tag e operadora de tag, portico de entrada, datahora entrada, modelo passagem passagem.status = 1
passagem.idClassificacao = 1
passagem.tag is not null
passagem.operadora_tag is not null
passagem.localPorticoEntrada is not null
passagem.localPorticoSaida is null
passagem.dataHoraEntrada is not null
passagem.dataHoraSaida is null
passagem.modeloCobranca = 1
pagamento.statusPagamento = 2
pagamento.valorCobrado is not null
pagamento.dataHoraLimitePagamento is not null
pagamento.dataHoraPagamento is not null
pagamento.status_tag = 1
pagamento.tipoCobranca = 1
pagamento.valorPago is not null
pagamento.operadorPagamento is not null
Registro de pagamento com status pago, com as informações referentes ao pagamento preenchidas. (valorCobrado, dataHoraLimitePagamento, statusTag, dataHoraPagamento, tipoCobranca, operadorPagamento, valorPago)
2 Veículo de Passeio, sem TAG , modelo de cobrança viagem
Este cenário será exigido apenas das concessões que possuem modelo de cobrança viagem
Validar Pagamento Avulso, para modelo de cobrança viagem, para veículo de passeio PXK3A02 Registro da passagem ativa, classificação CAT01, com informações de portico de entrada e saída, datahora entrada e saída, modelo viagem e tipo de cobrança avulso passagem.status = 1
passagem.idClassificacao = 1
passagem.tag IS NULL
passagem.operadora_tag IS NULL
passagem.localPorticoEntrada IS NOT NULL
passagem.localPorticoSaida IS NOT NULL
passagem.dataHoraEntrada IS NOT NULL
passagem.dataHoraSaida IS NOT NULL
passagem.modeloCobranca = 2
pagamento.statusPagamento = 2
pagamento.valorCobrado IS NOT NULL
pagamento.dataHoraLimitePagamento IS NOT NULL
pagamento.dataHoraPagamento IS NOT NULL
pagamento.tipoCobranca = 2
pagamento.valorPago IS NOT NULL
pagamento.operadorPagamento IS NOT NULL
pagamento.statusPagamento -> alteração de 3 para 2
Registro de pagamento com status pendente de pagamento, com o valor e prazo a ser pago
Registro de pagamento atualizado com status pago dentro do prazo, com as informações do valor e data do pagamento
3 Caminhão com mais de um eixo, carregado, com tag. Atualizar classificação e valor Validar registro de veículo comercial, com atualizações de classificação, valor cobrado PXK3A05 Registro de passagem ativa, de veículo comercial com mdfe = true, com informações de tag e operadora de tag passagem.status = 1
passagem.idClassificacao.tipoCategoria = 'Comercial'
passagem.tag IS NOT NULL
passagem.operadora_tag IS NOT NULL
passagem.localPorticoEntrada IS NOT NULL
passagem.dataHoraEntrada IS NOT NULL
passagem.mdfe = TRUE
pagamento.statusPagamento = 2
pagamento.valorCobrado IS NOT NULL
pagamento.dataHoraLimitePagamento IS NOT NULL
pagamento.dataHoraPagamento IS NOT NULL
pagamento.status_tag = 1
pagamento.tipoCobranca = 1
pagamento.valorPago IS NOT NULL
pagamento.operadorPagamento IS NOT NULL
pagamento.statusPagamento -> alteração de 1 para 2 passagem.idClassificacao -> alteração de valor pagamento.valorCobrado -> alteração de valor
Registro de pagamento com status em processamento
Registro de passagem com campo idClassificacao atualizado
Registro de pagamento com status pago, com campo valorCobrado atualizado e as informações referentes ao pagamento preenchidas. (dataHoraLimitePagamento, statusTag, dataHoraPagamento, tipoCobranca, operadorPagamento, valorPago)
4 Cancelar Registro Passagem Cancelar Registro Passagem PXK3A03 Registro da passagem com status Ativa passagem.status = 2
Registro de pagamento com status de pagamento Em Processamento
Registro de passagem com status Cancelada
5 Veículo Oficial Validar o envio de registro de veículo isento PXK3A04 Registro da passagem com status Ativa pagamento.statusPagamento = 5
Registro de pagamento com status de pagamento isento
6 Registro fora do prazo Validar o envio de registro de passagem após 24 horas o evento da passagem PXK3A06 Mensagem de erro sobre o envio após o prazo webhook.motivo ILIKE '%dentro de 24 horas da cria%'
7 Placa inválida Validar erros de entrada/dados AKA0005 Mensagens de erro webhook.motivo ILIKE '%Placa%não encontrada%'
8 Data de passagem futura Validar erros de entrada/dados PXK3A07 Mensagens de erro webhook.motivo ILIKE '%dentro de 24 horas da cria%'
9 Pórtico inexistente Validar erros de entrada/dados PXK3A08 Mensagens de erro webhook.motivo ILIKE '%Pórtico inválido%'

Fluxo Assíncrono

Incluir Registro de Passagem

Concessiońaria inclui um registro de passagem através da API usando PUT /api-v3/passagens

Evento de passagem recebido e publicado para processamento (HTTP 201 Created)

Retorno contendo url para consulta da passagem.

Registro armazenado corretamente no sistema.

Retorno do resultado do processamento do registro por webhook

Alterar Registro de Passagem

Concessionária altera um registro de passagem através da API usando PUT /api-v3/passagens

Evento de passagem recebido e publicado para processamento (HTTP 201 Created)

Retorno contendo url para consulta da passagem.

Registro atualizado corretamente no sistema.

Retorno do resultado do processamento do registro por webhook

Incluir Registro de Pagamento

Concessinária inclui um registro de pagamento através da API usando PUT /api-v3/pagamentos

Evento de pagamento recebido e publicado para processamento (HTTP 201 Created)

Retorno contendo url para consulta do pagamento.

Registro armazenado corretamente no sistema.

Retorno do resultado do processamento do registro por webhook

Alterar Registro de Pagamento

Concessinoária altera um registro de pagamento através da API usando PUT /api-v3/pagamentos

Evento de pagamento recebido e publicado para processamento (HTTP 201 Created)

Retorno contendo url para consulta do pagamento.

Registro atualizado corretamente no sistema.

Retorno do resultado do processamento do registro por webhook

Fluxo Síncrono

Consultar Registro de Passagem

Concessinária consulta registro da passagem através da API usando GET /api-v3/passagens/{idPassagem}

Passagem encontrada (HTTP 200 OK)

Consulta retorna dados corretos

Consultar Registro de Pagamento

Concessionária consulta registro de pagamento através da API usando GET /api-v3/pagamentos/{idPassagem}

Pagamento encontrado (HTTP 200 OK)

Consulta retorna dados corretos

Placas para Testes Homologação

PLACA TIPO VEÍCULO TIPO POSSUIDOR POSSUIDOR
PXK3A01 Automóvel CPF XXX314249XX
PXK3A02 Automóvel CPF XXX526630XX
PXK3A03 Automóvel CNPJ 33683111000360
PXK3A04 Automóvel CPF XXX917980XX
PXK3A05 Caminhão CNPJ 33683111000360
PXK3A06 Caminhão CPF XXX917980XX
PXK3A07 Caminhão CPF XXX526630XX
PXK3A08 Caminhão CPF XXX314249XX
PXK3A09 Motocicleta CPF XXX917980XX
PXK3A10 Microônibus CNPJ 33683111000360
REH1C04 Automóvel CPF XXX

Comprovação da interoperabilidade

Em atendimento ao art. 6º da Portaria SENATRAN nº 442, de 10 de junho de 2025, as evidências decorrentes da execução dos testes de interoperabilidade, realizados no ambiente de homologação, serão disponibilizadas à SENATRAN para subsidiar a avaliação da capacidade de interoperabilidade dos sistemas. Para tanto, a concessionária deverá executar os cenários deste roteiro de homologação, no ambiente de homologação, para cada um dos CNPJs que serão objeto de análise pela SENATRAN.