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
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?
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:
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
| 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. |
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. |
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
| 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.
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
| Campo | Descrição |
|---|---|
| Id Cobrança | O ID da cobrança é único, é gerado um ID por título selecionado |
| Título | Identificaçã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 :
|
| Data de Geração | Data de geração da Cobrança. |
| Data Vencimento | Data de Vencimento do Documento |
| Valor | Valor do Documento |
| Cobrança | Modalidade de cobrança conforme carteira configurada no TOTVS Techfin, ou seja, Boleto Híbrido. |
| Indica se o email foi enviado com sucesso | |
| Alertas | Caso 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.
Outras Ações / Ações relacionadas
| Ação | Descrição |
|---|---|
| Enviar E-mail | Permite enviar as cobranças por email para os clientes. |
| Cancelar Cobrança | Permite selecionar as cobranças e realizar o cancelamento do Boleto Híbrido. |
| Remover Cobrança | Permite remover as cobranças geradas. |
| Visualizar Cobrança | Informações adicionais da cobrança, informações do título, dados do pagamento, dados do envio e informações da liquidação no Contas a Receber. |
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 |
|---|---|
| Copiar Código PIX | Quando 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. |
| Download Boleto | Permite que você faça o download do Boleto em formato (.PDF) para o seu dispositivo para enviá-lo por WhatsApp, ou de qualquer outra plataforma. |
| Enviar Boleto por E-mail | Realiza o envio do boleto híbrido por e-mail na hora . |
Cancelar Cobrança
Permite selecionar quais cobrança deseja cancelar no Monitor de Cobrança e realizar o cancelamento do Boleto Híbrido, esta ação cancela o boleto na instituição bancária e libera o título no Contas a Receber, assim o Título em aberto poderá movimentado conforme a necessidade da empresa, poderá gerar um novo Boleto Híbrido ou cobrar de outra forma pelas rotinas do ERP.
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.
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.
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 e contabilização
06. Cancelamento e Devoluções de Nota Fiscal
07. Bloqueio de movimentações
Para evitar divergências entre os títulos do contas a receber e títulos que foram integrados ao TOTVS Pagamentos Instantâneos (TPI), as rotinas do Contas a Receber receberam alguns bloqueios, necessários para garantir a consistência dos dados e conciliações de links de pagamentos gerados pelo TPI.
Rotinas que sofreram bloqueios exclusivos para títulos integrados no TPI:
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.