Integração do ERP X com o ERP Banking
A integração entre o ERP X e o ERP Banking permite a troca de dados financeiros e bancários, viabilizando operações como cobrança e pagamento de títulos via PIX e boleto bancário, além da consulta e sincronização automatizada de extratos bancários.
Todos os títulos devidamente parametrizados são enviados para o ERP Banking. Nas operações via PIX, o ERP Banking retorna os QR Codes gerados e as informações referentes aos pagamentos realizados.
Para que a integração funcione corretamente, todas as parametrizações descritas nesta documentação devem ser realizadas previamente.
Pré-requisitos
- Possuir integração ativa com o ERP Banking;
- Possuir contas internas devidamente parametrizadas;
- Possuir bancos homologados e aceitos pelo ERP Banking.
Parametrizações
1. Contas a receber
Configure o portador do banco para integrar com o ERP Banking.
Carteira
Cadastre uma carteira acessando Cadastros > Finanças > Contas a pagar e receber > Carteiras de cobrança
A carteira deve ser do tipo Terceiros.
Sugestão de cadastro:
- Código: 07
- Descrição: Cobrança PIX
- Abreviatura: PIX Cob.
- Responsável pela carteira: Terceiro
Portador
Cadastre o portador em Cadastros > Finanças > Portadores > Cadastro
Configure os seguintes parâmetros:
- A premissa é que você associe a uma conta interna pertencente a um banco aceito no Banking;
- Selecione o campo Pix QR code gerado pelo ERP banking;
- Preencha os campos Carteira dos títulos de PIX QR code, Tipo de chave e Chave PIX.
Forma de pagamento
Cadastre a forma de pagamento em Cadastros > Mercado e suprimentos > Formas de pagamento
Configure os seguintes parâmetros:
- Campo Tipo pagamento com o valor 17 - Pagamento instantâneo (PIX);
- Na especialização do Contas a Receber, guia Geral, informe no campo Portador para remessa de títulos o portador ativo para geração do PIX.
Carteira
Cadastre uma carteira acessando Cadastros > Finanças > Contas a pagar e receber > Carteiras de cobrança
A carteira deve ser do tipo ERP Banking.
Sugestão de cadastro:
- Código: 08
- Descrição: Cobrança ERP Banking
- Abreviatura: ERP Banking
- Responsável pela carteira: ERP Banking
Também é necessário relacionar a carteira com o banco em Cadastros > Finanças > Contas a pagar e receber > Cobrança Escritural > Relacionamentos Bancários > Carteiras de Cobrança
Portador
Cadastre o portador em Cadastros > Finanças > Portadores > Cadastro
Configure os seguintes parâmetros:
- A premissa é que você associe a uma conta interna pertencente a um banco aceito no Banking
- Selecione o campo Cobrança escritural gerado pelo ERP Banking;
- Preencha o campo Carteira remessa de títulos de Cobrança ERP Banking.
Forma de pagamento
Cadastre a forma de pagamento em Cadastros > Mercado e suprimentos > Formas de pagamento
Configure os seguintes parâmetros:
- Campo Tipo pagamento com o valor 15 – Boleto Bancário;
- Na especialização do Contas a Receber, guia Geral, informe o campo Portador para remessa de títulos o portador ativo para geração da cobrança.
2. Contas a pagar
Configure a conta interna do banco para integração com o ERP Banking.
Acesse Cadastros > Finanças > Tesouraria > Contas internas
Nos detalhes da conta interna, na guia Contas a Pagar, habilite o parâmetro Utiliza pagamento eletrônico banking.
De acordo com o banco informado, será apresentado o serviços disponíveis através das informações no ícone .
Acesse os bancos disponíveis para utilização com o ERP Banking.
Observação
Os dados para pagamento eletrônico são configurados exclusivamente na conta interna.
Ative o módulo DDA Banking com ERPX para disponibilizar a integração com o ERP Banking.
Acesse Cadastros > Ferramentas > Módulos.
Clique em Adicionar e, no campo Módulos, selecione a opção DDA Banking com ERPX.
Marque o parâmetro Ativo e clique em Salvar.
Observação
Após a ativação do módulo, as configurações do DDA Banking com ERPX ficam disponíveis para parametrização.
No momento, esta funcionalidade está disponível somente para contas vinculadas ao BTG Banking
3. Tesouraria: Gestão de Caixa
Não é necessário realizar parametrizações adicionais.
Apenas certifique-se de que os dados das contas internas estejam de acordo com os dados existentes no Gestão de Caixa.
Integração contínua
A integração entre o ERP X e o ERP Banking ocorre continuamente, permitindo sincronização automática das operações financeiras.
Relatório Pix QR Code
É possível encaminhar para o cliente ou então realizar o download do relatório com o QR Code do Pix gerado. Veja abaixo como proceder:
- Acesse a tela de Consulta de Títulos a Receber, localizada em Finanças > Gestão do contas a receber > Consultar títulos;
- Em Filtros, realize a pesquisa dos títulos desejados;
- Na listagem dos títulos a receber,o botão Ações exibe as seguintes opções quando o título está com a Situação igual a Aberto e a Situação Banking igual a Pix Gerado:
- Cancelar Pix QR Code: cancela o Pix Gerado. A situação do título volta para Aberto Normal;
- Enviar Pix QR Code: envia o relatório do Pix QR Code para o e-mail do cliente;
- Download Pix QR Code: permite o download do relatório do Pix QR Code.
Observação
Para a geração de títulos por origem de Nota fiscal de Saída: quando a geração do Pix está ativada e a forma de pagamento utilizada é a 17 - Pagamento Instantâneo (PIX), o cliente recebe o relatório Pix QR Code por e-mail junto com a Danfe.
O relatório do Pix QR Code exibe as seguintes informações:
- QR Code do Pix gerado;
- Título;
- Valor líquido;
- Vencimento;
- Observação;
- Informações do Pix Copia e Cola.
- Chave Pix;
- Banco;
- Razão Social;
- CNPJ.
- CNPJ;
- Razão Social.
Também é possível gerar e registrar boletos de forma integrada com o ERP Banking.
Para isso, selecione uma forma de pagamento parametrizada com o tipo de pagamento boleto bancário.
Ao realizar essa parametrização:
- O ERP X envia ao ERP Banking a solicitação de registro do título;
- O ERP Banking aciona o parceiro responsável para efetuar o registro do boleto;
- O boleto é gerado automaticamente;
- O título permanece com a situação Aberto (cobrança eletrônica).
O ERP Banking realiza a gestão do título e efetua a liquidação automática quando ocorrer a baixa.
Os títulos do contas a pagar que possuem conta interna sugerida, forma de pagamento e tipo de pagamento informados são enviados automaticamente ao ERP Banking, por meio dos endpoints de boleto e de Pix.
Caso seja utilizado a rotina de aprovação do contas a pagar, o título será enviado após a aprovação.
O tipo de pagamento do título determina como ele é enviado ao ERP Banking:
| Forma de Pagamento | Tipo de Pagamento compatível | Enviado ao ERP Banking? |
|---|---|---|
| Pix | Pix QR Code | Sim |
| Pix | Pix Transferência | Sim |
| Boleto | Boleto | Sim |
| Boleto | Guia com código de barras | Sim |
| Boleto | GRU | Sim |
| Boleto | DARF | Sim |
| Boleto | GPS | Sim |
| TED | — | Não |
Títulos com tipo de pagamento TED não são enviados ao ERP Banking.
Ao ser enviado, o título assume a situação Pagamento ERP Banking, que bloqueia a edição, a baixa manual e a exclusão enquanto o pagamento estiver sendo processado pelo ERP Banking.
Na listagem de títulos a pagar é exibido o status do pagamento Banking, que pode assumir os seguintes valores:
- Não enviado;
- Processando;
- Agendado;
- Aprovado;
- Cancelado;
- Pago;
- Estornado.
Conforme o ERP Banking processa o pagamento, o ERP X recebe automaticamente os eventos correspondentes e atualiza a situação e o histórico do título:
- Quando o pagamento é agendado ou aprovado, o status é atualizado no título e um novo registro é incluído no histórico;
- Quando o pagamento é efetivado (pago), o sistema realiza automaticamente a baixa do título no contas a pagar;
- Quando o pagamento é cancelado, recusado, estornado ou ocorre erro no processamento, o título retorna automaticamente para a situação Aberto, ficando novamente disponível para edição.
A integração DDA Banking conecta o Contas a pagar do ERP X ao DDA (Débito Direto Autorizado) do ERP Banking. Com ela, os títulos a pagar do tipo boleto são enviados, conciliados e pagos eletronicamente, sem digitação manual de código de barras.
Benefícios:
- Menos trabalho manual (o código de barras deixa de ser digitado);
- Mais segurança e integridade nas operações;
- Visibilidade completa do ciclo de vida do título, pelo histórico;
- Conciliação mais rápida e confiável.
Títulos elegíveis: apenas forma de pagamento tipo 15 - Boleto (código de barras).
Na associação (o Banking concilia o título com um boleto DDA), o ERP senior X automaticamente:
- Grava o tipo de pagamento como Boleto;
- Preenche o código de barras do boleto;
- Registra a entrada "Boleto DDA associado" no histórico.
Na desassociação (feita pela tela do Banking), o ERP senior X automaticamente:
- Limpa o tipo de pagamento;
- Re-sugere o tipo de pagamento;
- Registra a entrada Boleto DDA desassociado no histórico.
Observação
Se o ERP Banking estiver parametrizado para permitir tolerância de valor ou de vencimento, essas alterações serão refletidas no ERP e registradas no histórico.
O valor e o vencimento originais do título serão preservados. Nesse cenário:
- Valores acima do original serão considerados como acréscimos;
- Valores abaixo do original serão considerados como descontos;
- O novo vencimento será registrado como vencimento prorrogado/provável pagamento.
A tela de Título a pagar possui um painel de histórico que reúne todas as operações do título — manuais e automáticas (envio ao DDA, associação e desassociação de boletos).
Veja abaixo como proceder:
- Acesse a tela de Título a pagar;
- Abra o título desejado;
- Abra a painel de histórico;
- Consulte a lista de operações registradas.
Use o painel para conferir associações/desassociações, entender por que o tipo de pagamento mudou e auditar as operações do título.
É possível reprocessar lotes nas situações Excluído com pendênciase Processado com pendências.
Um exemplo de utilização ocorre quando um lote de inclusão de título associado a boleto DDA é excluído e permanece na situação Excluído com pendências. Nessa situação, o lote pode ser reprocessado.
Veja abaixo como proceder:
- Acesse a tela de lotes financeiros;
- Localize o lote em Excluído com pendências ou Processado com pendências;
- Utilize a ação de reprocessamento do lote;
- Acompanhe a nova situação do lote.
Tratamento de pendências
Abra o lote e verifique a mensagem, consulte o histórico do título relacionado, ajuste o necessário (ou aguarde o retorno do Banking) e reprocesse quando a situação permitir. Se a pendência persistir, procure o suporte com o número do lote e do título.
Requisitos
- Existir uma filial cadastrada no ERP X com o CNPJ informado no extrato;
- Existir um banco cadastrado no ERP X conforme o código do banco informado no extrato;
- Existir uma conta interna cadastrada no ERP X conforme empresa, CNPJ e banco informados no extrato;
- O número da conta deve estar cadastrado conforme informado no extrato.
Importante
- Zeros à esquerda são considerados na comparação das contas bancárias.
- O dígito verificador da conta pode ser cadastrado separado ou não por hífen ("-").
Os movimentos bancários enviados pelo ERP Banking são automaticamente integrados ao ERP X e exibidos na tabela de extratos da tela de Conciliação.
O recebimento do registro de extrato ocorre quando o evento de inclusão de extrato é disparado pelo ERP Banking na Senior X Platform, por meio do serviço erpx_bnk_cob/ig5_integration (configurado acima), o evento erpx_bnk_tes/contas/statementUpdated do ERP Banking gerará uma requisição para o endpoint abaixo do ERP_SERVICE:
- Endpoint: erp_fin/ig5_tesouraria/signals/incluirExtrato.
A conciliação também ocorre automaticamente, utilizando critérios como:
- Data;
- Valor;
- Número do documento;
- Tipo de movimento (débito ou crédito).
Essa integração elimina a necessidade de importação manual de extratos, permitindo processamento em tempo real.
Veja também a documentação de Gestão de Caixa do ERP Banking.
English
Español
English
Español


