Histórico da Página

...

1. Visão Geral
2. Manutenção Contas Corrente X Chave Pix
3. Manutenção Cliente Financeiro
4. API Cliente FinanceiroFianceiro
5. Manutenção Bancos
6. Manutenção Portador EDI
7. Parâmetros Destinação de Cobrança
8. Manutenção Ocorrência Bancária Parceiro
9. Gerar Destinação de Cobrança
10. Enviar Movimento Cobrança Escritural
11. Receber Movimento Cobrança Escritural
12. Manutenção Lotes Implantação Títulos ACR
13. API de Implantação de Títulos ACR
14. Alteração Títulos ACR
15. API de Alteração de Títulos ACR
16. Alterar Movimentos Escritural
17. Consulta Título Contas a Receber
18. Relatório Movimento Ocorrência Bancária
19. Liberações
    1. Liberação Fase 1 - Cadastros
    2. Liberação Fase 2 - Rotinas
    3. Liberação PIX - Layout Híbrido de Cobrança Escritural 
20. Tabela Nova
21. Campos novos disponibilizados

...

• CPF/CNPJ
• Celular
• E-mail
• Chave aleatória

02. Manutenção Contas Corrente X Chave Pix

...

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 é expedida e fica dentro da estrutura de programas do EMS5, na pasta dochlppode ser acessada pelo link UTB765ZL - Manutenção/Integração de Cliente/Fornecedor. Na documentação conterá a seguinte orientação:

...

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.

É possível configurar na Cobrança PIX para utilizar o Layout Híbrido de Cobrança Escritural no módulo do Contas a Receber, para isso foi incluído o parâmetro Híbrida (Normal com PIX). Este parâmetro possibilita utilizar boletos de cobrança normal (400 posições) com registro adicional para solicitar e receber QR Code, dando opção para o cliente pagar com o código de barras ou usando o QR Code. Para títulos em portadores PIX Híbrido, deixa de gerar a ocorrência PIX - Excluir QR Code e gera as ocorrências de cobrança normal.

Image RemovedImage Added

07. Parâmetros Destinação de Cobrança 

...

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

Image AddedImage Removed

Na Manutenção Ocorrências Bancárias Banco (UFN002AA) foi incluído as novas opções para atender a Retorno Cobrança Escritural PIX:

...

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

...

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.

Image Added

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.

Image Added

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.

Image Added 

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. Na tela, também será possível gerar o QR Code através do botão Gerar QR Code, existente ao lado do campo EMV QR Code.

Image Added

Quando o portador informado na implantação do título está configurado com o parâmetro Híbrida (Normal com PIX) selecionado, ao acessar a tela de modal pelo botão cobrança escritural, além dos campos mencionados anteriormente será apresentado também o campo Num Título Banco, conforme tela abaixo:

Image Added

Uma vez informado o Pix link ou EMV QR Code 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.

Image Added

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.

Image Added

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. Na tela, também será possível gerar o QR Code através do botão Gerar QR Code, existente ao lado do campo EMV QR Code.

Image Added

Quando o portador do título está configurado com o parâmetro Híbrida (Normal com PIX) selecionado, ao acessar a tela de modal pelo botão cobrança escritural, além dos campos mencionados anteriormente será apresentado também os campos referente a cobrança normal, como: Num Título Banco, Obs Cobrança, Instr. Bancária 1 e Inst Bancária 2.

Image Added

Uma vez informado o Pix link ou EMV QR Code na modal acima, ao atualizar a alteração do 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.

Image Added

Informações
title Importante
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.

Informações
title Importante
Quando o título está em Cobrança PIX Híbrida ao alterar qualquer título, por exemplo: Alteração de Valor ou Vencimento Não gera a ocorrência bancária de remessa PIX - Excluir QR Code. Nessas situações as alterações de títulos geram ocorrências de cobrança Normal (Concessão de abatimento, Alteração de Vencimento, etc).

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.

Image Added

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. É possível também, através do botão Gerar QR Code realizar a geração do QR Code conforme informação do campo EMV QR Code.

O campo Cobrança Híbrida (Normal com PIX) apresentado nessa tela, caso esteja selecionado, indica que o título se encontra em cobrança escritural e no envio seu portador na Manutenção Portadores EDI estava parametrizado como Híbrida (Normal com Pix). 

Image Added

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.

Image Added

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.

Image Added

19. Liberações

14. Alterar Movimentos Escritural

15. Consulta Título Contas a Receber

16. Relatório Movimento Ocorrência Bancária

a. Liberação Fase 1 - Cadastros

...

Foram disponibilizados os itens nos pacotes:

...

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. 

Os mapas mencionados acima (Itaú e Bradesco) se referem à cobrança PIX "pura", não cobrança híbrida (código de barras e QR Code PIX).

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

...

, 12.1.32 e 12.1.31. 

c. Liberação PIX Híbrido - Cobrança Escritural

Será possível configurar na Cobrança PIX para utilizar o Layout Híbrido de Cobrança Escritural no módulo do Contas a Receber que possibilita utilizar boletos de cobrança normal (400 posições) com registro adicional para solicitar e receber QR Code, dando opção para o cliente pagar com o código de barras ou usando o QR Code.

Esta parte do projeto encontra-se em desenvolvimento e a previsão de liberação é a 12.1.2311 com liberação nos patches 12.1.2307-3, 12.1.2301-11 e 12.1.2209-16.

Banco Itaú:

Foram criados os mapas "107 - Cobrança Banco Itaú - Export - BoleCode" e "108 - Cobrança Banco Itaú - Import - BoleCode" da Cobrança Escritural para atender o Layout 400 híbrido do Itaú. Para utilizar deve ser feito a Importação dos novos mapas através do arquivo "edi_1100_508_hibrido_pix.d" no programa "Exportação e Importação de Mapas - EDU717za". 

Esses mapas de Cobrança Escritural Híbrida do Itaú tem previsão de liberação na 12.1.2311 com liberação nos patches 12.1.2307.6 , 12.1.2301.14 e 12.1.2209.19.

A Ocorrência Bancária Banco "Pix - Gerar QR Code" deve estar vinculada ao código de ocorrência "71".

           Conforme página 14 do Layout do Itaú de Julho/2021 deve ser utilizado o código "71 REMESSA – BOLECODE (emissão do boleto e QR Code pix)". Para alteração do boleto não é necessário o envio do registro.

Image Added

Banco Bradesco:

Foram criados os mapas "109 - Cobrança Bradesco - Import - Híbrido" e "110 - Cobrança Bradesco - Export - Híbrido" da Cobrança Escritural para atender o Layout 400 híbrido do Bradesco. Para utilizar deve ser feito a Importação dos novos mapas através do arquivo "edi_1100_508_hibrido_pix.d" no programa "Exportação e Importação de Mapas - EDU717za". 

Esses mapas de Cobrança Escritural Híbrida do Bradesco tem previsão de liberação na 12.1.2403 com liberação nos patches 12.1.2311.2, 12.1.2307.8 e 12.1.2301.16.

Para os demais bancos os clientes podem customizar os mesmos.

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

21. Campos novos disponibilizados

• A partir da release 12.1.31:

...

• A partir da release 12.1.34:

• A partir da release 12.1.2311