Portal de Clientes - Integração ERP Banking

1. Na plataforma Senior X, acesse Tecnologia / Administração / Gerenciamento de aplicações;

2. Cadastre uma Nova aplicação;

3. Na Geração de tokens, selecione a opção Reutilizar o mesmo token para as múltiplas sessões da aplicação;

4. Clique em Salvar;

5. Copie a Chave de acesso e o Secret;

6. Clique novamente em Salvar.

Exemplo de aplicação criada

• Aplicações:

• Gerenciamento da aplicação:

Caso a chave gerada para o campo Secret no passo 5 seja perdida, é preciso executar o processo abaixo:

1. Acesse o ERP Senior X com um usuário Administrador;

2. Vá até o menu Tecnologia / Administração / Gerenciamento de aplicações;

3. Edite o registro da integração do ERP Senior X com a solução de ERP Banking (A aplicação criada no passo anterior);

4. Clique no botão Remover.

5. Após remover, inicie o processo de configuração do início novamente.

1. Na plataforma Senior X, acesse Tecnologia / Administração / Autorização / Gestão dos Papéis;

2. Clique em Editar sobre a opção admin;

3. Acesse a guia Aplicações e associe a nova aplicação;

4. Clique em Salvar e em seguida em Voltar;

5. Clique em Editar sobre a opção Banking;

6. Acesse a guia Aplicações e associe a nova aplicação;

7. Clique em Salvar e em seguida em Voltar.

Ao editar a nova aplicação acessando a plataforma Senior X pelo menu Tecnologia / Administração / Gerenciamento de aplicações, os papeis atribuídos serão apresentados:

1. Na plataforma Senior X, clique em Novo consentimento;

2. Na etapa de Parametrizações, preencha o campo CNPJ, e em seguida, habilite os escopos desejados;

3. Clique em Iniciar o consentimento;

4. Você é encaminhado para a tela de cadastro do BTG, onde é necessário possuir uma conta cadastrada para acessar;

5. Ao acessar, são mostrados os escopos que foram habilitados na etapa de Parametrização, no ERP Senior X. Clique em Continuar;

6. Você é encaminhado para a tela de confirmação CNPJ. Após confirmar, você é redirecionado para o ERP Senior X;

7. Já no ERP Senior X, o consentimento é finalizado;

8. Clique em Finalizar.

Após isso, o escopo habilitado passa a ser exibido na Lista de Consentimentos, e através do botão Ações, é possível Refazer o consentimento ou então Consultar o histórico.

Veja também:

• Onboarding BTG

Assim que o banco BTG atualizar o status do título para a plataforma Senior X, serão disparados eventos para atualização do boleto no Portal de Clientes.

Evento erpx_bnk_cob/boleto/bankSlipCreated: Processamento de confirmação de entrada

Ao receber o título, o banco retornará informando se o mesmo foi aceito. Dessa forma, é necessário o cadastro do webhook bankSlipCreated para que o boleto seja atualizado no Portal de Clientes e fique disponível para emissão.

Para cadastrar o evento webhook erpx_bnk_cob/boleto/bankSlipCreated, será necessário ter o endereço do serviço IntegraTitulosEntrada da API Mega, responsável pela integração de entrada de títulos no Portal de Clientes.

Após obter o endereço:

1. Acesse a plataforma Senior X / Tecnologia Customização / Events hub / Webhooks;

2. Para realizar o cadastro, clique em Novo;

3. No campo Evento, digite o texto bankSlipCreated para que o evento erpx_bnk_cob/boleto/bankSlipCreated seja apresentado;

4. Preencha o campo URL com o endereço do serviço IntegraTitulosEntrada da API Mega;

5. Clique em Adicionar.

Evento erpx_bnk_cob/boleto/bankSlipReceived: Processamento de baixa

Assim que o pagamento for processado, o banco retornará para a plataforma Senior X a solicitação de baixa do título. Dessa forma, é necessário o cadastro do webhook bankSlipReceived para que o boleto seja baixado no Portal de Clientes e Mega.

Para cadastrar o evento webhook erpx_bnk_cob/boleto/bankSlipReceived, será necessário ter o endereço do serviço IntegraTitulosPagamento da API Mega, responsável pela integração de baixa de títulos no Portal de Clientes.

Após obter o endereço:

1. Acesse a plataforma Senior X / Tecnologia / Customização / Events hub / Webhooks;

2. Para realizar o cadastro, clique em Novo;

3. No campo Evento, digite o texto bankSlipReceived para que o evento erpx_bnk_cob/boleto/bankSlipReceived seja apresentado;

4. Preencha o campo URL com o endereço do serviço IntegraTitulosPagamento da API Mega;

5. Clique em Adicionar.

Para recuperar o valor do campo Nome:

1. Acesse a plataforma Senior X pelo menu Tecnologia / Administração / Gestão dos Tenants / Configurar;

2. Copie o valor apresentado do Tenant;

No exemplo a seguir, o nome do tenant é portalmegacombr

3. Acesse o Portal de Clientes com login administrativo, menu Parâmetros / Integração Senior X;

4. Cole o valor no campo Nome;

5. Preencha os campos Chave de acesso e Secret de acordo com o cadastro da aplicação realizado na plataforma Senior menu Tecnologia / Administração / Gerenciamento de aplicações;

6. Clique em Salvar.

Log

Será gerado log operacional da alteração. O campo Secret não será gravado.

• Local: Portal de Clientes / Usuário Administrador / Relatórios / Log.

Para cadastro da conta financeira e do contrato de cobrança, será necessário realizar os seguintes passos:

Cadastro da agência

1. Acesse Mega ERP / Empresarial / Global / Cadastros / Bancos e Agências;

2. Selecione o banco BTG;

3. Clique na guia Agência e em Inserir;

4. Após preenchimento dos campos, clique em Confirmar.

Cadastro da conta financeira

1. Acesse Mega ERP / Empresarial / Global / Cadastros / Agentes;

2. Clique em Avançar;

3. Selecione as guias Conta Financeira e Fornecedor;

4. Preencha os campos:

5. Nome, na guia Geral (de acordo com a configuração do Portal de Clientes, o nome do beneficiário poderá ser o nome da filial ou da conta financeira vinculada a este cadastro);

6. Banco, Agência e Número da conta na guia Conta Financeira;

Cadastro do contrato bancário

1. Acesse Mega ERP/ Empresarial / Financeiro / Office Banking;

2. Clique em Avançar;

3. Selecione a conta financeira cadastrada no passo anterior;

4. Clique em Avançar;

5. Selecione a operação Envio de Arquivo e a modalidade Cobrança Bancária;

6. Clique em Avançar;

7. Será apresentada a tela do contrato bancário, clique em Inserir;

8. Acessar a guia Carteira e selecionar o parâmetro Gera Nosso Número.

9. Após o preenchimento dos demais campos, clique em Confirmar.

Cadastro da forma de cobrança

1. Acesse Mega ERP / Todos os Módulos / Configurações Globais / Financeiro / Parâmetros;

2. Clique em Editar;

3. Selecione a guia Forma de Cobrança;

4. Clique em Inserir;

5. Preencha os dados informando o contrato bancário e conta financeira cadastrados nos passos anteriores;

6. Também preencha o código da carteira e habilite o parâmetro Gera Nosso Número.

1. Acesse o Portal de Clientes com perfil Administrador / Parâmetros / Cobrança;

2. Selecione o empreendimento desejado;

3. Em seguida, selecione o contrato bancário e conta financeira criada no passo anterior.

1. Acesse o Portal de Clientes com perfil Administrador / Parâmetros / Parâmetros Gerais;

2. Selecione o empreendimento ou bem de terceiro desejado;

3. Acesse a guia Boleto;

4. Habilite o parâmetro Emite boleto pelo ERP Bank?;

5.Clique em Salvar.

Log

Será gravado log de alteração do novo parâmetro, nos logs operacionais do Portal de Clientes.

• Local: Portal de Clientes / Usuário Administrador / Relatórios / Log.

Em caso de erro no processamento da geração do boleto, é possível verificar o incidente com mais detalhes na Plataforma Senior X.

1. Acesse a plataforma Senior X / Tecnologia / Customização / Events hub / Webhooks;

2. Serão listados ao menos três webhooks:

3. Solicitação do boleto: erpx_bnk_cob / boleto / iniciarIntegracaoCobrancaBoletoBtg37297902000141

4. Confirmação de entrada do título: erpx_bnk_cob / boleto / bankSlipCreated

5. Confirmação de pagamento do título: erpx_bnk_cob / boleto / bankSlipReceived

3. Clique em Ações / Detalhes;

4. Expanda a requisição desejada. Será apresentado o payload (input) e a mensagem do erro (output).