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


