Linha Microsiga Protheus

Árvore de páginas

Importante

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

  1. Conferência e cadastro de Espécies do Boleto Registrado. Exemplo de uso: Espécies do Boleto Registrado.
  2. 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
  3. 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

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


ALTERAÇÃO/CANCELAMENTO DE BOLETOS  


Importante

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.

Obs: Só 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 e sim irá considerar como alteração normal de CNAB aparecendo a tela de ocorrências CNAB.


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  


  1. Para realizar a alteração de um boleto registrado, basta acessar a rotina Contas a receber (FINA040) 
  2. Atualização → Contas a receber → Contas a receber
  3. Posicionar sobre o titulo que foi transmitido via API (EA_BORAPI = S, EA_TRANSF = S)
  4. Clicar em alterar, e alterar o vencimento por exemplo, confirmar a alteração.
  5. Será gravado um registro na tabela FI2 para o titulo em questão, onde os campos FI2_BORAPI = S e FI2_OPEAPI = A
  6. 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
  7. 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_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.