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":

Image Modified

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":

Image Modified

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":

Image Modified

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

;

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".

Obtenção do  "COMPUTE

/Valor" foi informado "Método" e no campo "Parâmetros"

o dado fornecido pela Operadora  Stone.

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


Obtenção do  "

HMAC":

Image Modified

Imagem

5

4 - 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 6

para gerar o código de autorização encriptado (Imagem 5).

Image Modified

Imagem

6

5 - 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
defaultyesno
referenciapasso1passo2

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 selecionado , 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)" foram relacionados ", no campo "Estabelecimento" são informados os "Stone Id" das empresas usuárias do sistema fornecidas pela operadora StoneCode" 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
referenciapasso2

04. DEMAIS INFORMAÇÕES

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!
passo3

Requisição de arquivo de conciliação através do Agendamento Geral de Processo: 

Image Added

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.


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>