> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uvvipague.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Placas de Teste - Homologação

> Placas de teste para validação e homologação da integração com a API Uvvipague

## 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**.

<Warning>
  **Atenção**: As placas de teste listadas abaixo funcionam apenas no ambiente de homologação. Não utilize essas placas em ambiente de produção.
</Warning>

## Como Usar as Placas de Teste

Para testar com as placas abaixo, utilize o endpoint de consulta de débitos no ambiente de sandbox:

```bash theme={null}
POST https://api-sandbox.uvvipague.com.br/uvvi/v1/debts
```

<Info>
  Todas as placas de teste devem ser consultadas com o estado correspondente ao cenário que você deseja testar. Utilize dados fictícios para RENAVAM e CPF/CNPJ.
</Info>

## Placas Disponíveis

### Cenários de Indisponibilidade

<AccordionGroup>
  <Accordion title="SUA0001 - Estado Indisponível" icon="circle-xmark">
    **Descrição**: Simula o cenário em que o sistema do estado está temporariamente indisponível.

    **Tipos de Débitos**: Estado indisponível

    **Comportamento Esperado**:

    * Status: `STATE_UNAVAILABLE`
    * Mensagem indicando que o estado está temporariamente indisponível
    * Recomendação para tentar novamente mais tarde
  </Accordion>

  <Accordion title="ERR0001 - Sistema Indisponível" icon="triangle-exclamation">
    **Descrição**: Simula erro de sistema indisponível.

    **Tipos de Débitos**: N/A

    **Comportamento Esperado**:

    * Status: `SYSTEM_ERROR`
    * Erro genérico de sistema
  </Accordion>
</AccordionGroup>

### Cenários de IPVA

<AccordionGroup>
  <Accordion title="IPP0001 e IPP0002 - IPVA Parcelado + Cota Única" icon="credit-card">
    **Descrição**: Cenários com débitos de IPVA parcelado e cota única disponíveis.

    **Tipos de Débitos**:

    * IPVA Parcelado
    * IPVA Cota Única

    **Use para testar**:

    * Listagem de múltiplas opções de pagamento de IPVA
    * Escolha entre parcelamento ou cota única
    * Cálculo de valores e descontos
  </Accordion>

  <Accordion title="IPU0001 e IPU0002 - IPVA Cota Única" icon="file-invoice-dollar">
    **Descrição**: Cenários apenas com IPVA em cota única.

    **Tipos de Débitos**:

    * IPVA Cota Única

    **Use para testar**:

    * Pagamento de IPVA em cota única
    * Aplicação de descontos para pagamento à vista
  </Accordion>
</AccordionGroup>

### Cenários de Infrações

<AccordionGroup>
  <Accordion title="TIC0001 - Infrações de Trânsito" icon="triangle-exclamation">
    **Descrição**: Veículo com multas de trânsito pendentes.

    **Tipos de Débitos**:

    * Multas de Trânsito (Infrações)

    **Use para testar**:

    * Consulta de multas
    * Pagamento de infrações individuais
    * Pagamento em lote de múltiplas infrações
  </Accordion>

  <Accordion title="RTI0001 - Infrações + RENAINF" icon="scale-balanced">
    **Descrição**: Veículo com infrações comuns e infrações RENAINF.

    **Tipos de Débitos**:

    * Infração
    * Infração RENAINF

    **Use para testar**:

    * Diferenciação entre infrações comuns e RENAINF
    * Pagamento de infrações RENAINF
  </Accordion>
</AccordionGroup>

### Cenários de Licenciamento

<AccordionGroup>
  <Accordion title="LIC0001 - Licenciamento Simples" icon="file-certificate">
    **Descrição**: Veículo com débito de licenciamento anual.

    **Tipos de Débitos**:

    * Licenciamento

    **Use para testar**:

    * Consulta de licenciamento
    * Pagamento de taxa de licenciamento
  </Accordion>

  <Accordion title="LIC0002 - Licenciamento + Infração" icon="layer-group">
    **Descrição**: Veículo com licenciamento e multa pendentes.

    **Tipos de Débitos**:

    * Licenciamento
    * Infração

    **Use para testar**:

    * Múltiplos tipos de débitos
    * Pagamento combinado
  </Accordion>

  <Accordion title="LIC0003 - Licenciamento + IPVA + Infração" icon="layers">
    **Descrição**: Veículo com múltiplos débitos: licenciamento, IPVA cota única e infrações.

    **Tipos de Débitos**:

    * Licenciamento
    * IPVA Cota Única
    * Infração

    **Use para testar**:

    * Cenário completo com múltiplos débitos
    * Priorização de pagamentos
    * Cálculo de valores totais
  </Accordion>
</AccordionGroup>

### Cenários de Dependência de Débitos

<Note>
  **Débitos Dependentes**: Alguns débitos precisam ser pagos em conjunto. Por exemplo, para licenciar um veículo, pode ser necessário quitar o IPVA e multas pendentes.
</Note>

<AccordionGroup>
  <Accordion title="DEP0001 - Infração + Licenciamento" icon="link">
    **Descrição**: Débitos que devem ser pagos juntos.

    **Tipos de Débitos**:

    * Infração
    * Licenciamento

    **Use para testar**:

    * Validação de dependências entre débitos
    * Bloqueio de pagamento parcial quando há dependência
  </Accordion>

  <Accordion title="DEP0002 - IPVA Parcelado + Licenciamento" icon="link">
    **Descrição**: IPVA parcelado com licenciamento dependente.

    **Tipos de Débitos**:

    * IPVA Parcelado
    * Licenciamento
  </Accordion>

  <Accordion title="DEP0003 - IPVA Cota Única + Licenciamento" icon="link">
    **Descrição**: IPVA cota única com licenciamento dependente.

    **Tipos de Débitos**:

    * IPVA Cota Única
    * Licenciamento
  </Accordion>

  <Accordion title="DEP0004 - Infração + IPVA Parcelado + Licenciamento" icon="link">
    **Descrição**: Múltiplos débitos dependentes.

    **Tipos de Débitos**:

    * Infração
    * IPVA Parcelado
    * Licenciamento
  </Accordion>

  <Accordion title="DEP0005 - Infração + IPVA Cota Única + Licenciamento" icon="link">
    **Descrição**: Múltiplos débitos dependentes com IPVA cota única.

    **Tipos de Débitos**:

    * Infração
    * IPVA Cota Única
    * Licenciamento
  </Accordion>

  <Accordion title="DEP0006 - Infração + Licenciamento (Variante)" icon="link">
    **Descrição**: Outra variação de débitos dependentes.

    **Tipos de Débitos**:

    * Infração
    * Licenciamento
  </Accordion>

  <Accordion title="DEP0007 - Licenciamentos Múltiplos Anos" icon="calendar-days">
    **Descrição**: Débitos de licenciamento acumulados desde 2022.

    **Tipos de Débitos**:

    * Licenciamento (múltiplos anos)

    **Use para testar**:

    * Débitos acumulados de anos anteriores
    * Cálculo de juros e multas por atraso
  </Accordion>
</AccordionGroup>

### Cenários de Débitos Distintos

<Warning>
  **Débitos Distintos**: Alguns débitos não podem ser pagos juntos na mesma transação. Por exemplo, IPVA parcelado e cota única são mutuamente exclusivos.
</Warning>

<AccordionGroup>
  <Accordion title="DIS0001, DIS0002, DIS0003 - IPVA Parcelado + Cota Única" icon="ban">
    **Descrição**: Cenários com opções de IPVA que não podem ser pagas juntas.

    **Tipos de Débitos**:

    * IPVA Parcelado
    * IPVA Cota Única

    **Use para testar**:

    * 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
  </Accordion>
</AccordionGroup>

### Cenários de Débitos Obrigatórios

<AccordionGroup>
  <Accordion title="REQ0001 - Seguro Obrigatório" icon="shield-check">
    **Descrição**: Débito de seguro obrigatório (DPVAT).

    **Tipos de Débitos**:

    * Seguro Obrigatório

    **Use para testar**:

    * Débitos obrigatórios que devem ser incluídos
    * Validação de seguro obrigatório
  </Accordion>
</AccordionGroup>

### Cenários Especiais

<AccordionGroup>
  <Accordion title="VWD0001 - Veículo Sem Débitos" icon="circle-check">
    **Descrição**: Veículo totalmente regularizado, sem débitos pendentes.

    **Tipos de Débitos**: Nenhum

    **Comportamento Esperado**:

    * Status: `SUCCESS`
    * Lista de débitos vazia
    * Mensagem indicando que o veículo está regularizado

    **Use para testar**:

    * Tratamento de veículos sem débitos
    * Mensagens de sucesso
    * Interface para veículos regularizados
  </Accordion>
</AccordionGroup>

### Cenários de Débitos Não Autorizados

<Warning>
  **Débitos Não Autorizados**: Simulam débitos que não podem ser pagos através da API por alguma restrição ou bloqueio.
</Warning>

<AccordionGroup>
  <Accordion title="DNA0001 - 5 Débitos Não Autorizados" icon="lock">
    **Descrição**: Veículo com 5 infrações bloqueadas para pagamento.

    **Tipos de Débitos**:

    * Infração (5 débitos não autorizados)

    **Use para testar**:

    * Tratamento de débitos bloqueados
    * Mensagens de erro específicas
    * Filtragem de débitos não pagáveis
  </Accordion>

  <Accordion title="DNA0002 - 1 Débito Não Autorizado" icon="lock">
    **Descrição**: Veículo com 1 infração bloqueada.

    **Tipos de Débitos**:

    * Infração (1 débito não autorizado)
  </Accordion>

  <Accordion title="DNA0003 - 3 Débitos Não Autorizados" icon="lock">
    **Descrição**: Veículo com 3 infrações bloqueadas.

    **Tipos de Débitos**:

    * Infração (3 débitos não autorizados)
  </Accordion>

  <Accordion title="DNA0004 - Débitos Não Autorizados + Estornados" icon="lock">
    **Descrição**: Veículo com 2 débitos não autorizados e 1 débito estornado.

    **Tipos de Débitos**:

    * Infração (2 não autorizados, 1 estornado)

    **Use para testar**:

    * Múltiplos status de débitos
    * Combinação de bloqueios e estornos
  </Accordion>

  <Accordion title="DNA0005 - 2 Débitos Não Autorizados" icon="lock">
    **Descrição**: Veículo com 2 infrações bloqueadas.

    **Tipos de Débitos**:

    * Infração (2 débitos não autorizados)
  </Accordion>
</AccordionGroup>

### Cenários de Débitos Estornados

<Info>
  **Débitos Estornados**: Simulam débitos que foram cancelados ou estornados após a consulta inicial.
</Info>

<AccordionGroup>
  <Accordion title="REV0001 - 5 Débitos Estornados" icon="rotate-left">
    **Descrição**: Veículo com 5 infrações estornadas.

    **Tipos de Débitos**:

    * Infração (5 débitos estornados)

    **Use para testar**:

    * Tratamento de débitos estornados
    * Atualização de status após consulta
    * Webhooks de estorno
  </Accordion>

  <Accordion title="REV0002 - 1 Débito Estornado" icon="rotate-left">
    **Descrição**: Veículo com 1 infração estornada.

    **Tipos de Débitos**:

    * Infração (1 débito estornado)
  </Accordion>

  <Accordion title="REV0003 - 3 Débitos Estornados" icon="rotate-left">
    **Descrição**: Veículo com 3 infrações estornadas.

    **Tipos de Débitos**:

    * Infração (3 débitos estornados)
  </Accordion>

  <Accordion title="REV0005 - Débito Estornado + Não Autorizado" icon="rotate-left">
    **Descrição**: Veículo com 1 débito estornado e 1 não autorizado.

    **Tipos de Débitos**:

    * Infração (1 estornado, 1 não autorizado)

    **Use para testar**:

    * Múltiplos status em uma mesma consulta
    * Lógica de filtragem de débitos
  </Accordion>
</AccordionGroup>

### Cenários de Débitos 2025

<Note>
  **Débitos 2025**: Placas específicas para testar débitos do exercício de 2025, úteis para validar lógica de ano corrente.
</Note>

<AccordionGroup>
  <Accordion title="IPV2501 - Cenário Completo 2025" icon="calendar">
    **Descrição**: Veículo com todos os tipos de débitos para 2025.

    **Tipos de Débitos**:

    * Licenciamento
    * IPVA Cota Única
    * IPVA Parcelado
    * Taxas
    * Multas

    **Use para testar**:

    * Débitos do ano corrente
    * Cenário completo de regularização
  </Accordion>

  <Accordion title="IPV2502 - IPVA + Licenciamento + Taxas 2025" icon="calendar">
    **Descrição**: Débitos principais sem multas.

    **Tipos de Débitos**:

    * Licenciamento
    * IPVA Cota Única
    * IPVA Parcelado
    * Taxas
  </Accordion>

  <Accordion title="IPV2503 - Apenas Licenciamento 2025" icon="calendar">
    **Descrição**: Somente débito de licenciamento.

    **Tipos de Débitos**:

    * Licenciamento
  </Accordion>

  <Accordion title="IPV2504 - IPVA + Licenciamento 2025" icon="calendar">
    **Descrição**: IPVA cota única com licenciamento.

    **Tipos de Débitos**:

    * IPVA Cota Única
    * Licenciamento
  </Accordion>

  <Accordion title="IPV2505 - Taxas e Multas 2025" icon="calendar">
    **Descrição**: Apenas taxas e multas.

    **Tipos de Débitos**:

    * Taxas
    * Multas
  </Accordion>
</AccordionGroup>

## Tabela Resumida de Placas

<Note>
  Use a tabela abaixo como referência rápida para escolher a placa adequada ao seu cenário de teste.
</Note>

| Placa       | Descrição                    | Tipos de Débitos                          |
| ----------- | ---------------------------- | ----------------------------------------- |
| **SUA0001** | Estado indisponível          | Estado indisponível                       |
| **IPP0001** | IPVA com opções              | IPVA Parcelado + Cota Única               |
| **IPP0002** | IPVA com opções              | IPVA Parcelado + Cota Única               |
| **IPU0001** | IPVA cota única              | Cota Única                                |
| **IPU0002** | IPVA cota única              | Cota Única                                |
| **TIC0001** | Infrações                    | Infração                                  |
| **RTI0001** | Infrações RENAINF            | Infração + Infração RENAINF               |
| **LIC0001** | Licenciamento                | Licenciamento                             |
| **LIC0002** | Licenciamento + Multa        | Licenciamento + Infração                  |
| **LIC0003** | Múltiplos débitos            | Licenciamento + Cota Única + Infração     |
| **DEP0001** | Débitos dependentes          | Infração + Licenciamento                  |
| **DEP0002** | Débitos dependentes          | IPVA Parcelado + Licenciamento            |
| **DEP0003** | Débitos dependentes          | Cota Única + Licenciamento                |
| **DEP0004** | Débitos dependentes          | Infração + IPVA Parcelado + Licenciamento |
| **DEP0005** | Débitos dependentes          | Infração + Cota Única + Licenciamento     |
| **DEP0006** | Débitos dependentes          | Infração + Licenciamento                  |
| **DEP0007** | Licenciamentos múltiplos     | Débitos de Licenciamento desde 2022       |
| **DIS0001** | Débitos distintos            | IPVA Parcelado + Cota Única               |
| **DIS0002** | Débitos distintos            | IPVA Parcelado + Cota Única               |
| **DIS0003** | Débitos distintos            | IPVA Parcelado + Cota Única               |
| **REQ0001** | Débito obrigatório           | Seguro Obrigatório                        |
| **VWD0001** | Sem débitos                  | Veículo sem débitos                       |
| **DNA0001** | Não autorizados              | Infração (5 não autorizados)              |
| **DNA0002** | Não autorizados              | Infração (1 não autorizado)               |
| **DNA0003** | Não autorizados              | Infração (3 não autorizados)              |
| **DNA0004** | Não autorizados + Estornados | Infração (2 não autorizados, 1 estornado) |
| **DNA0005** | Não autorizados              | Infração (2 não autorizados)              |
| **REV0001** | Estornados                   | Infração (5 estornados)                   |
| **REV0002** | Estornados                   | Infração (1 estornado)                    |
| **REV0003** | Estornados                   | Infração (3 estornados)                   |
| **REV0005** | Estornados + Não autorizado  | Infração (1 estornado, 1 não autorizado)  |
| **ERR0001** | Sistema indisponível         | N/A                                       |
| **IPV2501** | Débitos 2025 completo        | Licenciamento, IPVA, Taxas e Multas       |
| **IPV2502** | Débitos 2025                 | Licenciamento, IPVA e Taxas               |
| **IPV2503** | Débitos 2025                 | Somente Licenciamento                     |
| **IPV2504** | Débitos 2025                 | IPVA Cota Única e Licenciamento           |
| **IPV2505** | Débitos 2025                 | Taxas e Multas                            |

## Exemplo de Uso

Veja como consultar débitos usando uma placa de teste:

<CodeGroup>
  ```javascript JavaScript theme={null}
  const response = await fetch('https://api-sandbox.uvvipague.com.br/uvvi/v1/debts', {
    method: 'POST',
    headers: {
      'x-api-key': process.env.UVVIPAGUE_SANDBOX_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      state: 'SP',
      licensePlate: 'LIC0003', // Placa de teste
      renavam: '12345678901',
      cpfCnpj: '12345678900',
      externalId: crypto.randomUUID()
    })
  });

  const data = await response.json();
  console.log('Débitos encontrados:', data.debts);
  ```

  ```python Python theme={null}
  import requests
  import uuid

  response = requests.post(
      'https://api-sandbox.uvvipague.com.br/uvvi/v1/debts',
      headers={
          'x-api-key': os.getenv('UVVIPAGUE_SANDBOX_API_KEY'),
          'Content-Type': 'application/json'
      },
      json={
          'state': 'SP',
          'licensePlate': 'LIC0003',  # Placa de teste
          'renavam': '12345678901',
          'cpfCnpj': '12345678900',
          'externalId': str(uuid.uuid4())
      }
  )

  data = response.json()
  print('Débitos encontrados:', data['debts'])
  ```

  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api-sandbox.uvvipague.com.br/uvvi/v1/debts' \
    --header 'x-api-key: SUA_API_KEY_SANDBOX' \
    --header 'Content-Type: application/json' \
    --data '{
      "state": "SP",
      "licensePlate": "LIC0003",
      "renavam": "12345678901",
      "cpfCnpj": "12345678900",
      "externalId": "550e8400-e29b-41d4-a716-446655440000"
    }'
  ```
</CodeGroup>

## Checklist de Testes

Use este checklist para garantir que sua integração está tratando todos os cenários corretamente:

<Steps>
  <Step title="Cenários Básicos">
    * [ ] Veículo sem débitos (VWD0001)
    * [ ] Veículo com débitos simples (LIC0001, IPU0001)
    * [ ] Estado indisponível (SUA0001)
  </Step>

  <Step title="Múltiplos Tipos de Débitos">
    * [ ] IPVA parcelado vs cota única (IPP0001, IPP0002)
    * [ ] Licenciamento + Infrações (LIC0002)
    * [ ] Cenário completo (LIC0003)
  </Step>

  <Step title="Dependências e Restrições">
    * [ ] Débitos dependentes (DEP0001 a DEP0007)
    * [ ] Débitos distintos (DIS0001 a DIS0003)
    * [ ] Débitos obrigatórios (REQ0001)
  </Step>

  <Step title="Casos de Erro">
    * [ ] Débitos não autorizados (DNA0001 a DNA0005)
    * [ ] Débitos estornados (REV0001 a REV0005)
    * [ ] Sistema indisponível (ERR0001)
  </Step>

  <Step title="Cenários Específicos">
    * [ ] Infrações RENAINF (RTI0001)
    * [ ] Débitos acumulados (DEP0007)
    * [ ] Débitos do ano corrente (IPV2501 a IPV2505)
  </Step>
</Steps>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Consulta de Débitos" icon="magnifying-glass-dollar" href="/consulta-debitos">
    Aprenda a consultar débitos usando a API
  </Card>

  <Card title="Fluxo Completo" icon="diagram-project" href="/fluxo-completo">
    Veja o fluxo completo de integração
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks">
    Configure notificações automáticas
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/introduction">
    Documentação técnica completa
  </Card>
</CardGroup>

<Warning>
  **Lembre-se**: Essas placas são exclusivas para o ambiente de homologação. Em produção, você trabalhará com placas reais de veículos.
</Warning>