PORTAL DE DOCUMENTAÇÃO
Gestão Empresarial | ERP senior X
ERP senior X > Banking > Ativação de parceiros > Ativação eSales

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, é necessário realizar as etapas descritas nos tópicos a seguir.

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.

Closed1.1 - Abertura dos relacionamentos com os bancos

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 conforme abaixo para os respectivos bancos e serviços. 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 nos materiais mencionados, entre em contato com o parceiro através do e-mail implantacoes.theke@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.
Closed1.2 - Abertura do relacionamento com o parceiro eSales

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;
  • Número convênio;
  • Chave Pix;
  • Client ID do banco (caso a instituição envie);
  • Token temporário do banco (caso a instituição envie);
  • Certificado digital tipo e-CNPJ A1 (obrigatório apenas nos casos em que houver exigência por parte do banco).
ClosedExemplos de e-mail

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

Closed2.1 - Habilitar tipo de ambiente na PDL
  1. Acesse Tecnologia > Configuração > Por tenant;
  2. Na seção Domínios e Serviços, pesquise por erpx_bnk;
  3. Expanda o serviço erpx_bnk listado, e clique no botão Editar da opção Onboarding;
  4. Acesse a guia Sistema;
  5. No campo ESales - Produção habilitado, selecione Verdadeiro para produção ou Falso para homologação;
  6. Clique em Salvar.
Closed2.2 - Cadastrar parceiro
  1. Acesse ERPX > Banking > Onboarding > eSales;
  2. Clique em Adicionar Parceiro;
  3. Preencha os campos CNPJ e Razão Social com as informações da sua empresa. Devem ser informados os dados do CNPJ principal da empresa ou do detentor do contrato Senior;
  4. Clique em Salvar.
  5. O sistema envia automaticamente as informações para o eSales, armazena as credenciais no Banking e configura o ambiente para integração.
Closed2.3 - Cadastrar clientes e contas

Após adicionar o parceiro, é necessário realizar o cadastro dos clientes e de suas respectivas contas. Para isso, siga os passos abaixo:

  1. Acesse ERPX > Banking > Onboarding > eSales;
  2. Clique no botão Gerenciar Cliente, e em seguida clique em Adicionar;
  3. Preencha os campos CNPJ e Razão social;
  4. Clique em Salvar;
  5. Na relação de clientes cadastrados, clique em Adicionar Conta;
  6. Informe os dados válidos da conta;
  7. Ao salvar, o sistema envia as informações do cliente e da conta para a eSales.

Observação

Caso o cliente já esteja cadastrado no eSales, o sistema ignora os dados do cliente e realiza apenas a inclusão da nova conta vinculada.

Closed2.4 - Testes para validar se a integração está ocorrendo com sucesso

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.

Modelo de implantação anterior

Os passos detalhados neste tópico devem ser executados exclusivamente em implantações que já iniciaram a parametrização do ERP Banking seguindo os processos descritos abaixo. Novos projetos devem seguir o novo modelo de implantação, conforme descrito no tópico 2 – Implantação.

ClosedDetalhes do modelo de implantação anterior
Closed2.1 - Criar aplicação na Plataforma senior X para se comunicar com a eSales

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: 

  1. Acesse Tecnologia > Administração > Gerenciamento de Aplicações;
  2. Clique em Nova aplicação;
  3. Preencha os campos Nome e Descrição;
  4. 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.
  5. 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.

Closed2.2 - Vincular papel à aplicação de comunicação com a eSales


Agora, é necessário vincular o papel criado à aplicação criada nos passos anteriores. Para isso, siga os passos abaixo:

  1. Acesse Tecnologia > Administração > Autorização > Gestão de Papéis;
  2. Em Pesquisar papéis, digite Banking;
  3. Localize o papel e clique em Editar;
      Closed Caso não seja possível localizar o papel Banking, siga esses abaixo para realizar a criação

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

      1. Acesse Tecnologia > Administração > Autorização > Gestão de Papéis;
      2. Clique em Novo papel;
      3. Informe os campos Nome do papel e Descrição do papel;
      4. Clique em Salvar;
      5. Acesse a guia Permissões;
      6. Na opção Agrupar por, selecione Serviço;
      7. Preencha o campo Pesquisar domínios / serviços com a informação erpx_bnk e clique em Filtrar;
      8. 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;
      9. 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;
      10. 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;
      11. Clique em Salvar.

      Tabelas

      Closederpx_bnk
      Domínio / ServiçoPermissão
      erpx_bnk / foundationPrimitiva responsável pelo retorno se o cliente possui a conta bancária implantada no banking

      res://senior.com.br/erpx_bnk/foundation/queries/listServiceStatusReceivable
      erpx_bnk / onboardingautenticacaoBtg

      res://senior.com.br/erpx_bnk/onboarding/entities/autenticacaoBtg
      erpx_bnk / onboardingautenticacaoBtgHistorico

      res://senior.com.br/erpx_bnk/onboarding/entities/autenticacaoBtgHistorico
      erpx_bnk / onboardingPrimitiva responsável por gerar a url de consentimento com o banco BTG

      res://senior.com.br/erpx_bnk/onboarding/actions/gerarUrlConsentimentoBtg
      erpx_bnk / onboardingPrimitiva responsável por gerar os tokens de autenticação com o banco BTG

      res://senior.com.br/erpx_bnk/onboarding/actions/gerarAutenticacaoBtg
      erpx_bnk_cob / boleto

      cobrancaDadosBoleto

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaDadosBoleto

      erpx_bnk_cob / boletocobrancaItemBoleto

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoleto
      erpx_bnk_cob / boletocobrancaItemBoletoDescontoDataFixa

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoDescontoDataFixa
      erpx_bnk_cob / boletocobrancaItemBoletoErro

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoErro
      erpx_bnk_cob / boletocobrancaItemBoletoHistorico

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoHistorico
      erpx_bnk_cob / boletocobrancaItemBoletoHistoricoMotivoOcorrencia

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoHistoricoMotivoOcorrencia
      erpx_bnk_cob / boletocobrancaItemBoletoMensagem

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoMensagem
      erpx_bnk_cob / boletocobrancaItemBoletoRegistro

      res://senior.com.br/erpx_bnk_cob/boleto/entities/cobrancaItemBoletoRegistro
      erpx_bnk_cob / boletoe001pes

      res://senior.com.br/erpx_bnk_cob/boleto/entities/e001pes
      erpx_bnk_cob / boletoe006pai

      res://senior.com.br/erpx_bnk_cob/boleto/entities/e006pai
      erpx_bnk_cob / boletoe007ufs

      res://senior.com.br/erpx_bnk_cob/boleto/entities/e007ufs
      erpx_bnk_cob / boletoe008rai

      res://senior.com.br/erpx_bnk_cob/boleto/entities/e008rai
      erpx_bnk_cob / boletoe085pes

      res://senior.com.br/erpx_bnk_cob/boleto/entities/e085pes
      erpx_bnk_cob / boletoItem da operação de registro boleto

      res://senior.com.br/erpx_bnk_cob/boleto/entities/operacaoItemBoleto
      erpx_bnk_cob / boletomotivoOcorrenciaBanco

      res://senior.com.br/erpx_bnk_cob/boleto/entities/motivoOcorrenciaBanco
      erpx_bnk_cob / boletoocorrenciaBanco

      res://senior.com.br/erpx_bnk_cob/boleto/entities/ocorrenciaBanco
      erpx_bnk_cob / boletoOperações de registro boleto

      res://senior.com.br/erpx_bnk_cob/boleto/entities/operacaoBoleto
      erpx_bnk_cob / boletoPrimitiva de listagem dos títulos de cobrança boleto

      res://senior.com.br/erpx_bnk_cob/boleto/queries/listTitulosCobrancaBoleto
      erpx_bnk_cob / boletoPrimitiva responsável pelas informações de acompanhamento da cobrança boleto

      res://senior.com.br/erpx_bnk_cob/boleto/queries/getAcompanhamentoCobrancaBoleto
      erpx_bnk_cob / boletoPrimitiva 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/getDetal
      erpx_bnk_cob / cobrancaAPI 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/retornoCobrancaBoletoBtg
      erpx_bnk_cob / cobrancaAPI 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/retornoCobrancaESales
      erpx_bnk_cob / cobrancaEntidade de dados da cobrança de boleto

      res://senior.com.br/erpx_bnk_cob/cobranca/entities/cobrancaDadosBoleto
      erpx_bnk_cob / cobrancaEntidade de dados do título de cobrança de boleto

      res://senior.com.br/erpx_bnk_cob/cobranca/entities/cobra
      erpx_bnk_cob / databaseasyncBatches

      res://senior.com.br/erpx_bnk_cob/database/entities/asyncBatches
      erpx_bnk_cob / databaseasyncReceivedMessage

      res://senior.com.br/erpx_bnk_cob/database/entities/asyncReceivedMessage
      erpx_bnk_cob / databaseasyncTransactions

      res://senior.com.br/erpx_bnk_cob/database/entities/asyncTransactions
      erpx_bnk_cob / databaseasyncTransactionsLog

      res://senior.com.br/erpx_bnk_cob/database/entities/asyncTransactionsLog
      erpx_bnk_cob / pixAPI pública responsável pela geração de cobrança do PIX

      res://senior.com.br/erpx_bnk_cob/pix/actions/registerPixBilling
      erpx_bnk_cob / pixAPI responsável pelo cancelamento do registro de cobrança do PIX

      res://senior.com.br/erpx_bnk_cob/pix/actions/cancelPixBilling
      erpx_bnk_cob / pixcancelamentoItemPix

      res://senior.com.br/erpx_bnk_cob/pix/entities/cancelamentoItemPix
      erpx_bnk_cob / pixcancelamentoPix

      res://senior.com.br/erpx_bnk_cob/pix/entities/cancelamentoPix
      erpx_bnk_cob / pixcobrancaDadosPix

      res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaDadosPix
      erpx_bnk_cob / pixcobrancaItemPix

      res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPix
      erpx_bnk_cob / pixcobrancaItemPixErro

      res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixErro
      erpx_bnk_cob / pixcobrancaItemPixHistorico

      res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixHistorico
      erpx_bnk_cob / pixcobrancaItemPixRegistro

      res://senior.com.br/erpx_bnk_cob/pix/entities/cobrancaItemPixRegistro
      erpx_bnk_cob / pixdescontoDataFixa

      res://senior.com.br/erpx_bnk_cob/pix/entities/descontoDataFixa
      erpx_bnk_cob / pixe001pes

      res://senior.com.br/erpx_bnk_cob/pix/entities/e001pes
      erpx_bnk_cob / pixe006pai

      res://senior.com.br/erpx_bnk_cob/pix/entities/e006pai
      erpx_bnk_cob / pixe007ufs

      res://senior.com.br/erpx_bnk_cob/pix/entities/e007ufs
      erpx_bnk_cob / pixe008rai

      res://senior.com.br/erpx_bnk_cob/pix/entities/e008rai
      erpx_bnk_cob / pixe070emp

      res://senior.com.br/erpx_bnk_cob/pix/entities/e070emp
      erpx_bnk_cob / pixe070fil

      res://senior.com.br/erpx_bnk_cob/pix/entities/e070fil
      erpx_bnk_cob / pixe085pes

      res://senior.com.br/erpx_bnk_cob/pix/entities/e085pes
      erpx_bnk_cob / pixinformacoesAdicionaisPix

      res://senior.com.br/erpx_bnk_cob/pix/entities/informacoesAdicionaisPix
      erpx_bnk_cob / pixPrimitiva de listagem dos títulos na tela de cobranças PIX

      res://senior.com.br/erpx_bnk_cob/pix/queries/listTitulosCobrancaPix
      erpx_bnk_cob / pixPrimitiva responsável pelas informações do acompanhamento da tela de cobranças PIX

      res://senior.com.br/erpx_bnk_cob/pix/queries/getAcompanhamentoCobrancaPix
      erpx_bnk_cob / pixPrimitiva responsável pelos detalhes do título

      res://senior.com.br/erpx_bnk_cob/pix/queries/getDetalhe
      erpx_bnk_cob / register_boletoExecuçã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_boletoGeração de cobrança do boleto

      res://senior.com.br/erpx_bnk_cob/register_boleto/actions/registerBankSlipBilling
      erpx_bnk_cob / register_pixAPI pública responsável pela geração de cobrança do PIX

      res://senior.com.br/erpx_bnk_cob/register_pix/actions/registerPixBilling
      erpx_bnk_cob / register_pixAPI responsável pelo cancelamento do registro de cobrança do PIX

      res://senior.com.br/erpx_bnk_cob/register_pix/actions/cancelPixBilling
      erpx_bnk_cob / register_pixcancelamentoPix

      res://senior.com.br/erpx_bnk_cob/register_pix/entities/cancelamentoPix
      erpx_bnk_cob / register_pixcobrancaDadosPix

      res://senior.com.br/erpx_bnk_cob/register_pix/entities/cobrancaDadosPix
      erpx_bnk_cob / register_pixcobrancaItemPix

      res://senior.com.br/erpx_bnk_cob/register_pix/entities/cobrancaItemPix
      erpx_bnk_cob / register_pixe070emp

      res://senior.com.br/erpx_bnk_cob/register_pix/entities/e070emp
      erpx_bnk_cob / register_pixe070fil

      res://senior.com.br/erpx_bnk_cob/register_pix/entities/e07
      Closedplatform / events_hub
      Domínio / ServiçoPermissão
      platform / events_hubWebhook

      res://senior.com.br/platform/events_hub/webhook
  4. Acesse a guia Aplicações;
  5. Localize na lista de aplicações a aplicação criada anteriormente, e ative a associação;
  6. Clique em Salvar.

Após isso, é preciso habilitar os recursos que necessitam de acesso. Acesse a guia Permissões e siga os passos abaixo:

  1. Em Agrupar por, selecione a opção Serviço;
  2. Preencha o campo de pesquisa com erpx_bnk, para que sejam listados todos os serviços do Banking;
  3. Em cada serviço listado, clique no botão para expandir, e habilite todas as opções para Processar e Visualizar;
  4. 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:

  1. Ainda na guia Permissões, mantenha a opção Agrupar por como Serviço;
  2. Preencha o campo de pesquisa com events;
  3. No serviço listado platform / events_hub, clique no botão para expandir e habilite todas as opções.
Closed2.3 - Teste para validação das credenciais

Para testar as credenciais e garantir o correto funcionamento antes de configurar o eSales, siga os seguintes passos:

  1. 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.
  2. Caso a chamada retorne corretamente o token gerado, é possível dar continuidade no processo:

    3. 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:

Closed2.4 - Vincular as credenciais da eSales na plataforma Senior X
  1. 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.
  2. 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:

ClosedcURL para o Pix cobrança 
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": []
                }
            }
        }
    ]
}'
ClosedcURL para o boleto cobrança 
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": []
                }
            }
        }
    ]
}'
ClosedcURL para o pagamento boleto 
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"
        }
    ]
}'
ClosedcURL para o pagamento Pix QR Code 
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"
        }
    ]
}'
ClosedcURL para o pagamento PIX transferências 
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:

Closed2.5 - Parametrizar e habilitar o serviço na PDL

Realize as parametrizações abaixo para habilitar o cancelamento da conbrança Pix:

  1. Acesse Tecnologia > Configuração > Por tenant;
  2. Com a barra de rolagem, desça a tela até a sessão de Domínios e Serviços;
  3. Preencha o campo Filtrar domínios com erpx_bnk;
  4. Acesse o registro erpx_bnk, e clique no botão Editar do serviço foundation;
  5. 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;
  6. Clique no botão Salvar.
Closed2.6 - Testes para validar se a integração está ocorrendo com sucesso

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.

Este artigo ajudou você?

Base de Conhecimento

Portal de Exigências Legais

Contrato de Licenciamento de Software e Prestação de Serviços

Documentação em outros idiomas:

English

Español

Senior Store

Universidade Corporativa

Fórum de Produtos

Trabalhe conosco

Blog

Todos os direitos de cópias reservadas para Senior Sistemas S.A.

A reprodução não autorizada desta publicação, no todo ou em parte, constitui violação dos direitos autorais (Lei 9.610/98).

Ainda com dúvidas?

Fale com a SARA!

Ver site completo