Manual de Implantação – Integração ILLI + Equals (Conciliação de Recebíveis)

Visão Geral

A integração entre o PDV ILLI e a plataforma Equals (via ECOS) tem como objetivo centralizar e automatizar a conciliação de vendas realizadas com cartão, facilitando o controle de recebimentos e a identificação de taxas incorretas ou valores divergentes.

Duas formas de integração são possíveis:

• Manual (via importação de arquivos CSV)

• Automatizada (via API REST da Ilimitar)

1. Pré-requisitos para Implantação

Manual

• Acesso ao Gestor Ilimitar

• Geração de relatório CSV por período (máx. 20 dias)

• Acesso à plataforma Equals

Automatizada

• Biblioteca Equals integrada ao sistema Ilimitar

• API ativa no Ilimitar (chave de acesso)

• CNPJ do cliente informado à Equals

• Autorização via API Key + usuário no sistema

2. Formas de Integração

Manual (via CSV)

• No Gestor Ilimitar, selecione:

  • Período de até 20 dias

  • Entidade (loja)

• Exporte o relatório ZIP contendo os arquivos CSV por dia

• Acesse a Equals  e importe os arquivos

Vantagens:
✔️ Rápida de implantar
❌ Necessita de ações manuais recorrentes

Automatizada (via API Ilimitar)

• Biblioteca ativa no cliente

• Equals consulta o endpoint GET /vendas da Ilimitar via:

  • CNPJ

  • Data de emissão

  • Paginação

• Requisições são feitas a cada 5 minutos ou hora em hora

Vantagens:
✔️ Tempo real ou próximo
✔️ Sem ação manual
❌ Requer autenticação e biblioteca instalada

3. Autenticação e Controle de Acesso

• A API do Ilimitar exige autenticação por API Key + usuário.

• Para revogar o acesso:

  • Gere um novo PIN

  • Redefina a API Key

  • Desative o usuário

Exemplo de usuário configurado:
Usuário: Icor
Chave: XXXXXXXXXXXXXXXXXXXXX

4. Dados Enviados / Sincronizados

A Equals (ECOS) coleta os seguintes dados via API ou CSV:

5. Funcionalidades da Equals 

• Conciliação automática entre:

  • Vendas do PDV

  • Dados das adquirentes

  • Repasse bancário

• Interface Equals exibe:

  • Percentual conciliado

  • Total de vendas no período

  • Cronograma de recebimento (parcelas)

  • Taxas aplicadas por adquirente

  • Alertas de divergência (ex: antecipação indevida)

6. Regras Técnicas para Integração Automatizada

7. Instalação da Integração Automatizada

• Solicite ativação da biblioteca Equals no Ilimitar

• Crie um usuário técnico e gere a chave API

• Informe o CNPJ à Equals

• A Equals iniciará a leitura via API

8. Aspectos Comerciais

• Integração manual: pode ser disponibilizada sem custo

• Integração automática: pode envolver modelo comercial adicional