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