Big Retail - P&D > Documentações > Documentações - QR Linx
Expandir | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
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:
- PDV e Pay Hub
Esta URL é responsável pela comunicação entre o PDV e o PayHub e poderá ser liberada somente no PDV. É a mesma para HML e Produção.
PRD/HML: https://api.linxpayhub.com.br/wallet-hub-qrlinx/v1
- 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
Expandir | ||
---|---|---|
| ||
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.,
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.
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:
7. No tópico Troco, preencher os campos com os dados a seguir:
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)
Aba Geral
Esta aba permite a definição das regras gerais para o nova Forma de Recebimento Genérica.
Aba Troco
Esta permite definir valor e percentual a serem praticados para o Troco.
Aba Moedas
Esta aba permite a definição das moedas que serão aceitas pela forma genérica.
Aba Dados
Esta aba permite a definição relacionada à exibição dos valores e impressão de comprovante.
Aba Parâmetros
Aba Processos
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
Expandir | ||
---|---|---|
| ||
1. Acesse no Portal Storex o caminho Cadastros/Plano de Pagamento/Planos à Vista 2. Pesquise o Plano à Vista e o selecione.
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.
4. Acione o botão Salvar.
|
Portal Storex (Antigo)
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.
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.
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:
- APK para instalação, baixe aqui,
- APK para instalação, baixe aqui,
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.
- 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';
- Select Codigo_Loja,Data_Transacao,Numero_Componente,Nsu_Transacao,Codigo_Forma,
- p2k_recb_transação
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';
- select codigo_loja, data_transacao, NUMERO_COMPONENTE, NSU_TRANSACAO, NUM_SEQ_CAMPO_GENERICO, CAMPO_GENERICO, DESC_CHAVE_DADO_GENERICO
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' ;
- Esta forma de pagamento entra na categoria de pagamento genérico. Também será encontrado na tabela p2k_recb_generico, juntamente com os demais
Logs
Repositório do log no PDV que apresentara informações das transações de QRLinx:
Neste log será possível identificar toda comunicação com o PayHub.
Detalhamento do processo de pagamento QR Code pode ser obtido no arquivo: p2k\bin\logger\integrador_wallet\linx_wallet_client.log
AQUI, esta um log de exemplo para visualização de todo o fluxo seguidoNeste 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 |