Sumário

Conceito

Esta implementação tem o objetivo de disponibilizar aos clientes a integração entre o Terminal Comanda e o Beerpass - Autosserviço de chopp e bebidas, no PDV Linx Empório POS e Retaguarda Empório.

O self-service de chopp do Beerpass permite que os próprios clientes do estabelecimento acionem as torneiras de chopp através da leitura do cartão pelos dispositivos instalados. A venda é realizada por ML de chopp, diminuindo o desperdício e proporcionando autonomia para o consumidor. No PDV, ao realizar a abertura, será executado o serviço beerpass.exe, que irá realizar a consulta das comandas em aberto para atualizar o status.

Abaixo, veja as informações sobre como habilitar esta integração e como é seu funcionamento.

Pré-requisitos

Para habilitar esta integração e poder usar esta funcionalidade, há alguns pré-requisitos a serem atendidos. Veja:

  • Possuir o módulo Integração Beerpass liberado na chave do cliente;
  • O parâmetro Integração com Beerpass precisa estar Ativo no Retaguarda Empório;
  • Fazer a configuração de autenticação da loja no Retaguarda;
  • Fazer o cadastro dos cartões comanda com RFID no Retaguarda;
  • Fazer o cadastro do produto no Retaguarda como Mililitro, vinculando o código no campo ID Integração do Beerpass;
  • O PDV Linx Empório POS precisa estar na versão 1.1.0.79 ou superior.

Como habilitar esta funcionalidade

Veja mais detalhes referentes aos pré-requisitos para habilitar a integração com o Beerpass - Autosserviço de chopp e bebidas.

Chave na Intranet

O módulo Integração Beerpass precisa estar liberado na chave do cliente, conforme imagem de exemplo abaixo:

Chave na Intranet

Parâmetro de integração no Retaguarda

No Retaguarda, o parâmetro Integração com Beerpass precisa estar Ativo, ou seja, com o valor igual a 1.

  • Parâmetro Ativo: valor definido como 1;
  • Parâmetro Inativo: valor definido como 0.

Veja a imagem de exemplo:

Parâmetro de integração no Retaguarda

Configuração da loja no Retaguarda

Faça a configuração de autenticação da loja na guia Beerpass, definindo:

  • Forma de pagamento padrão;
  • Token da Loja;
  • ID da Loja;
  • Código Produto Adicional;
  • Regra de formação de preço sugerido; e
  • Valor.

Essa configuração é feita no menu Cadastros > Estabelecimento > Estabelecimento, Estabelecimento > Conf. Delivery.

Veja a imagem de exemplo:

Configuração da loja

Cadastro do cartão comanda no Retaguarda

Os cartões do Beerpass utilizam a tecnologia RFID. Para fazer o cadastro, é necessário pegar o código de cada cartão e vincular a um cartão comanda no sistema, para que seja possível identificar o cartão e a comanda. Para fazer esse vínculo, acesse o menu Cadastro > Estabelecimento > Cartões Comanda. Dentro do menu, é possível incluir novas comanda ou alterar as comandas já existentes.

O código de cada cartão do Beerpass deve ser configurado no campo RFID de cada comanda.

Importante

  • O preenchimento do campo RFID não é obrigatório, porém, caso ele seja preenchido, é necessário digitar 10 números;
  • O campo RFID aceita somente números inteiros.

Veja a imagem de exemplo:

Cadastro do cartão comanda

Cadastro de produto

Para esta integração, torna-se necessário fazer o cadastro do produto no gerenciador Beerpass, vinculando o código do produto do Retaguarda no campo ID Integração. A unidade de venda do produto, por sua vez, deve ser Mililitro (ML).

Confira a imagem de exemplo:

Cadastro de produto

No PDV

Todas os cadastros feitos são sincronizados para o PDV e, ao abrir o PDV, será feito o start no serviço beerpass.exe. Com esse serviço sendo processado, o PDV irá atualizar na guia Comanda, as comandas recebidas com o consumo de chopp das torneiras.

Veja a imagem de exemplo:

Importante

O serviço beerpass.exe também irá consultar se as comandas vindas do Retaguarda já existem no Beerpass. Caso não exista, será feita a criação, conforme a API de comunicação.

Utilizando esta funcionalidade

Veja as informações referentes à utilização desta funcionalidade.

Cenário 1: Consumo + Beerpass

Abertura de comanda no PDV

A abertura da comanda no PDV esta condicionada ao lançamento de um item. Ao lançar um item, o PDV irá questionar se deseja abrir a comanda (imagem de exemplo 1). Ao abrir a comanda, o sistema faz a seguinte validação:

  • Consulta se a comanda já existe no Beerpass:
    • Caso não exista, a comanda será criada;
    • Caso já exista a comanda, o sistema irá verificar se a comanda está em uso. Caso a comanda não esteja em uso, o sistema irá atualizar o status da comanda para Em uso.

Quando são adicionados itens na comanda que têm vínculo com o Beerpass, ao salvar a comanda, é enviada uma atualização de consumo para o Beerpass.

Imagem de exemplo 1: abertura de comanda

Comanda em aberto no PDV

Quando uma comanda está em uso, é realizada uma consulta no Beerpass para atualizar o status da comanda (imagem de exemplo 2):

  • Caso haja consumo, o item será adicionado à comanda automaticamente;
  • Somente será atualizado o consumo daqueles itens vinculados ao Beerpass. Isso ocorre através do campo ID integração (imagem de exemplo 3);
  • Os produtos não vinculados ao Beerpass não sofreram nenhuma alteração na comanda.

O sistema envia a atualização de consumo/status ao Beerpass, quando:

  • É feita a adição de itens da comanda (caso seja um item vinculado ao Beerpass, envia o consumo);
  • É feita a exclusão de itens da comanda;
  • É feita a baixa de itens da comanda.

Quando ocorre uma transferência de comanda, o comportamento do sistema é o seguinte:

  • O status é alterado e enviado o consumo para a nova comanda no Beerpass;
  • Somente é enviado o consumo para o Beerpass quando há produtos que tenham vínculo;
  • O status da comanda anterior é retirado de uso.

Imagem de exemplo 2: comanda em aberto


Imagem de exemplo 3: comanda em aberto

Baixar comanda

Ao finalizar a baixa da comanda, o comportamento é o seguinte:

  • É feita a atualização de status da comanda no Beerpass;
  • É feita a atualização do consumo, retirando o produto da comanda no Beerpass.

Veja a imagem de exemplo:

Baixar comanda

Cancelamento de comanda

Ao fazer o cancelamento de uma comanda, o status retorna para Aberto em tela. Nesse caso, o status e o consumo são atualizados no Beerpass.

Cenário 2: Somente Beerpass

Abertura da comanda

A comanda é criada pelo PDV no Beerpass, onde o sistema busca pelo RFID vinculado a uma comanda do PDV.

Com o cartão comanda em mãos, ao acionar a torneira de chopp (imagem de exemplo abaixo):

  • O sistema Beerpass busca a comanda cadastrada através do RFID;
  • O sistema Beerpass faz a atualização de status da comanda;
  • O sistema Beerpass atualiza o consumo da comanda.

Importante

  • O PDV fica buscando as atualizações das comandas através do serviço beerpass.exe;
  • Caso haja alguma comanda com o status Em uso e com consumo, o sistema irá salvar como comanda Em aberto no PDV;
  • Ao fazer abertura da comanda pelo Beerpass, não será exibida a tela de abertura de comanda no PDV.

No Terminal Comanda

No Terminal Comanda, os comportamentos são os mesmos do PDV, sendo:

  • Abertura de comanda (imagem de exemplo 1);
  • Adicionar item em comandas já abertas (imagem de exemplo 2);
  • Cancelar a comanda (imagem de exemplo 3);
  • Transferir os itens para outra comanda (imagem de exemplo 3).

Imagem de exemplo 1



Imagem de exemplo 2



Imagem de exemplo 3

No Totem de Autoatendimento

No Totem de Autoatendimento, os comportamentos são os mesmos do PDV, sendo:

  • Abertura de comanda (imagem de exemplo 1);
  • Adicionar item em comandas já abertas (imagem de exemplo 2);
  • Fazer a baixa da comanda (imagem de exemplo 2).

Imagem de exemplo 1: Totem de Autoatendimento



Imagem de exemplo 2: Totem de Autoatendimento

Consumo pré-pago

Esta modalidade dá, ao usuário, a possibilidade de consumir com cartões pré-pagos Beerpass. Os cartões pré-pagos, por sua vez, não estão vinculados ao cadastro de comandas internas.

Veja mais informações sobre esta modalidade:

Consumir pré-pago

Nas configurações de loja do Retaguarda, há a forma de pagamento Crédito Beerpass (imagem de exemplo 1):

  • Caso o sistema não apresente a forma de pagamento cadastrada, o PDV irá exibir a seguinte mensagem no momento da baixa: Forma de pagamento padrão Beerpass pré-pago não configurada;
  • O sistema irá fazer a validação da forma de pagamento Crédito Beerpass no item, referente ao totalizador demonstrado no totem.

O sistema irá buscar os consumos que não possuem o RFID vinculado às comandas (essa rotina é executada de tempos em tempos através de uma API). Esses consumos sem vínculos, por sua vez, são tratados como cartão pré-pago. Com isso, o sistema valida se já possui um código vinculado a uma comanda interna:

  • Se Sim: o sistema abre a comanda que apresenta o código vinculado;
  • Se Não: o sistema traz o cartão pré-pago, saldo e seus consumos, vinculando a uma comanda do lote de comanda reservado para isso (imagem de exemplo 2).
    • O RFID do cartão pré-pago é adicionado no lugar do número na comanda e exibido no card (imagem de exemplo 3);
    • O sistema vincula a forma de pagamento Crédito Beerpass para a baixa.

Veja as imagens de exemplo:

Imagem de exemplo 1: Crédito Beerpass


Imagem de exemplo 2: Consumo pré-pago


Imagem de exemplo 3: Consumir pré-pago

Abertura de consumo pré-pago

O PDV dá a possibilidade de efetuar a abertura da comanda pré-paga e envio de consumo, caso o cliente vá consumir direto no PDV antes de passar nas torneiras. Nesse caso, o sistema se comporta da seguinte maneira:

  • Consulta se o RFID existe no Beerpass e abre o cartão vinculando a uma comanda do lote reservado para isso. Caso não exista o cartão do lote reservado, o sistema apresenta a mensagem Comanda não encontrada;
  • O consumo é enviado para o cartão:
    • Ao lançar um item na comanda pré-paga: o PDV envia o consumo para o Beerpass que, por sua vez, irá validar o saldo:
      • Com saldo: inclui um item na comanda e atualiza o campo Saldo pré-pago;
      • Sem saldo: apresenta a mensagem Saldo insuficiente, faça uma nova recarga (imagem de exemplo 1).

Caso o cliente vá direto nas torneiras Beerpass, a abertura e consumo serão lançados diretamente pelo hardware.

Imagem de exemplo 1: Adicionar produtos no pré-pago

Exibir saldo pré-pago

Na tela de dentro da comanda, há o totalizador Saldo pré-pago R$, que demonstra o valor do saldo. Nessa tela:

  • Valor total: totaliza o valor a pagar;
  • Valor Pago: totaliza o valor que já esta pago. Os itens consumidos no pré-pago consumiram o saldo, totalizando também no valor pago;
  • Saldo pré-pago: totaliza o saldo atualizado do cartão pré-pago:
    • Esse valor atualizado é retornado e validado pela API Beerpass;
    • Esse campo aparece somente:
      • Quando o parâmetro Integração Beerpass está ativo e as comandas s]ao do tipo pre.
  • Subtotal: totaliza o valor dos consumos. Pela regra, os cartões pré-pagos irão consumir somente quando houver saldo. Sendo assim, não gerando valor a pagar no PDV.

Veja a imagem de exemplo:

Exibição do saldo pré-pago

Pesquisar pré-pago

Caso deseje, pode-se fazer a pesquisa por cartão pré-pago. Para isso, basta teclar F9 (imagem de exemplo 1). Pode-se pesquisar por:

  • Número da comanda;
  • Número RFID (dez dígitos):
    • O número é capturado via leitor RFID, disponibilizado pela Beerpass (cuja entrada de texto é similar ao leitor de código de barras);
    • O sistema também dá a possibilidade de digitar o código manualmente;
    • Ao consultar o RFID e não encontrar, a mensagem Comanda não encontrada é exibida (imagem de exemplo 3).

Na guia Comanda, no campo Pesquisa comanda, o sistema possui o mesmo comportamento da janela de pesquisa, pesquisando pelo RFID também (imagem de exemplo 2).

Imagem de exemplo 1: pesquisar pré-pago


Imagem de exemplo 2: pesquisar pré-pago



Imagem de exemplo 3: pesquisar pré-pago

Baixar pré-pago

Ao dar baixa na comanda, o sistema leva a forma de pagamento Crédito Beerpass. Dessa forma, o PDV, por sua vez, entende que com essa forma de pagamento não há cobrança do usuário.

No registro do cupom, segue o mesmo código SEFAZ já utilizado por outros deliveries, sendo:

  • NFCe: Código 19 (Programa de fidelidade, Cashback, Crédito Virtual);
  • CFe: Código 99 (Outros).

No Terminal Comanda

No Terminal Comanda, também há a pesquisa pelo RFID (imagem de exemplo 1), sendo o mesmo comportamento do PDV, onde pode-se:

  • Digitar o código manual;
  • Usar o leitor de RFID.

O sistema exibe o RFID no lugar do número da comanda, tendo:

  • Comandas Abertas (imagem de exemplo 2);
  • Comandas Pendentes (imagem de exemplo 3).

Para visualizar o saldo, há o totalizador Saldo pré-pago na tela de comandas abertas (imagem de exemplo 4). No lançamento de um item na comanda pré-paga, o Terminal possui o mesmo comportamento do PDV (imagem de exemplo 5), retornando à tela da comanda aberta, onde demonstra o Saldo pré-pago.

Imagem de exemplo 1


Imagem de exemplo 2: Comandas Abertas


Imagem de exemplo 3: Comanda Pendentes



Imagem de exemplo 4: totalizador Saldo pré-pago



Imagem de exemplo 5

Importante

Por se tratar de uma comanda pré-paga, onde o crédito é vinculado a um cartão e cliente externo, quando o parâmetro Integração Beerpass está ativo e o cartão é do tipo pre, o sistema não exibe os botões TransferirMesclar.

No Totem de Autoatendimento

No Totem de Autoatendimento, a comanda pode ser consultada (imagem de exemplo 1):

  • Por número;
  • Por RFID, onde:
    • Pode-se digitar manualmente o código (10 dígitos);
    • Pode-se usar o leitor RFID.

No Totem, a comanda é exibida no checkout (imagem de exemplo 2). Veja as informações:

  • 1 - Número RFID da comanda pré-paga;
  • 2 - Totalizadores:
    • Saldo Pré-pago: refere-se ao saldo atualizado da comanda pré-paga;
    • Valor Pago: refere-se à soma dos valores dos itens consumidos dentro da comanda pré-paga;
    • Valor Total: refere-se ao valor a pagar.

A adição de produtos no Totem se dá da seguinte forma:

  • No Totem, o produto é adiciona fora da comanda;
  • O produto adicionado fora da comanda pré-paga será cobrado normalmente no Totem;
  • O Totem exibe como o valor pago (itens consumidos na comanda pré-paga);
  • No Valor Total, é apresentado somente o valor a pagar dos itens adicionados fora da comanda pré-paga.

Veja as informações referentes ao pagamento:

  • Quando houver itens adicionados fora da comanda: o sistema efetua a soma desses e demonstra no Valor Total para pagamento no Totem;
  • Quando houver somente a comanda pré-paga:
    • É exibido o Valor Total como R$ 0,00;
    • Não irá cobrança do cliente;
    • Irá registrar a forma de pagamento como Crédito Beerpass;
    • Irá emitir cupom registrando os itens da comanda.

Imagem de exemplo 1: consulta da comanda


Imagem de exemplo 2:

Imagem de exemplo 3:

  • Sem rótulos