# Frente de Lojas Linux

Informações referentes as aplicações de frente de lojas, desenvolvidas em Linux Slackware e Debian pela Avanço.

# Configuração Pagamento Carteira Digital QRCode NFC-e Frente Linux

### **Configuração do Pagamento de Carteira Digital (ITI, PicPay, PIX) com QRCode para NFC-e no Frente Linux**

---

#### **Sumário**

**1** - Explicando o Pagamento com QRCode para NFC-e  
**2** - Configurando o Supervisor  
 **2.1** - Cadastrando Meios de Pagamento com TEF Dedicado  
 **2.2** - Cadastrando Forma de Pagamento com o Tipo TEF  
 **2.3** - Incluindo o Registrador da Forma de Pagamento  
 **2.4** - Exportando a Configuração para os Caixas Linux  
**3** - Vinculando Formas de Pagamento no Sistema Integral  
 **3.1** - Incluindo Forma de Pagamento no Integral  
 **3.2** - Vinculando a Forma de Pagamento do Supervisor com o Plano de Contas Gerencial do Integral  
**4** - Configurando o SITEF  
**5** - Configurando o QRCode no Linux  
**6** - Configurando o CliSitef.ini  
**7** - Atualizando as Tabelas Enviadas  
**8** - Pagamento com QRCode (ITI, PicPay ou PIX) no Frente Linux  
**9** - Cancelando Transação da Carteira Digital  
 **9.1** - Identificando o Número do Documento a ser Cancelado  
 **9.2** - Cancelando Transação da Carteira Digital no Frente Linux  
**10** - Configurando o QRCode no PinPad

Neste manual, será explicado o funcionamento do Pagamento com QRCode no Frente Avanço.

<div class="table-wrap" id="bkmrk-requisitos%3A-antes-de"><table class="wrapped relative-table confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red" title="Cor de fundo: Vermelho"><p class="callout info">**REQUISITOS:** Antes de qualquer ação via sistemas, o lojista precisa realizar o contato com o prestador de serviço de pagamento, neste caso, são os bancos ou entidades financeiras (Recebedoras), registradas no Banco Central, que irão gerar/criar a "conta" (chave PIX) e uma credencial para o estabelecimento.</p>

<p class="callout info">Cadastrar a sua credencial emitida pelo seu banco domicílio (PSP recebedor), juntamente com a Chave PIX, associada à sua conta, na plataforma da Software Express por meio do portal web.</p>

<p class="callout info">Toda transação ocorre Online, assim o estabelecimento obrigatoriamente precisar ter Internet.</p>

<p class="callout info">A configuração do pagamento com QRCode (ITI, PICPAY. PIX), está disponível a partir da versão **1.4.88 do Frente Linux**.</p>

<p class="callout info">A versão do Sistema Operacional do Linux, precisa estar com Slackware 14.1 e 32 Bits ou acima.</p>

<p class="callout info">Aplicativo TEF (Software Express) contratado.</p>

<p class="callout info">A Instalação e Configuração do Módulo **CardSE** deverá ser feita no Servidor e no Sitef com os dados adquiridos no 1º tópico desses requisitos. **Para isso, será necessário acionar o Suporte da Avanço para que seja feita a instalação e configuração do módulo**.</p>

<p class="callout info">Sistema Integral na última versão do release, pois há impacto no layout de cupons, no que se refere a importação de vendas.</p>

</td></tr></tbody></table>

</div><p class="callout success">  
 Explicando o Pagamento com QRCode para NFC-e  
  
</p>

O QRCode é um código de barras bidimensional (em 2D), que pode ser lido por qualquer dispositivo com câmera, como por exemplo, o celular.

O funcionamento do pagamento com QRCode, é bem simples. Quando o cliente optar por pagamento via aplicativo (ITI, PicPay ou Pix), o operador deverá escolher uma forma de pagamento que tenha movimentação do tipo TEF. Escolhendo essa forma de pagamento, o sistema irá listar os tipos de captura de dados para pagamento, sendo possível optar pela plataforma (ITI, PicPay ou Pix). Logo após o sistema irá apresentar o QRCode na tela, conforme o exemplo abaixo.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 1.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-1.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-1.png)</span>  
  
A leitura do QRCode é feita na hora e de forma bem simples. Basta o cliente apontar a câmera do celular para escanear o código e realizar o pagamento, conforme a imagem abaixo.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 2.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-2.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-2.png)</span>  
  
Não é preciso informar senha ou dados do cliente durante a transação, pois o aceite será pelo aplicativo e autorizado pelo próprio cliente.

####   
2 - Configurando o Supervisor 

##### 2.1 - Cadastrando Meios de Pagamento com TEF Dedicado  
  


<div class="table-wrap" id="bkmrk-rotina%3A-configura%C3%A7%C3%A3o"><table border="1" class="wrapped confluenceTable" style="width: 38.3333%; border-collapse: collapse; border-style: solid;"><colgroup><col style="width: 31.7635%;"></col><col style="width: 68.2414%;"></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Configuração TEF Dedicado Avanço  
</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Tabelas / TEF Dedicado Avanço</td></tr></tbody></table>

</div>Para configurar os meios de pagamento do QRCode no TEF Dedicado, acesse a localização citada acima.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 3.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-3.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-3.png)</span>  
  
Na aba **Meios de Pagto**, CLIQUE no campo em branco e informe o nome da forma de pagamento **Carteira Digital**.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 4.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-4.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-4.png)</span>  
  
Assim que a opção **Gravar**, situado na barra lateral esquerda, for habilitada CLIQUE na mesma para salvar as configurações realizadas.  
  
[![Carteira Digital 5.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-5.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-5.png)  
  
Depois de gravar a configuração acima, será necessário cadastrar a forma de pagamento, conforme será apresentado no subtópico seguinte.

#####   
2.2 - Cadastrando Forma de Pagamento com o Tipo TEF

<div class="table-wrap" id="bkmrk-rotina%3A-cadastro-de-"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Cadastro de Formas de Pagamento  
</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Cadastros / Formas de Pagamento</td></tr></tbody></table>

</div>Para configurar o pagamento com QRCode, primeiramente é necessário cadastrar uma nova forma de pagamento, acessando a localização citada acima.

<div class="table-wrap" id="bkmrk-observa%C3%87%C3%83o%3A%C2%A0o-client"><table class="wrapped confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red"><p class="callout info">**OBSERVAÇÃO:** O cliente pode utilizar uma forma de pagamento já cadastrada no Supervisor mudando apenas o tipo para **2-TEF**.</p>

</td></tr></tbody></table>

</div>[![Carteira Digital 6.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-6.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-6.png)  
Em seguida, CLIQUE no botão de **Incluir** para cadastrar uma nova forma de pagamento.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 7.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-7.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-7.png)</span>  
  
Na aba **Principal**, o código da forma de pagamento é gerado automaticamente a cada inclusão, como pode ser visto no exemplo abaixo no campo **Código**.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 8.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-8.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-8.png)</span>  
  
CLIQUE no campo **Descrição** e, informe a descrição desejada para a forma de pagamento.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 9.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-9.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-9.png)</span>  
  
Logo após, CLIQUE na opção **Tipo** e, selecione o tipo **2-TEF**, conforme a imagem abaixo.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 10.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-10.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-10.png)</span>  
  
Na aba **Parâmetros 2**, CLIQUE na opção **Consulta Cliente (F5), mostrar:** e, selecione **Todos**.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 11.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-11.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-11.png)</span>  
  
Na aba **Parâmetros 3**, CLIQUE na opção **Meio Pagto TEF** e, selecione a opção **CARTEIRA DIGITAL**.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 12.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-12.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-12.png)</span>  
  
Em seguida, CLIQUE na opção **Tratamento da Data Vencimento** e, selecione a opção **Livre**.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 13.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-13.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-13.png)</span>  
  
Assim que a opção **Gravar**, situado na barra lateral esquerda, for habilitada CLIQUE na mesma para salvar as configurações realizadas.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 14.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-14.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-14.png)</span>  
  
Depois de gravar a configuração acima, será necessário incluir o registrador da forma de pagamento cadastrada, conforme será apresentado no subtópico seguinte.

#####   
2.3 - Incluindo o Registrador da Forma de Pagamento  


<div class="table-wrap" id="bkmrk-rotina%3A-registradore"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Registradores das Formas de Pagamentos no ECF  
</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Tabelas / Registradores Formas Pagtos</td></tr></tbody></table>

</div>  
Para incluir o registrador da forma de pagamento cadastrada, acesse a localização citada acima.  
  
[![Carteira Digital 15.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-15.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-15.png)  
  
CLIQUE em um campo vazio da coluna **ECF** (refere-se à impressoras cadastradas no Supervisor) e, selecione a opção **NFCE**.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 16.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-16.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-16.png)</span>  
  
Em seguida, CLIQUE na mesma linha, porém, da coluna **Forma Pagto** e, selecione a opção da forma de pagamento cadastrada, que no exemplo deste documento foi a **Carteira Digital**.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 17.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-17.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-17.png)</span>  
  
Ainda na mesma linha, porém, da coluna **Registrador Forma**, insira **99**.   
  
[![Carteira Digital 18.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-18.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-18.png)  
  
Assim que a opção **Gravar**, situado na barra lateral esquerda, for habilitada CLIQUE na mesma para salvar a configuração.  
  
[![Carteira Digital 19.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-19.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-19.png)  
  
Depois de configurar todas as configurações acima, será necessário exportar as alterações para os caixas, conforme o subtópico seguinte.

#####   
2.4 - Exportando a Configuração para os Caixas Linux 

<div class="table-wrap" id="bkmrk-rotina%3A-gerando-arqu"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Gerando Arquivos para: Linux  
</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Exportação / Frente Avanço (Linux/Windows)</td></tr></tbody></table>

</div>Para exportar as alterações para os caixas, acesse a localização citada acima.  
  
[![Carteira Digital 20.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-20.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-20.png)  
  
  
Ao acessar a rotina **Gerando Arquivos para: Linux**, MARQUE as opções **Formas de Pagamento** e **TEF Dedicado** e, em seguida CLIQUE em **Exportar**  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 21.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-21.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-21.png)</span>

####   
3. Vinculando Formas de Pagamento no Sistema Integral 

Após realizar as configurações da Forma de Pagamento referente a Carteira Digital (Pagamento com QRCode referente ao ITI, PicPay ou PIX), será preciso fazer o processo de criar o Plano de Contas Gerencial e sua vinculação no sistema Integral, para que as vendas realizadas com essa nova modalidade de pagamento conste no sistema de gestão para conferência.

#####   
3.1 - Incluindo Forma de Pagamento no Integral

<div class="table-wrap" id="bkmrk-rotina%3A-plano-de-con"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Plano de Contas Gerencial</td></tr><tr><th class="confluenceTh">Programa:</th><td class="confluenceTd">CBA006</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Cadastros Básicos / Plano de Contas / Gerencial / Inclusão</td></tr></tbody></table>

</div>Para realizar o cadastro do plano de contas gerencial da forma de pagamento escolhida (ITI, PicPay ou PIX), acesse a localização citada acima, pressionando a tecla **Enter** para acessar cada caminho.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 22.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-22.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-22.PNG)</span>  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 23.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-23.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-23.PNG)</span>  
  
Ao acessar a rotina preencha os dados conforme desejado. Para mais detalhes dos campos, consulte o documento: " [Dúvida | Como Cadastrar Tipos Gerenciais Plano Contas Gerencial Integral?](http://192.168.0.253:9191/pages/viewpage.action?pageId=73894525) ".  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 24.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-24.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-24.PNG)</span>  
  
Após preencher os dados, o sistema exibirá a pergunta " **Confirma?** ", no qual deverá confirmar pressionando a tecla **Enter** ou informando a letra **S**.

Abaixo segue um exemplo, meramente ilustrativo, do cadastro do Plano de Contas do PicPay.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 25.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-25.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-25.PNG)</span>

#####   
3.2 - Vinculando a Forma de Pagamento do Supervisor com o Plano de Contas Gerencial do Integral

<div class="table-wrap" id="bkmrk-rotina%3A-vincula-loja"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="confluenceTh">Rotina:</th><td class="confluenceTd">Vincula Loja + Forma Pag com Tipo Gerencial</td></tr><tr><th class="confluenceTh">Programa:</th><td class="confluenceTd">EXP532</td></tr><tr><th class="confluenceTh">Localização:</th><td class="confluenceTd">Exportar - Importar Arquivo / Frente Avanco / Exportar / Forma de Pagamento / Tipo - Forma de Pagamen.</td></tr></tbody></table>

</div>Para vincular a forma de pagamento escolhida (ITI, PicPay ou PIX), acesse a localização citada acima, pressionando a tecla **Enter** para acessar cada caminho.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 26.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-26.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-26.PNG)</span>  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 27.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-27.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-27.PNG)</span>  
  
Ao acessar a rotina preencha os dados conforme desejado. Para mais detalhes dos campos, consulte o documento: " [Dúvida | Como Vincular Forma Pagamento Frente Loja Integral?](http://192.168.0.253:9191/pages/viewpage.action?pageId=91067094) ".  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 28.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-28.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-28.PNG)</span>  
  
Após preencher os dados, o sistema exibirá a pergunta " **Confirma?** ", no qual deverá confirmar pressionando a tecla **Enter** ou informando a letra **S**.

Abaixo segue um exemplo, meramente ilustrativo, da vinculação da forma de pagamento cadastrada no Supervisor com o Plano de Contas cadastrado no Integral.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 29.PNG](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-29.PNG)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-29.PNG)</span>

####   
4 - Configurando o SITEF 

<div class="table-wrap" id="bkmrk-observa%C3%87%C3%83o%3A%C2%A0procure-"><table border="1" class="wrapped confluenceTable" style="border-collapse: collapse; border-style: solid;"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red" title="Cor de fundo: Vermelho"><p class="callout info">**OBSERVAÇÃO:** Procure o Suporte da Avanço para fazer essa instalação e configuração.</p>

</td></tr></tbody></table>

</div>No servidor SITEF do cliente, baixe o módulo disponibilizado pela integradora **SOFTWARE EXPRESS**.

Pare o serviço do SITEF e feche todas as aplicações referente ao mesmo. Antes de iniciar a instalação do módulo, realize uma **cópia** da pasta SITEF atual localizada no disco raiz **C:/**.

Execute a instalação e configuração seguindo orientações do **"CardSE\_Guia de Instalação.pdf"**, já disponibilizado no pacote baixado anteriormente pela SOFTWARE EXPRESS.

Após configurar, feche a aplicação salvando as alterações e inicie novamente o serviço do SITEF.

####   
5 - Configurando o QRCode no Linux 

Para que o QRCode funcione no Sistema operacional Linux, é necessário baixar o pacote no mesmo.

<div class="table-wrap" id="bkmrk-observa%C3%87%C3%83o%3A%C2%A0procure--1"><table class="wrapped confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red"><p class="callout info">**OBSERVAÇÃO:** Procure o Suporte da Avanço para auxiliar nessa instalação.</p>

</td></tr></tbody></table>

</div>  
Acesse a linha de comando do prompt com usuário root.

<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 30.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-30.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-30.png)</span>  
  
Acesse o diretório **/u**. Para acessar o diretório, digite o comando **cd /u** e pressione a tecla **Enter**.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 31.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-31.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-31.png)</span>  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 32.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-32.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-32.png)</span>  
  
Ainda no prompt de comando, DIGITE o link disponibilizado para baixar o pacote e pressione a tecla **Enter**.

Link para baixar o pacote: **wget <u>[https://packages.slackonly.com/pub/packages/14.1-x86/graphics/qrencode/qrencode-3.4.2-i486-1\_slack.txz](https://packages.slackonly.com/pub/packages/14.1-x86/graphics/qrencode/qrencode-3.4.2-i486-1_slack.txz)</u>**

  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 33.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-33.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-33.png)</span>  
  
Após baixado, o próximo passo é instalar.

Para instalar o pacote, DIGITE o comando **Installpkg qrencode-3.4.2-i486-1\_slack.txz** no mesmo diretório **/u** do prompt de comando.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 34.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-34.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-34.png)</span>  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 35.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-35.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-35.png)</span>  
  
Logo após, reinicie o Sistema DIGITANDO na linha de comando o comando **reboot**, conforme o exemplo abaixo.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 36.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-36.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-36.png)</span>  
  
Depois de reiniciar o Linux, será necessário configurar o **CliSiTef.ini** para que o Frente de Loja esteja apto para aceitar o pagamento com **QRCode**.

#### 6 - Configurando o CliSitef.ini

 Na área de trabalho do Linux, CLIQUE no botão **Iniciar** ou utilize o atalho (cltr+esc) e, acesse o **Prompt do Linux**.

Na tela aberta, DIGITE **mcedit CliSiTef.ini** para acessar os parâmetros do Sitef.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 37.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-37.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-37.png)</span>  
  
Ao abrir o arquivo, no grupo **\[GERAL\]**, no parâmetro **TransacoesAdicionaisHabilitadas**, adicione os códigos **7** e **8**, conforme indicado na imagem abaixo.

<div class="table-wrap" id="bkmrk-importante%3A%C2%A0apenas-a"><table class="wrapped confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-yellow confluenceTd" data-highlight-colour="yellow" title="Cor de fundo: Amarelo"><p class="callout info">**IMPORTANTE:** Apenas adicione os códigos informados, não remova os demais, pois outras transações já se encontram ativas.</p>

</td></tr></tbody></table>

</div>  
[![Carteira Digital 38.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-38.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-38.png)

Após adicionar os códigos conforme citado acima, aperte a tecla **Enter** para inserir uma linha no grupo **\[GERAL\]**.

Nessa nova linha, informe o parâmetro **PermiteDevolucaoCodigoAutorizacaoEstendido=1**, conforme indicado no exemplo abaixo.

<div class="table-wrap" id="bkmrk-importante%3A-os-valor"><table class="wrapped confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red"><p class="callout info">**IMPORTANTE:**</p>

<p class="callout info">Os valores previstos para essa variável Permite Devolução Codigo Autorização Estendido são: 0 – Desabilitado (Default) e 1 – Habilitado. Caso essa configuração esteja habilitada poderá ser retornado no campo 135 (Código de Autorização) um código de até 99 bytes. Caso esteja desabilitada, somente serão retornados códigos de até no máximo 15 bytes.</p>

<p class="callout info">Apenas adicione o parâmetro novo informado, não remova os demais, pois outras transações já se encontram ativas.</p>

</td></tr></tbody></table>

</div>  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 39.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-39.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-39.png)</span>  
  
Após realizar a configuração, pressione a tecla **Esc** duas vezes para salvar o arquivo e, em seguida CLIQUE na opção **Yes**.   
  
[![Carteira Digital 40.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-40.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-40.png)  
  
Em sequência, será retornado para a área de trabalho do Linux.

Acesse o Frente Avanço CLICANDO no botão **Iniciar** ou utilizando o atalho (**cltr+esc**) e, CLIQUE em **Frente Avanço**, ou DIGITE na tela do **Prompt do Linux** o comando **pdv**.

[![Carteira Digital 41.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-41.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-41.png)

####   
7 - Atualizando as Tabelas Enviadas

Ao acessar o sistema Frente de Loja Linux, pressione a tecla **F4** para acessar o Menu Fiscal.   
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 42.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-42.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-42.png)</span>  
  
Ao ser exibida a janela do **MENU GERENTE**, utilize a seta do tecla para baixo, selecione a opção **TEF-Op Administrativas** e, pressione a tecla **Enter** para atualizar as tabelas enviadas.

<div class="table-wrap" id="bkmrk-observa%C3%87%C3%83o%3A%C2%A0a-atuali"><table class="wrapped confluenceTable"><colgroup><col></col></colgroup><tbody><tr><td class="highlight-red confluenceTd" data-highlight-colour="red" title="Cor de fundo: Vermelho"><p class="callout info">**OBSERVAÇÃO:** A atualização de tabelas de qualquer forma de pagamento TEF (Cartão de crédito ou débito) é realizada através do pinpad, porém, a forma de pagamento com QRCode não é realizado pelo pinpad, sendo necessário atualizar as tabelas antes de iniciar uma venda.</p>

</td></tr></tbody></table>

</div>  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 43.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-43.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-43.png)</span>  
  
Em seguida, o Frente de Loja exibirá a tela **OPER.ADMINISTRATIVAS TEF...** solicitando um usuário e senha, no qual deverá informar esses dados nos campos correspondentes.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 44.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-44.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-44.png)</span>  
  
Após digitar o usuário e senha, pressione a tecla **Enter** para confirmar os dados.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 45.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-45.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-45.png)</span>  
  
Em sequência, utilize a seta do teclado para baixo, selecione a opção **13 - Carga forcada de tabelas no pinpad (Servidor)** e, pressione a tecla **Enter** para confirmar.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 46.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-46.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-46.png)</span>  
  
Logo em seguida, o Frente de Loja iniciará a atualização das tabelas com o PinPad.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 47.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-47.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-47.png)</span>

####   
8 - Pagamento com QRCode (ITI, PicPay ou PIX) no Frente Linux  


 Após a atualização das tabelas enviadas, será realizada uma venda no Frente de Loja Linux para pagamento com QRCode.

Ao acessar o sistema Frente de Loja Linux, informe o (s) código (s) do (s) produto (s) desejado (s) e finalize a venda pressionando a tecla **F12**.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 48.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-48.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-48.png)</span>  
  
Na tela de **SubTotal**, na **FORMAS DE PAGTO**, escolha a **forma de pagamento** cadastrada no Supervisor.

No exemplo neste documento a forma de pagamento é a **Carteira Digital**.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 49.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-49.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-49.png)</span>  
  
Após selecionar a forma de pagamento, o Frente abrirá a tela do TEF.

Logo após, utilize a seta do teclado para baixo, selecione a opção desejada (ITI, PicPay ou PIX) e, pressione a tecla **Enter** para confirmar.  
  
No exemplo deste documento, a Carteira Digital utilizada foi o PicPay, porém, o procedimento será o mesmo para o ITI ou PIX.  
  
**[![Carteira Digital 50.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-50.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-50.png)** O Frente de Loja abrirá a tela do QRCode, no qual o cliente com a câmera do celular poderá escanear o código e realizar o pagamento. **[![Carteira Digital 51.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-51.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-51.png)** Para escanear o código é necessário que o cliente abra o aplicativo escolhido para realizar o pagamento no seu celular e, clicar na função correspondente a leitura do código QrCode.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 52.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-52.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-52.png)</span>  
  
Em seguida, o cliente deverá apontar a câmera do seu dispositivo para O QRCode apresentado no Frente de Loja, aguardando a leitura.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 53.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-53.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-53.png)</span>  
  
A transação só será confirmada quando o cliente autorizar no seu aplicativo, no qual será debitado automaticamente de seu saldo sendo notificado.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 54.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-54.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-54.png)</span>  
  
Após a confirmação, o Frente de Loja solicitará a confirmação o fechamento a venda, no qual deverá pressionar a tecla **Enter** para confirmar.

Para cancelar, utilize a seta do teclado lateral para selecionar a opção **Não** e, pressione a tecla **Enter**.  
  
**[![Carteira Digital 55.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-55.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-55.png)** <span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 56.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-56.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-56.png)</span>  
  
  
  
  
[![Carteira Digital 57.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-57.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-57.png)

Ao finalizar, será impresso uma NFC-e juntamente com comprovante da transação, conforme o exemplo abaixo.

#### [![Carteira Digital 58.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-58.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-58.png)  
9 - Cancelando Transação da Carteira Digital

#####   
9.1 - Identificando o Número do Documento a ser Cancelado

  
O número do documento a ser cancelado se encontra no comprovante de transação impresso pelo Frente no campo **DOC**, conforme o exemplo abaixo.  
  
  
[![Carteira Digital 59.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-59.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-59.png)

#####   
9.2 - Cancelando Transação da Carteira Digital no Frente Linux

  
Ao acessar o sistema Frente de Loja Linux, pressione a tecla **F4** para acessar o Menu Fiscal.   
  
[![Carteira Digital 60.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-60.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-60.png)  
  
  
No **MENU GERENTE**, utilize a seta do teclado para baixo, selecione a opção **TEF-Op. Administrativas** e, pressione a tecla **Enter** para realizar o cancelamento de transação da Carteira Digital.   
  
  
[![Carteira Digital 61.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-61.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-61.png)  
  
Em seguida, o Frente de Loja solicitará um usuário e senha, no qual deverá informar esses dados nos campos correspondentes.   
  
[![Carteira Digital 62.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-62.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-62.png)  
  
Após digitar o usuário e senha, pressione a tecla **Enter** para confirmar os dados.  
  
[![Carteira Digital 63.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-63.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-63.png)  
  
Em seguida, utilize a seta do teclado para baixo, selecione a opção **3 - Cancelamento de transacao** e, pressione a tecla **Enter** para confirmar.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 64.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-64.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-64.png)</span>  
  
Logo após, utilize a seta do teclado para baixo, selecione a opção **11 - Cancelamento Carteira Digital** e, pressione a tecla **Enter** para confirmar.   
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 65.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-65.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-65.png)</span>  
  
Em seguida, o Frente de loja solicitará informações sobre a transação efetuada no qual deseja cancelar, no qual será aberto uma janela de **Carteira digital**.

Utilize a seta do teclado para cima ou para baixo, selecione a transação efetuada que deseja cancelar e, pressione a tecla **Enter** para confirmar.

No exemplo deste documento, foi escolhida a opção **8 - PicPay CD**.   
  
[![Carteira Digital 66.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-66.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-66.png)  
  
Informe o valor da transação no qual deseja cancelar e, pressione a tecla **Enter** para confirmar.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 67.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-67.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-67.png)</span>  
  
Informe o **número do documento** a ser cancelado e, pressione a tecla **Enter** para confirmar.  
  
[![Carteira Digital 68.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-68.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-68.png)  
  
Informe a data em que a transação foi realizada, pressione a tecla **Enter** e, aguarde o fim da transação de cancelamento.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 69.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-69.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-69.png)</span>  
Se todos os dados estiverem corretos, será exibido a mensagem **Lojista OK** e os comprovantes de cancelamento serão impressos.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 70.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-70.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-70.png)</span>  
  
Abaixo segue um exemplo de um comprovante de cancelamento.  
  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 71.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-71.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-71.png)</span>

##### 10 - Configurando o QRCode no PinPad

  
Na área de trabalho do Linux, clique no botão iniciar ou use o atalho (cltr+esc), e acesse o Prompt de comando do Linux.

No prompt de comando do Linux digite **fazini** e aperte a tecla **Enter**.  
  
[![Carteira Digital 72.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-72.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-72.png)  
  
Ao abrir a tela **fazini**, no campo **Variável AV\_** informe a palavra **PINPADQ**, no campo **Tipo** informe a letra **L** (que corresponde a lógico) e no campo **Conteudo** informe a letra **T** (que corresponde a true - verdadeiro), conforme o exemplo abaixo.  
  
<span class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size">[![Carteira Digital 73.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/scaled-1680-/carteira-digital-73.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-07/carteira-digital-73.png)</span>  
Após realizar a configuração, aperte a tecla **Esc** duas vezes para sair da tela do fazini.

Logo depois, será retornado para a área de trabalho do Linux.

<table border="1" id="bkmrk-o-atendimento-para-a"><colgroup><col></col></colgroup><tbody><tr><td>**O Atendimento para a Avanço Informática é prioridade!**

Caso Você tenha alguma dúvida, fique à vontade para entrar em contato com a gente:  
[![logo whatsapp.jpg](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-05/scaled-1680-/logo-whatsapp.jpg)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-05/logo-whatsapp.jpg)[Clique aqui para falar conosco no WhatsApp](https://wa.me/553130251188?text=Ol%C3%A1!)

[![avanco.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-05/scaled-1680-/kibavanco.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-05/kibavanco.png)

</td></tr></tbody></table>

# Frente de Lojas Linux Slackware

Informações referentes a aplicação desenvolvida em Linux Slackware

# 1 - Versões do Frente de lojas Linux Slackware

A versão do Frente de Loja é controlada pelo hash do binário do PDV.  
  
Comando no prompt do Linux para você verificar o hash do binário do Frente de lojas:  
  
**cat pdv | md5sum**  
  
Versão: **1.5.41** - fe83935e0c92516c037d14843b3e3134  
  
Implementações da versão:  
  
MUDANÇAS NA VERSÃO 1.5.41 - LINUX

- AJUSTES:   
      
    Ajuste refere a Inconsistência no XML em vendas com desconto Scanntech por bin.  
    Permitir indentificar cliente por codigo em teclado reduzido.  
    Envio de SKU com mais de 6 digitos para Mercafácil ( CLIENTES NOVOAVANCO).  
    Ajuste na impressão de comprovantes TEF em modo Reduzido.
- MELHORIAS:   
      
    PDV TOUCH - Tocar em qualquer local da tela para sair da mensagem "PRODUTO NÃO CADASTRADO".Padronização de API's, usando sempre a url base.

# Frente de Lojas Linux Debian

Informações referentes a aplicação desenvolvida em Linux Debian

# 1 - Requisitos, recursos e informações sobre o Frente de Loja Linux Debian

A versão do Frente de Loja foi desenvolvida e adaptada sobre a plataforma do Linux Debian 12 - 64 bits, não existe um instalador para o Frente de Loja, as sim imagens disponibilizadas já vêm com todas as configurações iniciais prontas necessárias para a utilização da aplicação.

<span class="text-big">**Os requisitos mínimos de hardware para instalação são:**</span>

- Processador Intel Core i3;
- Mínimo de 8GB de memória RAM;
- SSD de no mínimo 120GB;
- Placa de rede Gigabit;
- Saída serial ou USB compatível com os dispositivos periféricos conectados, como mouse;
- **Outros periféricos:** Periféricos que podem compor o PDV, como leitor de código de barras, balança de PDV, PinPad, Teclado Reduzido, Leitor Biométrico entre outros, devem estar disponíveis no momento da instalação, conforme homologação;
- É necessários duas saídas de vídeo para casos de utilização de dois monitores touch screen!

**Importante:**

- **Não é recomendado a utilização do Frente de Loja, em redes do tipo Wifi, apenas com soluções cabeadas, podendo utilizar IP fixo ou dinâmico.**
- **O equipamento que vai receber a instalação do Frente de Lojas Linux Debian, deverá conter apenas uma unidade de disco e o pendrive da instalação, caso contrário o instalador poderá falhar.**

<span class="text-big">**A instalação é feita através de imagens e estas estão subdividida em quatro opções:**</span>

- **SATA - Legacy:** Para computadores que possuam unidade de disco SATA e opção de boot Legacy;
    
    
    - Para você baixar a imagem para modelo SATA e boot Legacy, clique <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[**aqui**](https://avancoinfo.com.br/tecnologia/pdv-debian/legacy.iso "Baixar a imagem de instalação para equipamentos do tipo Legacy")</span>
- **SATA - EFI:** Para computadores que possuam unidade de disco SATA e opção de boot EFI;
    
    
    - Para você baixar a imagem para modelo SATA e boot EFI, clique <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[**aqui**](https://avancoinfo.com.br/tecnologia/pdv-debian/efi.iso "Baixar a imagem de instalação para equipamentos do tipo UEFI")</span>
- **NVME:** Para computadores que possuam unidade de disco NVME (M.2)
    
    
    - Para você baixar a imagem para modelo NVME, clique <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[**aqui**](https://avancoinfo.com.br/tecnologia/pdv-debian/nvme.iso "Baixar a imagem de instalação para equipamentos do tipo NVME (M2)")</span>
- **FULL:** Para computadores que possuam quaisquer das três opções de setup anteriores: SATA Legacy, SATA EFI ou NVME.
    
    
    - Para você baixar a imagem FULL, clique <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[**aqui**](https://avancoinfo.com.br/tecnologia/pdv-debian/full.iso "Baixar a imagem de instalação completa do Frente de Lojas Linux Debian")</span>

<span class="text-big">**Os requisitos do pendrive para montagem da instalação são:**</span>

- Imagens separadas: É necessário um pendrive com no mínimo 4GB;
- Imagem completa, chamada de FULL: É necessário um pendrive com no mínimo 8GB.

***<u> \* Recomendamos a utilização de pendrives das marcas Sandisk ou Kingston que foram testados pela Avanço.</u>***

<span class="text-big">**Recursos que a versão oferece:**</span>

- Terminal de acesso remoto ***Putty,*** já instalado;
- Navegador de internet ***Firefox**,* já instalado;
- Cliente da **Gsurf** para sitef, já instalado;
- Servidor **VNC** para acesso remoto em redes privadas, já instalado;
- Preparado para acessos através de **SSH**;
- Instalação facilitada da ferramenta ***Rustdesk*** para acessos remotos diretamente ao caixa de fora da sua rede;
- Compatibilidade com telas touch screen **Sweda, Elgin e Custom**;
- Compatível com todos os modelos de **impressoras** já disponíveis no Frente de Loja Avanço;
- Compatível com todos os modelos de **pinpad** já disponíveis no Frente de Loja Avanço;
- Compatível com todos os modelos de **balanças** já disponíveis no Frente de Loja Avanço.

# 2 - Download e Montagem de Pendrive para instalação do Frente de Lojas Linux Debian

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da montagem do pendrive para instalação do Frente Linux Debian</span>

<span class="text-big">**Importante:** </span>

- <span class="text-big"> **Tenha certeza que não existam informações relevante no seu pendrive antes de executar a ferramenta de gravação da imagem, ou faça backup antes de começar.**</span>
- <span class="text-big">**O Computador que vai receber a instalação do Frente de lojas, deverá conter apenas uma unidade de disco e o pendrive da instalação, caso existam mais de um dispositivos no computador, o instalador poderá falhar.**</span>
- <span class="text-big">**Use pendrives das marcas Sandisk ou Kingston, pois este foram testados em nosso laboratório.**</span>

> Abaixo segue o vídeo demonstrando a preparação do pendrive:

<video controls="controls" height="493" src="https://bc.avancoinfo.com.br/attachments/1?open=true" style="width: 837px; height: 469px;" width="876"></video>

- **<span class="text-big">Para você baixar o software que faz a gravação do pendrive em Windows, clique <span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[aqui](https://avancoinfo.com.br/tecnologia/pdv-debian/rufus.exe "Baixar o aplicativo rufos que auxilia na montagem do pendrive")</span></span>**
- **<span class="text-big">Para você baixar a imagem *“legacy.iso”,* para modelo SATA e boot Legacy, pendrive mínimo 4GB. Clique </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">aqui</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/legacy.iso "Baixar a imagem de instalação para equipamentos do tipo Legacy")</span>**
- **<span class="text-big">Para você baixar a imagem *“efi.iso”,* para modelo SATA e boot EFI, pendrive mínimo 4GB. Clique </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">aqui</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/efi.iso "Baixar a imagem de instalação para equipamentos do tipo UEFI")</span>**
- **<span class="text-big">Para você baixar a imagem *"nvme.iso",* para modelo NVME, pendrive mínimo 4GB. Clique </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">aqui</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/nvme.iso "Baixar a imagem de instalação para equipamentos do tipo NVME (M2)")</span>**
- **<span class="text-big">Para você baixar a imagem *"full.iso",* para todos os modelos de setup, pendrive mínimo 8GB. Clique </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">aqui</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/full.iso "Baixar a imagem de instalação completa do Frente de Lojas Linux Debian")</span>**

# 3 - Instalação do Frente de Loja Linux Debian

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da instalação, feita na prática em uma maquina virtual do Frente Linux Debian</span>

<span class="text-big">**Muito importante:** </span>

- <span class="text-big">**O instalador não questiona sobre informações contidas no equipamento, sendo assim, tenha certeza que não existam informações relevante antes de executar o instalador ou faça o backup, antes de começar.**</span>
- **O Computador que vai receber a instalação do Frente de Lojas deverá conter apenas uma unidade de disco e o pendrive da instalação, caso existam mais de um dispositivos no computador, o instalador poderá falhar.**

> Abaixo segue o vídeo demonstrando a instalação em uma maquina virtual, utilizando Virtualbox:

  
<video controls="controls" height="471" src="https://bc.avancoinfo.com.br/attachments/2?open=true" style="width: 837px; height: 471px;" width="837"></video>

Seguem algumas teclas de atalho, para opção de acesso a bios e também boot menu das placas mães mais utilizadas no mercado, você vai precisar desta opção para fazer o seu computador iniciar pelo pendrive que contem a instalação do frente de lojas:

<div align="left" dir="ltr" id="bkmrk-fabricante-bios-%28set"><table style="height: 307.563px; width: 100%;"><colgroup><col style="width: 15.8522%;" width="96"></col><col style="width: 15.8522%;" width="96"></col><col style="width: 15.8522%;" width="96"></col><col style="width: 52.4434%;" width="317"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Fabricante**

</td><td class="align-center" style="height: 29.7969px;">**BIOS (Setup)**

</td><td class="align-center" style="height: 29.7969px;">**Boot**

</td><td class="align-center" style="height: 29.7969px;">**Dicas úteis**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Asus**

</td><td class="align-center" style="height: 29.7969px;">**Del**

</td><td class="align-center" style="height: 29.7969px;">**F8**

</td><td class="align-center" style="height: 29.7969px;">**Padrão bem consistente do mercado**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Asrock**

</td><td class="align-center" style="height: 29.7969px;">**Del**

</td><td class="align-center" style="height: 29.7969px;">**F11**

</td><td class="align-center" style="height: 29.7969px;">**Muito usada em computadores genéricos**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Dell**

</td><td class="align-center" style="height: 29.7969px;">**F2**

</td><td class="align-center" style="height: 29.7969px;">**F12**

</td><td class="align-center" style="height: 29.7969px;">**Padrão mais consistente do mercado**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Gigabyte**

</td><td class="align-center" style="height: 29.7969px;">**Del**

</td><td class="align-center" style="height: 29.7969px;">**F12**

</td><td class="align-center" style="height: 29.7969px;">**Placas-mãe de Desktop**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**MSI**

</td><td class="align-center" style="height: 29.7969px;">**Del**

</td><td class="align-center" style="height: 29.7969px;">**F11**

</td><td class="align-center" style="height: 29.7969px;">**Muito usada em computadores genéricos**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Sweda Touch**

</td><td class="align-center" style="height: 29.7969px;">**Del**

</td><td class="align-center" style="height: 29.7969px;">**F11**

</td><td class="align-center" style="height: 29.7969px;">**Máquinas homologadas pela Avanço**

</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Positivo**

</td><td class="align-center" style="height: 29.7969px;">**F2 ou Del**

</td><td class="align-center" style="height: 29.7969px;">**F11 ou F7**

</td><td class="align-center" style="height: 29.7969px;">**Varia muito pois usam placas OEM. Se F2/Del falhar, tente Esc**

</td></tr><tr style="height: 35.5938px;"><td class="align-center" style="height: 35.5938px;">**HP / Compaq**

</td><td class="align-center" style="height: 35.5938px;">**F10**

</td><td class="align-center" style="height: 35.5938px;">**F9**

</td><td class="align-center" style="height: 35.5938px;">**Placas-mãe de Desktop**</td></tr><tr style="height: 33.5938px;"><td class="align-center" style="height: 33.5938px;">**Lenovo**

</td><td class="align-center" style="height: 33.5938px;">**F1 ou F2**

</td><td class="align-center" style="height: 33.5938px;">**F12 ou F10**

</td><td class="align-center" style="height: 33.5938px;">**F10 (Raro, modelos muito antigos)**</td></tr></tbody></table>

</div>

# 4 - Pós-instalação do Frente de Lojas Linux Debian

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da demonstrando do reinício do computador após instalação do Frente Linux Debian</span>

<span class="text-huge">**Muito importante:** </span>

- **Acessando o equipamento por SSH, utilize as seguintes credenciais:** IP do equipamento e porta padrão 22  
    Login: **pdv**  
    Senha: **super**
- **Acessando o equipamento por VNC, utilize a credencial:** IP do equipamento e porta 5969  
    Senha: **pdvdebian**
- **Não recomendamos que o caixa seja utilizado em DMZ, por questões de segurança.**
- **Nesta instalação, não existe o usuário root, para necessidades de root em casos de comandos administrativos, utilize o comando sudo, com no exemplo abaixo:  
    sudo** mcedit /etc/network/interface

> Abaixo segue o vídeo demonstrando a pós-instalação em uma maquina virtual, utilizando Virtualbox:

<span class="text-big"><video controls="controls" height="469" src="https://bc.avancoinfo.com.br/attachments/3?open=true" style="width: 836px; height: 468px;" width="834"></video></span>

# 5 - Configuração de rede no Frente de Lojas Linux Debian

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da configuração de rede, feita na prática do Frente Linux Debian</span>

Para a configuração de informações sobre a rede do Frente Linux Debian, é muito importante que você saiba sobre as informações de rede que devem ser inseridas nesta etapa para evitar problemas no funcionamento do sistema e até mesmo na sua própria rede. Caso não saiba ou não tenha as informações, sugerimos que procure seu técnico de TI / redes ou o responsável por tal.

> Abaixo segue o vídeo demonstrando a configuração de rede:

  
<video controls="controls" height="474" src="https://bc.avancoinfo.com.br/attachments/4?open=true" style="width: 843px; height: 474px;" width="843"></video>

<span class="text-big">**Os passos dos procedimentos mostrados no vídeo, estão descritos abaixo para auxílio:** </span>

1\. Sai do programa de frente de lojas  
  
2\. Use as teclas **&lt;CRTL&gt; e &lt;ESC&gt;** para subir o menu principal

3\. Selecionar em Menu: **Sistema --&gt; Terminal** (auxilia nas configurações dos arquivos necessários)

4\. Utilizar o editor de textos mcedit, precedido do comando administrativo sudo, para alterar as informações de rede no arquivo nomeado de interfaces

Exemplo:

cd /etc/network

sudo mcedit interfaces

4\. Escolha qual opção será definida no arquivo interfaces, se você vai utilizar IP fixo, ou se será utilizado IP através de DHCP, ou seja IP dinâmico, lembre-se que utilizando IP fixo, você pode acessar de maneira mais assertiva o caixa, através dos protocolos VNC ou SSH.

Para usar IP fixo você deve comentar a opção DHCP e deixar as linhas referentes a IP Fixo, caso contrário você faz o inverso.

Abaixo segue um exemplo do arquivo interfaces, nele você vai encontrar as sessões DHCP, usada para IP dinâmico, ou a sessão IP Fixo, e para comentar neste arquivo, você utilize no início da linha o simbolo #

Exemplo:   
  
*\# This file describes the network interfaces available on your system*  
*\# and how to activate them. For more information, see interfaces(5).*

*source /etc/network/interfaces.d/\**

*\# The loopback network interface*  
*auto lo*  
*iface lo inet loopback*

*\# USAR DHCP*  
*allow-hotplug enp0s3*  
*iface enp0s3 inet dhcp*

*\# USAR IP FIXO*  
*\#allow-hotplug enp0s3*  
*\#iface enp0s3 inet static*  
*\# address 192.168.1.3/24*  
*\# gateway 192.168.1.254*  
*\# dns-nameservers 8.8.8.8 1.1.1.1*

5\. Sai do editor de textos mcedit utilizando a tecla **&lt;ESC&gt;**, duas vezes e selecione sim para salvar o arquivo

6\. Após a alteração do arquivo interfaces**,** devemos reiniciar o computador usando o comando: **sudo reboot  
  
Para configurar rotas estáticas no Linux, além das informações acima, inclua as linhas de rota, como mostrado abaixo:**

Abaixo seguem exemplos do arquivo interfaces, nele você vai encontrar as sessões DHCP, usada para IP dinâmico, ou a sessão IP Fixo, e para comentar neste arquivo, você utilize no início da linha o simbolo #.   
Os exemplos mostram como definir uma rota, em caso de DHCP, também mostra um exemplo incluindo a rota para caso de IP Fixo.

Exemplo usando DHCP:   
  
*\# This file describes the network interfaces available on your system*  
*\# and how to activate them. For more information, see interfaces(5).*

*source /etc/network/interfaces.d/\**

*\# The loopback network interface*  
*auto lo*  
*iface lo inet loopback*

*\# USAR DHCP*  
*allow-hotplug enp0s3*  
*iface enp0s3 inet dhcp*  
*\# ROTA PARA TEF MARTINS &lt;--- Aqui incluímos a rota de exemplo, você vai precisar pegar o IP da rede e da antena e definir abaixo*  
***up ip route add 172.19.0.0/16 via 192.168.1.100 dev enp3s0***

*\# USAR IP FIXO*  
*\#allow-hotplug enp0s3*  
*\#iface enp0s3 inet static*  
*\# address 192.168.1.3/24*  
*\# gateway 192.168.1.254*  
*\# dns-nameservers 8.8.8.8 1.1.1.1*

Exemplo usando IP Fixo:   
  
*\# This file describes the network interfaces available on your system*  
*\# and how to activate them. For more information, see interfaces(5).*

*source /etc/network/interfaces.d/\**

*\# The loopback network interface*  
*auto lo*  
*iface lo inet loopback*

*\# USAR DHCP*  
*\#allow-hotplug enp0s3*  
*i#face enp0s3 inet dhcp*  
  
*\# USAR IP FIXO*  
*allow-hotplug enp0s3*  
*iface enp0s3 inet static*  
 *address 192.168.1.3/24*  
 *gateway 192.168.1.254*  
 *dns-nameservers 8.8.8.8 1.1.1.1*  
 *# ROTA PARA TEF MARTINS &lt;--- Aqui incluímos a rota de exemplo, você vai precisar pegar o IP da rede e da antena e definir abaixo*  
 ***up ip route add 172.19.0.0/16 via 192.168.1.100 dev enp3s0*** <span class="text-big">**Tabela com informações sobre mascara de IP para redes TCP/IP levando em consideração IPV4:**</span>

<table data-path-to-node="3" id="bkmrk-nota%C3%A7%C3%A3o-cidr-m%C3%A1scara"><thead><tr><td>**Notação CIDR**</td><td>**Máscara de Sub-rede (Decimal)**</td><td>**Total de IPs**</td><td>**Hosts Úteis**</td><td>**Uso Comum**</td></tr></thead><tbody><tr><td><span data-path-to-node="3,1,0,0">**/32**</span></td><td><span data-path-to-node="3,1,1,0">255.255.255.255</span></td><td><span data-path-to-node="3,1,2,0">1</span></td><td><span data-path-to-node="3,1,3,0">**1** (Host)</span></td><td><span data-path-to-node="3,1,4,0">IP Fixo (Rota de Host)</span></td></tr><tr><td><span data-path-to-node="3,2,0,0">**/31**</span></td><td><span data-path-to-node="3,2,1,0">255.255.255.254</span></td><td><span data-path-to-node="3,2,2,0">2</span></td><td><span data-path-to-node="3,2,3,0">0 (ou 2\*)</span></td><td><span data-path-to-node="3,2,4,0">Links Ponto-a-Ponto (Raro)</span></td></tr><tr><td><span data-path-to-node="3,3,0,0">**/30**</span></td><td><span data-path-to-node="3,3,1,0">255.255.255.252</span></td><td><span data-path-to-node="3,3,2,0">4</span></td><td><span data-path-to-node="3,3,3,0">**2**</span></td><td><span data-path-to-node="3,3,4,0">Links Ponto-a-Ponto (Padrão)</span></td></tr><tr><td><span data-path-to-node="3,4,0,0">**/29**</span></td><td><span data-path-to-node="3,4,1,0">255.255.255.248</span></td><td><span data-path-to-node="3,4,2,0">8</span></td><td><span data-path-to-node="3,4,3,0">**6**</span></td><td><span data-path-to-node="3,4,4,0">Pequenos blocos de IPs Públicos</span></td></tr><tr><td><span data-path-to-node="3,5,0,0">**/28**</span></td><td><span data-path-to-node="3,5,1,0">255.255.255.240</span></td><td><span data-path-to-node="3,5,2,0">16</span></td><td><span data-path-to-node="3,5,3,0">**14**</span></td><td><span data-path-to-node="3,5,4,0">Deptos pequenos / VLANs</span></td></tr><tr><td><span data-path-to-node="3,6,0,0">**/27**</span></td><td><span data-path-to-node="3,6,1,0">255.255.255.224</span></td><td><span data-path-to-node="3,6,2,0">32</span></td><td><span data-path-to-node="3,6,3,0">**30**</span></td><td><span data-path-to-node="3,6,4,0">Deptos pequenos / VLANs</span></td></tr><tr><td><span data-path-to-node="3,7,0,0">**/26**</span></td><td><span data-path-to-node="3,7,1,0">255.255.255.192</span></td><td><span data-path-to-node="3,7,2,0">64</span></td><td><span data-path-to-node="3,7,3,0">**62**</span></td><td><span data-path-to-node="3,7,4,0">Segmentação de /24</span></td></tr><tr><td><span data-path-to-node="3,8,0,0">**/25**</span></td><td><span data-path-to-node="3,8,1,0">255.255.255.128</span></td><td><span data-path-to-node="3,8,2,0">128</span></td><td><span data-path-to-node="3,8,3,0">**126**</span></td><td><span data-path-to-node="3,8,4,0">Metade de uma rede padrão</span></td></tr><tr><td><span data-path-to-node="3,9,0,0">**/24**</span></td><td><span data-path-to-node="3,9,1,0">**255.255.255.0**</span></td><td><span data-path-to-node="3,9,2,0">256</span></td><td><span data-path-to-node="3,9,3,0">**254**</span></td><td><span data-path-to-node="3,9,4,0">**Padrão de Redes Locais (LAN)**</span></td></tr><tr><td><span data-path-to-node="3,10,0,0">**/23**</span></td><td><span data-path-to-node="3,10,1,0">255.255.254.0</span></td><td><span data-path-to-node="3,10,2,0">512</span></td><td><span data-path-to-node="3,10,3,0">**510**</span></td><td><span data-path-to-node="3,10,4,0">Junção de duas redes /24</span></td></tr><tr><td><span data-path-to-node="3,11,0,0">**/22**</span></td><td><span data-path-to-node="3,11,1,0">255.255.252.0</span></td><td><span data-path-to-node="3,11,2,0">1.024</span></td><td><span data-path-to-node="3,11,3,0">**1.022**</span></td><td><span data-path-to-node="3,11,4,0">Redes Wi-Fi de médio porte</span></td></tr><tr><td><span data-path-to-node="3,12,0,0">**/21**</span></td><td><span data-path-to-node="3,12,1,0">255.255.248.0</span></td><td><span data-path-to-node="3,12,2,0">2.048</span></td><td><span data-path-to-node="3,12,3,0">**2.046**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,13,0,0">**/20**</span></td><td><span data-path-to-node="3,13,1,0">255.255.240.0</span></td><td><span data-path-to-node="3,13,2,0">4.096</span></td><td><span data-path-to-node="3,13,3,0">**4.094**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,14,0,0">**/19**</span></td><td><span data-path-to-node="3,14,1,0">255.255.224.0</span></td><td><span data-path-to-node="3,14,2,0">8.192</span></td><td><span data-path-to-node="3,14,3,0">**8.190**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,15,0,0">**/18**</span></td><td><span data-path-to-node="3,15,1,0">255.255.192.0</span></td><td><span data-path-to-node="3,15,2,0">16.384</span></td><td><span data-path-to-node="3,15,3,0">**16.382**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,16,0,0">**/17**</span></td><td><span data-path-to-node="3,16,1,0">255.255.128.0</span></td><td><span data-path-to-node="3,16,2,0">32.768</span></td><td><span data-path-to-node="3,16,3,0">**32.766**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,17,0,0">**/16**</span></td><td><span data-path-to-node="3,17,1,0">**255.255.0.0**</span></td><td><span data-path-to-node="3,17,2,0">65.536</span></td><td><span data-path-to-node="3,17,3,0">**65.534**</span></td><td><span data-path-to-node="3,17,4,0">**Grandes Redes Corporativas**</span></td></tr><tr><td><span data-path-to-node="3,18,0,0">**/15**</span></td><td><span data-path-to-node="3,18,1,0">255.254.0.0</span></td><td><span data-path-to-node="3,18,2,0">131.072</span></td><td><span data-path-to-node="3,18,3,0">**131.070**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,19,0,0">**/14**</span></td><td><span data-path-to-node="3,19,1,0">255.252.0.0</span></td><td><span data-path-to-node="3,19,2,0">262.144</span></td><td><span data-path-to-node="3,19,3,0">**262.142**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,20,0,0">**/13**</span></td><td><span data-path-to-node="3,20,1,0">255.248.0.0</span></td><td><span data-path-to-node="3,20,2,0">524.288</span></td><td><span data-path-to-node="3,20,3,0">**524.286**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,21,0,0">**/12**</span></td><td><span data-path-to-node="3,21,1,0">255.240.0.0</span></td><td><span data-path-to-node="3,21,2,0">1.048.576</span></td><td><span data-path-to-node="3,21,3,0">**1.048.574**</span></td><td><span data-path-to-node="3,21,4,0">Redes Privadas (172.16.x.x)</span></td></tr><tr><td><span data-path-to-node="3,22,0,0">**/11**</span></td><td><span data-path-to-node="3,22,1,0">255.224.0.0</span></td><td><span data-path-to-node="3,22,2,0">2.097.152</span></td><td><span data-path-to-node="3,22,3,0">**2.097.150**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,23,0,0">**/10**</span></td><td><span data-path-to-node="3,23,1,0">255.192.0.0</span></td><td><span data-path-to-node="3,23,2,0">4.194.304</span></td><td><span data-path-to-node="3,23,3,0">**4.194.302**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,24,0,0">**/9**</span></td><td><span data-path-to-node="3,24,1,0">255.128.0.0</span></td><td><span data-path-to-node="3,24,2,0">8.388.608</span></td><td><span data-path-to-node="3,24,3,0">**8.388.606**</span></td><td> </td></tr><tr><td><span data-path-to-node="3,25,0,0">**/8**</span></td><td><span data-path-to-node="3,25,1,0">**255.0.0.0**</span></td><td><span data-path-to-node="3,25,2,0">16.777.216</span></td><td><span data-path-to-node="3,25,3,0">**16.777.214**</span></td><td><span data-path-to-node="3,25,4,0">**Redes Gigantes (Ex: 10.x.x.x)**</span></td></tr></tbody></table>

# 6 - Configuração de acesso remoto no Frente de Lojas Linux Debian

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da instalação e configuração da ferramenta de acesso remoto Rustdesk, além de ser uma ferramenta gratuita e muito prática para o auxílio no dia a dia, o Rustdesk não possui as limitações, que o Anydesk, por ser proprietário está impondo, também utilizamos um servidor de relay da própria Avanço Informática, mantendo mais segurança nas informações que são trafegadas nos acessos.  
  
</span><span class="text-big">**Muito importante:** </span>

- <span class="text-big">**Para este procedimento, é fortemente recomendado que utilize um mouse ligado ao equipamento, para facilitar as configurações.**</span>
- <span class="text-big">**Você deve definir um servidor para acesso que não seja o servidor padrão do fornecedor Rustdesk, pois assim a ferramenta vai funcionar com bem mais agilidade.**</span>
- <span class="text-big">**Os parâmetros de servidores, não estarão no vídeo, por questões de privacidade, caso necessitem de ajuda, por favor chamem o setor de suporte da Avanço ou vejam os parâmetros no arquivo leia\_sobre\_rustdesk.txt, que se encontra na pasta /u/util, onde também está o pacote de instalação da ferramenta.**</span>

> Abaixo segue o vídeo demonstrando a instalação e a base da configuração:

<video controls="controls" height="472" src="https://bc.avancoinfo.com.br/attachments/6?open=true" style="width: 842px; height: 472px;" width="842"></video>

**Os passos dos procedimentos mostrados no vídeo, estão descritos abaixo para auxílio:**

**Tela principal - Abra o Rustdesk**

**[![Rustdesk_principal.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-principal.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-principal.png)**

**Tela principal - Clique nos 3 pontinhos para tela de configurações**

**[![Rustdesk_Confgurações.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-confguracoes.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-confguracoes.png)**

**Tela de configurações - Selecione segurança**

**[![Rustdesk_segurança.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-seguranca.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-seguranca.png)**

**Tela de segurança - Faça o desbloqueio da tela de segurança usando a senha do usuário pdv, senha super**

[![Rustdesk_segurança_desbloquear.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-seguranca-desbloquear.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-seguranca-desbloquear.png)

**Tela de segurança - Habilite a opção: Habilitar modificações de configuração remotas**

**[![Rustdesk_remota.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-remota.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-remota.png)**

**[![Rustdesk_senha.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-senha.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-senha.png)**

**Tela de configurações - Selecione rede**

**[![Rustdesk_rede.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-rede.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-rede.png)**

**Tela de rede - Faça o desbloqueio da tela de rede usando a senha do usuário pdv, senha super**

**[![Rustdesk_desbloquear_rede.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-desbloquear-rede.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-desbloquear-rede.png)**

**Tela de rede - Defina os parâmetros do servidor da Avanço, ou caso tenha algum servidor próprio para esta função.**

**É muito importante que você defina um servidor, para que o acesso não fique lento, pois os servidores compartilhados do fornecedor do Rustdesk, são muito lentos.**

**[![Rustdesk_Servidores.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/scaled-1680-/rustdesk-servidores.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-11/rustdesk-servidores.png)**

# 7 - Telas touch screen - Sweda, Elgin e Custom

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da instalação e configuração de um modelo de tela touch screen, além de várias outras informações sobre os modelos que são homologados pela Avanço informática.  
  
</span><span class="text-big">**Muito importante:** </span>

- <span class="text-big">**Leia as informações abaixo referentes as telas touch screen homologadas e principalmente as informações que fazem referencias específicas aos modelos que você está instalado, pois as informações ajudam na configuração.**</span>
- <span class="text-big">**Para este procedimento, é fortemente recomendado que não utilize um mouse ligado ao equipamento.**</span>
- <span class="text-big">**Em todos os casos, as configurações das telas touch screen homologadas, ficam na resolução de 1024x768.**</span>
- <span class="text-big">**Todos os cabos USB's devem estar ligados no equipamento, para o funcionamento correto das telas homologadas, pois existem algumas particularidades de troca de ID's, quando retiramos e incluímos quaisquer devices nas portas USB.**</span>
- <span class="text-big">**As telas avulsas da Custom foram homologadas, porém o equipamento All In One Custom Sirius 15.6" Intel Celeron J6412 8gb 128gb Ssd - 921lb661700233, não pode ser utilizado com a aplicação da Avanço, devido as resoluções não serem padrão para o sistema. Pois este equipamento possui para a tela menor, apenas a resolução de 1366x768, <span class="text-huge"> não sendo possível alterar esta resolução.</span>**</span>

> **Acesse o link abaixo para ver o vídeo demostrando a instalação e configuração:**

<video controls="controls" height="471" src="https://bc.avancoinfo.com.br/attachments/7?open=true" style="width: 837px; height: 471px;" width="837"></video>

**<span class="text-huge">O funcionamento das telas touch screen possuem as seguintes particularidades, exceto um modelo da marca Elgin, que possui apenas USB, fugindo a regra: </span>**

1. <span class="text-huge">Cabo de energia elétrica, fonte de energia para alimentação da tela</span>
2. <span class="text-huge">Cabo de entrada de vídeo, onde recebemos as imagens do computador na tela;</span>
3. Cabo USB, para o funcionamento do toque na tela.

**<span class="text-huge">Existem no Linux Debian 12, comandos que nos auxiliam na hora de configurarmos as telas touch homologadas, os comandos são estes abaixo:</span>**

1. <span class="text-huge">**lsusb** - Lista os dispositivos USB ligados efetivamente ao computador, mostrando também a ligação USB das telas touch;</span>
2. <span class="text-huge">**xrandr** - Lista os dispositivos conectados efetivamente a um entrada de vídeo no computador, normalmente são nomeadas de VGA, HDMI, DP, entre outro nomes, também é importante ressaltar que a entrada vem complementada pelo número da porta ao qual o cabo de vídeo está ligado com computador, como por exemplo: HDMI-2;</span>
3. <span class="text-huge">**xinput** - Lista os ID's das telas ligadas ao computador, também chamados de números de identificação de cada dispositivo plugado em uma porta USB no computador, estes ID's podem variar de acordo com as portas USB's que as telas foram ligadas fisicamente, também é muito importante ressaltar que as portas USB's 3.0, possuem uma caraterística particular de variar muito os ID's, quando inserimos ou retiramos dispositivos diversos nestes modelos de portas, e isso pode desconfigurar facilmente uma tela touch. Sendo assim recomendamos fortemente que todos os dispositivos que serão utilizados no computador que vai servir como caixa, devem ser ligados antes das configuração final das telas, para evitar que os ID's mudem. Outra boa prática é evitar ao máximo, colocar as telas touch screen, exceto o modelo da Elgin apenas USB, ligadas a portas USB do tipo 3.0. </span>

<span class="text-huge">  
**Telas Sweda:**  
  
As telas da Sweda possuem uma denominação interna de ILITEK ILITEK-TP, tanto a tela de 15 polegadas, quanto a tela de 9 polegadas e as duas telas aparecem com o mesmo nome, dificultando um pouco a configuração, até o acerto do ID para cada tela, recomendamos fortemente que não liguem as telas em saídas USB 3.0, principalmente na maquinas completas da Sweda que possuem o conjunto completo de fábrica.  
  
**Telas Elgin:**</span>

<span class="text-huge">As telas da Elgin possuem uma denominação interna de Weida Hi-Tech CoolTouch, diferentemente da Sweda, a tela de 15 polegadas da Elgin é embutida juntamente ao computador, não sendo uma tela avulsa, porém a tela de 9 polegadas vem com uma denominação interna um pouco diferente da tela de 15 polegadas, isso é quando a tela que possui apenas um cabo USB e nenhum outro cabo, neste caso a denominação é Weida Hi-Tech CoolTouch®, ou seja é mais fácil a identificação do ID, devido ao ® de marca registrada da tela de 9 polegadas. Ainda falando sobre a tela de 9 polegadas da Elgin, também existe um modelo da tela de 9 polegadas com cabo VGA, a denominação deste modelo é ILITEK ILITEK-TP, como nas telas Sweda, facilitando também a configuração de ID para cada tela, pois possuem os nomes diferentes.  
  
**Telas Custom:**  
  
As telas da Custom possuem uma denominação interna de ILITEK ILITEK-TP, assim como as telas da Sweda, tanto para as telas de 15 e 17 polegadas, quanto a tela de 9 polegadas e as três telas aparecem com o mesmo nome, dificultando um pouco até o acerto da configuração de ID para cada tela, recomendamos fortemente que não liguem as telas em saídas USB 3.0. As telas da Custom precisam que alem de definirmos as saídas de vídeo e os ID's, também são necessárias as taxas de atualizações para que funcionem corretamente, diferentemente das telas de Sweda e Elgin.  
</span>

<span class="text-huge"><span class="text-big">**O equipamento All In One Custom Sirius 15.6" Intel Celeron J6412 8gb 128gb Ssd - 921lb661700233, não pode ser utilizado com a aplicação da Avanço, devido as resoluções não serem padrão para o sistema. Este equipamento possui para a tela menor, apenas a resolução de 1366x768, não sendo possível alterar esta resolução.**</span></span>

<span class="text-huge">**Configurações e detalhes que existem nas imagens do frente de lojas Linux Debian:** Nas imagens da Avanço, existem dois script na pasta /u/bats, que fazem o controle das telas touch screen, primeiro você deve usar o script telas\_touch.sh para as telas Sweda ou Elgin ou então o script telas\_touch\_taxa.sh para as telas da Custom, nestes arquivos você vai definir quais são as telas e seus ID's respectivos e no caso das telas Custom também a taxa de atualização, abaixo seguem exemplos dos dois scripts citados neste tópico:</span>

<span class="text-huge">Outros scripts relevantes e que auxiliam muito na instalação, são eles: configura\_telas\_touch.sh e configura\_telas\_touch\_taxa.sh. Estes scripts possuem um passo a passo solicitando ao usuário a entrada de vídeo e o ID respectivo da tela, ao final o script cria os outros scripts, denominados: script telas\_touch.sh e script telas\_touch\_taxa.sh  
  
Neste exemplo a seguir usaremos telas Sweda ou Elgin, ligadas da seguinte forma: A tela de 15 polegadas está na porta HDMI-1 e a tela de 9 polegadas está na porta VGA-1, e conseguimos os ID's, através do comando xinput e os resultados são: A tela de 15 polegadas recebeu o ID 17, já a tela de 9 polegadas recebeu o ID 13.  
  
**Exemplo do script telas\_touch.sh**  
  
</span>*\#!/bin/bash*

*\# Variáveis de configuração*  
*\# Você deve definir qual é o monitor primário e também o secundário, para isso use o comando xrandr*  
*\# Para cada monitor você vai também colocar qual é o ID da tela atraveś do comando xinput*  
*MONITOR\_PRIMARIO="HDMI-1"*  
*MONITOR\_AUXILIAR="VGA-1"*  
*ID\_TOUCH\_PRIMARIO="17"*  
*ID\_TOUCH\_AUXILIAR="13"*

*\# Configura o layout das telas: primário à esquerda, auxiliar à direita.*  
*xrandr --output $MONITOR\_PRIMARIO --primary --mode 1024x768 --output $MONITOR\_AUXILIAR --mode 1024x768 --right-of $MONITOR\_PRIMARIO*

*\# Aguarda a estabilização do sistema gráfico.*  
*sleep 5*

*\# Mapeia o toque para as telas corretas.*  
*xinput map-to-output $ID\_TOUCH\_PRIMARIO $MONITOR\_PRIMARIO*  
*xinput map-to-output $ID\_TOUCH\_AUXILIAR $MONITOR\_AUXILIAR*

<span class="text-huge">  
Já no exemplo a seguir usaremos telas Custom, ligadas da seguinte forma: A tela de 15 ou 18 polegadas está na porta HDMI-1 e a tela de 9 polegadas está na porta VGA-1, e conseguimos os ID's, através do comando xinput e os resultados são: A tela de 15 ou 18 polegadas recebeu o ID 09, já a tela de 9 polegadas recebeu o ID 15, ambas as telas possuem a taxa de atualização em 60 hz.  
  
**Exemplo do script telas\_touch\_taxa.sh**  
  
</span>*\#!/bin/bash*

*\# Variáveis de configuração*  
*\# Você deve definir qual é o monitor primário e também o secundário, para isso use o comando xrandr*  
*\# Para cada monitor você vai também colocar qual é o ID da tela atraveś do comando xinput*  
*\# Taxa de atualização também conhecido como frequência, veja no comando xrandr referente a resolução de 1024x768*  
*\# A opção que usa taxas, devem ser utilizada para telas da marca CUSTOM*  
*MONITOR\_PRIMARIO="HDMI-1"*  
*MONITOR\_AUXILIAR="VGA-1"*  
*ID\_TOUCH\_PRIMARIO="09"*  
*ID\_TOUCH\_AUXILIAR="15"*  
*TAXA\_PRIMARIA="60.00"*  
*TAXA\_AUXILIAR="60.00"*

*\# Configura o layout das telas: primário à esquerda, auxiliar à direita.*  
*xrandr --output $MONITOR\_PRIMARIO --primary --mode 1024x768 --rate $TAXA\_PRIMARIA --output $MONITOR\_AUXILIAR --mode 1024x768 --rate $TAXA\_AUXILIAR --right-of $MONITOR\_PRIMARIO*

*\# Aguarda a estabilização do sistema gráfico.*  
*sleep 5*

*\# Mapeia o toque para as telas corretas.*  
*xinput map-to-output $ID\_TOUCH\_PRIMARIO $MONITOR\_PRIMARIO*  
*xinput map-to-output $ID\_TOUCH\_AUXILIAR $MONITOR\_AUXILIAR*

# 8 - Coletas informações de Hardware

<span class="text-huge">Nesta sessão, você vai poder acompanhar um vídeo com o passo a passo da montagem de um pendrive para coleta das informações de hardware e também outro vídeo de como executar a coletas destas informações. Esta coleta serve para saber se o equipamento que as informações foram coletadas, contem os requisitos mínimos para instalação da ferramenta de frente de lojas Linux Debian da Avanço Informática.</span>

<span class="text-big">**Muito importante:** </span>

- <span class="text-big">**Para este procedimento, é fortemente recomendado, caso você não saiba detalhes das informações dos caixas do seu estabelecimento.**</span>
- <span class="text-big">**Você vai precisar de um pendrive, e tenha certeza que o mesmo possa ser limpo, pois o procedimento vai limpar todo o conteúdo do seu pendrive.**</span>
- <span class="text-big">**Caso seu equipamento esteja em uma rede com internet, as informações colhidas, serão enviadas para um grupo do Telegram dos responsáveis em analisar os recursos de hardware da Avanço Informática.**</span>
- <span class="text-big">**As informações colhidas tem apenas a finalidade de informar sobre os hardware existentes no estabelecimento, estas informações não serão utilizadas para mais nenhum fim. Após analise, as informações serão apagadas.**</span>
- <span class="text-big"> **O que será informado: CNPJ do cliente, Nome Fantasia do cliente, Número da loja, Numero do caixa e Técnico responsável.**</span>
- <span class="text-big">**O que será colhido: Modelo da placa mãe do computador, quantidade de núcleos do processador, quantidade de memória RAM, tamanho e tipo do disco e performance da ligação de rede.**</span><span class="text-big">  
    </span>
- **Para você baixar a ferramenta Ventoy versão Windows, clique [aqui](https://sourceforge.net/projects/ventoy/files/v1.1.07/ventoy-1.1.07-windows.zip/download "Baixar a ferramenta Ventoy, versão Windows")**
- **Para você baixar a imagem ISO do coletor de informações, clique [aqui](https://avancoinfo.com.br/tecnologia/pdv-debian/coleta.iso "Baixar a imagem ISO do coletor de informações")**

> **<span class="text-huge">Abaixo seguem vídeos demonstrando a montagem do pendrive e coleta das informações dos equipamentos na prática utilizando uma maquina virtual como exemplo:</span>**

#### **<span class="text-huge">Montagem do pendrive</span>**

<span class="text-huge"><video controls="controls" height="471" src="https://bc.avancoinfo.com.br/attachments/9?open=true" style="width: 837px; height: 471px;" width="837"></video></span>

#### **<span class="text-huge">Coletando informações</span>**

<span class="text-huge"><video controls="controls" height="471" src="https://bc.avancoinfo.com.br/attachments/8?open=true" style="width: 837px; height: 471px;" width="837"></video></span>

> **<span class="text-big"><span class="text-huge">A coleta demonstrada no vídeo acima, gerou o seguinte resultado no Telegram:</span></span>**

<span class="text-big"><span class="text-huge">  
  
[![Resultado_Telegram.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/resultado-telegram.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/resultado-telegram.png)  
</span></span>

> **<span class="text-big"><span class="text-huge">Abaixo, seguem a imagem de quando a coleta aconteceu, porém o computador não estava conectado a internet, você deve tirar uma foto da tela e enviar para o responsável na Avanço para análise:</span></span>**

<span class="text-big"> **[![Coletas_sem_Internet.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/scaled-1680-/coletas-sem-internet.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-12/coletas-sem-internet.png)** </span>

# 9 - Laboratório da Instalação do Frente de Lojas Linux Debian, utilizando a imagem completa (Full)

<span class="text-huge">**Vídeo de laboratório da i**</span><span class="text-huge">**nstalação do Frente de lojas Linux Debian, utilizando equipamento da Sweda Touch Screen com duas telas, este vídeo mostra todo o processo, na prática, da instalação do frente de lojas Debian.** </span>**Sugerimos que não pule etapas do vídeo, também no final da página existe um detalhamento do passo a passo mostrado no vídeo.**

A versão do Frente de Loja foi desenvolvida e adaptada sobre a plataforma do Linux Debian 12 - 64 bits, não existe um instalador para o Frente de Loja, mas sim imagens disponibilizadas que já vêm com todas as configurações iniciais prontas, necessárias para a utilização da aplicação.

Para computadores que possuam as três opções de setup.

Imagem FULL contem recursos: Legacy, EFI - SATA, EFI - NVME.

- <span class="text-big">Para você baixar a imagem FULL, clique </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">**aqui**</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/full.iso "Baixar a imagem de instalação completa do Frente de Lojas Linux Debian")</span>
- <span class="text-big">Veja o vídeo completo do laboratório mão na massa, clicando </span><span style="background-color: rgb(224, 62, 45); color: rgb(0, 0, 0);">[<span class="text-big">**aqui**</span>](https://avancoinfo.com.br/tecnologia/pdv-debian/laboratoriopdvfull.mp4 "Vídeo laboratório da instalação em um equipamento da Sweda com duas telas Touch")</span>

**Detalhes importantes para acessos ao equipamento com PDV Debian** Acessando o equipamento por SSH utilize as seguintes credenciais:   
  
Login: **pdv**  
Senha: **super**

Acessando o equipamentos por VNC utilize a credencial:

Senha: **pdvdebian**

**Nesta instalação, não existe o usuário root, para necessidades de root em casos de comandos administrativos, utilize o comando sudo.**

**<span class="text-big">Os comandos usados:</span>**

- **cd** - Comando usado para trocarmos de diretórios no Linux
- **mcedit** - Editor de textos utilizado para alterações em arquivos de configurações. PS: Para sair salvando o arquivo neste editor, devemos utilizar a tecla **&lt;ESC&gt; &lt;ESC&gt;** e selecionar **\[ SIM \]**, tenha certeza que a alteração foi correta
- **&lt;CRTL&gt; &lt;ESC&gt;** - Subir o menu onde podemos selecionar opções necessárias
- **xrandr** - Comando que nos mostra quais são as portas do computador que possuem algum monitor ligado, os monitores que deveram ser utilizados, aparecem com a opção **connected,** não utilize as portas que estiverem com o parâmetro **disconnected**
- **sudo reboot -** Comando usado para reiniciarmos o Linux

<span class="text-big">**Os passos dos procedimentos mostrados no vídeo, estão descritos abaixo para auxílio:** </span>

- Teclas **&lt;CRTL&gt; e &lt;ESC&gt;** para subir o menu principal
- Menu: **Sistema --&gt; Terminal** (auxilia nas configurações dos arquivos necessários)
- Utilizar o comando **xrandr** para verificar as portas onde s monitores estão ligado fisicamente, existem vários modelos de portas que são tratados como: (VGA, HDMI, DP e DVI)
- Editar o arquivo **tela\_touch\_coordenadas.sh** que está no diretório **/u/bats** e apontar os monitores que estão conectados, de acordo com as portas que foram mostradas no comando **xrandr,** para editar o arquivo, foi utilizado o editor de textos chamado **mcedit.** Exemplo:
    
    cd /u/bats
    
    mcedit tela\_touch\_coordenadas.sh
- Após a edição use o comando **cd,** para caminhar ate o home do usuário pdv
- Depois ainda com comando **cd,** você deve caminhar para o diretório onde ficam as inicializações do sistema Linux no diretório **.config/lxsession/LXDE,** o caminho completo fica assim: **/home/pdv/.config/lxsession/LXDE**
- Usando novamente o editor de textos **mcedit**, editar o arquivo **autostart,** assim: **mcedit autostart**
- Na edição do arquivo **autostart,** devemos comentar a linha **/u/bats/tela.sh,** colocando um simbolo **\# "Jogo da velha"** no início da linha e descomentar, retirando o **# "jogo da velha"** do início da linha **/u/bats/tela\_touch\_coordenadas.sh**
- Após sair gravando o arquivos, devemos reiniciar o computador usando o comando: **sudo reboot**
- Último passo é sinalizarmos para o **Frente de lojas Linux Debian**, através de um parâmetro, avisando que vamos utilizar os recursos de duas telas. Para isso utilizando o comando **fazini,**  criamos uma variável chamada **TOUCH,** do tipo **L** "lógico" e com valor **T,** isso faz com que o Frente de Lojas Linux Debian saiba que será usado duas telas no setup.  
    Exemplo:
    
    cd /u/pdv
    
    fazini
- Após a criação da variável **TOUCH,** devemos reiniciar o computador usando o comando: **sudo reboot**

# 10 - Versões do Frente de lojas Linux Debian

A versão do Frente de Loja é controlada pelo hash do binário do PDV.  
  
Comando no prompt do Linux para você verificar o hash do binário do Frente de lojas:  
  
**cat pdv | md5sum**  
  
Versão: **1.5.41** - **1654d2d06ef820225ad8dd4725143138**  
  
Implementações da versão:  
  
MUDANÇAS NA VERSÃO 1.5.41 - LINUX

- AJUSTES:   
      
    Ajuste refere a Inconsistência no XML em vendas com desconto Scanntech por bin.  
    Permitir indentificar cliente por codigo em teclado reduzido.  
    Envio de SKU com mais de 6 digitos para Mercafácil ( CLIENTES NOVOAVANCO).  
    Ajuste na impressão de comprovantes TEF em modo Reduzido.
- MELHORIAS:   
      
    PDV TOUCH - Tocar em qualquer local da tela para sair da mensagem "PRODUTO NÃO CADASTRADO".Padronização de API's, usando sempre a url base.

# Como Realizar a Configuração e Manutenção do Pinpad

Realizando configuração e manutenção na rotina de pinpad do frente de loja Linux

# Como Realizar a Configuração e Manutenção do Pinpad

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/8TWimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/8TWimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/C1cimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/C1cimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/6aFimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/6aFimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/NN7image.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/NN7image.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/Io0image.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/Io0image.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/xiHimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/xiHimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/4cGimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/4cGimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/myYimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/myYimage.png)

[![image.png](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/scaled-1680-/yaNimage.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2025-08/yaNimage.png)  
  
<span style="color: rgb(224, 62, 45);">*Em caso de erros com códigos não especificados sobre o erro, vide tabela Fiserv:*</span>  
  
<span style="color: rgb(224, 62, 45);">*https://dev.softwareexpress.com.br/docs/clisitef/tabela\_codigos\_retorno*</span>

# Requisitos Frente de Loja Linux

Requisitos e recomendações para instalação de frente de loja da versão Linux. Solução de PDV que realizar registro, pagamento e tramitação de vendas da Avanço Informática.

Os seguintes requisitos e recomendações devem ser seguidos para garantia do funcionamento mínimos das funcionalidades da aplicação.

## Requisitos de Máquina

Para garantir o desempenho adequado da solução de ponto de venda (PDV), é essencial atender aos seguintes requisitos mínimos:

- Processador Intel Core i3;
- Mínimo de 8GB de memória RAM;
- SSD de no mínimo 120GB;
- Placa de rede Gigabit;
- Saída serial ou USB compatível com os dispositivos periféricos conectados, como mouse;
- **Outros periféricos:** Periféricos que podem compor o PDV, como leitor de código de barras, balança de PDV, PinPad, Teclado Reduzido, Leitor Biométrico entre outros, devem estar disponíveis no momento da instalação, conforme homologação;
- É necessários duas saídas de vídeo para casos de utilização de dois monitores touch screen!


## Sistemas operacionais disponíveis

Sistemas operacionais necessários para execução correta do caixa na versão Windows.

<div class="table-container" id="bkmrk-sistema-operacional-"><table style="width: 33.9286%; height: 84.1876px;"><tbody><tr style="height: 37.5938px;"><td style="width: 57.6207%; height: 37.5938px;">Sistema Operacional</td><td style="width: 21.42%; height: 37.5938px;">Versão</td><td style="width: 20.7018%; height: 37.5938px;">Edição</td></tr><tr><td style="width: 57.6207%;">Debian 12 (64 bits)</td><td style="width: 21.42%;">12</td><td style="width: 20.7018%;">1</td></tr><tr style="height: 46.5938px;"><td style="width: 57.6207%; height: 46.5938px;">Slackware 15.0 (32 bits)</td><td style="width: 21.42%; height: 46.5938px;">15.0</td><td style="width: 20.7018%; height: 46.5938px;">1</td></tr></tbody></table>

</div>> A Avanço Informática disponibiliza uma imagem ( iso ) com o pacote completo de instalação da distribuição do Linux Slackware incluindo o pacote da aplicação do PDV em sua última versão disponível. Para mais informações, entre em contato com o suporte Avanço através do nosso [Canal de Atendimento](https://novo.avancoinfo.net/novoPortal/atendimento).

## Requisitos de Infraestrutura

Além dos requisitos de hardware, a infraestrutura necessária para operação inclui:

1. **Monitor:** Com entrada compatível (VGA, HDMI, DisplayPort) e resolução mínima de 1024x768.
2. **Placa de Vídeo:** Compatível com os sistemas operacionais mencionados.
3. **Impressora não Fiscal:** Verificar os modelos homologados pela solução.
4. **Conexão de Rede:** Ponto de rede cabeada RJ45 disponível, com comunicação com a internet sem controle de firewall (Wi-Fi não permitido).

## Requisitos de Rede Recomendáveis

Para o funcionamento da NFC-e, é recomendável que o ambiente de comunicação seja compatível com os itens abaixo:

- **Internet Estável:** Deve ser uma conexão estável, sem quedas ou perdas de pacotes, com velocidade mínima de 1MB para download e 256KB para upload (por ponto utilizado).
- **Contingência de Internet:** É recomendável que a instalação contenha contingência de internet, utilizando dois ou mais links de fornecedores provedores distintos, para manter o funcionamento pleno.
- **Internet Exclusiva:** É recomendável uma internet exclusiva para emissão das notas, para evitar gargalos e lentidões com compartilhamentos no momento das transações.

## Requisitos de Segurança de Rede

Recomenda-se que o ambiente de comunicação seja compatível com os itens abaixo:

- **Estrutura de Acesso à Internet:** Protegida por firewall e antivírus, principalmente para instalações que utilizam sistema operacional Windows.

## Requisito do Certificado Digital

O modelo do certificado digital usado para NFC-e é o A1, que é gerado e armazenado no computador pessoal, dispensando o uso de cartões inteligentes ou tokens.

> Para cada filial deverá existir um certificado A1, e este ficará copiado em todos os equipamentos que emitem a NCF-e, para emissão de notas fiscais em processo de contingência.

> É de responsabilidade do usuário fazer a proteção de acesso aos equipamentos que emitem NFC-e, através de senhas, firewall e antivírus, devido a necessidade deles conter uma cópia do certificado digital da empresa.

## Recomendações e Observações

Para uma instalação bem-sucedida e operação otimizada, tais recomendações devem ser seguidas

1. Recomenda-se realizar o processo de instalação de forma presencial.
2. Crie um ponto de restauração antes de iniciar a instalação para facilitar a recuperação em caso de problemas.
3. Reinicie a máquina conforme solicitado pelo instalador para garantir a conclusão adequada do processo.
4. Utilize o ODBC Driver versão psqlodbc\_10\_03\_0000-x86 ou superior para compatibilidade com o banco de dados.
5. Instale o ODBC Driver a partir do link fornecido ou do site oficial do PostgreSQL.
6. Desative o Controle de Conta de Usuário (UAC) do Windows para evitar interferências durante a instalação.
7. Instale o Java antes de executar a instalação do sistema de frente de loja ou supervisor. Tal instalação será solicitada no processo inicial da instalação do PDV.
8. Reinicie a máquina após a conclusão da instalação para aplicar todas as configurações e garantir o funcionamento correto.

## Impressoras não fiscais Homologadas:

Para o funcionamento da NFC-e, é recomendável que a impressora fiscal seja compatível com as listadas abaixo, por terem sido homologadas:

<div class="table-container" id="bkmrk-marca-modelos-elgin-"><table><thead><tr><th>Marca</th><th>Modelos</th></tr></thead><tbody><tr><td>ELGIN</td><td>I7, I9</td></tr><tr><td>EPSON</td><td>TM 88V, TM T20, T20X</td></tr><tr><td>BEMATECH</td><td>MP 4200 TH, MP 2800</td></tr><tr><td>CONTROLID</td><td>PRINTID</td></tr><tr><td>DARUMA</td><td>DR-700/800</td></tr><tr><td>TANCA</td><td>TP-650</td></tr><tr><td>JETWAY</td><td>JP-800</td></tr></tbody></table>

</div>## PinPads Homologados

Para o funcionamento da NFC-e, é recomendável que o pind pad seja compatível com os listados abaixo, por terem sido homologados:

<div class="table-container" id="bkmrk-marca-modelos-ingeni"><table><thead><tr><th>Marca</th><th>Modelos</th></tr></thead><tbody><tr><td>INGENICO</td><td>IPP320</td></tr><tr><td>GERTEC</td><td>PPC910, PPC930</td></tr></tbody></table>

</div>

# Integração PDV Avanço — Consulta de Descontos e Envio de Venda (Parceiros CRM)

> **Objetivo**  
> Documentar o fluxo PDV → Parceiro de Fidelidade/Descontos (ex.: "crescevendas" como placeholder), com exemplos de requisição e retorno, e a explicação dos campos utilizados. O documento é **genérico** e pode ser aplicado a qualquer parceiro que exponha endpoints equivalentes.

---

## Visão geral do fluxo

1. **Consulta de descontos** (pré-venda): o PDV envia os itens do carrinho + identificação do cliente → **API do parceiro** retorna descontos aplicáveis e dados do cliente.
2. **Envio da venda** (pós-fechamento): o PDV registra a venda efetuada (itens, pagamento, total) → **API do parceiro** confirma pontos/saldo/benefícios concedidos e retorna os saldos finais.

> **Observação:** os nomes de host, caminhos e cabeçalhos abaixo são **exemplos**. Adapte-os ao parceiro real (ex.: `https://{host-parceiro}/admin/api/v2/...`).

---

## Padrões comuns

- **Formato**: JSON (UTF-8).
- **Métodos**: `POST` para as operações descritas.
- **Timeout recomendado no PDV**: 30s.
- **Autenticação**: via cabeçalhos proprietários do parceiro (ex.: `X-AdminUser-Email`, `X-AdminUser-Token`).
- **Idioma**: quando suportado, enviar `Accept-Language: pt-BR`.

### Cabeçalhos (exemplo)

```
Accept: */*
Content-Type: application/json
Accept-Language: pt-BR,pt;q=0.8,en-US;q=0.6,en;q=0.4
charsets: utf-8
X-AdminUser-Email: <email-de-integracao@parceiro>
X-AdminUser-Token: <token-de-integracao>

```

---

## 1) Consulta de Descontos (pré-venda)

**Endpoint (exemplo):**

```
POST https://{host-parceiro}/admin/api/v2/shops

```

### Request — Exemplo de `curl`

```bash
curl -k -m 30 -s -S \
  -H "Accept: */*" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: pt-BR,pt;q=0.8,en-US;q=0.6,en;q=0.4" \
  -H "charsets: utf-8" \
  -H "X-AdminUser-Email: <email-de-integracao@parceiro>" \
  -H "X-AdminUser-Token: <token-de-integracao>" \
  -X POST \
  --data-binary @inicia_parceiro.json \
  "https://{host-parceiro}/admin/api/v2/shops" \
  -o retorno_consulta.json --stderr erro_consulta.log -D header_consulta.txt

```

### Request — Corpo (exemplo)

```json
{
  "items": [
    {
      "category": "046",
      "code": "00000000000017",
      "product_name": "CREME AMEND ALMOND B",
      "quantity": 1.0,
      "subcategory": "241",
      "unit_type": "um",
      "unit_value": 6.99
    }
  ],
  "registration": "05940778690"
}

```

### Significado dos campos (request)

<table id="bkmrk-campo-tipo-obrigat%C3%B3r"><thead><tr><th>Campo</th><th align="right">Tipo</th><th align="center">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td>`items`</td><td align="right">Array de objeto</td><td align="center">Sim</td><td>Lista de itens no carrinho do PDV para avaliação de desconto.</td></tr><tr><td>`items[].category`</td><td align="right">string</td><td align="center">Recomendado</td><td>Código de **categoria mercadológica** do item no PDV.</td></tr><tr><td>`items[].subcategory`</td><td align="right">string</td><td align="center">Opcional</td><td>Código de **subcategoria** mercadológica.</td></tr><tr><td>`items[].code`</td><td align="right">string</td><td align="center">Sim</td><td>Identificador do produto (EAN/PLU/código interno).</td></tr><tr><td>`items[].product_name`</td><td align="right">string</td><td align="center">Recomendado</td><td>Descrição do produto.</td></tr><tr><td>`items[].quantity`</td><td align="right">number</td><td align="center">Sim</td><td>Quantidade do item.</td></tr><tr><td>`items[].unit_type`</td><td align="right">string</td><td align="center">Recomendado</td><td>Unidade de medida (ex.: `um`, `kg`, `lt`).</td></tr><tr><td>`items[].unit_value`</td><td align="right">number</td><td align="center">Sim</td><td>Preço unitário vigente no PDV (antes de desconto).</td></tr><tr><td>`registration`</td><td align="right">string</td><td align="center">Sim</td><td>Identificação do cliente para o parceiro. **Ex.: CPF** (somente números).</td></tr></tbody></table>

> **Boas práticas:**
> 
> - Enviar `unit_value` já no **valor de venda** do PDV; o parceiro retornará descontos/propostas.
> - Se houver mix de unidades (ex.: peso/quilagem), alinhar previamente com o parceiro como enviar e arredondar.

### Response — Exemplo

```json
{
  "response": {
    "code": 200,
    "discounts": {
      "products": [],
      "subtotal": 0.0
    },
    "shop_id": "0909092413",
    "user": {
      "address": {
        "adjunct": "",
        "city": "Belo Horizonte",
        "district": "Santa Efigênia",
        "number": 131,
        "phone": "(31) 33333-3333",
        "state": "Minas Gerais",
        "street": "Avenida Brasil",
        "zipcode": "30140-000"
      },
      "name": "Heberth Minelli",
      "st_token": "11177821-d40a-40f8-9b58-9f50978682a9",
      "total_balance": 100.0,
      "total_points": 1969
    }
  }
}

```

### Significado dos campos (response)

<table id="bkmrk-campo-tipo-descri%C3%A7%C3%A3o"><thead><tr><th>Campo</th><th align="right">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>`response.code`</td><td align="right">number</td><td>Código de status interno do parceiro (200 = sucesso). Não substitui o HTTP status.</td></tr><tr><td>`response.discounts.products`</td><td align="right">array</td><td>Detalhes de descontos por produto (quando aplicável).</td></tr><tr><td>`response.discounts.subtotal`</td><td align="right">number</td><td>Desconto total a ser aplicado no **subtotal** do carrinho (se houver).</td></tr><tr><td>`response.shop_id`</td><td align="right">string</td><td>Identificador da loja/estabelecimento no parceiro.</td></tr><tr><td>`response.user`</td><td align="right">objeto</td><td>Dados do cliente no ecossistema do parceiro (endereços, saldos, pontos).</td></tr><tr><td>`response.user.st_token`</td><td align="right">string</td><td>Token de sessão/identificação do cliente no parceiro (usar conforme política do parceiro).</td></tr><tr><td>`response.user.total_balance`</td><td align="right">number</td><td>Saldo monetário de benefícios (se aplicável).</td></tr><tr><td>`response.user.total_points`</td><td align="right">number</td><td>Pontos acumulados (se aplicável).</td></tr></tbody></table>

> **Aplicação no PDV:** o PDV pode aplicar descontos retornados (por item e/ou subtotal) e exibir dados do cliente (nome, pontos, etc.), conforme regras da loja.

---

## 2) Envio da Venda (pós-fechamento)

**Endpoint (exemplo):**

```
POST https://{host-parceiro}/admin/api/v2/sales

```

> O caminho acima é **exemplo**. Alguns parceiros usam `/shops/sales`, `/orders`, etc. Alinhe o endpoint definitivo na homologação.

### Request — Corpo (exemplo)

```json
{
  "discounts": [],
  "items": [
    {
      "category": "046",
      "code": "00000000000017",
      "product_name": "CREME AMEND ALMOND B",
      "quantity": 1.0,
      "subcategory": "241",
      "total_value": 6.99,
      "unit_type": "um",
      "unit_value": 6.99
    },
    {
      "category": "048",
      "code": "00000000000031",
      "product_name": "LEITE UHT PIRACANJUB",
      "quantity": 1.0,
      "subcategory": "269",
      "total_value": 1.0,
      "unit_type": "um",
      "unit_value": 1.0
    }
  ],
  "payment": {
    "coupon": "02290621.99",
    "date": "2025-09-09T11:12:20",
    "paymethod": [
      { "paymethod": 1, "value": 7.99 }
    ],
    "total": 7.99
  },
  "registration": "05940778690"
}

```

### Significado dos campos (request)

<table id="bkmrk-campo-tipo-obrigat%C3%B3r-1"><thead><tr><th>Campo</th><th align="right">Tipo</th><th align="center">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td>`discounts`</td><td align="right">array</td><td align="center">Opcional</td><td>Lista de descontos efetivamente aplicados na venda (quando o parceiro exige detalhar).</td></tr><tr><td>`items`</td><td align="right">array</td><td align="center">Sim</td><td>Itens efetivamente vendidos. Campos seguem a semântica da consulta, com **adição** de `total_value`.</td></tr><tr><td>`items[].total_value`</td><td align="right">number</td><td align="center">Sim</td><td>Valor total do item (já considerando quantidade e descontos).</td></tr><tr><td>`payment`</td><td align="right">objeto</td><td align="center">Sim</td><td>Dados do pagamento da venda.</td></tr><tr><td>`payment.coupon`</td><td align="right">string</td><td align="center">Recomendado</td><td>Identificador do cupom/ECF/NSU no PDV (para auditoria).</td></tr><tr><td>`payment.date`</td><td align="right">string (ISO-8601)</td><td align="center">Sim</td><td>Data/hora de fechamento da venda no PDV (ex.: `YYYY-MM-DDThh:mm:ss`).</td></tr><tr><td>`payment.paymethod[]`</td><td align="right">array</td><td align="center">Sim</td><td>Parcelas/meios de pagamento utilizados.</td></tr><tr><td>`payment.paymethod[].paymethod`</td><td align="right">number/string</td><td align="center">Sim</td><td>Código do meio de pagamento (tabela acordada com o parceiro).</td></tr><tr><td>`payment.paymethod[].value`</td><td align="right">number</td><td align="center">Sim</td><td>Valor pago com o respectivo meio.</td></tr><tr><td>`payment.total`</td><td align="right">number</td><td align="center">Sim</td><td>Total da venda (soma dos pagamentos).</td></tr><tr><td>`registration`</td><td align="right">string</td><td align="center">Sim</td><td>Identificação do cliente no parceiro (ex.: CPF).</td></tr></tbody></table>

> **Conciliação:** `payment.total` deve bater com a soma de `paymethod[].value`. Para múltiplos meios, adicione entradas no array.

### Response — Exemplo

```json
{
  "response": {
    "balance": 0.0,
    "code": 200,
    "future_balance": 0.0,
    "points": 8,
    "user": {
      "address": {
        "adjunct": "",
        "city": "Belo Horizonte",
        "district": "Santa Efigênia",
        "number": 131,
        "phone": "(31) 33333-3333",
        "state": "Minas Gerais",
        "street": "Avenida Brasil",
        "zipcode": "30140-000"
      },
      "name": "Heberth Minelli",
      "st_token": "11177821-d40a-40f8-9b58-9f50978682a9",
      "total_balance": 100.0,
      "total_points": 1977
    }
  }
}

```

### Significado dos campos (response)

<table id="bkmrk-campo-tipo-descri%C3%A7%C3%A3o-1"><thead><tr><th>Campo</th><th align="right">Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>`response.code`</td><td align="right">number</td><td>Código de processamento no parceiro (200 = sucesso).</td></tr><tr><td>`response.points`</td><td align="right">number</td><td>Pontos concedidos na venda.</td></tr><tr><td>`response.balance`</td><td align="right">number</td><td>Saldo monetário utilizado/remanescente após a venda (quando aplicável).</td></tr><tr><td>`response.future_balance`</td><td align="right">number</td><td>Saldo futuro (benefícios liberados em D+N, quando houver).</td></tr><tr><td>`response.user.total_points`</td><td align="right">number</td><td>Pontos totais do cliente **após** a venda.</td></tr><tr><td>`response.user.total_balance`</td><td align="right">number</td><td>Saldo total do cliente **após** a venda (quando aplicável).</td></tr></tbody></table>

---

## Considerações de implementação (PDV)

- **Idempotência:**
    
    
    - Recomenda-se enviar um **identificador único** por venda (ex.: `payment.coupon` + data) e, se o parceiro suportar, um cabeçalho `Idempotency-Key` para evitar lançamentos duplicados em reenvios.
- **Tratamento de erros:**
    
    
    - Mapear HTTP status (ex.: `4xx/5xx`) e também `response.code` do corpo quando houver. Implementar retentativas **somente** para erros transitórios.
- **Encoding:**
    
    
    - Garantir UTF-8 para nomes de produtos e logradouros; caso o parceiro retorne acentos com encoding incorreto, normalizar para exibição no PDV.
- **Tabelas de referência:**
    
    
    - `paymethod` (meios de pagamento) e eventuais códigos de categoria/subcategoria devem ser alinhados e versionados entre PDV e parceiro.
- **Segurança:**
    
    
    - Armazenar `X-AdminUser-Token` em cofre seguro. Nunca registrar token em logs de nível INFO/DEBUG.
- **Observabilidade:**
    
    
    - Logar request-id, latência, tamanho de payload e resumo do resultado (sem PII sensível) para facilitar diagnósticos.

---

## Anexos — Arquivos de exemplo

### `inicia_parceiro.json`

```json
{
  "items": [
    {
      "category": "046",
      "code": "00000000000017",
      "product_name": "CREME AMEND ALMOND B",
      "quantity": 1.0,
      "subcategory": "241",
      "unit_type": "um",
      "unit_value": 6.99
    }
  ],
  "registration": "05940778690"
}

```

### `retorno_consulta.json` (amostra)

```json
{
  "response": {
    "code": 200,
    "discounts": { "products": [], "subtotal": 0.0 },
    "shop_id": "0909092413",
    "user": {
      "name": "Heberth Minelli",
      "st_token": "11177821-d40a-40f8-9b58-9f50978682a9",
      "total_balance": 100.0,
      "total_points": 1969
    }
  }
}

```

### `venda_enviada.json`

```json
{
  "discounts": [],
  "items": [
    {
      "category": "046",
      "code": "00000000000017",
      "product_name": "CREME AMEND ALMOND B",
      "quantity": 1.0,
      "subcategory": "241",
      "total_value": 6.99,
      "unit_type": "um",
      "unit_value": 6.99
    },
    {
      "category": "048",
      "code": "00000000000031",
      "product_name": "LEITE UHT PIRACANJUB",
      "quantity": 1.0,
      "subcategory": "269",
      "total_value": 1.0,
      "unit_type": "um",
      "unit_value": 1.0
    }
  ],
  "payment": {
    "coupon": "02290621.99",
    "date": "2025-09-09T11:12:20",
    "paymethod": [ { "paymethod": 1, "value": 7.99 } ],
    "total": 7.99
  },
  "registration": "05940778690"
}

```

### `retorno_venda.json` (amostra)

```json
{
  "response": {
    "balance": 0.0,
    "code": 200,
    "future_balance": 0.0,
    "points": 8,
    "user": {
      "name": "Heberth Minelli",
      "st_token": "11177821-d40a-40f8-9b58-9f50978682a9",
      "total_balance": 100.0,
      "total_points": 1977
    }
  }
}

```

---

## Checklist de Homologação

- [ ]  [ ]  Confirmar **endpoints definitivos** (consulta e venda) e autenticação.
- [ ]  [ ]  Validar **mapeamento de `paymethod`** (códigos e formas aceitas).
- [ ]  [ ]  Verificar regras de **arredondamento** e casas decimais em itens/descontos.
- [ ]  [ ]  Ensaiar cenários com **múltiplos meios de pagamento** e cancelamento/estorno (se aplicável).
- [ ]  [ ]  Testar comportamento **offline/timeout** e diretrizes de reenvio (com idempotência).

---

> **Observação:** os exemplos de dados (CPF, nomes, tokens, códigos) são **fictícios** e servem apenas para demonstração. Substitua por valores reais na sua integração.