Exibir origem

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. Monitor Integração TOTVS Techfin

a. Gerar Cobrança

b. Monitor Cobrança

05. Liquidação de Títulos e contabilização.

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.

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.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_8-42-1.png

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 ter acesso ao boleto híbrido você deverá ter realizado o processo de Autenticação e ter um Token válido, entre em contato com a TOTVS TECHFIN.

No ERP Datasul será necessário ativar a função Utiliza Boleto Híbrido e seguir as orientações de parametrizações.

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

03. PARÂMETROS TOTVS TECHFIN

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

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_10-30-8.png

a. Configurações Gerais

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

Principais Campos e Parâmetros

Campo	Descrição
Utiliza Boleto Híbrido	Ativar Boleto Híbrido
URL TOTVS Cobranças	URL da plataforma de integração com a solução TECHFIN, será disponibilizada pelo time de produto responsável pelo processo de implantação.

b. Parâmetros de Cobrança

Parâmetros

Os dados de Autenticação e credenciais de acesso serão fornecidos pelo time de produto responsável pelo processo de implantação TOTVS TECHFIN.

Campos	Descrição
URL Autenticação	Informe a URL de Autenticação para geração de PIX Cobrança
Usuário	Usuário cadastrado no processo de implantação na plataforma TOTVS TECHFIN.
Senha	Senha cadastrada no processo de implantação na plataforma TOTVS TECHFIN.
Client ID	Código de Client ID para autenticação no TECHFIN
Secret ID	Código do Secret ID para autenticação no 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.

Campos	Descrição
Modalidade	Boleto Hibrido
Código Carteira	Código da Carteira retornada pela TOTVS TECHFIN
Nome Carteira	Nome da carteira cadastrada no TECHFIN
Banco	Nome da instituição bancária que foi previamente configurada no produto TOTVS TECHFIN
Conta Corrente	Não se aplica para geração de Boleto Híbrido.
Portador	Informar o portador do ERP Datasul, para realizar as liquidações dos títulos relacionados
Carteira Bancária	Informar a carteira bancária do ERP Datasul, para realizar as liquidações dos títulos relacionados
Dias Após Vencimento	Quantidade de dias após o Vencimento que o Boleto Híbrido será válido, conforme configurado no TOTVS TECHFIN.
Dt Atualização	Será gravado automaticamente pelo sistema, indica a data da última atualização.
Hr Atualização	Será gravado automaticamente pelo sistema, indica a hora da última atualização.
Atualizar Carteiras	Importa as carteiras cadastradas no TOTVS TECHFIN.
Editar	Editar os parâmetros bancários do ERP Datasul.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_10-54-56.png

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.

Integrações > Integração Datasul X Boleto Híbrido > image-2024-12-16_11-44-43.png

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

Integrações > Integração Datasul X Boleto Híbrido > image-2024-12-16_11-43-49.png

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. MONITOR INTEGRAÇÃO TOTVS TECHFIN

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

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_11-4-33.png

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

Campo	Descrição
Considera Estabelecimento do Título	Indica se considera o estabelecimento do título para a realização da baixa.
Estabelecimento de Cobrança	Indica em qual estabelecimento será realizada a baixa do título.
Carteira	Permite selecionar as carteiras habilitadas no produto TOTVS Techfin e no ERP Datasul.
Tipo Cobrança	Indica a modalidade de cobrança da carteira, conforme serviço contratado com a TOTVS Techfin.
Enviar E-mail?	Indica se deverá dispara envio de mail no final da cobrança para cada título.

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.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_14-3-0.png

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.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_14-16-18.png

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.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_14-30-48.png

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

Pronto!

O processo de geração é finalizado com sucesso, os títulos selecionados ficarão disponíveis para que o ERP Datasul realize a integração com o TOTVS Techfin e gere os Boletos Híbridos para cada título.

b. Monitor Cobrança

Todas as cobranças podem ser monitoradas através do monitor de cobrança:

O ID da cobrança é único, é gerado um ID por título selecionado;
Cada linha representa um título diferente;
Visualização do status do pagamento;
Possibilidade de baixar o PDF do Boleto Híbrido gerado.
Visualização de alertas do sistema para cada título
Possibilidade de cancelar boletos gerados, enviar e-mails de forma individual ou em lote.

Integrações > Integração Datasul X Boleto Híbrido > image-2025-4-2_14-34-51.png

Principais Campos e Parâmetros

Campo	Descrição
Inclua o campo	Inclua a descrição relacionada
Inclua o campo	Inclua a descrição relacionada
Inclua o campo	Inclua a descrição relacionada

Busca Avançada

Visualizar Boleto Híbrido

Enviar Email - Qual o layout do Email

Outras Ações / Ações relacionadas

Ação	Descrição
Enviar E-mail	Inclua a descrição relacionada
Remover Cobrança	Inclua a descrição relacionada
Cancelar Cobrança	Inclua a descrição relacionada
Detalhes da Cobrança

05. TABELAS UTILIZADAS

Coloque o link das tabelas relacionadas