Páginas filhas
  • Integração Datasul X Boleto Híbrido

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Maior liquidez em caso de recebimento por pix.

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

...

Como será a Geração e processamento?

A geração de boletos híbridos será realizada diretamente no módulo Financeiro, através da seleção de títulos em abertos do Contas Receber.

O Contas a Receber 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.

...

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

Restrição: Esta nova funcionalidade não foi disponibilizada no Emissor DANF-e programa FT0518.

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.

...

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

  • link da documentação d o RPW

Image Added

Nome do programa de integração api_agend_totvs_pagto_instantaneo.


Card documentos
InformacaoA funcionalidade será liberada a partir da release: 12.1.2503.2, 12.1.2411.7 e 12.1.2407.13
TituloIMPORTANTE!

...

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 conclusão bem-sucedida do processo de geração, os títulos selecionados ficarão estarão disponíveis para que integração entre o ERP Datasul realize a integração com a TOTVS Techfin, possibilitando a emissão dos Boletos Híbridos correspondentese a TOTVS TECHFIN.
Durante essa integração, o serviço da TECHFIN será responsável pela emissão dos boletos e pela atualização automática do portador dos títulos, que passará a ser o portador do banco informado na cobrança.

É 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

...

  • 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 a data de vencimento seja menor que a data do dia, emitirá 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.apresentado os dados título e a instrução relacionada - Documento:  Código Estabelecimento -Espécie-Série-Título-Parcela-Cobrar Juros
  • Encargos Financeiras: Multa, Juros, Desconto, Abatimento conforme valores calculados no título pelo Contas a Recebertítulo pelo Contas a Receber e seguindo as regras do TOTVS Techfin.
  • Complemento do endereço: Caso não exista a informação no cadastro do cliente o programa enviar "-", pois o campo é obrigatório para a Techfin e não obrigatório para os cadastros do Cliente.

Layout do Boleto Híbrido

...

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 e conformidade dos de dados e simplificando 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 Boleto Híbrido: Gera 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 API 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.

Card documentos
InformacaoO banco Bradesco não permite o cancelamento de boletos híbridos via API bancária. Para cancelar cobranças do Bradesco, é necessário realizar dois passos manuais: Cancelar a cobrança no Monitor de Cobranças. Cancelar o boleto diretamente no Bradesco através dos canais oficiais do banco.
TituloLimitação Bradesco

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).na instrução informada no título, além de apresentar os dados do título:

Documento:  Código Estabelecimento -Espécie-Série-Título-Parcela-Cobrar Juros

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.

...

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 na instituição bancária 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 pagamentona instituição bancária. Para Gerar um novo Boleto Híbrido, será necessário Remover a Cobrança do Monitor, verificar se o título não está vencido e gerar uma nova Cobrança.
  • 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. Quando o boleto for cancelado no banco a cobrança receberá o status Cancelado. Caso ocorra algum erro neste processo,  o registro continuará com status em cancelamento  e os erros serão apresentados no Monitor de Cobrança.
  • 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.
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. 

...

AçãoDescrição
Enviar E-mailPermite enviar as cobranças por email para os clientes.
Cancelar CobrançaPermite selecionar as cobranças e realizar o cancelamento do Boleto Híbrido.
Remover CobrançaPermite remover as cobranças geradas.
Visualizar CobrançaInformaçõ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.envio e informações da liquidação no Contas a Receber.
AtualizarAtualiza o status da cobrança de forma individual.
Histórico

Exibe todo o histórico de requisições relacionadas à cobrança. É possível realizar o download dos arquivos JSON de entrada e saída, além de visualizar o ID da transação, que representa o código da transação registrado na TechFin.
Os registros que possuem ID correspondem às requisições de retorno ou consulta realizadas.

Image Added


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

...

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,

...

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.

...

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

...

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á
  • a regra da parametrização "Devolve".
  • 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
  • Os títulos no Contas a Receber não são alterados, e nenhuma antecipação é gerada.

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

...