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?

02. EXEMPLO DE UTILIZAÇÃO

Como funciona o Boleto Híbrido no Datasul?

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: 

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: 

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


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

CampoDescrição
Utiliza Boleto Híbrido

Ativar Boleto Híbrido 

URL TOTVS CobrançasURL 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çãoInforme a URL de Autenticação para geração de PIX Cobrança
UsuárioUsuário cadastrado no processo de implantação na plataforma TOTVS TECHFIN.
Senha

Senha cadastrada no processo de implantação na plataforma TOTVS TECHFIN.

Client IDCódigo de Client ID para autenticação no TECHFIN
Secret IDCó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 CarteiraNome da carteira cadastrada no TECHFIN
BancoNome da instituição bancária que foi previamente configurada no produto TOTVS TECHFIN
Conta CorrenteNão se aplica para geração de Boleto Híbrido.
PortadorInformar 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 VencimentoQuantidade 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çãoSerá gravado automaticamente pelo sistema, indica a hora da última atualização.
Atualizar CarteirasImporta as carteiras cadastradas no TOTVS TECHFIN.
EditarEditar os parâmetros bancários do ERP Datasul.


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. 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

CampoDescrição
Considera Estabelecimento do TítuloIndica se considera o estabelecimento do título para a realização da baixa.
Estabelecimento de CobrançaIndica em qual estabelecimento será realizada a baixa do título.
CarteiraPermite selecionar as carteiras habilitadas no produto TOTVS Techfin e no ERP Datasul.
Tipo CobrançaIndica 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.


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:

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!

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

CampoDescrição
Id Cobrança

O ID da cobrança é único, é gerado um ID por título selecionado

TítuloIdentificação do título, campos que compõe índice da tabela separados por "|', Estabelecimento|Espécie|Série|Título|Parcela
Status

Situação da Cobrança, indica se está pendente de geração, em pagamento, expirado, confirmado e atualizado no ERP.

Legenda de opções :

  • Processando, indica que a cobrança está sendo atualizada no ERP Datasul.
  • Pendente de Envio, indica que o lote está em digitação e ainda não possui nenhum Boleto Híbrido.
  • Aguardando Pagamento, indica que o Boleto Híbrido foi gerado e está ativo aguardando o pagamento.
  • Pendente ACR, indica que o pagamento foi confirmado mas a atualização no Contas a Receber possui alguma pendência, devido a erros de negócio que serão apresentados em tela. 
  • Pendente CMG, este status é exclusivo para a modalidade PIX Cobrança e indica que o pagamento foi confirmado, o título já foi liquidado no Contas a Receber mas existe alguma pendência de atualização no Contas a Receber.
  • Sucesso Datasul, indica que o processo foi concluído. O título relacionado foi liquidado no Contas a Receber e o valores foram atualizados no Caixa e Bancos.
  • Expirado, indica que o tempo de pagamento do Boleto Híbrido Expirou e será necessário gerar outro Boleto Híbrido para pagamento.
  • Em Cancelamento, indica que o usuário realizou o cancelamento do Boleto Híbrido no Monitor de Cobrança, o cancelamento ficará na fila de processamento até a próximo agendamento.
  • Cancelado, indica que o Boleto Híbrido foi cancelado no Monitor Lote Cobrança e não poderá ser utilizado para pagamento. No sistema bancário o Boleto Híbrido será inválido.
  • Erro, 
Data de GeraçãoData de geração da Cobrança.
Data VencimentoData de Vencimento do Documento 
ValorValor do Documento
CobrançaModalidade de cobrança conforme carteira configurada no TOTVS Techfin, ou seja, Boleto Híbrido.
E-mailIndica se o email foi enviado com sucesso
AlertasCaso possua alguma inconsistência de processamento no ERP Datasul, algum problema/instabilidade que impossibilitou a geração do boleto ou liquidação do título, será apresentada na coluna de Alertas. 

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. 


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:

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


Campo

Descrição

CopiarQuando o pagamento ou a transferência é feita através de um QR Code, o processo envolve escanear esse código. No entanto, em alguns casos, é possível que o QR Code seja apresentado de forma digital (como em uma tela de computador ou mensagem) e, em vez de escanear, você pode "copiar" o código e "colar" diretamente no aplicativo do banco.
BaixarPermite que você faça o download de um código QR Code em formato de imagem (.PNG)  para o seu dispositivo para enviá-lo por WhatsApp, ou qualquer outra plataforma.
E-mail

Permite o envio do QR Code para o seu cliente por E-mail, será o email cadastrado para o cliente do título 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.

Remetente: E-mail cadastrado para o usuário do sistema. 

Destinatário: E-mail do cliente do lote de Cobrança TPI 

Corpo da mensagem:

Prezado(a) Cliente XPTO, 


Estamos entrando em contato para informar sobre a cobrança gerada no valor de R$200,00.
Para sua comodidade, oferecemos a opção de pagamento através do PIX, um método rápido e seguro. Anexamos um QR Code para facilitar a transação, bem como o código para copiar e colar diretamente na sua plataforma de pagamentos.
Código PIX: 00020101021226810014br.gov.bcb.pix2559api.rendimento.com.br/q/v2/2862a19130a945c3a4cd2f9311dab33d520400005303986540567.625802BR5907Techfin6009Joinville62070503***63041810

Agradecemos a sua atenção e nos colocamos à disposição para quaisquer dúvidas ou informações adicionais. Se você  já realizou o pagamento, por favor, desconsidere este e-mail.

Atenciosamente Empresa XPTO.


Outras Ações / Ações relacionadas

AçãoDescrição
Enviar E-mailInclua a descrição relacionada
Remover CobrançaInclua a descrição relacionada
Cancelar CobrançaInclua a descrição relacionada
Detalhes da Cobrança


05. TABELAS UTILIZADAS

Coloque o link das tabelas relacionadas