# INTEGRAÇÃO BEERPASS

##### **Módulo pago?**

Sim, para utilizar a integração com BEERPASS se faz necessário contratar o módulo de **Integração Tap.**

---

#####  

##### **O que é um sistema de autosserviço de CHOPP?**

O autosserviço de chopp é um sistema que permite ao cliente se servir diretamente das torneiras.

[![BEERPASS.PNG](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/Y7mgABFYZIbK5Fut-BEERPASS.PNG)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/Y7mgABFYZIbK5Fut-BEERPASS.PNG)

---

#####  

##### **Este sistema é composto pelos seguintes componentes:**

**Torneira -&gt;**  
A torneira do autosserviço de chopp é semelhante àquela utilizada em chopeiras convencionais encontradas nos bares, conectada a uma linha que extrai o chopp de uma câmara fria. No entanto, ao invés de estar atrás do balcão, a parede de torneiras está ao alcance dos clientes, permitindo que eles se sirvam. Além disso, são necessários componentes adicionais para habilitar o autosserviço, como um controlador de fluxo, uma tela e um leitor de cartão RFID.

**Módulo -&gt;**  
Este componente é responsável por interagir com o cliente por meio da tela e do leitor de cartões.

**Leitor de Cartão RFID -&gt;**  
Para controlar as vendas e liberar o chopp na hora do serviço, é utilizado um cartão RFID. A escolha entre um cartão convencional ou uma pulseira é deixada a critério do cliente. Ao aproximar o cartão ou pulseira do leitor RFID, localizado em cada torneira de autosserviço, o cliente é identificado, vinculado à sua conta e a torneira é habilitada. O cartão RFID pode ser carregado com créditos, debitados a cada chopp servido, ou os gastos podem ser acumulados para pagamento posterior antes da saída.

**Tela -&gt;**  
Geralmente, acima de cada torneira há uma tela que informa ao cliente a quantidade de chopp sendo servida em mililitros. Além disso, a tela pode fornecer informações sobre o tipo de chopp que está sendo degustado.

---

##### **🚫Limitações:**

- - Não há possibilidade de utilização de produtos com atributos na integração

---

#####  **⚙️ Configuração Centralizada e Vínculo de Cartão**

É fundamental compreender que o **PDV Desktop** é a única interface autorizada para a realização do cadastro inicial de clientes e o vínculo de cartões RFID. Esta restrição de segurança garante a integridade dos dados financeiros do cliente.

- **Restrição:** Interfaces como o PDV Android, Smart TEF, Totens de Autoatendimento e Cardápio Digital **não possuem permissão** para realizar o cadastro ou o vínculo do cartão ao perfil do usuário.
- **Ação:** Qualquer operação de ativação de novo cartão deve ser direcionada obrigatoriamente ao caixa físico.

---

#####  **🤖 Operação via Totem de Autoatendimento**

Com a implementação do **CP Server**, o Totem de Autoatendimento passou a oferecer uma experiência completa de consumo para o cliente final. Através desta interface, o usuário que já possui um cartão vinculado pode:

- Realizar a **visualização do saldo** atual em tempo real.
- Efetuar a **compra de novos saldos/créditos** diretamente no terminal.
- Finalizar a **compra de produtos** utilizando o saldo disponível no RFID.

---

#####  **🍽️ Fluxo de Pedidos em Mesa (Cardápio Digital e Smart Menu)**

Diferente do Totem, os aplicativos de mesa funcionam como lançadores de pedidos. O fluxo operacional segue uma lógica de vinculação prévia:

1. **Preparação:** A mesa deve ser aberta previamente no PDV, com o cliente e seu respectivo cartão RFID já vinculados ao atendimento.
2. **Lançamento:** Quando o cliente realiza um pedido pelo Cardápio Digital ou Smart Menu, este item é direcionado automaticamente para a mesa correspondente.
3. **Baixa de Saldo (Pré-pago):** Caso o cliente utilize a modalidade pré-paga, o sistema processa o débito do saldo de forma automática assim que o pedido entra no sistema.
4. **Finalização (Pós-pago):** Na modalidade pós-paga, os itens acumulados na mesa são pagos integralmente no momento do fechamento, utilizando o registro do cliente.

---

#####  **📱 Particularidades do PDV Android**

Diferente das outras interfaces, o **PDV Android não possui integração com o ecossistema Tapp/RFID**.

- **O que ele faz:** Permite a venda normal de produtos do tipo "Geral".
- **O que ele NÃO faz:** Não cadastra/vincula RFID, não consulta saldo e não realiza a baixa/débito automático no sistema MyTapp. É uma operação isolada da integração.

---

#####  **📊 Resumo de Disponibilidade Técnica**

<table data-path-to-node="19" id="bkmrk-funcionalidade-pdv-d" style="width: 823px;"><thead><tr><td style="width: 171.997px;">**Funcionalidade**</td><td style="width: 102.986px;">**PDV Desktop**</td><td style="width: 145px;">**Totem (Autoatend.)**</td><td style="width: 168.993px;">**Cardápio / Smart Menu**</td><td style="width: 233.993px;">**PDV Android**</td></tr></thead><tbody><tr><td style="width: 171.997px;"><span data-path-to-node="19,1,0,0">**Cadastro/Vínculo RFID**</span></td><td style="width: 102.986px;"><span data-path-to-node="19,1,1,0">✅ Sim</span></td><td style="width: 145px;"><span data-path-to-node="19,1,2,0">❌ Não</span></td><td style="width: 168.993px;"><span data-path-to-node="19,1,3,0">❌ Não</span></td><td style="width: 233.993px;"><span data-path-to-node="19,1,4,0">❌ Não</span></td></tr><tr><td style="width: 171.997px;"><span data-path-to-node="19,2,0,0">**Compra/Consulta Saldo**</span></td><td style="width: 102.986px;"><span data-path-to-node="19,2,1,0">✅ Sim</span></td><td style="width: 145px;"><span data-path-to-node="19,2,2,0">✅ Sim</span></td><td style="width: 168.993px;"><span data-path-to-node="19,2,3,0">❌ Não</span></td><td style="width: 233.993px;"><span data-path-to-node="19,2,4,0">❌ Não</span></td></tr><tr><td style="width: 171.997px;"><span data-path-to-node="19,3,0,0">**Lançamento de Itens**</span></td><td style="width: 102.986px;"><span data-path-to-node="19,3,1,0">✅ Sim</span></td><td style="width: 145px;"><span data-path-to-node="19,3,2,0">✅ Sim</span></td><td style="width: 168.993px;"><span data-path-to-node="19,3,3,0">✅ Sim</span></td><td style="width: 233.993px;"><span data-path-to-node="19,3,4,0">✅ Sim (Geral) - Não debita saldo</span></td></tr><tr><td style="width: 171.997px;"><span data-path-to-node="19,4,0,0">**Integração Tapp**</span></td><td style="width: 102.986px;"><span data-path-to-node="19,4,1,0">✅ Sim</span></td><td style="width: 145px;"><span data-path-to-node="19,4,2,0">✅ Sim</span></td><td style="width: 168.993px;"><span data-path-to-node="19,4,3,0">✅ Sim</span></td><td style="width: 233.993px;"><span data-path-to-node="19,4,4,0">❌ **Não**</span></td></tr></tbody></table>

#####  

---

#####  

##### **⚙️Solicitação/Ativação/Configuração da Integração**

- Para realizar a integração CPLUG + BEERPASS, solicite as credenciais (TOKEN e BEERPASS ID) no **grupo de WhatsApp: BEERPASS+CPLUG**

Caminho das telas abaixo: ERP&gt;Configurações&gt;Integrações&gt;Beerpass

[![beerpass_erp_integracoes.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/XpGXJ3CdVESCMrhT-beerpass_erp_integracoes.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/XpGXJ3CdVESCMrhT-beerpass_erp_integracoes.png)

- Na aba **CONFIGURAÇÕES PRINCIPAIS,** insira as credenciais: **TOKEN+BEERPASS ID**
- Na aba **OUTRAS CONFIGURAÇÕES** tenha a possibilidade de especificar:
    
    
    - - **Pós Pago:** Defina se o modelo de consumação será pós ou pré-pago, se **PÓS-PAGO,** defina se haverá finalização automática dos consumos e o respectivo tempo para isso e qual PDV deverá ser vinculado

---

#####  

##### **⚙️Acesso a retaguarda BEERPASS**

[![beerpass_retaguarda.PNG](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/iwgQ9bZQAWsIZbg9-beerpass_retaguarda.PNG)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/iwgQ9bZQAWsIZbg9-beerpass_retaguarda.PNG)

- Utilize o endereço: [https://gestao.beerpassclub.com.br/](https://gestao.beerpassclub.com.br/) para acessar o sistema de retaguarda

**Para vinculação ao barril e detalhes do chopp e de produtos do tipo GERAL, acesse as telas abaixo no PORTAL BEERPASS:**

[![beerpass_produto_geral.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/z4mVuucWiYyJYvLc-beerpass_produto_geral.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/z4mVuucWiYyJYvLc-beerpass_produto_geral.png)

[![beerpass_produto_chopp.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/X82XLACB1uR0ZhvW-beerpass_produto_chopp.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/X82XLACB1uR0ZhvW-beerpass_produto_chopp.png)

---

#####  

##### **⚙️Cadastro de Produto:** 

Caminho das telas abaixo: ERP&gt;Estoque&gt;Cadastros&gt;Produtos

[![beerpass_erp_cadatro_produto.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/TEt6E6b7rnwlHkgq-beerpass_erp_cadatro_produto.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/TEt6E6b7rnwlHkgq-beerpass_erp_cadatro_produto.png)

- Defina o tipo correto dos respectivos produtos:
    
    
    - - **Produto do tipo Chopp:** Produtos que são controlados e fornecidos por meio do autosserviço de chopp
        - **Produto geral:** Qualquer produto que não seja controlado pela plataforma BEERPASS

---

#####  

##### **⚙️Cadastro de Cliente:**

Caminho da tela abaixo: PDV 2&gt;Cadastro de Clientes

[![itap_cadastro_clientes_pdv.PNG](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/RnOcwjNrKYpm7fEX-itap_cadastro_clientes_pdv.PNG)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/RnOcwjNrKYpm7fEX-itap_cadastro_clientes_pdv.PNG)

**Os campos obrigatórios são:**

- **Nome**
- **Tipo de cliente:** Pessoa física, não é possivel cadastrar pessoa jurídica
- **CPF:** É obrigatório a inserção de um CPF válido
- **Data de Nascimento**
- **Integrações:** realizar a marcação em Integrações: **CLIENTE TAP**

---

#####  

##### **⚙️Consumações via PDV 2:**

Caminho da tela abaixo: PDV 2&gt;Consumações Beerpass[![beerpass_cadastro_consumos_pdv.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/tIxrOatqeUQHTJ8b-beerpass_cadastro_consumos_pdv.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/tIxrOatqeUQHTJ8b-beerpass_cadastro_consumos_pdv.png)

Para consultar e finalizar consumações acesse a opção **CONSUMOS BEERPASS**