¶ Configurar a Integração iMendes
¶ Para que serve
A integração iMendes mantém a tributação dos seus produtos sempre atualizada. Antes de usar, você precisa cadastrar uma credencial que liga a sua empresa ao serviço da iMendes. Quem faz isso é o responsável fiscal ou administrativo, uma única vez por empresa.
¶ Antes de começar
- Contrate o serviço de atualização tributária diretamente com a iMendes.
- Peça à iMendes para liberar o CNPJ da sua empresa na base deles. Sem essa liberação, a conexão falha.
- Confirme que a empresa está cadastrada no Gestor com o CNPJ correto.
- Você não precisa pedir usuário e senha à iMendes. Os dados de acesso ao serviço já vêm configurados no Gestor.
Importante: a liberação do CNPJ é feita pela iMendes. Se o teste de conexão acusar "CNPJ não cadastrado", fale com a iMendes antes de continuar.
¶ Onde encontrar no sistema
Menu Utilitários → Integrações.
Na tela de Integrações, localize o card iMendes (categoria Fiscal) e clique nele para abrir a configuração.
A credencial só é configurada por aqui. O item Fiscal → Gestão tributária → Atualização Tributária (iMendes) abre a tela de correção dos produtos, não a credencial.
¶ Passo a passo
¶ Passo 1 — Abra o card iMendes
No menu Utilitários → Integrações, clique no card iMendes.
Se ainda não houver credencial, aparece a mensagem "Nenhuma credencial iMendes configurada". Clique em Configurar iMendes para abrir o formulário.
¶ Passo 2 — Preencha a credencial
No grupo Credencial de acesso, preencha:
| Campo | O que informar |
|---|---|
| Apelido | Um nome para identificar a credencial. Ex.: "iMendes Loja Matriz". Obrigatório. |
| Empresa | A empresa que vai usar a integração. Vem preenchida com a empresa aberta. Obrigatório. |
| Ambiente | Homologação (testes) ou Produção (uso real). |
| Ativo | Deixe ligado para a integração funcionar. |
Os demais campos já vêm definidos e não precisam ser alterados: o Id do Sistema é fixo e os dados de acesso ao serviço já estão configurados.
A empresa não pode ser trocada depois que a credencial é salva. Se precisar mudar de empresa, crie uma nova credencial e desative a antiga.
¶ Passo 3 — Confira as opções de envio
No grupo Opções de envio, você pode ajustar:
- Tamanho do lote — quantos produtos são enviados de cada vez. Padrão 100, mínimo 1, máximo 300.
- Modo de aplicação — como as correções chegam ao produto:
- Sempre revisar antes de aplicar — você confere e aprova cada correção.
- Aplicação automática — as correções aprovadas são gravadas sem revisão manual.
Observação: o modo de aplicação automática afeta apenas produtos já corrigidos, que sofreram alterações tributárias. São corrigidos automaticamente 200 produtos por dia.
¶ Passo 4 — Salve
Clique em Salvar. A mensagem "Credencial salva com sucesso" confirma o cadastro.
¶ Passo 5 — Teste a conexão
Com a credencial salva, clique em Testar conexão (canto superior direito).
O sistema faz uma verificação rápida com a iMendes e mostra o resultado no indicador de status:
- Conectado (verde) — tudo certo. Aparece a mensagem "Conexão e autenticação OK".
- Erro de conexão (vermelho) — Entre em contato com iMendes ou suporte Kinyx.
O teste não altera nenhum produto. Ele só confirma que a conexão com a iMendes foi bem sucedida.
¶ Variações e casos especiais
¶ Aba Histórico / Telemetria
Depois de salvar, a credencial ganha a aba Histórico / Telemetria. Nela você acompanha:
- Consumo de hoje — quantas consultas a empresa já usou no dia, e o limite diário.
- Data da primeira e da última consulta, produtos pendentes e produtos devolvidos.
O botão Atualizar agora busca esses números na iMendes e consome uma consulta do dia.
A iMendes trabalha com um limite diário de consultas por CNPJ. O consumo é mostrado nesta aba para você acompanhar.
¶ Mensagens de erro comuns
¶ "Salve a credencial antes de testar a conexão"
Causa: você clicou em Testar conexão antes de salvar.
Como resolver: clique em Salvar e depois em Testar conexão.
¶ "CNPJ não cadastrado na base iMendes" (código 104)
Causa: o CNPJ da sua empresa ainda não foi liberado pela iMendes.
Como resolver: entre em contato com a iMendes e peça a liberação do CNPJ.
¶ "Consulta impedida por pendência financeira" (código 105)
Causa: há pendência financeira no seu contrato com a iMendes.
Como resolver: regularize a situação junto à iMendes.
¶ "Número máximo de consultas diárias atingido" (código 106)
Causa: o limite diário de consultas foi atingido.
Como resolver: aguarde a virada do dia, quando o limite é renovado.
¶ "Já existe uma credencial iMendes com apelido '…' nesta empresa"
Causa: já existe outra credencial com o mesmo apelido no mesmo ambiente.
Como resolver: use um apelido diferente.
¶ Dicas e atalhos
- Use o campo Apelido para diferenciar credenciais de Homologação e Produção da mesma empresa.
- O indicador de status (Conectado / Erro / Não testado) mostra a última verificação feita — teste sempre depois de mudar algo.
- Mantenha a credencial Ativa. Desativar interrompe a integração.