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