Big Retail - P&D > Documentações > Documentações - QR Linx




Objetivo

Permitir a configuração e ativação da forma de recebimento QR Linx no PDV do produto Storex.


Conceito

O QR Linx é uma forma de recebimento que veio para facilitar a vida dos lojistas reduzindo atritos, melhorando a experiência do seu cliente e democratizando o acesso ao consumo. Ela permite o uso de várias carteiras, inclusive o PIX. 

O QR Linx permite ao cliente o pagamento de suas compras através de aplicativos apenas com a leitura do código gerado na finalização da venda. Com o QR Linx, o cliente evita o contato com dinheiro ou maquinetas de cartão e assim tem maior higiene e segurança ao realizar o seu pagamento.


Orientações Iniciais

  • Antes de iniciar a configuração, o usuário deve confirmar se a funcionalidade QR Linx, já se encontra disponível na versão instalada no ambiente do cliente, Na dúvida, deve consultar o gestor do projeto ou a equipe de P&D responsável pelo cliente.
  • Todos parâmetros mencionados neste documento deverão vir diretamente na versão.
  • Para efetuar um pagamento, via QR Linx, a loja deve possuir um cadastro junto ao Wallet HUB e cada PDV deve ter um RG individual.
  • Nas configurações a seguir serão mencionados os ambientes de HML e de Produção.


Premissas

  • Possuir acesso ao Portal Storex do cliente e usuário com perfil de acesso que permite o Cadastro de Forma de Ragamento. 
  • Definir uma tecla de acionamento para forma de recebimento QR Linx.
  • Credenciamento do cliente (CNPJ) junto à Linx Pay. Geralmente é feito junto ao time comercial. ATENÇÃO:  Sem a habilitação do CNPJ junto à Linx Pay, o WS NÃO retornará a carteira PIX para o PDV do cliente.
  • Acesso ao portal do cliente de Conciliação de Vendas. Geralmente é feito junto ao time comercial.


Liberação de Regras de Firewall

As URLs abaixo deverão ser liberadas para todas as lojas, de acordo com as seguintes instruções:

  • Portal de cliente:
    Estas URLs poderão ser liberadas aos usuários de loja ou somente para o Financeiro, ficando a critério do cliente. Elas permitem a consulta das transações efetivadas via QR Linx.
    PRD:  Portal de produção
    HML:  Portal Homologação.  


Cadastro de Evento de Recebimento QR Linx

Para concluir uma venda QR Linx será necessário criar uma nova Forma de Recebimento genérica. 
O código da forma varia de cliente para cliente, então deve ser solicitado a P&D. A descrição será QRLINX.
Se é usuário do PORTAL STOREX (Antigo), siga o documento normalmente.  Se já utiliza o NOVO PORTAL STOREX, então clique no link indicado para acesso às novas tela.

.

Novo Portal Storex



1. Acessar o Portal Storex do cliente.

2. Efetuar o login com Usuário e Senha autorizado ao acesso de cadastro de Forma de Recebimento. 



3. Após efetuar o login, acesse o caminho Cadastros/Formas de Recebimento/Genéricas.



4. Após clicar em Genéricas, em alguns ambientes pode ser apresentada a tela de segurança do Java. Marque o check-box e clique no botão RUN.,

  • O texto da mensagem pode variar de acordo com o idioma do Sistema Operacional, mas o botão será o mesmo, sendo RUN ou Executar, que em seguida será apresentada a tela de cadastro. 











 5. Para cadastrar uma nova Forma informe o código da forma e clique no botão + Novo ou clique somente no botão + Novo.  

  • Para o cadastro da forma QR Linx, informe o código definido por P&D para o cliente.



Aba Geral 


Esta aba permite a definição das regras gerais para o nova Forma de Recebimento Genérica. 































6. No tópico Configurações preencher os campos com os dados a seguir:

  • Descrição: QRLINX
  • Identificador da forma: QRLINX
  • Limite da Forma: 9.999.99.00
  • Fator de Pontos Extras: 0
  • Valor fixo: 0.00
























7. No tópico Troco, preencher os campos com os dados a seguir:

  • Valor: 0.00
  • Percentual: 0.00



Aba Moedas 

Esta aba permite a definição das moedas que serão aceitas pela forma genérica.






















8. A aba Moedas não deve ser preenchida.



Aba Dados 

Esta aba permite a definição relacionada à exibição dos valores e impressão de comprovante.




























9. A aba Dados deve permanecer com os valores default já definidos. Se houver algum valor diferente da imagem ao lado, faça a correção.



Portal Storex (Antigo)


1. Acessar o Portal Storex (antigo) do cliente.

2. Efetuar o login com Usuário e Senha autorizado ao acesso de cadastro de Forma de Recebimento. 



3. Após efetuar o login, acesse o caminho Cadastros/Formas de Recebimento/Genéricas.



4. Após clicar em Genéricas, em alguns ambientes pode ser apresentada a tela de segurança do Java. Marque o check-box e clique no botão RUN.,

  • O texto da mensagem pode variar de acordo com o idioma do Sistema Operacional, mas o botão será o mesmo, sendo RUN ou Executar, que em seguida será apresentada a tela de cadastro. 



5. Para cadastrar uma nova Forma informe o código da forma e clique no botão Novo.

  • Para o cadastro da forma QR Linx, informe o código fornecido por P&D para o cliente.



















6. Caso seja exibida a mensagem "Existe uma forma de recebimento com esta chave", informe à equipe de P&D.

  • A forma QR Linx será definida nos parâmetros do PDV (Em p2k\bin no arquivo parametrosGeraisPDV.properties, localize o parâmetro CODIGO_FORMA_RECEBIMENTO_WALLET. Ele deve ter o código da forma definido por P&D para cada cliente).

Aba Geral

Esta aba permite a definição das regras gerais para o nova Forma de Recebimento Genérica. 


7. Na aba Geral preencher os campos com os dados a seguir:

  • Descrição: QRLINX
  • Identificador da forma: QRLINX
  • Limite da Forma: 9.999.99.00
  • Fator de Pontos Extras: 0
  • Valor fixo: 0.00

Aba Troco

Esta permite definir valor e percentual a serem praticados para o Troco.


8. Na aba Troco, preencher os campos com os dados a seguir:

  • Valor: 0.00
  • Percentual: 0.00

Aba Moedas

Esta aba permite a definição das moedas que serão aceitas pela forma genérica.


9. A aba Moedas não deve ser preenchida.

Aba Dados

Esta aba permite a definição relacionada à exibição dos valores e impressão de comprovante.


10. A aba Dados deve permanecer com os valores default já definidos. Se houver algum valor diferente da imagem ao lado, faça a correção.


Aba Parâmetros


11. Na aba Troco, preencher os campos com os dados a seguir:

  • Valor Aprovação Total Acumulador: 0.00

  • Procedimento a executar: ES09, pressione Enter após digitar.

  • Aprovação Numero Passagens: 0

  • Procedimento a executar: ES08, pressione Enter após digitar.

  • Os demais campos deverão permanecer em branco.

Aba Processos


12. Na aba Processos, clicar no botão de Busca após o campo Processo




13. Clicar na opção 027 Recebimento Genérico sem Acatamento e clicar no botão Selecionar.



14. Clicar no botão Inserir para inclusão no grid.



14. Concluído o processo, a tela deve ficar conforme imagem ao lado.

15. Clicar no botão Incluir (rodapé da tela) para salvar a forma.



16. Clicar no botão Sim para confirmar a inclusão da forma



17. Será exibida a mensagem de sucesso na inclusão conforme imagem ao lado.

  • Para teste imediato será necessário gerar um lote e é recomendado que em seguida seja gerada uma base.
  • Aguarde até o processamento no PDV para iniciar os testes.

Associação da Forma (QR Linx) ao Plano à Vista  

Para o funcionamento da forma QR Linx no PDV será necessário associá-la ao Plano à Vista no Portal Storex.

Se é usuário do PORTAL STOREX (Antigo), siga o documento normalmente.  Se já utiliza o NOVO PORTAL STOREX, então clique no link indicado para acesso às novas tela.


Novo Portal Storex
























1. Acesse no Portal Storex o caminho Cadastros/Plano de Pagamento/Planos à Vista 


















2. Pesquise o Plano à Vista e o selecione.

  • O código do Plano à Vista varia por cliente. 




























3. Acesse a aba Forma de recebimento, pesquise a forma QR Linx e acione o botão + Adicionar para inclusão no grid. A forma QR Linx será exibida conforme o exemplo na figura ao lado, ou seja, associada ao Plano à Vista.


  • O código da Forma QR Linx varia por cliente. 




4. Acione o botão Salvar.


  • Acione o botão Remover para excluir o Plano `Vista.
    Acione o botão Cancelar para sair do Plano à Vista selecionado e retornar à tela de pesquisa.



Portal Storex (Antigo)




 

1. Acessar no Portal Storex (Antigo) o caminho Cadastro/Plano de Pagamento/Planos à Vista 

2. Pesquisar o Plano à Vista e o selecione.

  • O código do Plano à Vista varia por cliente. 

3. Com o Plano à Vista selecionado, clicar na aba Formas de Recebimento.

4. Pesquisar a forma QR Linx e clicar no botão Incluir para inclusão no grid. A forma QR Linx será exibida conforme o exemplo na figura ao lado, ou seja, associada ao Plano à Vista.

  • O código da Forma QR Linx varia por cliente. 

5. Clicar no botão Incluir (rodapé da tela) para salvar.

Cadastro do Tipo e Numerário na Tesouraria  

Para clientes que utilizam o módulo Tesouraria do Storex, será necessário realizar o cadastro da forma na tela Manutenção de Tipos de Numerário. Caso não utilize, siga para o próximo tópico.

Utilizar o código da forma de QRLinx fornecido pela equipe de P&D, o qual varia de cliente para cliente.


1. Preencher a tela Manutenção de Tipos de Numerário com base na imagem ao lado mantendo os valores default já definidos.





















Configurando os parâmetros QRLinx no PDV.  

Neste item será abordada a configuração necessária no PDV. Os dados apresentados são relacionados a PRODUÇÃO.

  • Iniciando o processo de configuração do PDV para recebimento via QR Linx.
    • Fazer a alteração do parâmetros que virão configurados com os valores de produção. 
    • Ajustar em parametrosGeraisPDV o atributo VERSAO_WALLET = 2.


1. Para iniciar as alterações será necessário iniciar a tela de configuração via CMD, lembrando que o PDV não poderá estar aberto no momento das alterações.

2. Pressionar a tela iniciar  + R, e digite cmd e pressione ENTER.



3. Com o CMD aberto, digitar cd\p2k\bin e pressionar ENTER.



4. Digitar ParametrizacaoP2K.bat e pressione ENTER.



5. Aguardar a inicialização da tela de configuração.



6. Na tela Configuração de Serviços ajustar os parâmetros conforme abaixo:

  • WALLET_TARGET = linx   => Este parâmetro indica que está sendo utilizado o  ambiente de PRD. Para ambiente HML, informar na TARGET 'linx-box' 
  • WALLET_API_KEY = consultar a equipe LINX. 
  • WALLET_URL = https://api.linxpayhub.com.br/wallet-hub-qrlinx/v1 => Url base Padrão utilizada em PRD e em HML.
  • WALLET_TIMEOUT = 60000 => Time Out Padrão utilizado. 

ATENÇÃO:

Caso o PDV não possua estes parâmetros consultar a equipe de P&D.



7. Após ajustar todos os parâmetros clicar em Atualizar.







8. Após os dados serem salvos, poderá ser exibida a mensagem da figura ao lado. Isto ocorre  
     quando o cliente não possui um Servidor de Configurações integrado ao PDV. Clicar OK.

9. E clique em Sair para finalizar. Feche também o CMD.




10. Para impressão do cupom gerencial com os Dados da Transação + QRCODE, o usuário                pode ativar através do seguinte parâmetro:

IMPRESSAO_QRLINX_PAGAMENTO = true


ATENÇÃO:

O relatório gerencial é impresso em duas vias (cliente e loja), mas o conteúdo é igual.

Operação de Venda

Neste tópico será demonstrado como efetuar um pagamento utilizando o APP via QRLinx. Não serão abordados os passos a serem seguidos até a totalização da venda porque não é o objetivo neste documento. 
As instruções iniciam a partir da totalização da venda, com o PDV aberto para a data atual do teste, ou seja, já com itens registrados. 

Antes de iniciar a operação devemos instalar o app de pagamento em um dispositivo Android:

1. Concluindo um pagamento via QRLinx.

  • Com todos os itens registrados e na tela de totalização, pressione a tecla "," (vírgula), 
  • Considere como tecla de exemplo, Faremos um pagamento parcial para melhor visualização.
  • Em uma compra de R$ 323,26  faremos um pagamento de R$ 100 em QRLinx. Digite R$ 100 no campo A Receber em seguida pressione a tecla "," 



Lembre-se:

O layout da tela pode variar de cliente para cliente.





 2. Após pressionar a tecla de pagamento correspondente ao QRLinx

  • Já abra o aplicativo de pagamento para teste mencionado no início desta fase. Este aplicativo é exclusivo para Testes. Em Produção, o cliente utilizará o próprio aplicativo de acordo com a carteira.
  • Pressione em  Pagamento  - QRCODE.



3. Escaneamento do QRCode

  • Utilize a câmera do celular para scanear o QRCode apresentado na tela do PDV.



4. Pagamento concluído

  • Ao lado visualizamos o pagamento de QRLinx concluído.
  • Este pagamento também pode ser integral, bastando pressionar diretamente a tecla de pagamento sem digitar o valor de pagamento. 



5. Impressão 

  • Na impressão do cupom podemos visualizar o pagamento QRLinx concluído e as demais formas de pagamento aplicadas.



Validação das transações no Banco de Dados

Neste tópico temos as tabelas relacionadas com a integração, caso o cliente queira filtrar a forma de pagamento. 

    • Tabela DataHub  = p2k_recb_transacao
    • Tabela Interna     = Item_pagamento

    • Tabela DataHub  = p2k_recb_generico
    • Tabela Interna     = recbto_generico

    • Tabela DataHub = p2k_campo_generico
    • Tabela Interna     = Dado_Generic


Para validação das transações no DataHub, segue um EXEMPLO DE CONSULTA.


    1. p2k_recb_transação
      • Select Codigo_Loja,Data_Transacao,Numero_Componente,Nsu_Transacao,Codigo_Forma,
        Valor_Pago_Forma,Nom_Forma from p2k_recb_transacao where codigo_forma = '121' and 
        codigo_loja = '2015' and data_transacao = '20200508';

código loja

2015

data da venda

08/05/2020

numero componente

44

nsu  da transação

4

Código da forma

121 (Exemplo)

Descrição da forma

QRLINX


         2.  p2k_campo_generico

    • select codigo_loja, data_transacao, NUMERO_COMPONENTE, NSU_TRANSACAO, NUM_SEQ_CAMPO_GENERICO, CAMPO_GENERICO, DESC_CHAVE_DADO_GENERICO
      from p2k_campo_generico where codigo_loja = '2015' and data_transacao = '20200508' and numero_componente = '44' and NSU_TRANSACAO = '4';

num_seq_campo_generico

campo_generico

desc_chave_dado_generico

Descrição

1

7b9d6ddf-48a2-4516-959b-c089f7a3c8e2

CHAVE_CAIXA_WALLET

 Código de autenticação individual do PDV.

2

20893225000121

CHAVE_CNPJ_WALLET

CNPJ do Beneficiário .

3

Carteira Teste Linx

CHAVE_NOME_WALLET

Descrição do Beneficiário

4

 f927fe6c-d782-4ad0-af18-daa632103d74

CHAVE_PAGAMENTO_WALLET

código individual do pagamento, junto ao Beneficiário

5

3509ee4

CHAVE_TRANSACAO_WALLET

Código da transação


3.- p2k_recb_genérico

    • Esta forma de pagamento entra na categoria de pagamento genérico. Também será encontrado na tabela p2k_recb_generico, juntamente com os demais 
      pagamentos da mesma categoria. 
      • select * from p2k_recb_generico where codigo_loja = '2015' and data_transacao = '20200508' and nsu_transacao = '4' ;


Logs

Detalhamento do processo de pagamento QR Code pode ser obtido no arquivo: p2k\bin\logger\integrador_wallet\linx_wallet_client.log

Neste log é possível identificar todo fluxo de comunicação entre Storex PDV e PayHub.

Check-list

Abaixo temos um exemplo de checkllist, que pode ser aplicado no início dos testes em HML ou em Produção. 


Item

Status

Validar a liberações de URLs


Validar o cadastro da forma de recebimento (Código Forma QRLINX varia por cliente)


Validar o credenciamento da loja junto ao PayHub


Validar os acessos ao portal de conciliação