CONTEÚDO

01. Visão Geral

02. Exemplo de utilização

03. Soluções de cobranças - Parâmetros de Cobrança

            a. Configurações Gerais

            b. Parâmetros de Cobrança

04. Soluções de Cobrança - Monitor Integração TOTVS Techfin       

                  a. Gerar Cobrança

                  b. Monitor Cobrança

05. Liquidação de Títulos.

06. Cancelamento e Devoluções de Nota Fiscal

07. Bloqueio de movimentações

01. VISÃO GERAL

Boleto híbrido, também chamado no mercado de “bolepix” ou “bolecode”, é uma nova forma para cobrança de títulos à receber.

No boleto híbrido, é gerado o 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.

Quais vantagens podemos obter com a utilização do boleto híbrido?

• Liberdade para o cliente final, pois ele pode escolher a forma que deseja pagar;

• Segurança, como é emitido em conjunto com boleto, o título poderá ser protestado;

• Economia com tarifas bancárias;

• Maior liquidez em caso de recebimento por pix.

Para saber mais sobre as soluções TOTVS Techfin acesse : https://totvstechfin.com.br/pagamentos/

02. EXEMPLO DE UTILIZAÇÃO

Como funciona o Boleto Híbrido no Datasul?

• Integração do produto Datasul com o produto da TOTVS Techfin;
• Transação próprio banco do cliente, desde que ele seja homologado (consulte bancos homologados);
• Emissão de boleto + pix simultâneos;
• Baixa automática de títulos, sem a necessidade de trocas de arquivos;
• Configuração simples, sem necessidade de novas instalações;

Como será a Geração e processamento?

O ERP Datasul fará integração com o produto TOTVS Techfin Pagamentos por meio de APIs de pagamentos,  realizará a geração de boletos nos bancos homologados, retornará as confirmações e retornos das situações das cobranças geradas.

Os boletos híbridos serão registrados nas instituições bancárias, através do qual o cliente poderá escolher se irá pagar através do Qr Code/PIX, linha digitada ou código de barras. 

Através da rotina Monitor de Cobrança, a empresa visualizará todas as cobranças geradas e poderá realizar a gestão e acompanhamento dos Boletos Híbridos.

Poderá utilizar o monitor para realizar os seguintes processos: 

• Conferir se os Boletos Híbridos foram liquidados pelo cliente.
• Conferir se os títulos relacionados foram liquidados no Contas a Receber.
• Cancelar os Boletos Híbridos gerados. 
• Verificar se os Boletos Híbridos estão expirados.
• Baixar ou visualizar os Boletos Híbridos.
• Enviar os Boletos Híbridos por E-mail para os clientes.
• Eliminar Cobranças geradas indevidamente.

Pré-requisitos 

Para utilizar o boleto híbrido no ERP Datasul, é necessário ativar a função "Utiliza Boleto Híbrido" e seguir as orientações de parametrização do sistema.
Entretanto, para obter os dados de autenticação e o token de acesso necessários à integração, a empresa deve possuir um contrato vigente com a TOTVS Techfin.

A funcionalidade será liberada a partir da release.patch: 

• 12.1.2503.2
• 12.1.2411.7
• 12.1.2407.13

 Certifique-se que o Menu Datasul foi atualizado realizando o procedimento:

• Realize a importação do arquivo men_utb.d pelo MEN706AA - Importação Menu Datasul.
• Em seguida execute o programa MER010AA - Atualiza Menu Usuário e reinicie a sessão do usuário.
• O arquivo men_mnu.d fica no diretório de instalação do Datasul abaixo da pasta ERP\fnd\univdata.
• Qualquer dúvida ou problema abra ticket para o time Framework - Linha Datas

Para realizar as integração com o TOTVS Techfin é necessário ter um Servidor RPW ativado no Datasul, a empresa optar entre utilizar um servidor RPW Ativo em seu ambiente ou criar um novo servidor RPW exclusivo para o Boleto Híbrido.

03. PARÂMETROS TOTVS TECHFIN 

No menu pesquise por techfin e acesse o programa "Parâmetros TOTVS Techfin".

a. Configurações Gerais

Ative a utilização de Boleto Híbrido no ERP Datasul em Configurações Gerais

Principais Campos e Parâmetros

b. Parâmetros de Cobrança

Parâmetros

Os dados de Autenticação e credenciais de acesso serão fornecidos pelo time de implantação da TOTVS TECHFIN. 

Carteira

As carteiras serão cadastradas no produto TOTVS TECHFIN juntamente com a modalidade que a empresa irá operar, o ERP Datasul importará as carteiras do TOTVS TECHFIN.

Agendamento

O Agendamento permite configurar qual a recorrência de atualização das informações, tanto das informações de Boleto Híbrido no TOTVS TECHFIN quanto as movimentações de liquidação no ERP Datasul. A atualização pode ser na hora, através do campo Executar Hoje.

Assim como pode Agendar a Execução, configurar o dia e horário para execução da atualização.

Esse processo devolve para o BackOffice Datasul a situação de pagamento do(s) Boleto(s) Híbrido(s) gerados, reconhece as confirmações de pagamento e realiza a liquidação automática dos títulos relacionados no Contas a Receber.

04. SOLUÇÕES DE COBRANÇA - MONITOR INTEGRAÇÃO TOTVS TECHFIN

No menu pesquise por techfin e acesse o programa "Monitor Integração TOTVS Techfin".

a. Gerar Cobrança

O primeiro passo para Geração do Boleto Híbrido é informar os Parâmetros da Cobrança, no campo Carteira será apresentada a carteira válida para geração do Boleto, o exemplo a seguir a carteira disponível é PIX Itaú. 

Este processo permite gerar diversos Boletos de uma única vez por carteira, para prosseguir clique em Adicionar Títulos e Continuar.

Principais Campos e Parâmetros

Adicionar Títulos para Cobrança.

Nesta tela serão apresentados os títulos em aberto do Contas a Receber, permite a seleção múltipla de títulos para facilitar a geração das Cobrança. 

Selecione os títulos desejados e clique em Adicionar Títulos.

Ao final do processo será gerado um Boleto Híbrido para cada Título selecionado, respeitando os valores e vencimento de cada título.

A coluna Título refere-se aos dados de identificação do título no Contas a Receber, ou seja, Estabelecimento|Espécie|série|Código Título| Parcela.

Filtrar títulos Disponíveis 

Através dos filtros é possível selecionar títulos em aberto mais antigos ou ainda melhorar a seleção dos títulos em aberto, fazer uma seleção por CNPJ de cliente, espécie e data de vencimento do título.

A seleção não considera  os títulos com as seguintes características:

• De moeda diferente de Real.
• Integrado no Produto TOTVS Mais Negócios.
• Estornado.
• De empresa diferente do Lote TPI.
• Título em Perdas Dedutíveis.
• Relacionado ao Cheque.
• Sem saldo para liquidação.
• Em cobrança via borderô.
• Título já possui um Movimento de Estorno de Título, não permitindo fazer qualquer outra Movimentação posterior.
• Título encontra-se vinculado à uma Operação Financeira de Desconto ainda não confirmada e não poderá ser liquidado.
• Título proveniente de Cobrança Especial
• Saldo do título zerado ou Espécie do título diferente de Normal ou Aviso de Débito
• Título gerado pela integração do TMS por intermédio da Emissão de Conhecimento de Frete (CTes).
• Título Vendor.
• Título em Cobrança Bancária.
• Já vinculado em um Lote de Cobrança

Títulos Adicionados

É a lista de títulos que já fora selecionados pelo usuário.

Revisar e Gerar Cobrança

Para finalizar o processo clique em Revisar e Gerar Cobrança.

Esta Tela irá trazer todas as informações do processo para que o usuário possa fazer uma conferência rápida, demonstra a quantidade de títulos e o valor total selecionado para geração da Cobrança. 

Conforme exemplo a seguir serão gerados 2 Boletos Híbridos, um para cada documento selecionado, respeitando as informações de cada um deles.

Caso necessite remover algum título selecionado ou alterar outros dados informados basta clicar na opção que desejar ajustar.

Para efetivar a geração clique em Gerar Cobrança

Pronto!

Após a finalização bem-sucedida do processo de geração, os títulos selecionados ficarão disponíveis para que o ERP Datasul realize a integração com a TOTVS Techfin, possibilitando a emissão dos Boletos Híbridos correspondentes.

É importante ressaltar que o serviço de integração deve estar previamente agendado no menu Parâmetros de Cobrança > Agendamento, garantindo a integração e envio das informações.

Informações de integração, layout e Regras para Instruções e Encargos Financeiros

Integração com a Techfin – Envio de Dados

O sistema chamará o endpoint da Techfin para gerar o Boleto Híbrido, enviando as seguintes informações obrigatórias para integração:

• Carteira TECHFIN: Carteira configurada no TOTVS Techfin que foi importada nos Parâmetros de Cobrança
• Data de Vencimento: A data de vencimento do título, se o título estiver vencido alterar no Contas a Receber antes de gerar o Boleto Híbrido. Caso contrário o processo de geração apresentará mensagem de erro.
• Dias Após Vencimento: A data limite para pagamento, após essa data o Boleto perde a validade e não poderá ser pago. 
• Dados do Cliente: Nome, CPF, Endereço completo  do cliente, Bairro, Cidade, Estado e  CEP. O sistema buscará essas informações no cadastro de cliente (Pessoa Física ou Jurídica) , preferencialmente em informações de Cobrança.
• Valor da Cobrança: Valor do saldo do título.
• Mensagem de Instrução Bancária: Será gerada conforme cadastro do cliente. Caso ausente, será utilizada a instrução bancária padrão do banco associado ao título.
• Encargos Financeiras: Multa, Juros, Desconto, Abatimento conforme valores calculados no título pelo Contas a Receber e seguindo as regras do TOTVS Techfin.

Layout do Boleto Híbrido

O layout do boleto híbrido é único e padronizado para todos os bancos homologados (Banco do Brasil, Itaú, Santander, Sicoob, Bradesco e Sicredi). 

Não é possível realizar personalizações ou customizações visuais ou estruturais no boleto, independentemente do banco emissor.  Essa padronização é estabelecida na TOTVS Techfin e garante compatibilidade de dados e simplifica o processo de integração com as instituições bancárias.

Bancos Homologados

A integração ERP Datasul com a Techfin está homologada para os seguintes bancos:

• Banco do Brasil (BB)

• Itaú

• Santander

• Sicoob

• Bradesco

• Sicredi

Ações Disponíveis para Boleto Híbrido

O sistema oferece as seguintes 2 ações no processo de gerenciamento de boletos híbridos integrados com o TOTVS TECHFIN:

1- Gerar o boleto híbrido (BolePIX) nas instituições bancárias homologadas. Esta ação:

• Cria o PDF do boleto híbrido e permite o envio do arquivo por E-mail para os clientes.
• Registra a cobrança na instituição bancária por meio da integração com o TOTVS Techfin.
• Grava as informações de retorno no ERP, incluindo dados como nosso número, vencimento, QR Code e código de barras.

2- Cancelar Cobrança:

• Cancela a cobrança no sistema ERP, o título é liberado para novas cobranças.

• A cobrança é cancelada da base da TOTVS Techfin e o boleto deixa de ser válido para pagamento na instituição bancária.

Mensagem de Instrução Bancária

A mensagem de instrução bancária será gerada com base no cadastro do cliente financeiro. Caso o cliente não possua uma instrução definida, o sistema utilizará a instrução bancária do banco vinculado ao portador do título, conforme configuração no módulo Contas a Receber (ACR).

Encargos financeiros 

Os encargos financeiros (multa, juros, abatimento e desconto) serão gerados com base nas informações registradas no título dentro do módulo de Contas a Receber do ERP.

Os boletos híbridos (BOLEPIX) gerados via integração com o TOTVS TECHFIN possuem particularidades que exigem atenção especial no envio de informações, principalmente relacionadas à forma de cálculo dos encargos e ao comportamento esperado por banco:

c. Monitor Cobrança

Todas as informações das cobranças podem ser monitoradas através do monitor de cobrança, onde cada linha representa um título/boleto híbrido diferente, na coluna status apresenta se existe alguma pendencia ou se o processo de geração e liquidação foi finalizado com a descrição Sucesso Datasul.

Esta rotina permite realizar algumas ações em massa, selecionando diversas cobranças simultaneamente para processamento.

Principais Campos e Parâmetros

Busca Avançada

Com a busca avançada poderá ser realizado um filtro das informações que serão apresentadas no Monitor de Cobrança. 

Outras Ações / Ações relacionadas

Enviar Email 

Permite selecionar as Cobranças para realizar o envio do Boleto Híbrido para o cliente por E-mail, selecione a cobrança desejada e clique na opção Enviar E-mail

Será apresentada a tela de confirmação, 

As cobranças selecionadas serão indicadas com o ícone em laranja, que significa em fila de agendamento.

Os e-mails  serão disparados no processamento do agendamento conforme opção utilizada, Executar Hoje (na Hora) ou Agendar Execução em  Parâmetros da Cobrança / Agendamento.

Informações sobre E-mail de Cobrança:

O destinatário será o email cadastrado do cliente na seguinte ordem de prioridade:

1º E-mail de cobrança do Cliente, conforme informado no cadastro da pessoa física ou jurídica.

2º E-mail do Cliente, conforme informado no cadastro da pessoa física ou jurídica.

O remetente será o e-mail cadastrado para o usuário do sistema. 

Será gerado um texto padrão pelo sistema, não possibilita alteração do texto ou de informações. 

Texto do Email:

Prezado(a) Razão Social Cliente,

Estamos entrando em contato para informar que foi gerada uma cobrança no valor de R$ 0,50 referente ao documento: 250325 parcela 08 e vencimento 31/12/2025.
Para facilitar o pagamento, disponibilizamos um Boleto Híbrido, que permite a liquidação tanto pelo código de barras quanto pelo QR Code Pix.

Dados para pagamento:
Código PIX(Copia e Cola): 00020101021226770014BR.GOV.BCB.PIX2555api.itau/pix/qr/v2/406f6a21-63f0-49d8-9aac-1f2f4bf597a35204000053039865802BR5921SHIPAY TECNOLOGIA S/A6009SAO PAULO62070503***6304F3CC

Se preferir, você pode acessar e baixar o boleto diretamente clicando aqui.

Caso já tenha efetuado o pagamento, por favor, desconsidere esta mensagem.
Permanecemos à disposição para esclarecer quaisquer dúvidas ou fornecer informações adicionais.

Atenciosamente,
Razão Social Empresa
Tel: (99)99999-9999
E-mail: [email protected]

Visualizar Boleto Híbrido

Cancelar Cobrança 

O sistema permite selecionar quais cobranças deseja cancelar diretamente no Monitor de Cobranças, possibilitando o cancelamento do Boleto Híbrido.

Ao realizar essa ação:

• O boleto é cancelado na instituição bancária.
• O título é liberado no Contas a Receber, permitindo sua movimentação conforme necessário.

Com o título em aberto, a empresa pode:
🔹 Gerar um novo Boleto Híbrido para reenvio ao cliente.
🔹 Utilizar outra forma de cobrança dentro das rotinas do ERP.

Essa funcionalidade garante mais flexibilidade na gestão das cobranças, permitindo ajustes conforme a necessidade da empresa.

Ao Clicar em Cancelar Cobrança o sistema apresentará uma tela de confirmação e fará o cancelamento de todos os registros selecionados no Monitor de Cobrança.

O sistema mudará o status da cobrança para Em Cancelamento e mostrará a mensagem:

Assim a rotina de execução RPW fará a leitura de todos os registros que estão Em cancelamento e confirmará o cancelamento do boleto na techfin, quando o processo for finalizado o status da cobrança é atualizado para Cancelado.

Cancelar Cobrança Individual

Para Cancelar um cobrança específica clique em "..." no canto esquerdo da linha que seja cancelar, selecione o Cancelar Cobrança.

Esta ação irá cancelar a Cobrança da linha correspondente, esta ação realiza o processo de cancelamento na mesma hora na instituição bancária, em alguns instantes já altera o status para Cancelado. O Boleto híbrido é cancelado na instituição bancária e o título é liberado no Contas a Receber. 

Qual a diferença das duas formas de cancelamento apresentadas?

A primeira deve ser realizada para processamento em massa, quando a empresa tem a necessidade de cancelar uma lista grande de boletos Híbrido. É necessário agendar o processamento da ação para que o Monitor Cobranças não fique travado e o usuário possa continuar trabalhando em suas cobranças. 

A segunda forma é on-line, o monitor de Cobrança faz a requisição de Cancelamento e aguarda o retorno do cancelamento pela TOTVS Techfin e Instituição bancária. 

Importante: Somente cobranças com status "Aguardando Pagamento" podem ser canceladas.

Remover Cobrança

Permite remover registros de cobranças que foram criados indevidamente, selecione quais cobrança deseja remover no Monitor de Cobrança e clique em Remover Cobranças.

Será apresentada a tela de confirmação:

Esta opção também poderá ser feita de forma individual, clique em "..." no canto esquerdo da linha que seja Remover selecione o Remover Cobrança. 

Importante: Somente cobranças com status "Expirada" e "Pendente Envio" podem ser removidas.

Visualizar Cobrança 

A tela de Detalhes da Cobrança tem como objetivo fornecer uma visão completa e clara das informações relacionadas. Nessa interface, o usuário pode consultar todos os dados relevantes, organizados de forma estruturada para facilitar a leitura e o acompanhamento.

Detalhes da Cobrança

05. Liquidação de Títulos

Quando o cliente realiza o pagamento do boleto híbrido, o sistema inicia automaticamente a rotina de integração com o TOTVS Techfin, responsável por buscar a confirmação desse pagamento.

Uma vez confirmado, o sistema atualiza as informações no Monitor de Cobranças, garantindo o registro adequado do pagamento realizado.

A liquidação do título ocorre com base no portador e na carteira bancária definidos para a modalidade de cobrança, conforme os parâmetros configurados na rotina Parâmetros de Cobrança.

Essa configuração é essencial para que o sistema reconheça corretamente as condições bancárias utilizadas na operação.

Após a confirmação da liquidação, o status da cobrança será automaticamente atualizado para: ✅ Sucesso Datasul

Além disso, no detalhamento da cobrança, os dados são classificados por categoria. Na classificação Liquidação, são exibidos todos os campos relacionados ao pagamento processado.

Na rotina ACR212AA – Consulta de Títulos do Contas a Receber – o sistema apresentará no histórico do título o registro da confirmação do pagamento do boleto híbrido.

Tratamento de Erros

Se ocorrer algum erro durante o processo de atualização no Contas a Receber, o título será marcado com o status: ⚠️ Pendente ACR

Neste caso, os erros serão apresentados no Monitor de Cobranças, através do ícone destacado o sistema exibirá a mensagem de erro específica, permitindo que o usuário identifique o problema, realize os ajustes necessários e reprocesse a atualização.

06. Cancelamento e Devoluções de Nota Fiscal

Cancelamento de Nota Fiscal - Módulo de Faturamento.

Durante o processo de cancelamento de notas fiscais, caso a nota esteja em cobrança, será exibida uma mensagem de alerta no relatório de processamento.

Essa mensagem tem caráter informativo e não impede a continuidade do cancelamento no módulo de Faturamento. No entanto, é necessário que o usuário realize duas ações complementares:

1. Cancelar o Boleto Híbrido no Monitor de Cobranças;

2. Efetuar o estorno do título correspondente no módulo de Contas a Receber.

Essa inconsistência será sinalizada no Monitor de Cobranças, justamente para orientar o usuário quanto aos procedimentos adicionais exigidos, garantindo que o processo seja concluído corretamente.

Devolução - Módulo de Recebimento

No processo de devolução no módulo de Recebimento, quando a nota fiscal estiver vinculada a uma Cobrança Techfin, nenhuma mensagem será emitida durante o processo. O sistema seguirá automaticamente as regras padrão de antecipação ou crédito, conforme definido nos parâmetros de devolução de clientes do módulo Contas a Receber.

No entanto, para os títulos listados no Monitor de Cobranças, o comportamento pode variar de acordo com a parametrização utilizada:

Parâmetro: Credita

• O sistema não seguirá as regras do Contas a Receber para não comprometer os títulos originais, ele apenas registrará que a devolução está ocorrendo.
• Os títulos originais permanecem inalterados.
• Não antecipa e nem cria valores automaticamente para compensação futura.
• A situação do título, no entanto, será atualizada para "Em Devolução".

Parâmetro: Credita/Antecipa

• O sistema seguirá a regra da parametrização "Antecipa" do Contas a Receber.

• Os títulos no Contas a Receber vinculados à nota fiscal em devolução não são estornados.

• Em vez disso, é gerada uma antecipação no Contas a Receber com o valor total da devolução.

Demais parametrizações

• O sistema executará o processo padrão de devolução conforme o comportamento habitual do Contas a Receber.

07. Bloqueio de movimentações

Para garantir a consistência dos dados e evitar divergências entre os títulos registrados no Contas a Receber e aqueles que foram integrados ao TOTVS Techfin pelo Monitor de Cobranças, foram implementados alguns bloqueios nas rotinas do Contas a Receber.

Esses bloqueios são necessários para assegurar que todas as informações financeiras estejam corretamente conciliadas entre o TOTVS Techfin e o ERP Datasul, evitando problemas como:

• Duplicidade de registros - Garantindo que um mesmo título não seja liquidado mais de uma vez.
• Inconsistências nos valores - Evitando que informações incorretas sejam registradas no sistema financeiro.
• Falhas na conciliação bancária - Prevenindo diferenças entre os valores contabilizados e os efetivamente pagos.
• Erros operacionais - Restringindo alterações manuais que possam comprometer a integridade dos dados.

Com essas medidas, o sistema mantém a sincronia entre os módulos financeiros e assegura que todas as operações estejam devidamente registradas e conciliadas.

Rotinas que sofreram bloqueios exclusivos para títulos integrados no Monitor de Cobranças:

• Alteração de títulos do Contas a receber
• Liquidação de títulos
• Encontro de Contas
• Renegociação
• Estorno/Cancelamento Títulos ACR.
• Avaliar se o título é elegível para os produtos TOTVS Mais Negócios e TOTVS Antecipa.

A rotina de Alteração de títulos do Contas a Receber, passou por algumas mudanças sobre o comportamento de campos, ou seja,  alguns campos e funcionalidades que não serão aplicadas à títulos integrados no TPI estarão desativadas como: Rateio Receita/Despesa, Instrução Bancaria, Crédito Imposto,  Vendor e Endereço Cobrança, Data Vencimento, Data Previsão de Liquidação, Data Fluxo, Saldo, Portador, Carteira, Valor Despesa Bancária, Condição Cobrança, Situação Titulo, Tipo de Cobrança.