Histórico da Página

A integração Protheus x Boleto Hibrido Techfin visa flexibilizar o processo de comunicação bancaria 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 Financeiro Backoffice Protheus com data igual ou superior a dd03/mm/aaa11/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
  Necessidade de configuração do
  • Job
  FINA713 (
  • Transmissão
  de boletos e envio de e-mail) no Schedule.
  • Necessidade de configuração do Job FINA715 (Retorno de pagamentos) no Schedule.
  • • e Envio de E-mail - FINA713 e Retorno de Pagamentos - FINA715.

  Informações
  title LIB igual ou superior 20260413
  A partir da LIB 20260413 não é possível selecionar a filial no agendamento do Schedule, os Jobs irão considerar as credênciais configuradas na rotina de Configuração de Contas. Importante - Com essa mudança, as filiais que terão integração com a Techfin, mesmo que o financerio seja compartilhado, precisam que ter as credênciais configuradas no ERP.

  • Habilitar a porta multiprotocolo no appserver.ini, para mais informações consulte a documentação Application Server - Porta Multiprotocolo,
  • Cadastro do banco:
    
    • informar Informar o banco oficial no campo Bco. Oficial (A6_BCOOFI) com o código do banco FEBRABAN.
    • Informar o O tipo de comunicação indicado no campo Cfg API Ativo (A6_CFGAPI) com conteúdo é 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 PIX no cadastro do banco em Outras→Chaves 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).

  Detalhes do Campo EE_CHVPIX

  Campo	Tipo	Tamanho	Descrição
  EE_CHVPIX	C	100	Chave PIX

  • 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
    Para o envio de e-mail é necessário informar no complemento o envio e seu endereço. Mais
    • detalhes no link:  Complemento do cliente.
    Para o envio do e-mail é necessário
    • Necessário configurar a carta de cobrança
    . Mais
    • , 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

  Informações
  title Nota
  Para utilização em ambiente de produção, não é necessária a configuração dos parâmetros acima!

  • 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)