Páginas filhas
  • DT DVAFIN-4446 - Extrato Eletrônico de Cartão - Conciliação de Cartão - STONE

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

Foi solicitado a implementação no processo de conciliação eletrônica de cartões, a requisição de arquivos de conciliação da Operadora Stone controlado por "Stone Id"Desenvolver o processo para conciliação dos cartões Stone realizando consultas na API Stone.

03. SOLUÇÃO

Ajuste no Foi desenvolvido o processo de conciliação eletrônica de cartões e de agendamento geral de processo, a requisição de arquivos da Operadora Stone controlado por "Stone Id"dos cartões Stone realizando consultas na API Stone conforme configuração realizada nos componentes INTFM010 e FCRFM142.


Totvs custom tabs box
tabsConfiguração Integração Sistema, Configuração Cartão Eletrônico, Requisição através Agendamento Geral Processo, Requisição através Baixa Cartão Extrato Eletrõnico
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyes
referenciapasso1

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" o dado fornecido pela Operadora  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" o dado fornecido pela Operadora  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" o dado fornecido pela Operadora  Stone.

Configuração do "x-authorization-encrypted-data":

Image Removed

Imagem 4 - 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" informar o  "COMPUTE HMAC".

foi informado uma "string" que será utilizada para gerar o código de autorização encriptado (Imagem 4).


Obtenção do  "Obtenção do  "COMPUTE HMAC":

Imagem 54 - A imagem acima mostra o conteúdo do página " https://www.freeformatter.com/hmac-generator.html" para obtenção do  "COMPUTE HMAC". No campo "Copy-paste the string here" foi informado o mesmo conteúdo do parâmetro da função "x-authorization-encrypted-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" e o . Clicar no botão "COMPUTE HMAC" foi pressionado para obtenção do "COMPUTE HMAC", exibido na imagem 6para gerar o código de autorização encriptado (Imagem 5).

Imagem 65 - A imagem acima mostra o "COMPUTE Computed HMAC" gerado pelo passo anterior na página " https://www.freeformatter.com/hmac-generator.html".

Configuração do "x-authorization-encrypted-data":

Image Added

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.

Totvs custom tabs box items
defaultno
referenciapasso2

Configuração da operadora Stone no sistema:

Image RemovedImage Added

Imagem 1 - Na imagem acima é mostrada a configuração da operadora Stone no sistema. No campo "Operadora *" foi informado o código "(18 " (- Stone). , no campo "Pessoa operadora *" foi informado o código da pessoa da operadora pessoa cadastrado através do componente PESFM010vinculado aos códigos de portador referente ao cartão Stone. No campo "Tipo entrada" foi informado , a opção padrão é "Centralizado", no 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.

Totvs custom tabs box items
defaultno
referenciapasso3

Obtenção 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 obtenção 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 deverá deve ser pressionado para obtenção dos arquivo executar o componente GERFP001.


Image Added

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.


 Image Added

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.  


Image Added

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.

Totvs custom tabs box items
defaultno
referenciapasso4

Requisição de arquivo de conciliação através do componente FCRFP169:

Image Added

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.


Image Added

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.

Image Added

Imagem 3 - Após a conclusão das requisições, a lista de arquivos gerados é apresentada no componente FCRFL142.

Image Added

Imagem 4 - Na imagem acima, demonstramos as vendas do dia 14/01/2020.

Templatedocumentos

HTML
<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>