> For the complete documentation index, see [llms.txt](https://alfa-informatica-net.gitbook.io/alfa-comercial-web/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alfa-informatica-net.gitbook.io/alfa-comercial-web/topicos-de-ajuda/cadastros/fiscal/integracao-imendes.md).

# Integração iMendes

{% embed url="<https://youtu.be/yuMuk5Na7Cc>" %}

### **1. Finalidade da Integração**

* Otimizar a **gestão tributária**.
* Garantir **informações fiscais corretas e atualizadas** para todos os produtos cadastrados.
* Facilitar a **emissão de documentos fiscais** e processos relacionados à tributação.

***

### **2. Configuração Inicial da Integração**

#### Acesso à Integração

* Acesse o sistema e vá para **Parâmetros do Sistema**.
* Na tela de parâmetros, selecione a aba iMendes.

#### Ativação e Definições

* **Ative a integração** com o iMendes.
* Escolha o **tipo de ambiente**: homologação ou produção.
* Se necessário, selecione o **Regime Especial** aplicável à empresa.

#### Contato com a Equipe Técnica

* Ao ativar a integração:
  * Um **e-mail automático** será enviado para a equipe técnica do iMendes.
  * Eles entrarão em contato com a empresa para iniciar o processo.
* **Observação importante**:
  * O serviço do iMendes possui **custo adicional**.
  * A **negociação comercial** deve ser feita diretamente com o iMendes.
  * A liberação da integração será com base no **CNPJ da empresa**.

#### Suporte da Equipe Avante

* Entre em contato com a equipe técnica da **Avante** para:
  * Obter mais informações.
  * Realizar **configurações adicionais necessárias**.

***

### **3. Utilização da Tela de Manutenção Tributária**

#### Acesso à Tela

* Acesse: **Cadastros > Fiscal > iMendes > Manutenção Tributária**.

#### Consulta de Produtos Pendentes

* A tela mostrará os **produtos sem tributação ajustada**.
* **Limite de visualização**: até 200 produtos por vez.

#### Processo de Consulta

* **Selecione os produtos** sem atualização tributária.
* Clique em **Consultar Tributação**.
* O sistema realiza a consulta automática com o iMendes.

#### Análise do Comparativo

* Serão exibidas duas colunas:
  * **Tributação atual** cadastrada no sistema.
  * **Tributação sugerida** pelo iMendes.

**Observações:**

* Nem todos os produtos podem retornar resultados.
* A validação é feita com base nos produtos existentes na base do iMendes.

#### Cores de Indicação

* **Verde**: tributação correta.
* **Vermelho**: tributação incorreta.

#### Confirmação de Alterações

* Se os dados retornados estiverem corretos:
  * Clique em **Confirmar Alteração de Tributação**.
  * O sistema aplicará a nova tributação automaticamente.

***

### **4. Lidando com Produtos Não Encontrados**

#### Filtro de Pendentes

* Exibe produtos que não foram encontrados na base do iMendes.

#### Mensagem de Aviso

* "Nenhum produto obteve tributação retornada pelo iMendes":
  * Significa que o produto não foi localizado.

#### Associação Manual

* Clique em **Código iMendes**.
* Clique em **Pesquisar** para localizar um produto similar.
* Caso não encontre:
  * **Edite o nome** do produto (simplifique/ajuste).
  * Tente pesquisar novamente.
* Após localizar:
  * **Associe o produto correspondente** ao cadastro.
  * Repita o processo de **consulta e alteração de tributação**.

***

### **5. Outras Telas Úteis da Integração**

#### Produtos com Alteração Tributária

* Lista todos os produtos que tiveram **tributação ajustada** via iMendes.

#### Histórico Devolvidos

* Permite visualizar:
  * Histórico completo de consultas.
  * Produtos **devolvidos com erro** (não encontrados na base do iMendes).

***

### **6. Benefícios da Integração**

* **Agilidade**: Acelera o processo de atualização tributária.
* **Segurança**: Informações fiscais corretas e validadas.
* **Padronização**: Uniformiza os dados tributários da empresa.
* **Redução de Erros**: Elimina tarefas manuais e **minimiza falhas fiscais**


---

# 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:

```
GET https://alfa-informatica-net.gitbook.io/alfa-comercial-web/topicos-de-ajuda/cadastros/fiscal/integracao-imendes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
