Ambiente de Homologação
Para facilitar o processo de integração e testes, disponibilizamos placas de teste que simulam diversos cenários reais de débitos veiculares. Essas placas devem ser utilizadas exclusivamente no ambiente de sandbox/homologação.Como Usar as Placas de Teste
Para testar com as placas abaixo, utilize o endpoint de consulta de débitos no ambiente de sandbox:Placas Disponíveis
Cenários de Indisponibilidade
SUA0001 - Estado Indisponível
SUA0001 - Estado Indisponível
- Status:
STATE_UNAVAILABLE - Mensagem indicando que o estado está temporariamente indisponível
- Recomendação para tentar novamente mais tarde
ERR0001 - Sistema Indisponível
ERR0001 - Sistema Indisponível
- Status:
SYSTEM_ERROR - Erro genérico de sistema
Cenários de IPVA
IPP0001 e IPP0002 - IPVA Parcelado + Cota Única
IPP0001 e IPP0002 - IPVA Parcelado + Cota Única
- IPVA Parcelado
- IPVA Cota Única
- Listagem de múltiplas opções de pagamento de IPVA
- Escolha entre parcelamento ou cota única
- Cálculo de valores e descontos
IPU0001 e IPU0002 - IPVA Cota Única
IPU0001 e IPU0002 - IPVA Cota Única
- IPVA Cota Única
- Pagamento de IPVA em cota única
- Aplicação de descontos para pagamento à vista
Cenários de Infrações
TIC0001 - Infrações de Trânsito
TIC0001 - Infrações de Trânsito
- Multas de Trânsito (Infrações)
- Consulta de multas
- Pagamento de infrações individuais
- Pagamento em lote de múltiplas infrações
RTI0001 - Infrações + RENAINF
RTI0001 - Infrações + RENAINF
- Infração
- Infração RENAINF
- Diferenciação entre infrações comuns e RENAINF
- Pagamento de infrações RENAINF
Cenários de Licenciamento
LIC0001 - Licenciamento Simples
LIC0001 - Licenciamento Simples
- Licenciamento
- Consulta de licenciamento
- Pagamento de taxa de licenciamento
LIC0002 - Licenciamento + Infração
LIC0002 - Licenciamento + Infração
- Licenciamento
- Infração
- Múltiplos tipos de débitos
- Pagamento combinado
LIC0003 - Licenciamento + IPVA + Infração
LIC0003 - Licenciamento + IPVA + Infração
- Licenciamento
- IPVA Cota Única
- Infração
- Cenário completo com múltiplos débitos
- Priorização de pagamentos
- Cálculo de valores totais
Cenários de Dependência de Débitos
DEP0001 - Infração + Licenciamento
DEP0001 - Infração + Licenciamento
- Infração
- Licenciamento
- Validação de dependências entre débitos
- Bloqueio de pagamento parcial quando há dependência
DEP0002 - IPVA Parcelado + Licenciamento
DEP0002 - IPVA Parcelado + Licenciamento
- IPVA Parcelado
- Licenciamento
DEP0003 - IPVA Cota Única + Licenciamento
DEP0003 - IPVA Cota Única + Licenciamento
- IPVA Cota Única
- Licenciamento
DEP0004 - Infração + IPVA Parcelado + Licenciamento
DEP0004 - Infração + IPVA Parcelado + Licenciamento
- Infração
- IPVA Parcelado
- Licenciamento
DEP0005 - Infração + IPVA Cota Única + Licenciamento
DEP0005 - Infração + IPVA Cota Única + Licenciamento
- Infração
- IPVA Cota Única
- Licenciamento
DEP0006 - Infração + Licenciamento (Variante)
DEP0006 - Infração + Licenciamento (Variante)
- Infração
- Licenciamento
DEP0007 - Licenciamentos Múltiplos Anos
DEP0007 - Licenciamentos Múltiplos Anos
- Licenciamento (múltiplos anos)
- Débitos acumulados de anos anteriores
- Cálculo de juros e multas por atraso
Cenários de Débitos Distintos
DIS0001, DIS0002, DIS0003 - IPVA Parcelado + Cota Única
DIS0001, DIS0002, DIS0003 - IPVA Parcelado + Cota Única
- IPVA Parcelado
- IPVA Cota Única
- Validação de débitos mutuamente exclusivos
- Mensagens de erro ao tentar pagar débitos incompatíveis
- Seleção de apenas uma opção de pagamento
Cenários de Débitos Obrigatórios
REQ0001 - Seguro Obrigatório
REQ0001 - Seguro Obrigatório
- Seguro Obrigatório
- Débitos obrigatórios que devem ser incluídos
- Validação de seguro obrigatório
Cenários Especiais
VWD0001 - Veículo Sem Débitos
VWD0001 - Veículo Sem Débitos
- Status:
SUCCESS - Lista de débitos vazia
- Mensagem indicando que o veículo está regularizado
- Tratamento de veículos sem débitos
- Mensagens de sucesso
- Interface para veículos regularizados
Cenários de Débitos Não Autorizados
DNA0001 - 5 Débitos Não Autorizados
DNA0001 - 5 Débitos Não Autorizados
- Infração (5 débitos não autorizados)
- Tratamento de débitos bloqueados
- Mensagens de erro específicas
- Filtragem de débitos não pagáveis
DNA0002 - 1 Débito Não Autorizado
DNA0002 - 1 Débito Não Autorizado
- Infração (1 débito não autorizado)
DNA0003 - 3 Débitos Não Autorizados
DNA0003 - 3 Débitos Não Autorizados
- Infração (3 débitos não autorizados)
DNA0004 - Débitos Não Autorizados + Estornados
DNA0004 - Débitos Não Autorizados + Estornados
- Infração (2 não autorizados, 1 estornado)
- Múltiplos status de débitos
- Combinação de bloqueios e estornos
DNA0005 - 2 Débitos Não Autorizados
DNA0005 - 2 Débitos Não Autorizados
- Infração (2 débitos não autorizados)
Cenários de Débitos Estornados
REV0001 - 5 Débitos Estornados
REV0001 - 5 Débitos Estornados
- Infração (5 débitos estornados)
- Tratamento de débitos estornados
- Atualização de status após consulta
- Webhooks de estorno
REV0002 - 1 Débito Estornado
REV0002 - 1 Débito Estornado
- Infração (1 débito estornado)
REV0003 - 3 Débitos Estornados
REV0003 - 3 Débitos Estornados
- Infração (3 débitos estornados)
REV0005 - Débito Estornado + Não Autorizado
REV0005 - Débito Estornado + Não Autorizado
- Infração (1 estornado, 1 não autorizado)
- Múltiplos status em uma mesma consulta
- Lógica de filtragem de débitos
Cenários de Débitos 2025
IPV2501 - Cenário Completo 2025
IPV2501 - Cenário Completo 2025
- Licenciamento
- IPVA Cota Única
- IPVA Parcelado
- Taxas
- Multas
- Débitos do ano corrente
- Cenário completo de regularização
IPV2502 - IPVA + Licenciamento + Taxas 2025
IPV2502 - IPVA + Licenciamento + Taxas 2025
- Licenciamento
- IPVA Cota Única
- IPVA Parcelado
- Taxas
IPV2503 - Apenas Licenciamento 2025
IPV2503 - Apenas Licenciamento 2025
- Licenciamento
IPV2504 - IPVA + Licenciamento 2025
IPV2504 - IPVA + Licenciamento 2025
- IPVA Cota Única
- Licenciamento
IPV2505 - Taxas e Multas 2025
IPV2505 - Taxas e Multas 2025
- Taxas
- Multas
Tabela Resumida de Placas
Exemplo de Uso
Veja como consultar débitos usando uma placa de teste:Checklist de Testes
Use este checklist para garantir que sua integração está tratando todos os cenários corretamente:Cenários Básicos
- Veículo sem débitos (VWD0001)
- Veículo com débitos simples (LIC0001, IPU0001)
- Estado indisponível (SUA0001)
Múltiplos Tipos de Débitos
- IPVA parcelado vs cota única (IPP0001, IPP0002)
- Licenciamento + Infrações (LIC0002)
- Cenário completo (LIC0003)
Dependências e Restrições
- Débitos dependentes (DEP0001 a DEP0007)
- Débitos distintos (DIS0001 a DIS0003)
- Débitos obrigatórios (REQ0001)
Casos de Erro
- Débitos não autorizados (DNA0001 a DNA0005)
- Débitos estornados (REV0001 a REV0005)
- Sistema indisponível (ERR0001)
Cenários Específicos
- Infrações RENAINF (RTI0001)
- Débitos acumulados (DEP0007)
- Débitos do ano corrente (IPV2501 a IPV2505)