Árvore de páginas


CONTEÚDO

  1. Visão Geral
  2. Mapa Extração
  3. Mapa Efetivação
  4. Importação dos Mapas Escriturais Pix
  5. Relacionamento Mapas Antigos x Novos Elementos Mapa Efetivação 
  6. FAQ - Perguntas Mais Frequentes - Atendimento


Aviso

Importante: Uma vez atualizados via console um desses patchs 12.1.31.15, 12.1.32.10 e 12.1.33.4, é necessário ler com atenção e realizar todos os procedimentos indicados neste Tutorial.

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


Importante

Você encontra o detalhamento das alterações das funcionalidades de Cobrança através do documento: PIX - Pagamentos Instantâneos - Módulo ACR.


02. Mapa de Extração

O processo de Extração dos dados para Cobrança Pix se inicia no Contas a Receber no programa Envio Movimento de Cobrança, aonde são selecionados os títulos vinculados aos portadores desta modalidade de cobrança. Os dados entram no EDI formatados pelo Mapa 000023 - Cobrança Escritural - Extração.  Abaixo o detalhamento das novas informações Pix extraídas no Envio:


Segmento 000291 - Header Cobrança Escritural

ElementoLabelOrigem MóduloComentário Técnico
005049ISPBIdentificador do Sistema de Pagamentos Brasileiros (ISPB) é um código único por Instituição Financeira assim como código Febraban e será utilizado nos layouts de Cobrança PIX. Esta informação está disponível na Manutenção Bancos.banco.cod_sist_pagto_bra


Segmento 000292 - Detalhe Cobrança Escritural

ElementoLabelOrigem MóduloComentário Técnico
006200Chave PixA chave PIX é a forma de identificar sua conta e substitui diretamente o uso de informações como agência, conta ou CPF, que são necessários para que seja possível realizar uma transferência. As chaves poderão ser cadastradas Manutenção Conta Corrente e o sistema exige que seja escolhida uma chave preferencial que será utilizada no envio da Cobrança Escritural Pix.

Primeira chave preferencia cadastrada para Conta Corrente do Portador Pix de Envio:

cta_corren_pix.log_chave_prefer

Importante

Caso queira um detalhamento de onde cada uma das informações são extraídas por este mapa basta acessar a documentação Origem das informações extraídas para a Cobrança Escritural.


03. Mapa de Efetivação

O processo de Efetivação dos dados para Cobrança Pix é realizado via programa Retorno Movimento de Cobrança, aonde são processados os arquivos retorno dos Bancos. Os dados entram formatados no EDI via Mapa de Importação dos Bancos e depois são efetivados no ERP Datasul no módulo Contas a Receber pelo Mapa 000025 - Cobrança Escritural - Efetivação.  Abaixo o detalhamento das novas informações processadas no retorno.


Segmento 000291 - Header Cobrança Escritural

ElementoLabelComentário Técnico
004630ISPBUtilizado para identificar o Banco responsável pelo envio do arquivo retorno.


Segmento 000292 - Detalhe Cobrança Escritural

Elemento LabelComentário Técnico
005049Chave PixInformação enviada no arquivo Remessa ao qual foi registrada a Cobrança Pix.
005050Código LiquidaçãoCódigo de Identificação da Liquidação retornado pelo Banco
005051END TO END IDID fim a fim da Transação. Campo que transita nas mensagens de recebimento dos QR Codes e transferências.
005052MSG Pagador FinalMensagem enviado pelo Pagador. Se ela retornar iremos gravar na ocorrência gerada pelo processamento arquivo retorno 
005053Codigo ErroPara os registros rejeitados alguns bancos chegam a enviar até dez códigos de erro que explicam o motivo da rejeição.
005054PIX LINKLink gerado para pagamento do QR Code.
005055Location LINKURL presente no EMV do QR Code Dinâmico e que contém os dados da cobrança
005056EMV DO QR CODEEsse campo deve ser utilizado no processo de geração de imagem (base64)

04. Importação dos Mapas Escriturais Pix

É indispensável realizar a importação de mapas EDI que disponibilizados para realizar Cobrança Escriturais na modalidade PIX.


Importante

Como pré-requisito desta importação faz-se necessário realizar o saneamento da base EDI. Detalhes de como realizar este procedimento, basta seguir o procedimento indicado no documento: Saneamento da base EDI.


No Programa EDU717ZA – Importação e Exportação de Mapas, realizar o procedimento de importação separadamente para os bancos Itaú e Bradesco. 


Utilizar para a importação os Arquivos disponibilizados para o Datasul:

  • Banco Itaú: edi_1100_508_pix341.d 
  • Banco Bradesco: edi_1100_508_pix237.d


Importar os mapas, só precisa da transação 1100.

Na nossa rede podem ser buscados os arquivos pela release desejada, já nos clientes é baixado conforme Console:

Exemplo:

\\ipiranga\patch_repository\ems5\12.1.33.4-SNAPSHOT\src\prgint\edf

Seleciona a opção Importação, e pela lupa busca o arquivo (a transação é preenchida automaticamente com o 1100):

Seleciona o 105 e 106 que seleciona automaticamente todos os mapas relacionados:

Clicar em Imprime.

Caso dê mensagens que encontrou processos e que precisam ser eliminados, pode dar um SIM.

No final vai emitir um relatório concluindo a importação:

Agora deve ser feito para o outro arquivo selecionando o 103 e 104, seguindo o mesmo passo a passo.

Pronto, a importação atualizando os mapas foi concluída.

Feito isto, já funciona o envio do pagamento para os Bancos, e provavelmente outros Bancos como Santander, Banco do Brasil, que devem usar esses mapas como modelo mas são específicos.


05. Relacionamento Mapas Antigos x Novos Elementos Mapa Efetivação

A disponibilização dos novos elementos no mapa de Efetivação no módulo de EDI cria uma obrigatoriedade no relacionamento dos Mapas de Cobrança existentes com estes elementos do Mapa Mandatório 000025 - Cobrança Escritural - Efetivação

Caso o mapa de retorno, seja um mapa customizado, com numeração acima de 20000, então para o retorno será necessário fazer o passo a passo no EDU004, pois precisa informar para o mapa da onde vem a informação do arquivo do banco. No exemplo abaixo, vamos detalhar como deve ser informado para o sistema, mas vamos orientar de tal forma que esta informação do PIX a empresa não utiliza ainda, gravando branco.

Caso um dia venha a utilizar, deverá relacionar o programa fórmula desejado.

Como saber qual mapa você utiliza?

Emita os relatórios abaixo de um processo com erro que irá apresentar:

- Relatório de Processos => (Tecnologia -> Integração com EDI -> Relatórios -> Processo EDI - EDU319);

- Relatório dos Dados Layout Entrada/Saída => (Tecnologia -> Integração com EDI -> Relatórios -> Dados Layout Entrada/Saída EDI - EDU327 (escolher opção "Ambos"))

  Colocar na Seleção o código das rotinas acima o código do Processo com erro.

E a opção Imprime Parâmetros igual a SIM.


Exemplo:

Na sequência acesse a rotina EDU004


Clicar na transação 1100 – Cobrança escritural, e dar duplo click para expandir, até encontrar o elemento criado.

São esses os elementos criados, e só aparecem depois de terem importado o mapa atualizado:

Segmento 000291 - Header Cobrança Escritural

Elemento

Label

Comentário Técnico

004630

ISPB

Utilizado para identificar o Banco responsável pelo envio do arquivo retorno.


Segmento 000292 - Detalhe Cobrança Escritural

Elemento 

Label

Comentário Técnico

005049

Chave Pix

Informação enviada no arquivo Remessa ao qual foi registrada a Cobrança Pix.

005050

Código Liquidação

Código de Identificação da Liquidação retornado pelo Banco

005051

END TO END ID

ID fim a fim da Transação. Campo que transita nas mensagens de recebimento dos QR Codes e transferências.

005052

MSG Pagador Final

Mensagem enviado pelo Pagador. Se ela retornar iremos gravar na ocorrência gerada pelo processamento arquivo retorno 

005053

Codigo Erro

Para os registros rejeitados alguns bancos chegam a enviar até dez códigos de erro que explicam o motivo da rejeição.

005054

PIX LINK

Link gerado para pagamento do QR Code.

005055

Location LINK

URL presente no EMV do QR Code Dinâmico e que contém os dados da cobrança

005056

EMV DO QR CODE

Esse campo deve ser utilizado no processo de geração de imagem (base64)


Localizar o primeiro elemento 004630:

Ao selecionar ele, só clicando em cima, clicar em incluir, que irá abrir a tela abaixo, onde deverá ser selecionado (posicionar o cursor) no mapa com numeração maior que 20000 utilizado, ou seja o específico, e que está dando o erro na importação:

Corra com o curso no ambiente do cliente, até encontrar o mapa específico, por exemplo o 200001 que apresentou no relatório acima que usamos de exemplo.

Na base do cliente, este mapa 200001 (ou o código específico dele) irá apresentar no final da tela abaixo.

Posicione o cursor neste mapa específico, e dê um OK.

Onde irá abrir esta outra tela:

Então para as empresas que não utilizam o PIX, podemos colocar para esta informação ISPB:

- a função Repete, clicar no check vermelho, em seguida no campo Caracter em BRANCO e Quantidade Caracter digite 1 e OK

Ok de novo.

Ou seja, está informando para o mapa que este campo vai ser gravado em branco.

No final poderá ver que este mapa some desta tela de incluir, e gera uma expressão apresentada no destaque abaixo, no cliente, vai apresentar a expressão criada:

Veja:

E isto deverá ser feito para todos os mapas customizados para este elemento, um a um, com numeração acima de 20000.

A cada mapa feito, perceba que no incluir ele não mostra mais o mapa.

Depois localizar os outros elementos e fazer o mesmo passo a passo.

Fazer isto para todos os elementos elencados na tabela acima, do elemento 005049 até 005056.

Após isto, poderão importar novamente o arquivo enviado pelo banco.

06. FAQ - Perguntas Mais Frequentes - Atendimento


Não irei utilizar a cobrança Pix, preciso realizar algum procedimento mesmo assim?

Sim, porque foi realizado alteração nos Mapas EDI 000023 - Extração e 000025 - Efetivação que são comuns também a Cobrança Escritural Normal. Neste caso será necessário realizar o procedimento de importação descrita no item Importação dos Mapas Escriturais Pix e também a alteração descrita no item Relacionamento Mapas Antigos x Novos Elementos Mapa Efetivação deste tutorial. 


Os layouts de Cobrança Pix de quais Bancos estão contemplados nesta liberação?

Foram liberados os mapas de Envio e Retorno dos Bancos Itaú e Bradesco.


Quais parceiros EDI estão relacionados aos novos mapas Envio e Retorno Escritural Pix?

Pontualmente foram criados os parceiros 23709 e 34109 e relacionados com os Bancos Bradesco e Itaú respectivamente. Lembramos que assim como na cobrança normal, deve existir um parceiro exclusivo para cada portador. Caso venha utilizar mais de um portador faz-se necessário criar novos parceiros e relacioná-los assim como ocorreu com os parceiros já pré-cadastrados 23709 e 34109.


Aonde encontro os novos mapas Envio e Retorno Escritural Pix?

Eles são expedidos juntos com os programas e podem ser encontrados dentro da estrutura de programas do EMS5, na pasta prgint/edf. Os arquivos são:

Banco Bradesco: edi_1100_508_pix237.d 

Banco Itaú: edi_1100_508_pix341.d


Está ocorrendo erro no Envio Cobrança Escritural: "Segmento 291...292... com quantidade incorreta de elementos...", o que devo fazer?

Este erro ocorre quando você acaba atualizando o programa de retorno escritural e os mapas escriturais de Cobrança não foram devidamente atualizados. Realize a importação dos mapas conforme indicado no Importação dos Mapas Escriturais Pix deste tutorial.


Está ocorrendo erro 5548 no Retorno: "No mapa 25, segmento 291....292... o elemento 1....2....2  não foi relacionado.", o que devo fazer?

Este erro ocorre porque falta relacionamento do mapa importação com os novos elementos do mapa 25 efetivação. Para que não ocorra mais o erro efetue o procedimento do item Relacionamento Mapas Antigos x Novos Elementos Mapa Efetivação deste tutorial.