Ir para o conteúdo principal

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 ECOS (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)

  1. No Gestor Ilimitar, selecione:

    • Período de até 20 dias

    • Entidade (loja)

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

  3. Acesse a Equals (ECOS) e importe os arquivos

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

 

 

Automatizada (via API Ilimitar)

  1. Biblioteca ativa no cliente

  2. Equals consulta o endpoint GET /vendas da Ilimitar via:

    • CNPJ

    • Data de emissão

    • Paginação

  3. 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:

Informação Detalhes
Valor bruto da venda Inclui taxas
Forma de pagamento Crédito, débito, Pix etc.
Número do comprovante NSU da venda
Data/hora da transação Timestamp
Dados do cliente Nome e CPF (quando disponível)
Taxas e bandeiras aplicadas Inclui taxa por parcela, antecipação etc.

 

5. Funcionalidades da Equals (ECOS)

  • Conciliação automática entre:

    • Vendas do PDV

    • Dados das adquirentes

    • Repasse bancário

  • Interface ECOS 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
Parâmetro Tipo Observação
CNPJ String Deve ser da loja a ser conciliada
DataEmissao Date Usado para filtrar as vendas
Page Integer Paginação de resultados
FormaPagamento String Apenas vendas com cartão são consultadas
Intervalo Horário Requisições a cada 5 ou 60 min

 

 

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

Voltar ao topo