# Documentação [Via BASE/GESTOR]

Guia simples para configurar e usar no dia a dia.

<div class="wrap" id="bkmrk-neste-documento1.-co"><div class="toc">**Neste documento**</div><div class="toc">1. [Instalação dos Apps](#bkmrk-1.-configurar-a-inte)  
2. [Configurar a integração](#bkmrk-2.-configurar-a-inte)  
3. [Configurar o totem (Visual)](#bkmrk-2b-config-totem)  
4. [Impressora no Gestor](#bkmrk-2.-impressora-no-ges)</div></div>
### Configuração de infraestrutura NGINX

  
Antes de iniciar a configuração da integração, é necessário abrir um chamado para a equipe de **DevOps** solicitando a configuração do **Nginx** da loja/ambiente onde a integração será utilizada. Essa configuração é indispensável para permitir a comunicação correta entre o ILLI e os serviços da Credsystem. Como referência para o escopo da solicitação, utilize o chamado **SIC-14670**, adaptando as informações conforme o ambiente e a loja que será configurada. Somente após a conclusão desse chamado prossiga com as etapas de configuração da integração.  
Modelo do chamado: [https://illimitar.atlassian.net/browse/SIC-14670](https://illimitar.atlassian.net/browse/SIC-14670)

\----------------------------------------------------------------------------------------------------------------------------------

## 1. Instalação dos Apps

Na sua base acesse a IlliStore, precisamos instalar os 3 Apps e conferir se as bibliotecas,funções de acesso e módulos de acesso, abaixo foram importadas  
  
**Apps:**  
@ISNP-337  
@I-SNP-337M  
@I-SNP-337MM

[![Captura de Tela 2026-07-31 às 17.34.10.png](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/captura-de-tela-2026-07-31-as-17-34-10.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/captura-de-tela-2026-07-31-as-17-34-10.png)

[![app.png](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/app.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/app.png)

[![app1.png](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/app1.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/app1.png)

**Bibliotecas instaladas:**  
\* 981bfb94-afe7-4956-8ecd-4ecbc3b45246  
\* 88e14c87-331c-485b-95f8-8f63d76d446d  
\* 857e21c5-203f-4943-b60d-9258bf0ebd7e  
\* f3d67c71-a1f9-4709-a81f-de0a4bb1f6e6  
  
**Funções de acesso:**  
\* Credsystem (Desfazer)  
\* Credsystem (Limite)  
\* Credsystem (PIX)  
\* Credsystem (Dinheiro)  
  
**Módulos de Acesso** \* CONFIGURAÇÃO GERAL  
\* CONFIGURAÇÃO TOTEM IMPRESSORA  
\* CREDSYSTEM (PIX)  
  
O Usuário que tiver acesso ao PDV e ao TOTEM deverá ter acesso ao Gestor e aos módulos da Credsystem  
Caso não tenha, pode dar erro de: Usuário não autenticado

\----------------------------------------------------------------------------------------------------------------------------------

## 2. Configurar a integração

A configuração da Credsystem deve ser feita via GESTOR.  
No módulo "CREDSYSTEM" &gt; **CONFIGURAÇÃO GERAL**. Nela há dois blocos principais:  
 \* **Configurações (Gerais)** (credenciais, URLs da API e outros)  
 \* **Configurações (Totem)** (aparência e timeouts e outros).

Em **Configurações (Gerais)**, insira as credenciais da Credsystem **por entidade**.  
Sempre selecione a **Entidade** correta antes de editar ou salvar — cada loja possui sua própria configuração.

<div class="wrap" id="bkmrk-tela-de-configura%C3%A7%C3%A3o"><figure class="print"><figcaption>Tela de configuração — Configurações (Gerais)  
[![Configurações Gerais — credenciais OAuth e URLs](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/9kE001.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/9kE001.png)</figcaption></figure></div>**Passo a passo — Configurações (Gerais)**

<div class="wrap" id="bkmrk-escolha-a-entidade-%28">1. Expanda **Configurações (Gerais)**.
2. Escolha a **Entidade** (loja) que será configurada.
3. Em **Acesso da loja**, preencha **Usuário** e **Senha**.
4. Em **Credenciais OAuth**, preencha **Client ID**, **Client Secret** e **Scope**.
5. Em **URLs dos serviços**, confira as 3 URLs (homologação ou produção, conforme o ambiente).
6. Em **Parâmetros ILLI**, preencha **Bandeira** e os IDs do ILLI (forma de pagamento, natureza receita e natureza despesa).
7. Clique em **Salvar configuração**.

</div>### O que cada campo significa

<div class="wrap" id="bkmrk-entidade-loja-que-es"><table style="width: 98.4524%;"><tbody><tr><th style="width: 40.1244%;">Entidade</th><td style="width: 59.7201%;">Loja que está sendo configurada.

</td></tr><tr><th style="width: 40.1244%;">Usuário</th><td style="width: 59.7201%;">Usuário da loja

</td></tr><tr><th style="width: 40.1244%;">Senha</th><td style="width: 59.7201%;">Senha da loja

</td></tr><tr><th style="width: 40.1244%;">Client ID</th><td style="width: 59.7201%;">Usuário técnico da API.</td></tr><tr><th style="width: 40.1244%;">Client Secret</th><td style="width: 59.7201%;">Senha técnica da API.</td></tr><tr><th style="width: 40.1244%;">Scope</th><td style="width: 59.7201%;">Permissão do token.</td></tr><tr><th style="width: 40.1244%;">URL Base Arrecadação</th><td style="width: 59.7201%;">Endereço para pagamentos e títulos.</td></tr><tr><th style="width: 40.1244%;">URL Base Venda Loja</th><td style="width: 59.7201%;">Endereço para limite e planos.</td></tr><tr><th style="width: 40.1244%;">URL OAuth</th><td style="width: 59.7201%;">Endereço para gerar o token.</td></tr><tr><th style="width: 40.1244%;">Bandeira</th><td style="width: 59.7201%;">Em geral `OBJETIVA`.</td></tr><tr><th style="width: 40.1244%;">ID forma de pagamento</th><td style="width: 59.7201%;">Código da forma Credsystem no ILLI.</td></tr><tr><th style="width: 40.1244%;">ID natureza receita</th><td style="width: 59.7201%;">Natureza do recebimento.</td></tr><tr><th style="width: 40.1244%;">ID natureza despesa</th><td style="width: 59.7201%;">Natureza do estorno/desfazimento.</td></tr></tbody></table>

</div>##   


\----------------------------------------------------------------------------------------------------------------------------------

## 3. Configurar o totem (Visual)

Na mesma tela, expanda **Configurações (Totem)** para ajustar tempos de uso e a aparência do totem Credsystem PIX.  
As alterações de imagem/cor são aplicadas após salvar e, em geral, após recarregar a página do totem.

O bloco do totem está organizado em:

- **Configurações gerais** — retorno por inatividade e revelação do CPF
- **Tela Principal** — imagem, cor e pulsar da tela inicial
- **Telas Internas** — imagem e cor das etapas de CPF, pagamento e sucesso

### 3.1 Configurações gerais do totem

#### Retorno por inatividade

Define por quanto tempo o totem aguarda sem toque ou tecla nas telas internas (CPF, pagamento e sucesso) antes de voltar automaticamente para a tela inicial.

- Campo: **Tempo sem atividade** (em segundos)
- Intervalo permitido: **1 a 3600** segundos
- Padrão: **30 segundos**
- Clique em **Salvar tempo** para gravar

<figure class="print" id="bkmrk-fig-inatividade">[![Retorno por inatividade](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/002.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/002.png)</figure>#### Revelação do CPF

Define por quanto tempo o CPF fica legível após o cliente tocar no ícone de olho na tela de digitação.  
Toque de novo no olho oculta de imediato.

- Campo: **Tempo com CPF revelado** (em segundos)
- Intervalo permitido: **1 a 60** segundos
- Padrão: **3 segundos**
- Clique em **Salvar tempo** para gravar

<figure class="print" id="bkmrk-fig-cpf">[![Revelação do CPF](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/003.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/003.png)</figure>### 3.2 Tela Principal

Configura a tela de atração (tela inicial) do totem: imagem de fundo, cor de fundo e indicador pulsante.  
**Imagem e cor são mutuamente exclusivas:** se houver imagem configurada, a cor fica indisponível até a imagem ser removida.

#### Imagem de fundo da tela inicial

Envie a imagem da tela de atração do totem. Sem arquivo, permanece o layout padrão. Com imagem, ela substitui fundo e textos iniciais.

- Formatos: **JPG, PNG, WEBP ou GIF**
- Tamanho máximo: **8 MB**
- Tamanho recomendado: **970 px (largura) × 1705 px (altura)**
- Use **Escolher imagem** para selecionar o arquivo e **Enviar** para salvar
- Use **Remover imagem** para voltar ao layout padrão / permitir definir a cor de fundo

<figure class="print" id="bkmrk-fig-img-inicial">[![Imagem de fundo da tela inicial](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/004.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/004.png)</figure>#### Cor de fundo da tela inicial

Escolha a cor de fundo quando não há imagem configurada. Se houver imagem de fundo selecionada, a tela exibe o aviso de que a cor está indisponível — remova a imagem para poder definir a cor.

- Presets: Credsystem, Azul escuro, Verde, Vinho, Grafite e Personalizada
- A pré-visualização mostra como a tela inicial fica com a cor escolhida
- Clique em **Salvar cor** para gravar

<figure class="print" id="bkmrk-fig-cor-inicial">[![Cor de fundo da tela inicial](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/005.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/005.png)</figure>#### Pulsar

Escolha a posição do indicador pulsante na grade 3×3 e personalize o texto exibido abaixo dele na tela inicial do totem.

- **Exibir pulsar**: liga ou desliga o indicador
- **Texto do pulsar / Mensagem**: até **60 caracteres** (padrão: “Toque em qualquer lugar”)
- **Posição na tela**: grade 3×3 (ex.: Inferior centro)
- Use a pré-visualização como referência aproximada
- Clique em **Salvar pulsar** para gravar

<figure class="print" id="bkmrk-fig-pulsar">[![Configuração do Pulsar](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/006.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/006.png)</figure>### 3.3 Telas Internas

Configura o fundo das etapas após a tela inicial (CPF, pagamento e sucesso). Assim como na tela principal, imagem e cor são alternativas: sem imagem, usa-se a cor escolhida (ou o layout padrão).

#### Imagem de fundo das telas internas

Envie a imagem de fundo das etapas internas. Sem arquivo, permanece o layout padrão (ou a cor escolhida abaixo).

- Formatos: **JPG, PNG, WEBP ou GIF**
- Tamanho máximo: **8 MB**
- Tamanho recomendado: **970 px (largura) × 1705 px (altura)**
- Use **Escolher imagem** e depois **Enviar**

<figure class="print" id="bkmrk-fig-img-internas">[![Imagem de fundo das telas internas](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/007.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/007.png)</figure>#### Cor de fundo das telas internas

Escolha a cor de fundo quando não há imagem configurada nas telas internas. A cor é salva no servidor e aplicada após recarregar a página.

- Presets: Credsystem, Azul escuro, Verde, Vinho, Grafite e Personalizada
- A pré-visualização mostra um mockup das telas internas com a cor escolhida
- Clique em **Salvar cor** para gravar

<figure class="print" id="bkmrk-fig-cor-internas">[![Cor de fundo das telas internas](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/008.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/008.png)</figure><div class="wrap" id="bkmrk--10"></div><div class="wrap" id="bkmrk--11"></div><div class="wrap" id="bkmrk--12"></div>## 4. Impressora no Gestor

Para o comprovante sair no caixa, configure a impressora do operador no Gestor.  
[![gestorConfig.png](https://kb.illimitar.pro/uploads/images/gallery/2026-07/scaled-1680-/gestorconfig.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-07/gestorconfig.png)

<div class="wrap" id="bkmrk-tipo-de-impressora-b"><table><tbody><tr><th>Tipo de impressora</th><td>Bluetooth, USB, Rede, GPOS, Clover… ou Nenhum.</td></tr><tr><th>Nome do dispositivo</th><td>Nome da impressora.</td></tr><tr><th>MAC (Bluetooth)</th><td>Endereço da impressora Bluetooth.</td></tr><tr><th>IP e Porta (Rede)</th><td>Usados no tipo Rede (porta comum: 9100).</td></tr><tr><th>Colunas</th><td>Largura do cupom (ex.: 48).</td></tr></tbody></table>

</div>Salve e faça um teste de impressão.

Credsystem × ILLI · Guia do usuário