# INTEGRAÇÃO MY TAPP

# INTEGRAÇÃO MYTAPP

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

Sim, para utilizar a integração com MYTAPP 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.

[![image.png](https://manual.cplug.com.br/uploads/images/gallery/2023-12/scaled-1680-/qgSHKc8N3BpUdEaq-image.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-12/qgSHKc8N3BpUdEaq-image.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:**

- - Atualmente existe uma limitação na integração do MYTAPP em relação a atributos. Os atributos não são exportados para o MYTAPP automaticamente, quando a integração é realizada, portanto a inserção dos códigos de integração dos atributos devem ser inseridos manualmente. **O código precisa ser nesse formato por exemplo: " att-784-27 ", sem o schema.**

---

##### **⚙️ 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 MyTapp/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 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>**Cadastro/Vínculo RFID**</span></td><td style="width:102.986px;"><span>✅ Sim</span></td><td style="width:145px;"><span>❌ Não</span></td><td style="width:168.993px;"><span>❌ Não</span></td><td style="width:233.993px;"><span>❌ Não</span></td></tr><tr><td style="width:171.997px;"><span>**Compra/Consulta Saldo**</span></td><td style="width:102.986px;"><span>✅ Sim</span></td><td style="width:145px;"><span>✅ Sim</span></td><td style="width:168.993px;"><span>❌ Não</span></td><td style="width:233.993px;"><span>❌ Não</span></td></tr><tr><td style="width:171.997px;"><span>**Lançamento de Itens**</span></td><td style="width:102.986px;"><span>✅ Sim</span></td><td style="width:145px;"><span>✅ Sim</span></td><td style="width:168.993px;"><span>✅ Sim</span></td><td style="width:233.993px;"><span>✅ Sim (Geral) - Não debita saldo</span></td></tr><tr><td style="width:171.997px;"><span>**Integração MyTapp**</span></td><td style="width:102.986px;"><span>✅ Sim</span></td><td style="width:145px;"><span>✅ Sim</span></td><td style="width:168.993px;"><span>✅ Sim</span></td><td style="width:233.993px;"><span>❌ **Não**</span></td></tr></tbody></table>

#####  

---

#####  

##### **👣 Solicitação/Ativação da Integração**

- Para realizar a integração CPLUG + MYTAPP,  **é necessário solicitar as credenciais enviando um e-mail para: <integracao@mytapp.com.br>**
- **Para inserir as credenciais nos campos**, se faz necessário solicitar a liberação para Agatha ou Giorgio.
- <span style="font-size:1.4em;font-weight:400;">Com as credenciais recebidas, insira no endereço abaixo da respectiva conta: </span>**<span style="color:#0000ff;">[https://www.connectplug.com.br/sistema/configuracoes-mytapp](https://www.connectplug.com.br/sistema/configuracoes-mytapp)</span>**

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

---

#####  

##### **👣 Cadastro de Produto:** 

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

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

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

---

#####  

##### **👣 Acesso a retaguarda MYTAPP**

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

<p class="callout info">Utilize o endereço: [https://cplug.mytapp.com.br/](https://cplug.mytapp.com.br/) para acessar o sistema de retaguarda</p>

---

#####  

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

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

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

---

#####  

##### **✨ Recursos diferenciais:**

- No cenário **MULTI-EMPRESA** é possível inserir o ID da filial na configuração com MYTAPP
- É possível utilizar a função **lista de preço**. A lista de preço deve estar configurada para operar com as funções da frente de caixa ou autoatendimento, uma vez que é possível utilizar MYTAPP com autoatendimento. Apesar de considerarmos o MYTAPP uma integração, a lista de preço não deve estar configurada com o módulo de integração.
- Existe a possibilidade de conceder desconto em um consumo MYTAPP do tipo pós-pago, na tela de consumos MYTAPP, no PDV. Isso possibilita encontrar um consumo e conceder um desconto diretamente nessa tela.
- Na tela de **CONSUMOS** é possível realizar a impressão de consumos

# APRESENTAÇÃO INTEGRAÇÕES TAPP

##### [-----------&gt; ACESSE AQUI APRESENTAÇÃO COMPLETA SOBRE TODAS AS INTEGRAÇÕES TAPP](https://drive.google.com/file/d/1u9zNLSmxJzMtIdxqk-smP8wcRqcJ0SuB/view?usp=drive_link)

[![INTEGRAÇÕES-TAPP-(1).png](https://manual.cplug.com.br/uploads/images/gallery/2024-05/scaled-1680-/Q1dqiRFUUMHqKNjY-INTEGRA%C3%87%C3%95ES-TAPP-(1).png)](https://manual.cplug.com.br/uploads/images/gallery/2024-05/Q1dqiRFUUMHqKNjY-INTEGRA%C3%87%C3%95ES-TAPP-(1).png)

---

##### **Vídeo de Apresentação:**

**<iframe height="449" src="https://www.youtube.com/embed/OLlKgZwWPSA?list=PL51ST4_8jgo6BBAJPU7mz1ClpUHPtg0RH" width="800"></iframe>**