Páginas filhas
  • Integração Datasul X PIX Cobrança

Versões comparadas

Chave

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


CONTEÚDO

01. Visão Geral

02. Exemplo de utilização

03. Parâmetros TOTVS TECHFIN
     a. Configurações Gerais

     b. Parâmetros do Totvs Pagamento Instantâneo Cobrança.

04. Monitor Integração TOTVS TECHFIN

     a. Gerar Lote Cobrança

     b. Monitor Lote Cobrança 

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

06. Bloqueio de movimentações


01. VISÃO GERAL


O TOTVS Pagamento Instantâneo é um novo sistema desenvolvido pela TOTVS TECHFIN para integrar a ferramenta de pagamentos digitais do Banco Central às operações da sua empresa. Saiba mais sobre esta solução em TOTVS TECHFIN Pagamentos.

 Através da integração Datasul ao TOTVS Pagamento Instantâneo Cobrança será possível selecionar Títulos à Receber para geração de uma chave PIX para envio aos clientes. O PIX é intermediado pela TOTVS, que realiza a conciliação e processamentos das cobranças via PIX. Esta solução reduz custos nas transações em comparação com meios tradicionais (cartão de crédito, débito, boleto e dinheiro físico) e receber o dinheiro na conta empresarial de sua preferência.

02. EXEMPLO DE UTILIZAÇÃO


Empresas que realizam a gestão financeira pelos módulos Contas a Receber e Caixa e Bancos do produto Backoffice Datasul têm a necessidade de cobrar os títulos através de PIX, além de realizar a conciliação dos valores recebidos e o controle dos QR Code/link de pagamento gerados no TOTVS Pagamentos Instantâneos (TPI).

Através desta solução, as empresas poderão receber suas cobranças via PIX, realizar os processos de Liquidação de Títulos de forma automática, gerar QR Code de pagamentos,   receber os valores e realizar o controle dos QR Code/link de pagamentos.


03. PARÂMETROS TOTVS TECHFIN


Ative a integração Datasul ao TOTVS Pagamento Instantâneo e informe as configurações necessárias para utilização desta integração.

A solução está embarcada no TECHFIN BackOffice Datasul e não possui custo de ativação e implantação.

Para utilização do Totvs Pagamentos Instantâneo a . Configurações Gerais

Ativar a Integração Datasul ao Totvs Pagamento Instantâneo Cobrança. 

Image Removed

partir da release 12.1.2403 ou 12.1.2407 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 Datasul.

a. Configurações Gerais

Ativar a Integração Datasul ao Totvs Pagamento Instantâneo Cobrança. 

Image Added


CamposDescrição
Utiliza TOTVS Pagamento Instantâneo CobrançaInforme Sim para Ativar o TOTVS Pagamento Instantâneo
URL TOTVS
CamposDescrição
Utiliza TOTVS Pagamento Instantâneo CobrançaInforme Sim para Ativar o TOTVS Pagamento Instantâneo
URL TOTVS Pagamento Instantâneo CobrançaURL 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 do TOTVS Pagamento Instantâneo Cobrança

Os Parâmetros serão definidos por empresa, para Pagamentos instantâneos deve-se informar o portador e carteira exclusivo para estas movimentações.


Image RemovedImage Added


CamposDescrição
URL AutenticaçãoInforme a URL de Autenticação para geração de PIX Cobrança
UsuárioInforme Sim para Ativar o TOTVS Pagamento InstantâneoUsuário cadastrado no processo de implantação na plataforma TOTVS TECHFIN.
Senha

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

SenhaURL da plataforma de integração com a solução TECHFIN

Client IDCódigo de Client ID para autenticação no TECHFIN
Secret IDCódigo do Secret ID para autenticação no TECHFIN

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


Image Modified

Cadastrar um Tipo de Transação Caixa, Portador TPI e Carteira TPI específicos para operar com a modalidade PIX - Pagamento Instantâneo. A carteira também deve ser específica e não poderá ter nenhum tipo de movimentação no módulo do Contas a Receber antes de ser utilizada para esta modalidade.

CamposDescrição
Portador TPI

Utilizar um portador exclusivo para o PIX Cobrança, este portador deve ser cadastrado com o tipo Caixa, para o sistema ele será um portador transitório que indicará que se trata de uma operação de PIX Cobrança. Quando o pagamento do PIX for confirmado pela plataforma TOTVS TECHFIN será realizado o movimento de liquidação do título neste portador. Quando o valor for creditado na conta corrente pela TOTVS TECHFIN, os valores serão transferidos automaticamente para a Conta Corrente parametrizada pela empresa.

Carteira TPIUtilizar uma Carteira exclusivo para o PIX Cobrança, a carteira deve ser do tipo Carteira, esta carteira indicará que se trata de uma operação de PIX Cobrança.
Tipo Transação Caixa DespesaUtilizar um Tipo Transação Caixa exclusivo para lançar os valores de Despesa do PIX Cobrança, será gerada a movimentação do valor da Despesa no Caixa e Bancos.
Tipo Transação Caixa ConciliaçãoUtilizar um Tipo Transação Caixa exclusivo para lançar os valores de Conciliação do PIX Cobrança, será gerada a
CamposDescriçãoPortador TPI

O portador deve ser do tipo Caixa

Carteira TPIA carteira deve ser do tipo CarteiraTipo Transação Caixa DespesaTipo Transação Caixa que será utilizado para gerar a movimentação do valor da Despesa no Caixa e BancosTipo Transação Caixa ConciliaçãoTipo Transação Caixa que será utilizado para gerar a
movimentação do Valor Recebido no Caixa e Bancos. 
AgendamentoA integração com
o TOTVS Pagamentos Instantâneos será agendada conforme necessidade do cliente, através de serviços RPW
a plataforma TOTVS TECHFIN bem como a geração de liquidação e atualizações das informações é iniciada pelo agendamento e executados através de um servidor RPW, conforme necessidade da empresa, com recorrência por hora, minuto, uma ou mais vezes ao dia.

Card documentos
InformacaoAs rotinas do Contas a Receber serão bloqueadas para não permitir a utilização do Portador e Carteira Bancária declarado nos Parâmetros do TPI
TituloIMPORTANTE!



CamposDescrição
Estabelecimento

Estabelecimento Informar o estabelecimento do ERP que fará as operações de PIX Cobrança. 

Valor Despesa

Informar o Valor da Despesa Bancária conforme estabelecido em contrato com a TOTVS TECHFIN, este valor precisa ser informado para que ele seja provisionado, quando a liquidação do PIX é confirmada e efetivado quando aa plataforma TOTVS TECHFIN transferir o PIX Cobrança para a Conta Corrente Parametrizada.

Data Início ValidadeData Data Início ValidadeData de início de validade da taxa conforme definido em contrato.
Data Fim ValidadeData de fim de validade da taxa conforme definido em contrato.


Image AddedImage Removed


CamposDescrição
Nome Carteira

Nome da carteira cadastrada no TECHFIN

Código CarteiraCódigo da Carteira 
Conta CorrenteConta Corrente da empresa que receberá o valor do pix recebido na modalidade Pix Cobrança.
Id CarteiraIdentificador da cadeira carteira definido no TOTVS TECHFIN, não é necessário informar este campo, ele será carregado automaticamente pelo sistema. 
Dias Após VencimentoQuantidade de dias após o Vencimento o QR Code PIX Cobrança será válido, conforme configurado no TOTVS TECHFIN.
Dt Atualização Data Será gravado automaticamente pelo sistema, indica a data da última atualização
Hr AtualizaçãoHora Será gravado automaticamente pelo sistema, indica a hora da última atualização.

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

Boleto Híbrido

A plataforma TECHFIN retornará as carteiras bancárias existentes, para as modalidade PIX Cobraça e Boleto Hibrido.

Image Removed

Para carteiras na modalidade Boleto Híbrido, retornará qual é o banco corresponde, será necessário realizar o cadastro do portador e carteira correspondentes no Contas a Receber, esses dados serão utilizados para geração da liquidação do título. 




Agendamento

O Agendamento permite configurar qual a recorrência de atualização das informações, tanto das informações de PIX Cobrança no TOTVS TECHFIN quanto as movimentações de liquidação, confirmação dos créditos/débitos de todos os valores relacionados ao PIX Cobrança no ERP Datasul.  

A rotina de Agendamento permite configurar as janelas de atualização das informações da TECHFIN no ERP, essa execução pode ser na hora.

Image Added

Configurar o dia e horário para execução da atualização.

Image Added

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

04. MONITOR INTEGRAÇÃO TOTVS TECHFIN


O Totvs Pagamentos Instantâneos é uma solução embarcada ao produto TECHFIN BackOffice Datasul, foram acrescentadas ao Monitor Integração TOTVS TECHFIN as rotinas: Gerar lote Cobrança e Monitor Lote Cobrança. 

...

O processo de geração de Lote Cobrança foi criado para facilitar o processo de Cobrança, permite selecionar quais títulos serão agrupados e a geração o título e gerar de QR-Code único /PIX  para pagamento.

A seguir o detalhamento das etapas desse processo:

...

Conciliação ERPIndica que o BackOffice Datasul recebeu o Valor Líquido na Conta Corrente da Empresa, os valores são movimentados no Caixa e Bancos.
Valor DespesaIndica o Valor da Despesa da operação, cobrada por transação confirmada.
Valor LíquidoValor líquido que será recebido na Conta Corrente da Empresa
Valor RecebidoValor Recebido no Pagamento do QR Code.
Data ConciliaçãoData que o sistema recebe os valores e realiza a movimentação no Caixa e Bancos.


Janela Relacionamentos 

Demonstra a lista de movimentos relacionados gerados no processo de Conciliação.

Image Added

.
Conta CorrenteSerá a conta corrente cadastrada no Caixa e Bancos

Janela Relacionamentos 

Demonstra a lista de movimentos relacionados gerados no processo de Conciliação.

Image Removed

...

Janela Erros Conciliação

Image Removed

05. LIQUIDAÇÕES DE TÍTULOS E CONTABILIZAÇÃO

O processo de movimentação do título no Contas a Receber e sua contabilização segue um fluxo definido. Quando o título é vinculado a um lote de cobrança TPI, ele assume um portador e uma carteira exclusivos para o TPI. Nesse momento, é gerado um lote de liquidação no Contas a Receber, e o saldo do título fica comprometido, aguardando o pagamento via QR Code.

Após a confirmação do pagamento, o lote de liquidação no Contas a Receber é atualizado, e o título é liquidado. Em seguida, são gerados movimentos no Caixa e Bancos, provisionando os valores da transação. O valor do PIX entra na conta corrente transitória do portador e da carteira, enquanto o valor da despesa referente à transação TPI é registrado como saída.

...

no Backoffice Datasul.
Data MovtoData de Movimento
Sequência Sequencia do movimento na Conta Corrente para a data do movimento
Fluxo MovtoTipo de Movimento, Entradas ou saídas
Valor MovimentoValor do lançamento na conta corrente


Janela Erros Conciliação


Image Added


05. LIQUIDAÇÕES DE TÍTULOS E CONTABILIZAÇÃO


O processo de movimentação do título no Contas a Receber e sua contabilização segue um fluxo definido. Quando o título é vinculado a um lote de cobrança TPI, ele assume um portador e uma carteira exclusivos para o TPI. Nesse momento, é gerado um lote de liquidação no Contas a Receber, e o saldo do título fica comprometido, aguardando o pagamento via QR Code.

Image Added

Após a confirmação do pagamento, o lote de liquidação no Contas a Receber é atualizado, e o título é liquidado. 

Image Added

Em seguida, são gerados movimentos no Caixa e Bancos, provisionando os valores da transação.

O valor do PIX Cobrança é lançado na Conta Corrente do Portador TPI Cobrança e na Carteira TPI Cobrança, enquanto o valor da taxa de PIX Cobrança é registrado como Saída no tipo de Transação Caixa Despesa para a Conta Corrente do Portador TPI Cobrança.

Para visualizar os valores gerados no caixa e bancos acesse a consulta de título, selecione o movimento de liquidação e clique na opção Caixa e bancos.

Image Added

Image Added


Image Added

Manutenção Finalidades Econômicas Portador Estabelecimento (UFN103AA)

Neste cadastro será informada a conta corrente relacionada ao Portador TPI Cobrança r Carteira TPI Cobrança, ela receberá o valor do PIX Cobrança para o movimento de liquidação, esse movimento será gerado quando a plataforma TOTVS TECHFIN retornar a confirmação do pagamento do PIX Cobrança.

Trata-se de uma conta corrente transitória para receber apenas o lançamento da confirmação de pagamento, informar o Estabelecimento, a Carteira TPI Cobrança e a Finalidade da empresa.

Image Added

Movimento gerado no Caixa e Bancos para a Conta Corrente do Portador TPI Cobrança

Através do Relatório CMG315AA, é possível verificar os movimentos gerados e no histórico é informado o lote de Cobrança data e usuário.

Image Added


Movimento de Conciliação TOTVS TECHFIN

A plataforma TOTVS TECHFIN enviará para o ERP Datasul o registro de Conciliação PIX Cobrança, esse processo indica que o valor do PIX Cobrança foi transferido para a Conta Corrente da empresa, parametrizada para a modalidade PIX Cobrança em Parâmetros Totvs Pagamentos Instantâneo Cobrança.

No Caixa e Bancos, o valor recebido é registrado como uma entrada na conta corrente da empresa, esta conta deve ser a mesma informada na plataforma TOTVS TECHFIN.

Image Added

Além disso será necessário cadastrar um tipo de transação Caixa para contabilizar a despesa/taxa da operação, esta taxa será descontada do valor recebido na Conta Corrente.

Image Added

Como na confirmação do recebimento do PIX Cobrança a despesa/taxa é provisionada, na conciliação a provisão é zerada e a despesa/taxa é lançada no caixa e bancos na conta corrente do Portador TPI Cobrança.

Image Added

O valor do PIX Cobrança recebido na plataforma TOTVS TECHFIN é lançado como entrada na conta corrente da empresa.

Image Added

Por fim, o lote TPI é indicado com a situação de "Sucesso Datasul", encerrando o processo de forma bem-sucedida.

A seguir um exemplo da movimentação Conta Corrente (CMG700aa) do módulo Caixa e bancos.

Pagamento do QR Code e Liquidação do título no Contas a Receber:Os quadros a seguir representam os valores e os movimentos gerados, na confirmação do pagamento PIX Cobrança e na Conciliação no Caixa e Bancos.

Conta Corrente

Tipo de transação Caixa

Tipo

Valor

Histórico do Movimento 

Conta Corrente Transitória do portador TPI  

(UFN103AA - Finalidade Econômica X Portador) 

Tipo transação Caixa 

Entrada

Valor QR Code

Liquidação através do Lote de Pagamento Instantâneo. Lote 294 gerado em 29/08/24 pelo usuário: techfin.

Conta Corrente Transitória do portador TPI  

(UFN103AA - Finalidade Econômica X Portador) 

Tipo de Transação de Despesa 

(Parâmetros do TOTVS Pagamento Instantâneo)

Saída

Valor Despesa TPI

Valor de Despesa referente ao Lote de Pagamento Instantâneo 294 do estabelecimento 1500 e referência 240829Tbdk pelo usuário techfin.

...

O movimento de liquidação representa o instante em que o cliente efetua o pagamento utilizando o QR Code. É nesse momento que a transação é concluída, confirmando o recebimento do valor pelo sistema de pagamento.

Image Removed

Na janela de detalhe Caixa e Bancos o número do lote de pagamento instantâneo é gravado no histórico do registro.

de pagamento.

Image Added


Na janela de detalhe Caixa e Bancos o número do lote de pagamento instantâneo é gravado no histórico do registro.

Image Added

Importante:  

  • O processo de conciliação/transferência do valor recebido para a Conta Corrente da empresa pode ser efetuado dentro de um período curto, conforme definido no módulo Totvs Pagamentos Instantâneos.
  • Os valores do título, da taxa/despesa e líquido recebido serão gerados separadamente no Caixa e Bancos e Contabilidade.
  • Todas as movimentações utilizam API e seguem as premissas do Produto Financeiro do BackOffice Datasul.

...

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

...

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.


Card documentos
InformacaoA liberação deste produto ocorre na release 12.1.2411 com retrofit a partir da release 12.1.2403
TituloIMPORTANTE!