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.