Contas a receber (Comunicação bancária online)

Esta funcionalidade está disponível a partir do release 12.1.33.

01. VISÃO GERAL

O registro online de boletos tem por finalidade automatizar o processo de geração e registro dos boletos gerados pelas empresas, juntos aos bancos, utilizando comunicação com APIs.

Bancos Homologados:

02. CONFIGURAÇÃO GERAL

Conferência e cadastro de Espécies do Boleto Registrado. Exemplo de uso: Espécies do Boleto Registrado.
Para transmissão do boleto para a entidade financeira é necessário que o ambiente esteja com o serviço de agendamento (Schedule) configurado. Para mais informações sobre a configuração do Schedule consulte a documentação: Configuração Schedule
Ao realizar a configuração de uma conta será verificado a necessidade de criação do Job FINA713 de transmissão de boletos e envio de e-mail.
1. Para o envio de e-mail é necessário informar no complemento o envio e seu endereço. Mais detalhes no link: Complemento do cliente
2. Para o envio do e-mail é necessário configurar a carta de cobrança. Mais detalhes no link: Carta de Cobrança para envio de e-mail

03. FLUXO GERAL

REGISTRO DE BOLETOS

Informar o banco oficial no campo A6_BCOOFI com o código do banco FEBRABAN no cadastro do banco.
Configurar o cadastro de Parâmetros de Banco (Subconta) - FINA130.
Realizar Configuração de contas no menu do Novo Gestor Financeiro.
Gerar borderô informando a Subconta configurada.
Configurar o job FINA713 no schedule do módulo configurador que realizará a transmissão do boleto para o banco.
Monitoramento do status pelo Monitor de Boletos no Novo Gestor Financeiro.

ALTERAÇÃO/CANCELAMENTO DE BOLETOS

Importante

Atenção: Para alteração de boletos é preciso Appserver build 20.3.1.4 ou superior e pacote acumulado do financeiro com data igual ou superior a 15/05/2023

Os únicos bancos que contemplam a alteração e cancelamento de boletos: Banco do Brasil e Itaú:

Banco do Brasil - Só permite alteração do vencimento (E1_VENCTO ou E1_VENCREA)
Itaú - Só permite alteração do vencimento (E1_VENCTO ou E1_VENCREA) e/ou valor (E1_VALOR), a alteração de boleto para o Itaú deve se feito em ambiente de produção, por regra do banco só é possível alterar um boleto que foi transmitido em produção.

Será considerado alteração para transmissão automática (boleto on-line utilizando o job FINA713) se forem alterados somente os campos acima contemplados para cada banco. Caso algum outro campo do título for alterado, junto ou separado, e que não sejam esses campos acima contemplados, o sistema não irá considerar essa alteração como boleto on-line a ser transmitida pelo job FINA713 acompanhada pelo Monitor de Pendências, e sim irá considerar como alteração normal de CNAB aparecendo na tela de ocorrências CNAB.

É possível gerar instrução de ocorrência de alteração via CNAB para um boleto que tenha sido registrado online (job FINA713), inclusive para outros campos como histórico, juros entre outros. Obs: Deverá ser verificada a possibilidade junto ao banco.

Alteração de boleto on-line que atenda a regra dos bancos e campos contemplados, ao confirmar a alteração será gerada a instrução na tabela FI2 automaticamente e acompanhada pelo Monitor de Pendências. Não será mostrada tela para o usuário inserir ocorrência como acontece para o CNAB.

Alterações via Execauto do FINA040 e via botão Facilitador também seguem a mesma regra. Lembrando que para geração de ocorrência automaticamente via execauto para CNAB é nescessário utilizar os Pontos de Entrada F040VAUT e A040ATOK.

Para realizar a alteração de um boleto registrado, basta acessar a rotina Contas a receber (FINA040)
Atualização → Contas a receber → Contas a receber
Posicionar sobre o titulo que foi transmitido via API (EA_BORAPI = S, EA_TRANSF = S)
Clicar em alterar, e alterar o vencimento por exemplo, confirmar a alteração.
Será gravado um registro na tabela FI2 para o titulo em questão, onde os campos FI2_BORAPI = S e FI2_OPEAPI = A
Para cancelar o boleto basta retirar o titulo do borderô, após isso, será gravado um registro na tabela FI2 para o titulo em questão, onde os campos FI2_BORAPI = S e FI2_OPEAPI = C
Ao rodar o job FINA713 a alteração ou cancelamento será transmitido e é possível acompanhar os status através no Monitor de Boletos com Pendências - FINA710

04. TABELAS UTILIZADAS

SA6 - Bancos

A6_CFGBOL - Configuração do layout.

A6_CFGAPI - Habilitado para uso de API.

A6_BCOOFI - Código no Banco Central.

SEA - Títulos Enviados ao Banco

EA_BORAPI - Borderô para transmissão por API.

EA_TRANSF - Status de Transferência.

EA_APIMSG - Mensagem da API.

EA_APILOG - Eventos da API.

EA_APIMAIL - Status do envio do E-mail.

EA_SUBCTA - Subconta para transmissão por API.

EA_ESPECIE - Espécie para transmissão por API.

AI0 - Complementos de Clientes

AI0_RECBOL - Recebe Boleto por E-mail?

AI0_EMABOL - Lista de E-mails, separados por ponto e vírgula.

FWP - Cartas de Cobrança

FWP_TXTASS - Assunto do E-mail.

SE1 - Contas a Receber
SEE - Parâmetros de Banco

EE_CODCOB1 - Código da instrução de cobrança do Banco Itaú

EE_CODCOB1 - Código da instrução de cobrança do Banco Ita

EE_ITAUPRT - Quantidade de dias de protesto do boleto

EE_ITAUDEV - Quantidade de dias para devolução do Boleto

EE_ITAUNAO - Quantidade de dias para não recebimento do Boleto

EE_FORMEN1 - Instrução de cobrança para o boleto (Formula)

EE_FORMEN2 - Instrução de cobrança para o boleto (Formula)

EE_FOREXT1 - Instrução de cobrança para o boleto (Formula)

EE_DIASPRT - Quantidade de dias de protesto do boleto

EE_DIASREC - Quantidade de dias para devolução do Boleto

FI2 - Ocorrências CNAB

FI2_BORAPI - Define se a ocorrência é registro online (API)

FI2_OPEAPI - Define qual operação será transmitida na ocorrência (A = Alteração, C = Cancelamento)

FI2_APIMSG - Json de envio e retorno da transmissão online com o banco.

FI2_APILOG - Mensagem de retorno do banco

05. PARÂMETROS

MV_NGFCART - Código da carta de cobrança utilizado no envio dos boletos por e-mail.

Árvore de páginas