Comunicação Techfin - Protheus x Boleto Hibrido

A integração Protheus x Boleto Hibrido Techfin visa flexibilizar o processo de comunicação bancária entre o ERP e os principais bancos através da solução Totvs Boleto Híbrido.

Boleto híbrido, também chamado no mercado de “bolepix” ou “bolecode”, é uma nova forma para cobrança de títulos à receber. Nele, geramos código de barras (boleto convencional) e Qr code (pix) no mesmo documento, gerando mais liberdade para o cliente no momento de pagamento do título.

O envio do registro e retorno da cobrança é feito através da plataforma da Techfin, que é responsável pela comunicação com os bancos homologados. 

• Release 12.1.2310 ou superior
• Expedição contínua do Backoffice Protheus com data igual ou superior a03/11/2025(essa data poderá ser alterada de acordo com o calendário de publicação da expedição contínua).
• Ter contratado o produto TOTVS Boleto Híbrido da TECHFIN. Para mais informações sobre essa oferta entre em contato com seu executivo de solução TOTVS (ESN).

• A transmissão e retorno de pagamento do boleto são feitos através do serviço de agendamento (Schedule). Para mais informações sobre a configuração do Schedule consulte a documentação: Configuração Schedule
  • Job Transmissão e Envio de E-mail - FINA713 e Retorno de Pagamentos - FINA715.
• Habilitar a porta multiprotocolo no appserver.ini, para mais informações consulte a documentação Application Server - Porta Multiprotocolo,
• Cadastro do banco:
  
  • Informar o banco oficial no campo Bco. Oficial (A6_BCOOFI) com o código do banco FEBRABAN.
  • O tipo de comunicação indicado no campo Cfg API Ativo (A6_CFGAPI) é preenchido automaticamente quando uma configuração é feita, documento sobre a configuração Configuração de Contas - o conteúdo indicativo dessa integração será igual a 4=Techfin
• Chave PIX - Exitem duas opções para realizar o cadastro da Chave PIX utilizada no Produto Boleto Híbrido Techfin.
  • Primeira opção é Informar a chave PIX no cadastro do banco em Outras Ações → Chaves Pix.
  • Segunda opção é informar a chave PIX na rotina de Parâmetros de Bancos (campo EE_CHVPIX) - maiores informações Parâmetros de Bancos (FINA130 - SIGAFIN).

• Envio do e-mail da cobrança:
  • Necessário informar no complemento do cliente a indicação de envio e endereço de e-mail, mais detalhes no link:  Complemento do cliente.
  • Necessário configurar a carta de cobrança, mais detalhes no link: Carta de Cobrança para envio de e-mail
  • Necessário configurar os parâmetros de conexão do servidor de e-mail, mais detalhes no link: Utilização dos parâmetros MV_FINACNT, MV_FINPSW e MV_FINFROM
• Parâmetros a serem inseridos na seção do ambiente, para ambiente de desenvolvimento, dentro do .INI do serviço appServer:
  • fw-tf-rac-endpoint=https://{tenat_do_cliente}.rac.staging.totvs.app
  • fw-tf-raas-endpoint=https://staging.raas.varejo.totvs.com.br

• Parâmetro:
  • MV_BHTDTHR - parâmetro do tipo caractere utilizado no controle de Data e Hora da última execução de consulta do status do Boleto Híbrido Techfin (Job Retorno de Pagamentos - FINA715)

• Boleto Hibrido - Monitor
• Boleto Híbrido - Ocorrências
• Configuração de Contas