Financeiro - Integração ERP Banking

1. Acesse Menu > Gestão empresarial > ERP X > Cadastro > Ferramentas > Configuração ambiente ERP Banking;
2. Clique em Ler termos de aceite;
   
   
3. Leia e marque a opção Li e aceito as condições do termo, e clique em Continuar;
   
   
4. Em Configurções > Parametrizações, em parâmetros informe @AUTOPREPARE e no CNPJ informe os dados da empresa; (organização com contrato com a Senior)
   
   
5. Clique em Confirmar.

• Parametrização para a aplicação ERP Senior Mega XT utilizar os serviços do ERPBanking:

1. Acesse a Platform-X e clique em Menu Tecnologia > Administração > Gerenciamento de aplicações;
2. Clique em Cadastrar uma Nova aplicação;
3. Em 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; (serão usados para parametrização da tabela fin_hbkconfig)
6. Clique novamente em Salvar.

1. Acesse a Platform-X e clique em Menu Tecnologia > Administração > Autorização > Gestão dos Papéis;
2. Clique em Editar na opção Banking;
   
   
3. Acesse a guia Aplicações e associe a nova aplicação;
   
   
4. Clique em Salvar e em seguida em Voltar.

Ao editar a nova aplicação acessando a Plataforma Senior X, em Menu Tecnologia > Administração > Gerenciamento de aplicações, os papeis atribuídos serão apresentados:

Os serviços do ERP Banking disponibilizarão eventos para que o ERP Senior Mega XT atualize as informações no Módulo Financeiro. Para os serviços se comunicarem se faz necessário a criação de Webhooks dentro da Platform Senior X.

1. Acesse o postman;
2. Com o postman aberto, selecione o cURL abaixo de exemplo;
3. Com os dados inseridos no postman, clique na guia authorization e selecione a opção Bearer Token;
4. Coloque o Bearer token do usuário/tenant que irá criar o webhook;
5. Clique em send;

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": "boleto",
        "primitiveName": "bankSlipCreated"
    },
    "endpoints": [
        {
            "id": "{{$guid}}",
            "url": "https://rest.megaerp.online/api/financeiroErpBanking/response/bankSlipCreated",
            "active": true,
            "headers": [
                {
                    "key": "X-Send-Async",
                    "value": "true"
                }
            ],
            "applyRetry": false,
            "authByEndpoint": true,
            "ignoreHttpCode": [],
            "authSettings": {
                "internalAuthentication": false,
                "authTestSuccess": true,
                "url": "https://rest.megaerp.online/api/Auth/SignIn",
                "headers": [
                    {
                        "key": "tenantid",
                        "value": "/localizar o id do cliente no cloud ou on premise”
                    },
                    {
                        "key": "grantType",
                        "value": "Api"
                    }
                ],
                "payload": [
                    {
                        "key": "userName",
                        "value": "Mega"
                    },
                    {
                        "key": "password",
                        "value": "Meg"
                    }
                ],
                "payloadFilters": [
                    {
                        "key": "TOKEN",
                        "value": "$.accessToken"
                    }
                ],
                "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_cob",
    "serviceName": "boleto",
    "primitiveName": "bankSlipReceived"
},
"endpoints": [
    {
        "id": "{{$guid}}",
        "url": "https://rest.megaerp.online/api/financeiroErpBanking/response/bankSlipReceived",
        "active": true,
        "headers": [
            {
                "key": "X-Send-Async",
                "value": "true"
            }
        ],
        "applyRetry": false,
        "authByEndpoint": true,
        "ignoreHttpCode": [],
        "authSettings": {
            "internalAuthentication": false,
            "authTestSuccess": true,
            "url": "https://rest.megaerp.online/api/Auth/SignIn",
            "headers": [
                {
                    "key": "tenantid",
                    "value": "/ localizar o id do cliente no cloud ou on premise"
                },
                {
                    "key": "grantType",
                    "value": "Api"
                }
            ],
            "payload": [
                {
                    "key": "userName",
                    "value": "Mega"
                },
                {
                    "key": "password",
                    "value": "Meg"
                }
            ],
            "payloadFilters": [
                {
                    "key": "TOKEN",
                    "value": "$.accessToken"
                }
            ],
            "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_tes",
    "serviceName": "contas",
    "primitiveName": "statementUpdated "
},
"endpoints": [
    {
        "id": "{{$guid}}",
        "url": "https://rest.megaerp.online/api/financeiroErpBanking/accountStatement/movement",
        "active": true,
        "headers": [
            {
                "key": "X-Send-Async",
                "value": "true"
            }
        ],
        "applyRetry": false,
        "authByEndpoint": true,
        "ignoreHttpCode": [],
        "authSettings": {
            "internalAuthentication": false,
            "authTestSuccess": true,
            "url": "https://rest.megaerp.online/api/Auth/SignIn",
            "headers": [
                {
                    "key": "tenantid",
                    "value": "/ localizar o id do cliente no cloud ou on premise"
                },
                {
                    "key": "grantType",
                    "value": "Api"
                }
            ],
            "payload": [
                {
                    "key": "userName",
                    "value": "Mega"
                },
                {
                    "key": "password",
                    "value": "Meg"
                }
            ],
            "payloadFilters": [
                {
                    "key": "TOKEN",
                    "value": "$.accessToken"
                }
            ],
            "refreshToken": {
                "url": "",
                "payload": []
            }
        },
        "_discriminator": "completeEndpointDTO"
    }
]
}'

Cadastrar a Empresa e verifica se as Empresas e Filiais estão cadastradas no ERP X. Caso não esteja, efetuar os devidos cadastrados:

• Cadastro Empresa

  1. Acesse ERPX > Cadastros > Empresas > Adicionar;
  2. Preencher todos os campos obrigatórios.
  3. Clique em Salvar;

• Cadastro Filial

  1. Acesse ERPX > Cadastros > Filiais > Adicionar;
  2. Preencher todos os campos obrigatórios.
  3. Clique em Salvar;

Acesse o ERP Senior Mega e:

1. Clique em Menu > Empresarial > Global > Cadastros > Bancos e Agências;
2. Selecione o Banco;
3. Clique em Inserir;
4. Preencha os campos: Código, Digito, Fantasia e Nome.

Acesse o ERP Senior Mega e:

1. Clique em Menu > Empresarial > Global > Cadastros > Bancos e Agências;
2. Selecione o Banco;
3. Clique na guia Agência > Inserir
   Para BTG, a agência deverá ser cadastrada sem estar antecedida por zeros, como por exemplo, 0050 deverá ser informado apenas 50.

Acesse o ERP Senior Mega e:

1. Clique em Menu > Empresarial > Global > Cadastros > Agentes;
2. Selecione no agente Conta Financeira e em Inserir
   O processo de cadastro da Conta Financeira é exatamente como ocorre atualmente no ERP Senior Mega.

A parametrização tem o objetivo de garantir a dependência interna, maioria das tratativas ocorrerão no Banking. Na maioria dos casos, o preenchimento será realizadocom informações mínimas para os novos bancos, conforme ilustrado nas telas:

• Remessa

  
  
  
  
  
  

  Caso seja usado o nosso número, indique a fórmula do banco. Nesse exemplo, consta o BTG:

  
  

• Retorno

  
  

  A guia Motivos de Erros será tratada diretamente pelo ERPBanking não sendo necessário a seu cadastro no ERP Senior Mega.

O parâmetro Integra com o ERP Banking é utilizado para indicar que a jornada de cobrança ocorrerá via ERPBanking.

Acesso o ERP Senior Mega, e:

1. Clique em Menu > Empresarial > Financeiro > Office Banking;
2. Selecione a Conta Financeira desejada;
3. Selecione as operações Envio de Arquivo e a modalidade Cobrança Bancária;
4. Selecione a opção Inserir para cadastro do Contrato de Cobrança;

• Carteira

  
  

• Numeração Define a faixa de valor para numeração sequencial dos documentos cobrados através do Contrato.

  
  

• Contas Financeiras Realiza o cadastro das demais conta financeiras que poderão ser utilizadas com o Contrato de Cobrança

  
  

Acesse o ERP Senior Mega, e:

1. Clique em Menu > Todos os Módulos > Configurações Globais > Financeiro

Realiza o cadastro dos Tipos de Documentos (Categoria de Lançamento), caso ainda não esteja cadastrado para o Banco devido.

Acesse o ERP Senior Mega, e:

1. Clique em Menu > Empresarial > Financeiro > Cadastros > Bancos > Tipo de Documentos dos Bancos;
2. Efetue a parametrização;
3. Clique em Confirmar.

Para execução da Integração com o ERPBanking, faz-se necessário o uso da Agenda esteja inicializada.

As das pastas de envio/retorno de arquivos não são usadas na integração com o ERP Banking, mas esses campos precisam ser preenchidos com caminhos válidos por uma questão de dependência técnica do server Agenda HBK. Caso já possua a parametrização por conta da Nexxera poderá continuar a mesma. Caso seja para única e exclusivamente para o ERP Banking não se faz necessário a informação do server.

É necessário informar :

• Código de usuário para gerar os lançamentos;
• Temporizador da Agenda;
• O nome do computador que executa a Agenda.

Não se faz necessário a informação do campo importação de Extrato. No ERP Senior Mega, e:

1. Clique em Menu > Empresarial > Financeiro > Office Banking/Agenda;
2. Efetue a parametrização;
3. Clique em Confirmar.

Para que seja possível o ERP Senior MEGA acessar o ERP Banking, faz-se necessário efetuar o cadastro na tabela denominada Fin_bnkconfig. O cadastro ocorrerá por Filial

Os campos destacados em azul são informações fixas, podendo serem copiadas diretamente dessa documentação:

• FIL_IN_CODIGO = Código da Filial
• ORG_TAU_ST_CODIGO = Tipo do Agente
• CFG_ST _TENANTNAME = Tenant na Platform Senior X

Exemplo: totalcombr

• CFG_ST_URLAUTHENTICATION = URL para autenticação na Platform Senior X: http://platform.senior.com.br/t/senior.com.br/bridge/1.0/anonymous/rest/platform/authentication/actions/loginWithKey
• CFG_ST_URLREFRESHTOKEN = URL para atualização do Token na Platform Senior X: http://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/refreshToken
• CFG_ST_URLBOLETO = URL para registro de boleto na Plataforma Senior X: http://platform.senior.com.br/t/senior.com.br/bridge/1.0/rest/erpx_bnk_cob/register_boleto/actions/registerBankSlipBilling
• CFG_ST_CLIENTID : 6b36eca0-16b8-4401-88c8-e56c4b941b14
• CFG_ST_ACCESSKEY = Access Key na Platform Senior X (Ver item Criar Aplicação Platform Senior X)
• CFG_ST_SECRET = Secret na Plataforma Senior X (Ver item Criar Aplicação Platform Senior X)
• CFG_ST_URLCOMUNICADOR = URL do comunicador Mega Empresarial Solicitar endereço IP/Porta interno/externo com o Suporte Mega Cloud. Exemplo: http://rest.megacloud.local:8200/api/financeiroErpBanking/remittanceFile/send
• CFG_ST_TENANTIDMEGA = ID do Tenant na Mega Para clientes On Premisse não é necessário essa informação.

O objetivo desse teste é auxiliar na validação se a API Mega de comunicação com o ERP Banking está ativa Acessar pelo browser: api/financeiroErpBanking/test/status

Exemplo: http://localhost:5000/api/financeiroErpBanking/test/status

FIN_BNKREMESSA - Remessas enviadas para o ERP Banking.

FIN_BNKARQUIVO - Arquivos JSON das remessas enviadas para o ERP Banking.

FIN_BNKDOCUMENTO - Documentos dos arquivos JSON.

FIN_BNKRETORNO - Retornos recebidos do ERP Banking.