Histórico da Página
CONTEÚDO
- Visão Geral
- Manutenção Contas Corrente X Chave Pix
- Manutenção Cliente Financeiro
- API Cliente Financeiro
- Manutenção Bancos
- Manutenção Portador EDI
- Parâmetros Destinação de Cobrança
- Manutenção Ocorrência Bancária Parceiro
- Gerar Destinação de Cobrança
- Enviar Movimento Cobrança Escritural
- Receber Movimento Cobrança Escritural
- Manutenção Lotes Implantação Títulos ACR
- API de Implantação de Títulos ACR
- Alteração Títulos ACR
- Alterar Movimentos Escritural
- Consulta Título Contas a Receber
- Relatório Movimento Ocorrência Bancária
- Liberações
- Liberação Fase 1 - Cadastros
- Liberação Fase 2 - Rotinas
- Tabela Nova
- Campos novos disponibilizados
01. VISÃO GERAL
Pagamentos instantâneos (Pix) são as transferências monetárias eletrônicas na qual a transmissão da ordem de pagamento e a disponibilidade de fundos para o usuário recebedor ocorre em tempo real e cujo serviço está disponível durante 24 horas por dia, sete dias por semana e em todos os dias no ano. É uma nova modalidade de pagamentos e recebimentos, na qual as transferências ocorrem diretamente da conta do usuário pagador para a conta do usuário recebedor, sem a necessidade de intermediários, o que propicia custos de transação menores.
As demais formas de pagamentos já conhecidas, como DOC/TED, Boletos, etc, continuarão existindo, porém o Pix trará uma grande agilidade na compensação dos valores para o recebedor, visto que é para acontecer de forma instantânea. Para isso, algumas mudanças no sistema serão necessárias para atender a demanda, e este documento centralizará todas as mudanças e orientações aos usuários do Datasul.
A nova modalidade de pagamento Pix possibilita que seja utilizada uma chave para identificar os dados bancários. A chave não é obrigatória, mas fará com que os pagamentos sejam mais ágeis.
Neste momento a chave deverá ser criada diretamente no sistema bancário que é utilizado pelos usuários e posteriormente poderá ser vinculada no Datasul.
A chave, que poderá ser usada no lugar do banco/agência e conta, poderá ser identificada de 4 formas diferentes:
- CPF/CNPJ
- Celular
- Chave aleatória
Informações | ||
---|---|---|
| ||
O controle da cobrança na modalidade PIX serão geradas através da estrutura de Cobrança Escritural já existente, portanto os novos layouts disponibilizados pelos bancos deverão ser tratado através do módulo EDI, o que facilitará o processamento de Envio e Retorno nesta modalidade. Para mais detalhes utilize o documento: Pix - Mapas e Processamento |
02. Manutenção Contas Corrente X Chave Pix
Manutenção Contas Correntes - UTB099AA
O programa de Manutenção de Conta Corrente foi alterado para ter mais uma opção de cadastro filho, aonde serão definidos as Chaves Pix das Contas Correntes da Empresa.
O usuário deverá informar o tipo da chave PIX: CPF/CNPJ, Celular, E-mail ou Chave aleatória.
Poderá vincular até 20 chaves diferentes e uma mesma conta, contudo não é possível vincular a mesma chave em mais de uma conta.
Se a Conta Corrente tiver Conta Corrente PIX cadastrada, terá que ter uma preferencial. Se não for informada nenhuma preferencial ou tentar informar mais de uma é preferencial o programa irá validar.
03. Manutenção Cliente Financeiro
Manutenção Clientes Financeiro - UFN011AA
Na Manutenção Clientes Financeiro foi incluído um novo campo indicando se aquele cliente aceita cobrança PIX. Uma vez marcado o parâmetro, permitirá no programa Gerar Destinação Cobrança o envio dos títulos para um portador modalidade PIX.
04. API Cliente Financeiro
A API de Cliente (UTB765zl) foi evoluída para considerar o novo campo indicando se aquele cliente aceita cobrança PIX. Uma vez marcado o parâmetro, permitirá no programa Gerar Destinação Cobrança o envio dos títulos para um portador modalidade PIX.
A documentação da API pode ser acessada pelo link UTB765ZL - Manutenção/Integração de Cliente/Fornecedor. Na documentação conterá a seguinte orientação:
"O atributo log_cobr_acr_pix da temp-table tt_params_generic_api_id foi criado para informar se o cliente financeiro utiliza cobrança PIX ou não. Neste caso ao criar este registro na tt_params_generic_api_id deverá informar os campos da seguinte forma:
tt_params_generic_api_id.ttv_cod_id_tab = string(tt_clien_financ_integr_e.tta_cod_empresa) + '/' + string(tt_clien_financ_integr_e.tta_cdn_cliente)
tt_params_generic_api_id.ttv_cod_tabela = “tt_clien_financ_integr_e”
tt_params_generic_api_id.ttv_cod_campo = “log_cobr_acr_pix”
E no campo tt_params_generic_api_id.ttv_cod_valor indicar se o cliente Financeiro é igual “yes”' (Aceita Cobrança PIX) ou “no” (Não Aceita Cobrança PIX)."
05. Manutenção Bancos
Na Manutenção Bancos foi incluído o campo Identificador do Sistema de Pagamentos Brasileiros (ISPB). Este código é único por Instituição Financeira assim como código Febraban e será utilizado nos layouts de Cobrança PIX.
06. Manutenção Portador EDI
Manutenção Portador EDI - UFN009AA
Na Manutenção Portador EDI foi incluído o parâmetro Cobrança PIX. Este parâmetro fará a diferenciação dos demais portadores EDI's, justamente para ser utilizado na Manutenção Destinações de Cobrança nos casos em que a Regra de Destinação for do tipo Cobrança PIX.
07. Parâmetros Destinação de Cobrança
Parâmetros Destinação de Cobrança - ACR025AA
Na Manutenção Destinações de Cobrança foi incluído um novo campo indicando que a Regra de Destinação criada é exclusiva para Cobrança PIX.
Estas regras poderão ser selecionadas na rotina de Destinação de Cobrança quando o usuário selecionar a opção de Destinação Cobrança PIX.
O Portador e Carteira Auto Emissão deverão serão validados se estão marcados como Cobrança PIX na Manutenção Portador EDI. Caso contrário não permitira a inclusão ou alteração desta Destinação com Aceita Cobrança PIX.
08. Manutenção Ocorrência Bancária Banco
Manutenção Ocorrência Bancária Parceiro - UFN002AA
Na Manutenção Ocorrências Bancárias Banco (UFN002AA) foi incluído as novas opções para atender a Remessa Cobrança Escritural PIX:
- Ocorrência Gerar QR Code prevista para envio de remessa inicial em Cobrança PIX.;
- Ocorrência Excluir QR Code prevista para utilizar na alteração da forma de cobrança do título ou seja retirar o título de Cobrança PIX;
- Ocorrência Alteração de Dados prevista para realizar alterações de dados do título em cobrança PIX, que estejam contidas no QR Code (vencimento, valor, etc).
Na Manutenção Ocorrências Bancárias Banco (UFN002AA) foi incluído as novas opções para atender a Retorno Cobrança Escritural PIX:
Estas novas ocorrências disponibilizadas no sistema deverão ser relacionadas ao código de ocorrência correspondente de cada banco.
09. Gerar Destinação de Cobrança
No programa Destinar Títulos - ACR foi inserido o parâmetro Aceita Cobrança Pix que permite ao usuário realizar destinação de títulos para portadores de cobrança Pix. Para poder realizar a destinação após marcar o parâmetro é necessário selecionar uma Regra de Destinação Pix, que deve ser cadastrada conforme item Parâmetro Destinação de Cobrança deste tutorial.
Uma vez selecionado a Regra de destinação Pix, o sistema permite realizar a destinação de títulos cujo o cadastro de cliente financeiro. Para parametrizar o cliente para aceitar cobrança Pix, utilize o item 03 deste documento.
A Destinação seguirá as mesmas regras da cobrança normal indicadas na documentação Destinação de Títulos Contas a Receber.
Se houver apenas uma regra de destinação Pix, ao marcar o parâmetro indicado acima, o sistema irá sugerir esta Regra.
10. Enviar Movimento Cobrança Escritural
No programa Enviar Movimento Cobrança - ACR757AA foram acrescentadas as ocorrências de remessa Pix, permitindo a geração do arquivo remessa e envio dos títulos nesta modalidade de cobrança.
11. Receber Movimento Cobrança Escritural
No programa Receber Movimento Cobrança - ACR759AA foi criado tratativa para processar os arquivos de títulos em cobrança Pix. No entanto não foi adicionado nenhum parâmetro novo, bastando apenas selecionar o parceiro EDI relacionado ao portador Pix.
12. Manutenção Lotes Implantação Títulos ACR
Na Manutenção Lotes de Implantação ACR foi criado a tratativa para ser possível inserir os dados da Cobrança Pix. Para tal é necessário informar um Portador de Cobrança Pix, conforme item Manutenção Portador EDI deste tutorial. Através dele é possível informar manualmente as informações de cobrança através do botão Cobrança Escritural.
Através da modal que será apresentada, será possível informar Agência de Cobrança, Pix Link, Url Json e EMV QR Code da Cobrança Pix. Tirando a Agência de Cobrança, se a cobrança pix for controlado pelo banco, estas informações serão fornecidas pelo Banco.
Uma vez informado o Pix link na modal acima e ao atualizar o lote com o título, o mesmo será colocado em cobrança Pix, e serão geradas as ocorrências bancárias remessa e retorno Pix - Gerar QR Code e Pix - Emissão Confirmada respectivamente.
Informações | ||
---|---|---|
| ||
Não é obrigatório realizar este procedimento. Caso tenha realizado o envio escritural do título para Cobrança Pix, o banco irá retornar estas informações e o sistema irá atualizar no processamento arquivo retorno. |
13. API de Implantação de Títulos ACR
A API de Alteração de Títulos (ACR711ZV) foi evoluída para considerar os novos campos da cobrança PIX, assim como ocorreu com a rotina implantação.
A documentação da API pode ser acessada pelo link ACR900ZI - Integração/Implantação de Títulos. Na documentação conterá a seguinte orientação sobre modalidade de Cobrança PIX. Segundo os layouts dos bancos possuem informações diferentes da cobrança escritural normal e estas precisam estar disponíveis para alteração pelo usuário.
Informações necessárias:
- campo dsl_pix_link - Link gerado para pagamento do Qr Code dinâmico. Será retornado pelo Banco neste primeiro momento.
- campo des_url_loc_payload_json - URL presente no EMV do QR Code dinâmico e que contém os dados da cobrança
- campo dsl_emv_qr_code - EMV do QR Code dinâmico. Esse campo deve ser utilizado no processo de geração de imagem (base64).
Exemplo Criação temp-table tt_params_generic_api para campo Link:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de item lote implantação)
tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_lote_impl_9':U
tt_params_generic_api.ttv_cod_campo = 'dsl_pix_link':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar pix link fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo URL :
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de item lote implantação)
tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_lote_impl_9':U
tt_params_generic_api.ttv_cod_campo = 'des_url_localiz_json':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar URL presente no EMV do QR Code fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo EMV:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de item lote implantação)
tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_lote_impl_9':U
tt_params_generic_api.ttv_cod_campo = 'dsl_emv_qrcode':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar URL presente no EMV do QR Code fornecido pelo banco.
14. Alteração de Títulos ACR
Na Alteração Títulos Contas a Receber foi criado a tratativa para ser possível inserir os dados da Cobrança Pix. Para tal é necessário informar um Portador de Cobrança Pix, conforme item Manutenção Portador EDI deste tutorial. Através dele é possível informar manualmente as informações de cobrança através do botão Cobrança Escritural.
Através da modal que será apresentada, será possível informar Agência de Cobrança, Pix Link, Url Json e EMV QR Code da Cobrança Pix. Tirando a Agência de Cobrança, se a cobrança pix for controlado pelo banco, estas informações serão fornecidas pelo Banco.
Uma vez informado o Pix link na modal acima e ao atualizar o lote com o título, o mesmo será colocado em cobrança Pix, e serão geradas as ocorrências bancárias remessa e retorno Pix - Gerar QR Code e Pix - Emissão Confirmada respectivamente.
Informações | ||
---|---|---|
| ||
Não é obrigatório realizar este procedimento. Caso tenha realizado o envio escritural do título para Cobrança Pix, o banco irá retornar estas informações e o sistema irá atualizar no processamento arquivo retorno. |
15. API de Alteração de Títulos ACR
A API de Alteração de Títulos do Contas a Receber (ACR711ZV) foi evoluída para considerar os novos campos da cobrança PIX, assim como ocorreu com a rotina Alteração Títulos ACR.
A documentação da API pode ser acessada pelo link ACR711ZV - Alteração de Títulos. Na documentação conterá a seguinte orientação sobre modalidade de Cobrança PIX. Segundo os layouts dos bancos possuem informações diferentes da cobrança escritural normal e estas precisam estar disponíveis para alteração pelo usuário.
Informações necessárias:
- campo dsl_pix_link - Link gerado para pagamento do Qr Code estático ou dinâmico. Será retornado pelo Banco neste primeiro momento.
- campo des_url_loc_payload_json - URL presente no EMV do QR Code dinâmico e que contém os dados da cobrança
- campo dsl_emv_qr_code - EMV do QR Code dinâmico ou estático. Esse campo deve ser utilizado no processo de geração de imagem (base64).
Exemplo Criação temp-table tt_params_generic_api para campo Link:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'dsl_pix_link':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar pix link fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo URL :
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'des_url_localiz_json':U
tt_params_generic_api.ttv_cod_valor = char(100).
E no campo tt_params_generic_api_id.ttv_cod_valor indicar URL presente no EMV do QR Code fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo EMV:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'dsl_emv_qrcode':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar EMV do QR Code fornecido pelo banco.
16. Alterar Movimentos Escritural
Na Alteração dos Movimentos foram incluídas as Ocorrências de Remessa Pix, para permitir que a alteração das mesmas a exemplo do que já ocorre com as ocorrências na Cobrança Normal.
17. Consulta Título Contas a Receber
O Detalhe da Consulta de Títulos e Movimentos -ACR212AA também foi alterado para poder apresentar as informações de cobrança Pix. Para visualizar as mesmas basta detalhar o título, clicar no botão Cobrança Pix.
Também foi incluído um Detalhe das informações Pix que o banco devolve via arquivo escritural por Ocorrência Retorno. Para visualizar, basta detalhar a Ocorrência Retorno desejada e clicar no botão Pix.
18. Relatório Movimento Ocorrência Bancária
No Relatório Movimento de Ocorrências Bancárias - ACR317AA foram incluídas as ocorrências de Remessa Cobrança Pix, permitindo a listagem e controle destas pelos usuários.
a. Liberação Fase 1 - Cadastros
- Disponibilidade da função Retrofit via Console a partir do Release 12.1.27.
- Expedição com tratamento nos campos novos a partir do Release 12.1.31.
Foram disponibilizados os itens nos pacotes:
Release | Data Liberação |
12.1.29.5 | 11/12/2020 |
12.1.28.11 | |
12.1.27.15 |
b. Liberação Fase 2 - Rotinas
Será disponibilizado a Cobrança Escritural primeiramente para os bancos: Itaú e Bradesco, para atender aos bancos será necessário realizar a atualização dos MAPAS padrões e atualizações de programas que realizam o envio e retorno escritural do módulo Financeiro Contas a Receber.
Esta parte do projeto encontra-se em desenvolvimento e a previsão de liberação é a 12.1.34 com retrofit para as releases 12.1.33, 12.1.32 e 12.1.31.
19. Tabelas Novas
Liberação realizada na 12.1.31:
Criado uma tabela para armazenar as chaves PIX da conta corrente. Esta tabela é filha da tabela cta_corren e se relaciona pelo campo cod_cta_corren.
Liberado dicionário com esta tabela nova Retrofit também.
- Cta_corren_pix
Liberação será realizada na 12.1.34:
Criado uma tabela para armazenar as informações do pix inseridas na implantação. Esta tabela é filha da tabela item_lote_impl_tit_acr e se relaciona pelos campos cod_estab, cod_refer e num_seq_refer.
- ext_item_lote_impl_acr
Criado uma tabela para armazenar as informações do pix retornadas nas ocorrências via arquivo pelo Banco. Esta tabela é filha da tabela movto_ocor_bcia e se relaciona pelos campos cod_estab, num_id_tit_acr, num_seq_movto_ocor_bcia,
- ext_movto_ocor_bcia
Liberado dicionário com esta tabela nova Retrofit também.
20. Campos novos disponibilizados
- A partir da release 12.1.31:
Campo | Descrição |
---|---|
clien_financ.log_cobr_acr_pix | Cliente Financeiro Aceita Cobrança PIX |
banco.cod_sist_pagto_bra | Código do Sistema de Pagamentos Brasileiro |
portad_edi.log_cobr_acr_pix | Portador EDI Aceita Cobrança PIX |
destinac_cobr.log_cobr_acr_pix | Destinação Aceita Cobrança PIX |
ext_tit_acr.log_cobr_acr_pix | Extensão Título Contas a Receber em Cobrança PIX |
movto_ocor_bcia.cod_chave_pix | Chave PIX utilizada no movimento Remessa Escritural PIX |
- A partir da release 12.1.32:
Campo | Descrição |
---|---|
banco.cod_sist_pagto_bra | Código do Sistema de Pagamentos Brasileiro |
- A partir da release 12.1.34:
Campo | Descrição |
---|---|
ext_tit_acr.dsl_pix_link | Código Pix Link fornecido pelo banco |
ext_tit_acr.des_url_localiz_json | URL presente no EMV do QR Code fornecido pelo banco |
ext_tit_acr.dsl_emv_qrcode | EMV do QR Code fornecido pelo banco |