# INTEGRAÇÃO ITAP # INTEGRAÇÃO ITAP ##### **Módulo pago?** Sim, para utilizar a integração com ITAP, 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. ![ITAP](https://manual.cplug.com.br/uploads/images/gallery/2023-11/scaled-1680-/gVN9bPEHI4laowUC-image-1700746534950.png) **Este sistema é composto pelos seguintes componentes:** **Torneira ->** 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 ->** Este componente é responsável por interagir com o cliente por meio da tela e do leitor de cartões. **Leitor de Cartão RFID ->** 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 ->** 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 exportação de produtos, integração deverá ser feita manualmente - Versão do PDV deverá ser a ***VERSÃO 2.10.0*** tanto do PDV como do CPSERVER - Não é possível utilizar cadastro de cliente de ***PESSOA JURÍDICA***, apenas pessoa física - O servidor ITAP trabalha exclusivamente de maneira local, não possuindo aplicação em nuvem --- ##### **⚙️ 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**
**Funcionalidade****PDV Desktop****Totem (Autoatend.)****Cardápio / Smart Menu****PDV Android**
**Cadastro/Vínculo RFID**✅ Sim❌ Não❌ Não❌ Não
**Compra/Consulta Saldo**✅ Sim✅ Sim❌ Não❌ Não
**Lançamento de Itens**✅ Sim✅ Sim✅ Sim✅ Sim (Geral) - Não debita saldo
**Integração Tapp**✅ Sim✅ Sim✅ Sim❌ **Não**
##### --- ##### ##### **⚙️ Configurações ITAP:** A configuração da conta e servidor ITAP é feita pelo ***TIME ITAP*** . O servidor deve ser configurado ***NA REDE LOCAL*** do cliente (não há servidor em nuvem). Com esta configuração finalizada o cliente deve informar o ***IP*** que será utilizado na integração. --- ##### ##### **⚙️Configuração de Integração:** *Caminho da tela abaixo: ERP>Configurações>Integrações>ITAP>* **[![image-(52).png](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/QtFyv14FEjsuXdT5-image-(52).png)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/QtFyv14FEjsuXdT5-image-(52).png)** **[![image-(51).png](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/MYn5mX2XFX88zmhl-image-(51).png)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/MYn5mX2XFX88zmhl-image-(51).png)** - Insira a ***URL DE INTEGRAÇÃO*** , que seria o IP informado pelo ***TIME ITAP*** seguido do endereço: ***/API/V1/CLIENTES/*** - O ***TOKEN*** utilizado será sempre 1 - Na aba ***OUTRAS CONFIGURAÇÕES*** , defina se o modelo de consumação do tipo ***PÓS PAGO*** será permitida, e esta mesma escolha ***deverá ser especificada no portal ITAP*** - Se a marcação ***FINALIZAR CONSUMOS PENDENTES AUTOMATICAMENTE*** for marcada com a opção ***SIM,*** defina o tempo limite para se finalizar os consumos e em qual PDV será vinculado os consumos --- ##### ##### **⚙️ Cadastro de Produto: Tipo GERAL** Caminho das telas abaixo: Plataforma ITAP>Produtos ERP CPLUG>Estoque>Produtos [![itap_cadastro_produto_geral.png](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/ZQiorUiavzWabMq3-itap_cadastro_produto_geral.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/ZQiorUiavzWabMq3-itap_cadastro_produto_geral.png) - A integração se dará por meio dos campos **SKU e VALOR DE VENDA** de ambas plataformas, que precisam ser **OBRIGATORIAMENTE IDÊNTICOS** - O cadastro na plataforma ITAP deverá ser feito pela opção **PRODUTOS** - Não existe padronização ou obrigatoriedade de campos na plataforma ITAP em produtos do **tipo GERAL** - O dado de SKU deve ser extraído da URL do **ERP CPLUG>Estoque>Produtos>Edição de Produto**, não deve ser utilizado o SKU exibido em CÓDIGO (SKU) no cadastro do produto, como mostra **no exemplo do print acima o SKU que deveria ser utilizado seria o 87** --- ##### ##### **⚙️ Cadastro de Produto: Tipo CHOOP/CERVEJA** Caminho das telas abaixo: Plataforma ITAP>Cadastro de Cervejas ERP CPLUG>Estoque>Produtos [![itap_cadastro_produto_chopp.png](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/e96zKGqXUxZ0JLDp-itap_cadastro_produto_chopp.png)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/e96zKGqXUxZ0JLDp-itap_cadastro_produto_chopp.png) - A integração se dará por meio dos campos **SKU e VALOR DE VENDA** de ambas plataformas, que precisam ser **OBRIGATORIAMENTE IDÊNTICOS** - O cadastro na plataforma ITAP deverá ser feito pela opção **CADASTRO DE CERVEJAS** - Todos campos na plataforma ITAP marcados como obrigatórios devem ser preenchidos - O dado de SKU deve ser extraído da URL do **ERP CPLUG>Estoque>Produtos>Edição de Produto**, não deve ser utilizado o SKU exibido em CÓDIGO (SKU) no cadastro do produto, como mostra **no exemplo do print acima o SKU que deveria ser utilizado seria o 88** --- ##### ##### **⚙️ Cadastro de Cliente:** Caminho da tela abaixo: PDV 2>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>Consumações ITAP[![itap_cadastro_consumos_pdv.PNG](https://manual.cplug.com.br/uploads/images/gallery/2023-08/scaled-1680-/cf9hKh56qL81TIcd-itap_cadastro_consumos_pdv.PNG)](https://manual.cplug.com.br/uploads/images/gallery/2023-08/cf9hKh56qL81TIcd-itap_cadastro_consumos_pdv.PNG) Para consultar e finalizar consumações acesse a opção **CONSUMOS ITAP**