Ativação eSales
Esta integração contempla o envio dos dados do ERP Banking junto ao parceiro eSales para cobranças e pagamentos, e segue o fluxo abaixo:
Para realizar as parametrizações entre ERP Banking, eSales e bancos, são realizadas as seguintes etapas:
- O Gerente ou Analista de projetos da Senior entra em contato com o cliente para levantar as informações necessárias para a abertura do relacionamento com os Bancos e o Parceiro;
- Em seguida, o cliente entra em contato com os Bancos para preenchimento das cartas, através dos portais disponibilizados pela Instituição Financeira ou através de e-mail;
- Após os Bancos disponibilizarem o ID Token e ID Secret, é necessário informar ao Parceiro para que sejam realizados os devidos cadastrados das informações;
- O Gerente ou Analista de projetos da Senior entra em contato com o cliente realizar as parametrizações do sistema;
Veja abaixo todos os passos necessários para a parametrização.
1 - Abertura dos relacionamentos
Esta etapa contempla a abertura de relacionamentos com as instituições financeiras junto ao parceiro eSales para cobranças e pagamentos.
Verifique os tipos de serviços que serão implantados e siga as orientações informadas abaixo:
- Cobrança Pix e BolePix: Acesse os manuais disponibilizados pela eSales em Material de Apoio Implantação. Caso nenhum dos materiais contemple a sua necessidade, siga o próximo passo junto com o parceiro eSales.
- Demais serviços: Caso nenhum dos manuais disponíveis contemple sua necessidade no Material de Apoio Implantação, entre em contato com o parceiro através do e-mail erick.santos@esales.com.br, a fim de solicitar uma agenda ou mais informações/documentações que auxiliem no pedido das credenciais bancárias (ID Token e ID Secret) dos serviços multibancos.
Importante
Antes de iniciar a abertura de relacionamento com os bancos, envie os seguintes dados para o e-mail wizardERPBanking@senior.com.br:
- CNPJ Cliente;
- Razão Social;
- CNPJ da conta bancária;
- Razão Social do detentor da conta bancária;
- Nome do banco;
- Número da agência;
- Número da conta corrente.
Após o envio, o parceiro retornará o e-mail com as credenciais ID Client e Secret, que deverão ser utilizadas posteriormente na etapa 2.4 - Vincular as credenciais da eSales na plataforma Senior X.
Após realizar a abertura de relacionamento com os bancos, é preciso informar ao parceiro eSales o ID Token, ID Secret e os tipos de operações que serão realizadas (cobrança ou pagamento), para que seja possível cadastrar na solução e estabelecer a conexão com a instituição bancária.
Deste modo, as informações abaixo precisam ser enviadas para o contato wizardERPBanking@senior.com.br.
Campos obrigatórios:
- Serviços ativados com o banco de relacionamento (cobrança ou pagamento pix, boleto, bolepix, pix QRCode);
- ID Client (gerado no passo 2.1 da sessão "2. Implantação");
- ID Secret (gerado no passo 2.1 da sessão "2. Implantação");
- TenantName (tenant do cliente);
- CNPJ da empresa;
- Razão social;
- Banco;
- Agência + dígito;
- Conta + dígito;
- Chave Pix;
- Client ID;
- Token temporário.
Banco Itaú:
Título do e-mail: Implantação Cobrança PIX - Theke APIs
Dados do cliente
CNPJ:
Razão Social:
Dados bancários
Banco:
Agência + dígito:
Conta + dígito:
Chave PIX:
Credencial bancária
Cliente ID:
Token temporário:
Informações aplicação Senior X
ID Client:
ID Secret:
TenantName:
Banco do Brasil:
Título do e-mail: Implantação Cobrança PIX - Theke APIs
Dados do cliente
CNPJ:
Razão Social:
Dados bancários
Banco:
Agência + dígito:
Conta + dígito
Chave PIX:
Credencial bancária
appKey (Portal Banco do Brasil):
clientID (Portal Banco do Brasil):
clientSecret (Portal Banco do Brasil):
Convênio:
Variação Carteira:
Informações aplicação Senior X
ID Client:
ID Secret:
TenantName:
Anexar no e-mail certificado digital e-CNPJ a1 do cliente e senha
Sicredi
Título do e-mail: Implantação Cobrança PIX - Theke APIs
Dados do cliente
CNPJ:
Razão Social:
Dados bancários
Banco:
Agência + dígito:
Conta + dígito
Chave PIX:
Credencial bancária
appKey/Developer Key:
client ID (Portal Sicredi):
clientSecret (Portal Sicredi):
Convênio:
Posto:
Informações aplicação Senior X
ID Client:
ID Secret:
TenantName:
Anexar no e-mail certificado digital e-CNPJ a1 do cliente
Outros bancos
Título do e-mail: Implantação Cobrança PIX - Theke APIs
Dados do cliente
CNPJ:
Razão Social:
Dados bancários
Banco:
Agência + dígito:
Conta + dígito
Chave PIX:
Credencial bancária
Cliente ID:
Token temporário:
Informações aplicação Senior X
ID Client:
ID Secret:
TenantName:
Anexar no e-mail certificado digital e-CNPJ a1 do cliente
2 - Implantação
Crie uma Chave de acesso e Secret, para que o parceiro consiga se autenticar na nossa plataforma e chamar as primitivas de retorno.
Para isso, siga os passos abaixo:
- Acesse Tecnologia > Administração > Gerenciamento de Aplicações;
- Clique em Nova aplicação;
- Preencha os campos Nome e Descrição;
- No campo Geração de tokens, recomendamos utilizar a opção Reutilizar o mesmo token para as múltiplas sessões da aplicação. Deste modo, não há necessidade de os integradores chamarem a autenticação na plataforma a cada sessão, pois os tokens recebem a validade de uma semana.
- Ao clicar em Salvar, o sistema exibe os campos Chave de acesso e o Secret com as informações correspondentes.
Observação
Após fechar a tela, não é possível visualizar o Secret novamente, tornando-se necessária a geração de um novo.
Agora, é necessário vincular o papel criado à aplicação criada nos passos anteriores. Para isso, siga os passos abaixo:
- Acesse Tecnologia > Administração > Autorização > Gestão de Papéis;
- Em Pesquisar papéis, digite Banking;
- Localize o papel e clique em Editar;
- Acesse Tecnologia > Administração > Autorização > Gestão de Papéis;
- Clique em Novo papel;
- Informe os campos Nome do papel e Descrição do papel;
- Clique em Salvar;
- Acesse a guia Permissões;
- Na opção Agrupar por, selecione Serviço;
- Preencha o campo Pesquisar domínios / serviços com a informação erpx_bnk e clique em Filtrar;
- O sistema lista os serviços de acordo com o termo filtrado. Clique no botão
para expandir. Você deve ativar as opções de cada recurso conforme indicado na tabela erpx_bnk; - Ao finalizar o passo anterior, retorne ao campo Pesquisar domínios / serviços, informe o domínio e serviço platform / events_hub e clique em Filtrar;
- O sistema lista os serviços de acordo com o termo filtrado. Clique no botão
para expandir. Você deve ativar as opções de cada recurso conforme indicado na tabela platform / events_hub; - Clique em Salvar.
Caso não seja possível localizar o papel Banking, siga esses abaixo para realizar a criaçãoPara que seja possível utilizar a plataforma integrada com o parceiro eSales, é necessário a criação de um papel com as devidas permissões. Esse papel é o responsável por liberar apenas as APIs necessárias para os usuários que estiverem vinculados a ele. Veja abaixo como proceder:
Tabelas
erpx_bnk Domínio / Serviço Permissão erpx_bnk / foundation Primitiva responsável pelo retorno se o cliente possui a conta bancária implantada no banking
res://senior.com.br/erpx_bnk/foundation/queries/listServiceStatusReceivableerpx_bnk / onboarding autenticacaoBtg
res://senior.com.br/erpx_bnk/onboarding/entities/autenticacaoBtgerpx_bnk / onboarding autenticacaoBtgHistorico
res://senior.com.br/erpx_bnk/onboarding/entities/autenticacaoBtgHistoricoerpx_bnk / onboarding Primitiva responsável por gerar a url de consentimento com o banco BTG
res://senior.com.br/erpx_bnk/onboarding/actions/gerarUrlConsentimentoBtgerpx_bnk / onboarding Primitiva responsável por gerar os tokens de autenticação com o banco BTG
res://senior.com.br/erpx_bnk/onboarding/actions/gerarAutenticacaoBtgerpx_bnk_cob / boleto cobrancaDadosBoleto
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaDadosBoleto
erpx_bnk_cob / boleto cobrancaItemBoleto
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoerpx_bnk_cob / boleto cobrancaItemBoletoDescontoDataFixa
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoDescontoDataFixaerpx_bnk_cob / boleto cobrancaItemBoletoErro
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoErroerpx_bnk_cob / boleto cobrancaItemBoletoHistorico
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoHistoricoerpx_bnk_cob / boleto cobrancaItemBoletoHistoricoMotivoOcorrencia
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoHistoricoMotivoOcorrenciaerpx_bnk_cob / boleto cobrancaItemBoletoMensagem
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoMensagemerpx_bnk_cob / boleto cobrancaItemBoletoRegistro
res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoRegistroerpx_bnk_cob / boleto e001pes
res://senior.com.br/erpx_bnk_cob/boleto/entities/e001peserpx_bnk_cob / boleto e006pai
res://senior.com.br/erpx_bnk_cob/boleto/entities/e006paierpx_bnk_cob / boleto e007ufs
res://senior.com.br/erpx_bnk_cob/boleto/entities/e007ufserpx_bnk_cob / boleto e008rai
res://senior.com.br/erpx_bnk_cob/boleto/entities/e008raierpx_bnk_cob / boleto e085pes
res://senior.com.br/erpx_bnk_cob/boleto/entities/e085peserpx_bnk_cob / boleto Item da operação de registro boleto
res://senior.com.br/erpx_bnk_cob/boleto/entities/operacaoItemBoletoerpx_bnk_cob / boleto motivoOcorrenciaBanco
res://senior.com.br/erpx_bnk_cob/boleto/entities/motivoOcorrenciaBancoerpx_bnk_cob / boleto ocorrenciaBanco
res://senior.com.br/erpx_bnk_cob/boleto/entities/ocorrenciaBancoerpx_bnk_cob / boleto Operações de registro boleto
res://senior.com.br/erpx_bnk_cob/boleto/entities/operacaoBoletoerpx_bnk_cob / boleto Primitiva de listagem dos títulos de cobrança boleto
res://senior.com.br/erpx_bnk_cob/boleto/queries/listTitulosCobrancaBoletoerpx_bnk_cob / boleto Primitiva responsável pelas informações de acompanhamento da cobrança boleto
res://senior.com.br/erpx_bnk_cob/boleto/queries/getAcompanhamentoCobrancaBoletoerpx_bnk_cob / boleto Primitiva responsável por retornar todas as informações relacionadas a um título de cobrança boleto
res://senior.com.br/erpx_bnk_cob/boleto/queries/getDetalerpx_bnk_cob / cobranca API responsável pelo retorno da criação do registro de cobrança assíncrona do parceiro BTG
res://senior.com.br/erpx_bnk_cob/cobranca/actions/retornoCobrancaBoletoBtgerpx_bnk_cob / cobranca API responsável pelo retorno da criação do registro e pagamento de cobrança assíncrona do parceiro eSales
res://senior.com.br/erpx_bnk_cob/cobranca/actions/retornoCobrancaESaleserpx_bnk_cob / cobranca Entidade de dados da cobrança de boleto
res://senior.com.br/erpx_bnk_cob/cobranca/entities/cobrancaDadosBoletoerpx_bnk_cob / cobranca Entidade de dados do título de cobrança de boleto
res://senior.com.br/erpx_bnk_cob/cobranca/entities/cobraerpx_bnk_cob / database asyncBatches
res://senior.com.br/erpx_bnk_cob/database/entities/asyncBatcheserpx_bnk_cob / database asyncReceivedMessage
res://senior.com.br/erpx_bnk_cob/database/entities/asyncReceivedMessageerpx_bnk_cob / database asyncTransactions
res://senior.com.br/erpx_bnk_cob/database/entities/asyncTransactionserpx_bnk_cob / database asyncTransactionsLog
res://senior.com.br/erpx_bnk_cob/database/entities/asyncTransactionsLogerpx_bnk_cob / pix API pública responsável pela geração de cobrança do PIX
res://senior.com.br/erpx_bnk_cob/pix/actions/registerPixBillingerpx_bnk_cob / pix API responsável pelo cancelamento do registro de cobrança do PIX
res://senior.com.br/erpx_bnk_cob/pix/actions/cancelPixBillingerpx_bnk_cob / pix cancelamentoItemPix
res://senior.com.br/erpx_bnk_cob/pix/entities/cancelamentoItemPixerpx_bnk_cob / pix cancelamentoPix
res://senior.com.br/erpx_bnk_cob/pix/entities/cancelamentoPixerpx_bnk_cob / pix cobrancaDadosPix
res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaDadosPixerpx_bnk_cob / pix cobrancaItemPix
res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixerpx_bnk_cob / pix cobrancaItemPixErro
res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixErroerpx_bnk_cob / pix cobrancaItemPixHistorico
res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixHistoricoerpx_bnk_cob / pix cobrancaItemPixRegistro
res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixRegistroerpx_bnk_cob / pix descontoDataFixa
res://senior.com.br/erpx_bnk_cob/pix/entities/descontoDataFixaerpx_bnk_cob / pix e001pes
res://senior.com.br/erpx_bnk_cob/pix/entities/e001peserpx_bnk_cob / pix e006pai
res://senior.com.br/erpx_bnk_cob/pix/entities/e006paierpx_bnk_cob / pix e007ufs
res://senior.com.br/erpx_bnk_cob/pix/entities/e007ufserpx_bnk_cob / pix e008rai
res://senior.com.br/erpx_bnk_cob/pix/entities/e008raierpx_bnk_cob / pix e070emp
res://senior.com.br/erpx_bnk_cob/pix/entities/e070emperpx_bnk_cob / pix e070fil
res://senior.com.br/erpx_bnk_cob/pix/entities/e070filerpx_bnk_cob / pix e085pes
res://senior.com.br/erpx_bnk_cob/pix/entities/e085peserpx_bnk_cob / pix informacoesAdicionaisPix
res://senior.com.br/erpx_bnk_cob/pix/entities/informacoesAdicionaisPixerpx_bnk_cob / pix Primitiva de listagem dos títulos na tela de cobranças PIX
res://senior.com.br/erpx_bnk_cob/pix/queries/listTitulosCobrancaPixerpx_bnk_cob / pix Primitiva responsável pelas informações do acompanhamento da tela de cobranças PIX
res://senior.com.br/erpx_bnk_cob/pix/queries/getAcompanhamentoCobrancaPixerpx_bnk_cob / pix Primitiva responsável pelos detalhes do título
res://senior.com.br/erpx_bnk_cob/pix/queries/getDetalheerpx_bnk_cob / register_boleto Execução de operações sobre o registro de cobrança do boleto
res://senior.com.br/erpx_bnk_cob/register_boleto/actions/erpx_bnk_cob / register_boleto Geração de cobrança do boleto
res://senior.com.br/erpx_bnk_cob/register_boleto/actions/registerBankSlipBillingerpx_bnk_cob / register_pix API pública responsável pela geração de cobrança do PIX
res://senior.com.br/erpx_bnk_cob/register_pix/actions/registerPixBillingerpx_bnk_cob / register_pix API responsável pelo cancelamento do registro de cobrança do PIX
res://senior.com.br/erpx_bnk_cob/register_pix/actions/cancelPixBillingerpx_bnk_cob / register_pix cancelamentoPix
res://senior.com.br/erpx_bnk_cob/register_pix/entities/cancelamentoPixerpx_bnk_cob / register_pix cobrancaDadosPix
res://senior.com.br/erpx_bnk_cob/register_pix/entities/cobrancaDadosPixerpx_bnk_cob / register_pix cobrancaItemPix
res://senior.com.br/erpx_bnk_cob/register_pix/entities/cobrancaItemPixerpx_bnk_cob / register_pix e070emp
res://senior.com.br/erpx_bnk_cob/register_pix/entities/e070emperpx_bnk_cob / register_pix e070fil
res://senior.com.br/erpx_bnk_cob/register_pix/entities/e07
platform / events_hubDomínio / Serviço Permissão platform / events_hub Webhook
res://senior.com.br/platform/events_hub/webhook - Acesse a guia Aplicações;
- Localize na lista de aplicações a aplicação criada anteriormente, e ative
a associação; - Clique em Salvar.
Após isso, é preciso habilitar os recursos que necessitam de acesso. Acesse a guia Permissões e siga os passos abaixo:
- Em Agrupar por, selecione a opção Serviço;
- Preencha o campo de pesquisa com erpx_bnk, para que sejam listados todos os serviços do Banking;
- Em cada serviço listado, clique no botão
para expandir, e habilite todas as opções para Processar e Visualizar; - Clique em Salvar.
Observação
Sempre que um novo serviço for criado, é necessário executar essa ação.
Por fim, é preciso vincular os acessos do webhook, conforme demonstrado abaixo:
- Ainda na guia Permissões, mantenha a opção Agrupar por como Serviço;
- Preencha o campo de pesquisa com events;
- No serviço listado platform / events_hub, clique no botão
para expandir e habilite todas as opções.
Para testar as credenciais e garantir o correto funcionamento antes de configurar o eSales, siga os seguintes passos:
- Primeiro, é necessário chamar a primitava loginWithKey e informar os campos abaixo:
- accessKey: valor da Chave de Acesso configurado;
- secret: valor do Secret;
- tenantName: nome do tenant.
- Caso a chamada retorne corretamente o token gerado, é possível dar continuidade no processo:
cURL da requisição
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/platform/authentication/actions/loginWithKey' \ --header 'Content-Type: application/json' \ --data '{ "accessKey": "e6cc9508-0215-4ad5-97e7-ba134ce2cabe", "secret": "4ea9c0a3-cc72-4ee7-b944-f19ba3ea518d", "tenantName": "testeserpxcombr" }'
Veja um exemplo de caso de sucesso:
- Após receber as informações, os parceiros devem retornar o clientId e o clientSecret do esales, que são as credenciais para autenticação em suas plataformas.
- Após isso, é necessário utilizar o evento iniciarIntegracaoESales e criar um webhook para os endpoints utilizados pelo banking.
- Para realizar esta ação, chame a primitiva createWebhook:
Seguem modelos de cURL para cada serviço:
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/events_hub/actions/createWebhook' \ --header 'Authorization: bearer qG8bzZgLvqGN8Pi7zv7Eun3kR4FISDoY' \ --header 'Content-Type: application/json' \ --header 'Cookie: TS0122123d=01a760ec21cfd61dc85ebdbede76781725546137a32a42ecdcaf19773def3f378c3028c1bb6c1543d5adc33e2b12e09643e4ae47c3; TS0122123d030=01686c63805c244db7cf84151ede5166a1992a278e224b8ed630523ee71363091720a704f72ce6b134fbc7893253a17595cb9b3009' \ --data '{ "event": { "domainName": "erpx_bnk_cob", "serviceName": "pix", "primitiveName": "iniciarIntegracaoESales" }, "endpoints": [ { "url": "https://api-finance.theke.com.br/v1/cobrancas", "active": true, "headers": [ { "key": "X-Send-Async", "value": "true" } ], "applyRetry": false, "authByEndpoint": true, "ignoreHttpCode": [], "authSettings": { "authTestSuccess": true, "url": "https://api-finance.theke.com.br/v1/autenticacao/parceiros/token", "headers": [], "payload": [ { "key": "clientId", /"value": "<CLIENTE_ID DISPONIBILIZADO PELA ESALES>" }, { "key": "clientSecret", /"value": "CLIENTE_SECRET DISPONIBILIZADO PELA ESALES" } ], "payloadFilters": [ { "key": "TOKEN", "value": "$.token" }, { "key": "VALID_FOR_SECONDS", "value": "$.validForSeconds" } ], "refreshToken": { "url": "", "payload": [] } } } ] }'
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/events_hub/actions/createWebhook' \ --header 'Authorization: bearer qG8bzZgLvqGN8Pi7zv7Eun3kR4FISDoY' \ --header 'Content-Type: application/json' \ --header 'Cookie: TS0122123d=01a760ec21cfd61dc85ebdbede76781725546137a32a42ecdcaf19773def3f378c3028c1bb6c1543d5adc33e2b12e09643e4ae47c3; TS0122123d030=01686c63805c244db7cf84151ede5166a1992a278e224b8ed630523ee71363091720a704f72ce6b134fbc7893253a17595cb9b3009' \ --data '{ "event": { "domainName": "erpx_bnk_cob", "serviceName": "boleto", "primitiveName": "iniciarIntegracaoCobrancaBoletoESales" }, "endpoints": [ { "url": "https://api-finance.theke.com.br/v1/cobrancas", "active": true, "headers": [ { "key": "X-Send-Async", "value": "true" } ], "applyRetry": false, "authByEndpoint": true, "ignoreHttpCode": [], "authSettings": { "authTestSuccess": true, "url": "https://api-finance.theke.com.br/v1/autenticacao/parceiros/token", "headers": [], "payload": [ { "key": "clientId", /"value": "<CLIENTE_ID DISPONIBILIZADO PELA ESALES>" }, { "key": "clientSecret", /"value": "CLIENTE_SECRET DISPONIBILIZADO PELA ESALES" } ], "payloadFilters": [ { "key": "TOKEN", "value": "$.token" }, { "key": "VALID_FOR_SECONDS", "value": "$.validForSeconds" } ], "refreshToken": { "url": "", "payload": [] } } } ] }'
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/events_hub/actions/createWebhook' \ --header 'Authorization: bearer qG8bzZgLvqGN8Pi7zv7Eun3kR4FISDoY' \ --header 'Content-Type: application/json' \ --header 'Cookie: TS0122123d=01a760ec21cfd61dc85ebdbede76781725546137a32a42ecdcaf19773def3f378c3028c1bb6c1543d5adc33e2b12e09643e4ae47c3; TS0122123d030=01686c63805c244db7cf84151ede5166a1992a278e224b8ed630523ee71363091720a704f72ce6b134fbc7893253a17595cb9b3009' \ --data '{ "event": { "domainName": "erpx_bnk_pag", "serviceName": "boleto", "primitiveName": "iniciarIntegracaoPagamentoBoletoESales" }, "endpoints": [ { "id": "{{$guid}}", "url": "https://api-finance.theke.com.br/v1/pagamentos/boletos", "active": false, "headers": [], "applyRetry": true, "authByEndpoint": true, "ignoreHttpCode": [], "authSettings": { "internalAuthentication": false, "authTestSuccess": true, "url": "https://api-finance.theke.com.br/v1/autenticacao/parceiros/token", "headers": [], "payload": [ { "key": "clientId", /"value": "<CLIENTE_ID DISPONIBILIZADO PELA ESALES>" }, { "key": "clientSecret", /"value": "CLIENTE_SECRET DISPONIBILIZADO PELA ESALES" } ], "payloadFilters": [ { "key": "TOKEN", "value": "$.token" }, { "key": "VALID_FOR_SECONDS", "value": "$.validForSeconds" } ], "refreshToken": { "url": "", "payload": [] } }, "_discriminator": "completeEndpointDTO" } ] }'
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/events_hub/actions/createWebhook' \ --header 'Authorization: bearer qG8bzZgLvqGN8Pi7zv7Eun3kR4FISDoY' \ --header 'Content-Type: application/json' \ --header 'Cookie: TS0122123d=01a760ec21cfd61dc85ebdbede76781725546137a32a42ecdcaf19773def3f378c3028c1bb6c1543d5adc33e2b12e09643e4ae47c3; TS0122123d030=01686c63805c244db7cf84151ede5166a1992a278e224b8ed630523ee71363091720a704f72ce6b134fbc7893253a17595cb9b3009' \ --data '{ "event": { "domainName": "erpx_bnk_pag", "serviceName": "pix", "primitiveName": "iniciarIntegracaoPagamentoPixQrCodeESales" }, "endpoints": [ { "id": "{{$guid}}", "url": "https://api-finance.theke.com.br/v1/pagamentos/pix/qr-codes", "active": false, "headers": [], "applyRetry": true, "authByEndpoint": true, "ignoreHttpCode": [], "authSettings": { "internalAuthentication": false, "authTestSuccess": true, "url": "https://api-finance.theke.com.br/v1/autenticacao/parceiros/token", "headers": [], "payload": [ { "key": "clientId", /"value": "<CLIENTE_ID DISPONIBILIZADO PELA ESALES>" }, { "key": "clientSecret", /"value": "CLIENTE_SECRET DISPONIBILIZADO PELA ESALES" } ], "payloadFilters": [ { "key": "TOKEN", "value": "$.token" }, { "key": "VALID_FOR_SECONDS", "value": "$.validForSeconds" } ], "refreshToken": { "url": "", "payload": [] } }, "_discriminator": "completeEndpointDTO" } ] }'
curl --location 'https://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/events_hub/actions/createWebhook' \ --header 'Authorization: bearer qG8bzZgLvqGN8Pi7zv7Eun3kR4FISDoY' \ --header 'Content-Type: application/json' \ --header 'Cookie: TS0122123d=01a760ec21cfd61dc85ebdbede76781725546137a32a42ecdcaf19773def3f378c3028c1bb6c1543d5adc33e2b12e09643e4ae47c3; TS0122123d030=01686c63805c244db7cf84151ede5166a1992a278e224b8ed630523ee71363091720a704f72ce6b134fbc7893253a17595cb9b3009' \ --data '{ "event": { "domainName": "erpx_bnk_pag", "serviceName": "pix", "primitiveName": "iniciarIntegracaoPagamentoPixTransferenciaESales" }, "endpoints": [ { "id": "{{$guid}}", "url": "https://api-finance.theke.com.br/v1/pagamentos/pix/transferencias", "active": false, "headers": [], "applyRetry": true, "authByEndpoint": true, "ignoreHttpCode": [], "authSettings": { "internalAuthentication": false, "authTestSuccess": true, "url": "https://api-finance.theke.com.br/v1/autenticacao/parceiros/token", "headers": [], "payload": [ { "key": "clientId", /"value": "<CLIENTE_ID DISPONIBILIZADO PELA ESALES>" }, { "key": "clientSecret", /"value": "CLIENTE_SECRET DISPONIBILIZADO PELA ESALES" } ], "payloadFilters": [ { "key": "TOKEN", "value": "$.token" }, { "key": "VALID_FOR_SECONDS", "value": "$.validForSeconds" } ], "refreshToken": { "url": "", "payload": [] } }, "_discriminator": "completeEndpointDTO" } ] }'
Veja um exemplo de chamada de sucesso para a criação do webhook:
Realize as parametrizações abaixo para habilitar o cancelamento da conbrança Pix:
- Acesse Tecnologia > Configuração > Por tenant;
- Com a barra de rolagem, desça a tela até a sessão de Domínios e Serviços;
- Preencha o campo Filtrar domínios com erpx_bnk;
- Acesse o registro erpx_bnk, e clique no botão Editar do serviço foundation;
- Na tela Propriedades, acesse a guia Sistema e preencha os campos abaixo com as informações recebidas pela eSales:
- Credencial eSales – ClientId: preencha com o clientId informado pela eSales;
- Credencial eSales – ClientSecret: preencha com o clientSecret informado pela eSales;
- Credencial eSales – Produção habilitada: selecione a opção Verdadeiro;
- Clique no botão Salvar.
Realize testes para verificar se a integração está funcionando corretamente.
Observação
- Caso haja algum problema na integração, confira se todas as informações foram preenchidas corretamente. Se o problema persistir, entre em contato com nosso suporte.
- Caso o secret de autenticação da plataforma senior X seja alterado, é necessário informar ao eSales o novo valor gerado, para que o retorno continue funcionando corretamente.
English
Español
English
Español


