01. DADOS GERAIS
| Linha de Produto: | Virtual Age |
|---|---|
| Segmento: | Moda |
| Módulo: | Financeiro |
| Função: | INTFM010 - Manutenção de Integração de Sistemas FCRFM142 - Configuração do Extrato Eletrônico de Cartão GERFP069 - Agendamento Geral de Processo FCRFP169 - Baixa de Cartão por Extrato Eletrônico |
| Ticket: | |
| Requisito/Story/Issue (informe o requisito relacionado) : | DVAFIN-4446 |
02. SITUAÇÃO/REQUISITO
Desenvolver o processo para conciliação dos cartões Stone realizando consultas na API Stone.
03. SOLUÇÃO
Foi desenvolvido o processo de conciliação dos cartões Stone realizando consultas na API Stone conforme configuração realizada nos componentes INTFM010 e FCRFM142.
Configuração do "ClientApplicationKey":
Imagem 1 - A imagem acima mostra o componente INTFM010 utilizado na configuração do "ClientApplicationKey". No campo "Sistema" foi informado a opção "Stone", no campo "Função" foi informado do a opção "ClientApplicationKey", no campo "Campo/Valor" foi informado "Método" e no campo "Parâmetros" foi informado a chave do cliente, fornecida pela Stone.
Configuração do "ClientApplicationSecretKey":
Imagem 2 - A imagem acima mostra o componente INTFM010 utilizado na configuração do "ClientApplicationSecretKey". No campo "Sistema" foi informado a opção "Stone", no campo "Função" foi informado do a opção "ClientApplicationSecretKey", no campo "Campo/Valor" foi informado "Método" e no campo "Parâmetros" foi informado a chave secreta, fornecida pela Stone.
Configuração do "x-authorization-raw-data":
Imagem 3 - A imagem acima mostra o componente INTFM010 utilizado na configuração do "x-authorization-raw-data". No campo "Sistema" foi informado a opção "Stone", no campo "Função" foi informado do a opção "x-authorization-raw-data", no campo "Campo/Valor" foi informado "Método" e no campo "Parâmetros" foi informado uma "string" que será utilizada para gerar o código de autorização encriptado (Imagem 4).
Obtenção do "HMAC":
Imagem 4 - A imagem acima mostra o conteúdo do página " https://www.freeformatter.com/hmac-generator.html" para obtenção do "HMAC". No campo "Copy-paste the string here" foi informado o mesmo conteúdo do parâmetro da função "x-authorization-raw-data", no campo "Secret Key" foi informado o mesmo conteúdo do parâmetro da função "ClientApplicationSecretKey", no campo "Select a message digest algorithm" foi selecionado a opção "SHA512". Clicar no botão "COMPUTE HMAC" para gerar o código de autorização encriptado (Imagem 5).
Imagem 5 - A imagem acima mostra o "Computed HMAC" gerado pelo passo anterior na página " https://www.freeformatter.com/hmac-generator.html".
Configuração do "x-authorization-encrypted-data":
Imagem 6 - A imagem acima mostra o componente INTFM010 utilizado na configuração do "x-authorization-encrypted-data". No campo "Sistema" foi informado a opção "Stone", no campo "Função" foi informado do a opção "x-authorization-encrypted-data", no campo "Campo/Valor" foi informado "Método" e no campo "Parâmetros" foi informado o código "Computed HMAC" gerado na Imagem 5.
Configuração da operadora Stone no sistema:
Imagem 1 - Na imagem acima é mostrada a configuração da operadora Stone. No campo "Operadora *" foi informado o código (18 - Stone), no campo "Pessoa operadora *" foi informado o código da pessoa da operadora vinculado aos códigos de portador referente ao cartão Stone. No campo "Tipo entrada", a opção padrão é "Centralizado", mas essa opção não será tratada para a Stone e será definida informando o código de empresa Matriz na configuração dos estabelecimentos. No quadro "Relacionamento (Estabelecimento x Empresa)", no campo "Estabelecimento" são informados os "Stone Code" fornecidos pela operadora Stone, no campo "Empresa" são informadas as empresas correspondentes aos "Stone Code" e no campo "Matriz", é informado o código da empresa que deverá ser realizada a gravação das informações.
Requisição de arquivo de conciliação através do Agendamento Geral de Processo:
Imagem 1 - A imagem acima mostra o componente GERFP069 com as informações necessárias para requisição dos arquivos de conciliação de cartão. No quadro "Agendamento", o campo "Tipo" foi informado a opção "Integração", no campo processo foi informado (14 - WEBSERVICE STONE) e o botão "Executar" que deve ser pressionado para executar o componente GERFP001.
Imagem 2 - A imagem acima mostra o componente GERFP001, com o quadro "Data/hora" utilizado para informar o período dos arquivos de conciliação de cartão que serão requisitados da operadora Stone e o botão "Confirmar" que deve ser pressionado para obtenção das informações de conciliação da operadora Stone.
Imagem 3 - A imagem acima mostra o componente GERFP069, com o resultado da requisição dos arquivos de conciliação de cartão, do período informado no componente GERFP001, Imagem 2.
Imagem 4 - A imagem acima mostra o conteúdo completo do resultado da requisição dos arquivos de conciliação de cartão, ao dar um clique duplo do campo "Resultado" da linha do quadro "Log execução", do componente GERFP069, exibida na Imagem 3.
Requisição de arquivo de conciliação através do componente FCRFP169:
Imagem 1 - A imagem acima foi realizada a requisição de arquivo de conciliação através do componente FCRFP169. No quadro "Origem" foi marcado a opção "Web API" e foi selecionado a opção "STONE", no campo "Data" for informada o período da requisição do arquivo de conciliação. A consulta deverá ser realizada utiliando a função (F4 - Consultar) e o sistema apresentará o resultado na tela do componente GERFP008, exibida na Imagem 2.
Imagem 2 - A imagem acima mostra o resultado da requisição efetuada pelo sistema ao "Web API" da Stone no período informado, através do componente FCRFP169.
Imagem 3 - Após a conclusão das requisições, a lista de arquivos gerados é apresentada no componente FCRFL142.
Imagem 4 - Na imagem acima, demonstramos as vendas do dia 14/01/2020.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas