> 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-classificacao-fiscal.md).

# Pesquisa Avançada de Classificação Fiscal

A Pesquisa Avançada de Classificação Fiscal é o componente responsável pelo gerenciamento da entrada, validação e consulta de códigos de NCM (Nomenclatura Comum do Mercosul) e outras classificações fiscais no sistema. Este recurso foi projetado para garantir que os códigos fiscais atrelados aos produtos estejam corretos e formatados de acordo com as exigências tributárias vigentes, simplificando a digitação do usuário e validando se o código informado realmente existe na base de dados do governo e da empresa.

### Funcionalidades Principais

1. Formatação Automática de Dados\
   O sistema permite que o usuário digite o código de forma flexível (com ou sem pontuação). No momento do processamento, o leitor remove automaticamente pontos (<kbd>.</kbd>) e hifens (<kbd>-</kbd>). Isso garante que o dado seja armazenado de forma "limpa" e padronizada, evitando duplicidades por formatação diferente.
2. Dimensionamento do Campo\
   O campo está configurado com um tamanho padrão de 11 caracteres. Esse espaço é suficiente para comportar o código NCM (geralmente de 8 dígitos) e possíveis formatações ou extensões específicas de controle fiscal.
3. Pesquisa e Atalho\
   Para facilitar a localização de códigos complexos, o leitor oferece:\
   **Pesquisa Avançada (**<kbd>**F7**</kbd>**):** Abre uma janela de consulta onde o usuário pode buscar a classificação fiscal pela descrição ou pelo código parcial. O sistema também permite que essa pesquisa seja personalizada caso a empresa utilize uma regra de busca específica.\
   **Manutenção (**<kbd>**F8**</kbd>**):** Atalho para a tela de cadastro de classificações fiscais. Por padrão, esta função pode apresentar restrição de acesso conforme o perfil de usuário para evitar criações indevidas de códigos fiscais sem supervisão tributária.

### Fluxo de Validação de Saída

Ao concluir a inserção do código e realizar a saída do campo, o sistema executa automaticamente o fluxo de verificação:

1. **Remoção de Máscara:** Pontos e traços são ignorados.
2. **Verificação de Existência:** O sistema busca o código na tabela de Classificações Fiscais.
3. **Busca por NCM:** Caso não encontre um código idêntico, o sistema tenta identificar se o que foi digitado corresponde a um NCM válido cadastrado, buscando sua descrição oficial.
4. **Bloqueio de Inconsistência:** Se após essas tentativas o código não for reconhecido, o sistema emitirá um alerta impedindo o avanço, garantindo que nenhum produto fique com a tributação inconsistente.


---

# 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-classificacao-fiscal.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.
