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

<div class="_tableContainer_16hzy_1" id="bkmrk-informa%C3%A7%C3%A3o-detalhes-"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2725" data-start="2292"><thead data-end="2336" data-start="2292"><tr data-end="2336" data-start="2292"><th data-col-size="sm" data-end="2324" data-start="2292">Informação</th><th data-col-size="md" data-end="2336" data-start="2324">Detalhes</th></tr></thead><tbody data-end="2725" data-start="2381"><tr data-end="2428" data-start="2381"><td data-col-size="sm" data-end="2412" data-start="2381">Valor bruto da venda</td><td data-col-size="md" data-end="2428" data-start="2412">Inclui taxas</td></tr><tr data-end="2489" data-start="2429"><td data-col-size="sm" data-end="2460" data-start="2429">Forma de pagamento</td><td data-col-size="md" data-end="2489" data-start="2460">Crédito, débito, Pix etc.</td></tr><tr data-end="2537" data-start="2490"><td data-col-size="sm" data-end="2521" data-start="2490">Número do comprovante</td><td data-col-size="md" data-end="2537" data-start="2521">NSU da venda</td></tr><tr data-end="2582" data-start="2538"><td data-col-size="sm" data-end="2569" data-start="2538">Data/hora da transação</td><td data-col-size="md" data-end="2582" data-start="2569">Timestamp</td></tr><tr data-end="2648" data-start="2583"><td data-col-size="sm" data-end="2614" data-start="2583">Dados do cliente</td><td data-col-size="md" data-end="2648" data-start="2614">Nome e CPF (quando disponível)</td></tr><tr data-end="2725" data-start="2649"><td data-col-size="sm" data-end="2680" data-start="2649">Taxas e bandeiras aplicadas</td><td data-col-size="md" data-end="2725" data-start="2680">Inclui taxa por parcela, antecipação etc.</td></tr></tbody></table>

</div></div><div class="_tableContainer_16hzy_1" id="bkmrk--5"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"></div>---

</div>
##### **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**

<div class="_tableContainer_16hzy_1" id="bkmrk-par%C3%A2metro-tipo-obser"><div class="_tableWrapper_16hzy_14 group flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="3734" data-start="3163"><thead data-end="3244" data-start="3163"><tr data-end="3244" data-start="3163"><th data-col-size="sm" data-end="3191" data-start="3163">Parâmetro</th><th data-col-size="sm" data-end="3203" data-start="3191">Tipo</th><th data-col-size="sm" data-end="3244" data-start="3203">Observação</th></tr></thead><tbody data-end="3734" data-start="3327"><tr data-end="3407" data-start="3327"><td data-col-size="sm" data-end="3354" data-start="3327">`CNPJ`</td><td data-col-size="sm" data-end="3366" data-start="3354">String</td><td data-col-size="sm" data-end="3407" data-start="3366">Deve ser da loja a ser conciliada</td></tr><tr data-end="3488" data-start="3408"><td data-col-size="sm" data-end="3435" data-start="3408">`DataEmissao`</td><td data-col-size="sm" data-end="3447" data-start="3435">Date</td><td data-col-size="sm" data-end="3488" data-start="3447">Usado para filtrar as vendas</td></tr><tr data-end="3569" data-start="3489"><td data-col-size="sm" data-end="3516" data-start="3489">`Page`</td><td data-col-size="sm" data-end="3528" data-start="3516">Integer</td><td data-col-size="sm" data-end="3569" data-start="3528">Paginação de resultados</td></tr><tr data-end="3653" data-start="3570"><td data-col-size="sm" data-end="3597" data-start="3570">`FormaPagamento`</td><td data-col-size="sm" data-end="3609" data-start="3597">String</td><td data-col-size="sm" data-end="3653" data-start="3609">Apenas vendas com cartão são consultadas</td></tr><tr data-end="3734" data-start="3654"><td data-col-size="sm" data-end="3681" data-start="3654">`Intervalo`</td><td data-col-size="sm" data-end="3693" data-start="3681">Horário</td><td data-col-size="sm" data-end="3734" data-start="3693">Requisições a cada 5 ou 60 min</td></tr></tbody></table>

<div class="sticky end-(--thread-content-margin) h-0 self-end select-none">  
</div></div></div>
---

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