> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-placas.md).

# Pesquisa Avançada de Placas

A Pesquisa Avançada de Placas é o componente utilizado no módulo de Portaria destinado à identificação, validação e padronização da entrada de veículos. O recurso assegura que os registros sigam os padrões nacionais e do Mercosul, realizando o tratamento automático de caracteres e a uniformização visual dos dados inseridos.

### Regras de Validação e Formatação

Para manter a integridade dos registros de entrada e saída, o componente aplica as seguintes transformações e verificações:

1. Normalização de Dados\
   Ao digitar a placa, o sistema realiza a limpeza e padronização imediata dos caracteres inseridos:\
   **Caixa Alta:** Todas as letras são convertidas para maiúsculas.\
   **Limpeza de Pontuação:** Espaços, hifens ou pontos digitados são removidos internamente para o processamento.\
   **Extensão Obrigatória:** O sistema exige que a placa tenha exatamente 7 caracteres. Qualquer valor diferente disso resultará em um aviso de "Placa Inválida".

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Entrada: <code>abc 1234</code> → Processamento: <code>ABC1234</code></p></div>
2. Validação de Formato\
   Reconhecimento dos padrões vigentes para circulação veicular.\
   **Padrão Nacional Antigo:** Composto por 3 letras e 4 números. Formato <kbd>AAA-9999</kbd>.\
   **Padrão Mercosul:** Composto por 3 letras, 1 número, 1 letra e 2 números. Formato <kbd>AAA9A99</kbd>.

   <div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Regra de Segurança</strong></p><p>O último caractere da placa deve ser obrigatoriamente um número. Caso o usuário tente inserir uma letra no final, o sistema bloqueará o avanço.</p></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Entrada: <code>BRA3R52</code> (<strong>Padrão</strong> Mercosul aceito).<br>Entrada: <code>BRA3R5A</code> (<strong>Bloqueio</strong> por sufixo não numérico).</p></div>
3. Formatação Visual (Display)\
   Para placas que seguem o padrão nacional anterior (3 letras e 4 números), ocorre a inclusão automática de hífen exclusivamente para a exibição em tela. O campo de interface da Pesquisa Avançada é dimensionado com 8 caracteres para comportar essa formatação visual.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><em>Exemplo:</em><br>Digitação: <code>ABC1234</code> → Visualização em tela: <code>ABC-1234</code></p></div>

#### Comportamento por Contexto de Uso

<table><thead><tr><th width="220">Contexto</th><th>Regra de Aplicação</th></tr></thead><tbody><tr><td>Controle (Entrada/Saída)</td><td>O sistema exige que a placa já esteja cadastrada na base de dados de veículos. Se não encontrar, emitirá um alerta de "Veículo não cadastrado".</td></tr><tr><td>Cadastro de Veículo</td><td>O sistema valida apenas o formato e a extensão de 7 caracteres para a inclusão de novas placas na base de dados.</td></tr></tbody></table>

{% hint style="success" %}
**Dicas de Preenchimento**

A Pesquisa Avançada dispensa o uso da tecla <kbd>Caps Lock</kbd> ou a inserção manual de hifens e pontuações durante a digitação. A inserção de dados deve ser feita de forma contínua, apenas com letras e números, para que o sistema execute a padronização automática e a formatação visual adequada.

{% hint style="warning" %}
*Exemplo:*\
Digitação de `bra3r52` → Conversão automática para `BRA3R52`
{% endhint %}
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/tecnologia/erp/componentes/funcionalidades/pesquisa-avancada/pesquisa-avancada-de-placas.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.