Histórico da Página
...
- Visão Geral
- Manutenção Contas Corrente X Chave Pix
- Manutenção Cliente Financeiro
- API Cliente FinanceiroFianceiro
- 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
- API de Alteração de 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
- Liberação PIX - Layout Híbrido de Cobrança Escritural
- Tabela Nova
- Campos novos disponibilizados
...
- 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
...
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.
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).
É 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.
Informações | ||
---|---|---|
| ||
É recomendado que seja criada uma nova Carteira para Cobrança Híbrida (Manutenção Carteira Bancária - UFN012AA) e um novo Parceiro EDI, e configurar o Contas a Receber e o EDI conforme esses novos cadastros. |
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 Retorno Remessa 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
- 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;
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 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.
...
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 06 deste 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.
13. Alteração Títulos ACR
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
- 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:
...
11/12/2020
...
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.
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:
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.
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. 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.
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.
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.
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. |
Informações | ||
---|---|---|
| ||
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.
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).
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.
19. Liberações
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.
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, 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.
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:
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 |
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 e 12.1.32.
17. Tabela Nova
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
...
- A partir da release 12.1.3132:
Campo | Descrição | clien_financ.log_cobr_acr_pixCliente 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 |
- A partir da release 12.1.34:
Campo | Descrição | ||||||
---|---|---|---|---|---|---|---|
ext_tit_acr.dsl_pix_link | Código Pix Link fornecido pelo banco | destinac_cobr.log_cobr_acr_pix | Destinação Aceita Cobrança PIX | ||||
ext_tit_acr. | logdes_ | cobrurl_ | acrlocaliz_ | pixExtensão Título Contas a Receber em Cobrança PIX | movto_ocor_bcia.cod_chave_pix | Chave PIX utilizada no movimento Remessa Escritural PIXjson | URL presente no EMV do QR Code fornecido pelo banco |
ext_tit_acr.dsl_emv_qrcode | EMV do QR Code fornecido pelo banco |
- A partir da release 12.1.32:2311
Campo | Descrição | banco.cod_sist_pagto_bra | Código do Sistema de Pagamentos Brasileiro|
---|---|---|---|
portad_edi.log_cobr_hibr_pix | Cobrança Híbrida (Normal com PIX) | ||
ext_tit_acr.log_cobr_hibr_pix | Cobrança Híbrida (Normal com PIX) |