INTEGRAÇÃO ITAP
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.

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:
-
Preparação: A mesa deve ser aberta previamente no PDV, com o cliente e seu respectivo cartão RFID já vinculados ao atendimento.
-
Lançamento: Quando o cliente realiza um pedido pelo Cardápio Digital ou Smart Menu, este item é direcionado automaticamente para a mesa correspondente.
-
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.
-
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>
-
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
-
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
-
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
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
Para consultar e finalizar consumações acesse a opção CONSUMOS ITAP
APRESENTAÇÃO INTEGRAÇÕES TAPP
Apresentação Integrações Tapp - Clique aqui!