Ir para o conteúdo principal

OS 80729 - MELHORIA - CONTAS A PAGAR - COMPROVANTE ELETRONICO

Objetivo:

Essa solicitação visa, permitir imprimir comprovantes de pagamento de títulos/parcelas baixados automaticamente via arquivo de retorno CNAB 240 (Bradesco), usando os dados complementares gravados na baixa (incluindo Autenticação Bancária), com layouts padronizados equivalentes aos exibidos no Internet Banking para cada tipo de pagamento (PIX, boletos do próprio Bradesco, boletos de outros bancos, TED e transferência entre contas). O acesso à impressão ocorre diretamente na consulta/detalhe do título quando a parcela estiver baixada e possuir dados complementares válidos

Premissas:

  • Necessário o ambiente estar atualizado com as versões:
    • Contas a Pagar de número xxx Genexus 17 ou superior;
    • Script de número xxx SQL / xxx PostgreSQL ou superior;

Teste realizado após a atualização

Cenário 1: Boleto Bradesco - Código 30.

Objetivo: Confirmar que é possível visualizar e imprimir o comprovante de pagamento de um boleto do próprio Bradesco, a partir da baixa automática via arquivo de retorno, exibindo corretamente as informações do título e os dados bancários.

Passos:

  1. Importar arquivo de retorno CNAB 240 contendo baixa de boleto código 30.

  2. Abrir Consulta de Títulos e localizar a parcela baixada.

  3. Abrir o detalhe e confirmar que o botão “Comprovante” está habilitado.

  4. Clicar em “Comprovante” e gerar o PDF.

Resultado esperado:

  • Sistema deve identifica Tipo pagamento/operação pelo Header Lote (segunda linha posição 12-13), neste exemplo código 30.

  • PDF exibe:

    1. Autenticação Bancária: Segmento Z - 79 a 103;

    2. Empresa: Nome Empresa (cadastro Empresa x UOP);

    3. CNPJ Empresa: Header Lote: 19 a 32;

    4. Agência Débito: Header Lote: 53 a 57 | Digito Agência Débito: 58;

    5. Conta Débito: Header Lote: 59 a 70 | Digito Conta: 71;

    6. Tipo de conta: Carrega conforme cadastro de contas bancárias da empresa.

    7. Nome Pagador: Header Lote: 73 a 102;

    8. CNPJ Pagador: Header Lote: 19 a 32;

    9. Beneficiário Nome: Segmento J52 - 92 a 131;

    10. Beneficiário CNPJ: Segmento J52 - 77 a 91;

    11. Beneficiário Agência: Pega do código de barras: posição 20 a 23 (Código de barras está no seg. J - posição 18 a 61),

    12. Beneficiário Conta: Pega do código de barras: posição 37 a 43 (Código de barras está no seg. J - posição 18 a 61);

    13. Nº de Identificação:

      • É a “linha digitável” do boleto, calculamos esse campo com base no código de barras (Seg. J posição 18 a 61);

      • Para validar essa informação pode ser usado algum validador online: ex. https://barcodehelper.devstroupe.com/

    14. Banco Destino: Pega do código de barras: O código do banco, posição 1 a 3 (a descrição pega do cadastro
      de banco, ou seja, o banco precisa existir na base de dados para imprimir sua descrição corretamente);

    15. Vencimento: Data de vencimento do título;

    16. Número de pagamento: Segmento J - 203 a 222;

    17. Data de Pagamento: Segmento J - 145 a 152;

    18. Nº Documento: Imprime o número do Título ou Fatura;

    19. Carteira: Somente quando boleto próprio Bradesco, pega do código de barras: posição 24 a 25 (Código de barras está no seg. J - posição 18 a 61)

    20. Tipo de Documento: Não encontramos no retorno do banco, então ficará em branco;

    21. Valor do Documento: Segmento J - 100 a 114;

    22. Valor do Desconto: Segmento J - 115 a 129;

    23. Outras Deduções: Ficará em branco;

    24. Outros Acréscimos: Ficará em branco;

    25. Mora / Multa: Segmento J - 130 a 144;

    26. Valor Cobrado/Pago: Segmento J - 153 a 167;

Arquivo de retorno:image.png

Acessando a funcionalidade
image.png
image.png

Importando arquivo de retorno.

Na tela principal insira dos dados para baixa e importe o arquivo de retorno do banco.
Após importar o arquivo clique em Confirmar.image.png

O sistema irá direcionar para dashboard, onde será possível verificar o processamento e baixar o relatório de conferência. image.png

Relatório de conferência.image.png

Consulta do título no contas a pagar

Na tela principal de consulta de título clique no botão de anexo, ele vai exibir a opção Comprovante SisPag.image.png

Comprovante eletrônicoimage.png

Cenário 2: Boleto outros bancos - Código 31.

Objetivo: Verificar que o sistema permite gerar o comprovante de pagamento de boletos de outros bancos, com a exibição correta das informações principais (banco de destino, linha digitável e valores pagos).

Passos:

  1. Importar arquivo de retorno CNAB 240 contendo baixa de boleto código 31.

  2. Abrir Consulta de Títulos e localizar a parcela baixada.

  3. Abrir o detalhe e confirmar que o botão “Comprovante” está habilitado.

  4. Clicar em “Comprovante” e gerar o PDF.

Resultado esperado: 

  • Sistema deve identifica Tipo pagamento/operação pelo Header Lote (segunda linha posição 12-13), neste exemplo código 30.

  • PDF exibe:

    • Autenticação Bancária: Segmento Z - 79 a 103;

    • Empresa: Nome Empresa (cadastro Empresa x UOP);

    • CNPJ Empresa: Header Lote: 19 a 32;

    • Agência Débito: Header Lote: 53 a 57 | Digito Agência Débito: 58;

    • Conta Débito: Header Lote: 59 a 70 | Digito Conta: 71;

    • Tipo de conta: Carrega conforme cadastro de contas bancárias da empresa.

    • Nome Pagador: Header Lote: 73 a 102;

    • CNPJ Pagador: Header Lote: 19 a 32;

    • Beneficiário Nome: Segmento J52 - 92 a 131;

    • Beneficiário CNPJ: Segmento J52 - 77 a 91;

    • Beneficiário Agência: Pega do código de barras: posição 20 a 23 (Código de barras está no seg. J - posição 18 a 61),

    • Beneficiário Conta: Pega do código de barras: posição 37 a 43 (Código de barras está no seg. J - posição 18 a 61);

    • Nº de Identificação:

      • É a “linha digitável” do boleto, calculamos esse campo com base no código de barras (Seg. J posição 18 a 61);

      • Para validar essa informação pode ser usado algum validador online: ex. https://barcodehelper.devstroupe.com/

    • Banco Destino: Pega do código de barras: O código do banco, posição 1 a 3 (a descrição pega do cadastro
      de banco, ou seja, o banco precisa existir na base de dados para imprimir sua descrição corretamente);

    • Vencimento: Data de vencimento do título;

    • Número de pagamento: Segmento J - 203 a 222;

    • Data de Pagamento: Segmento J - 145 a 152;

    • Nº Documento: Imprime o número do Título ou Fatura;

    • Carteira: Boleto de outro banco ficará em branco;

    • Tipo de Documento: Não encontramos no retorno do banco, então ficará em branco;

    • Valor do Documento: Segmento J - 100 a 114;

    • Valor do Desconto: Segmento J - 115 a 129;

    • Outras Deduções: Ficará em branco;

    • Outros Acréscimos: Ficará em branco;
    • Mora / Multa: Segmento J - 130 a 144;

    • Valor Cobrado/Pago: Segmento J - 153 a 167;

Arquivo de retorno:image.png

Acessando a funcionalidade
image.png
image.png

Importando arquivo de retorno.

Na tela principal insira dos dados para baixa e importe o arquivo de retorno do banco.
Após importar o arquivo clique em Confirmar.image.png

O sistema irá direcionar para dashboard, onde será possível verificar o processamento e baixar o relatório de conferência. image.png

Relatório de conferência.image.png

Consulta do título no contas a pagar

Na tela principal de consulta de título clique no botão de anexo, ele vai exibir a opção Comprovante SisPag.image.png

Comprovante eletrônicoimage.png

Cenário 3: TED - Código 03.

Objetivo: Garantir que o usuário consiga emitir o comprovante de pagamento de uma TED baixada via retorno bancário, contendo os dados do favorecido, banco destino, valor, data e autenticação bancária

Passos

    1. Importar arquivo de retorno CNAB 240 contendo baixa de boleto código 03.

    2. Abrir Consulta de Títulos e localizar a parcela baixada.

    3. Abrir o detalhe e confirmar que o botão “Comprovante” está habilitado.

    4. Clicar em “Comprovante” e gerar o PDF.

Resultado esperado

  • Sistema deve identifica Tipo pagamento/operação pelo Header Lote (segunda linha posição 12-13), neste exemplo código 03.

  • PDF exibe:

    1. Autenticação Bancária: Segmento Z: 79 a 103;

    2. Empresa: Nome Empresa (Cadastro Empresa x UOP);

    3. CNPJ Empresa: Header Lote: 19 a 32;

    4. Agência Débito: Header Lote: 53 a 57 | Digito Agência Débito: 58;

    5. Conta Débito: Header Lote: 59 a 70 | Digito Conta: 71;

    6. Tipo de conta: Carrega conforme cadastro de contas bancárias da empresa.

    7. Nome Pagador: Header Lote: 73 a 102;

    8. CNPJ Pagador: Header Lote: 19 a 32;

    9. Favorecido: Segmento A: 44 a 73;

    10. CNPJ Favorecido: Segmento B: 19 a 32;

    11. Banco Destino: Segmento A: 21 a 23;

    12. Número Pagamento: Segmento A: 135 a 154;

    13. Agência destino: Segmento A:  24 a 28 | Digito Posição 29);

    14. Conta destino: Segmento A: 30 a 41 | Digito Posição 42);

    15. Data de Pagamento: Segmento A: 94 a 101;

    16. Valor: Segmento A: 163 a 177;

    17. Finalidade.: Se TED > Segmento A: 220 a 224 - Senão > Segmento A: 218 a 219 ;
      a. Se TED, descrição de acordo com a tabela FEBRABAN
      b. Diferente de TED, descrição de acordo com a tabela: FEBRABAN

Arquivo de retorno:image.png

Acessando a funcionalidade
image.png
image.png

Importando arquivo de retorno.

Na tela principal insira dos dados para baixa e importe o arquivo de retorno do banco.
Após importar o arquivo clique em Confirmar.image.png

O sistema irá direcionar para dashboard, onde será possível verificar o processamento e baixar o relatório de conferência. image.png

Relatório de conferência.image.png

Consulta do título no contas a pagar

Na tela principal de consulta de título clique no botão de anexo, ele vai exibir a opção Comprovante SisPag.image.png

Comprovante eletrônicoimage.png

Cenário 4: Transferência entre contas Bradesco - Código 01.

Objetivo: Confirmar que o sistema gera o comprovante de transferência entre contas do Bradesco, exibindo corretamente os dados de origem e destino, valores e identificação da operação.
Neste exemplo, vamos utilizar fatura. Quando a baixa é por meio de uma fatura, será impresso o valor da fatura no comprovante dos títulos vinculados.

Passos: 

  1. Importar arquivo de retorno CNAB 240 contendo baixa de boleto código 01.

  2. Abrir Consulta de Títulos e localizar a parcela baixada.

  3. Abrir o detalhe e confirmar que o botão “Comprovante” está habilitado.

  4. Clicar em “Comprovante” e gerar o PDF.


Resultado esperado

  • Sistema deve identifica Tipo pagamento/operação pelo Header Lote (segunda linha posição 12-13), neste exemplo código 01.

  • PDF exibe:

    1. Autenticação Bancária: Segmento Z: 79 a 103;

    2. Empresa: layoutNome Empresa (Cadastro Empresa x UOP);

    3. CNPJ Empresa: Header Lote: 19 a 32;

    4. Agência Débito: Header Lote: 53 a 57 | Digito Agência Débito: 58;

    5. Conta Débito: Header Lote: 59 a 70 | Digito Conta: 71;

    6. Tipo de Transf./TEDconta:  aplicável; camposCarrega conforme cadastro de contas bancárias da empresa.

    7. Seg.Nome A/BPagador: Header Lote: 73 a 102;

    8. CNPJ Pagador: Header Lote: 19 a 32;

    9. Favorecido: Segmento A: 44 a 73;

    10. CNPJ Favorecido: Segmento B: 19 a 32;

    11. Número Pagamento: Segmento A: 135 a 154;

    12. Agência destino: Segmento A:  24 a 28 | Digito Posição 29);

    13. Conta destino: Segmento A: 30 a 41 | Digito Posição 42);

    14. Data de Pagamento: Segmento A: 94 a 101;

    15. Valor: Segmento A: 163 a 177;

    16. Finalidade.: Se TED > Segmento A: 220 a 224 - Senão > Segmento A: 218 a 219 ;
      a. Se TED, descrição de acordo com a tabela FEBRABAN
      b. Diferente de TED, descrição de acordo com a tabela: FEBRABAN
      c. Se não informado no arquivo de retorno, ficará em branco.

Arquivo de retorno:image.png

Acessando a funcionalidade
image.png
image.png

Importando arquivo de retorno.

Na tela principal insira dos dados para baixa e importe o arquivo de retorno do banco.
Após importar o arquivo clique em Confirmar.image.png

O sistema irá direcionar para dashboard, onde será possível verificar o processamento e baixar o relatório de conferência. image.png

Relatório de conferência.image.png

Consulta do título no contas a pagar

Na tela principal de consulta de título clique no botão de anexo, ele vai exibir a opção númeroComprovante SisPag.image.png

Comprovante eletrônico
Quando a baixa é por meio de pagamentouma (Seg.fatura, Aserá 135–154),impresso data/o valor corretos.da fatura no comprovante dos títulos vinculados.image.png

Cenário 5: PIX (có- Código 45) via arquivo PIX dedicado45

Passos

  1. Importar arquivo de retorno CNAB 240 contendo baixa de boleto código 45.
  2. Abrir Consulta de Títulos e localizar a parcela baixada.
  3. Abrir o detalhe e confirmar que o botão “Comprovante” está habilitado.
  4. Clicar em “Comprovante” e gerar o PDF.

Resultado esperado

    1. SistemaData usada arquivooperação individual(pagamento): deSegmento PIX,A grava:| 94 a 101;

    2. Nº ChaveDocumento: PIXImprime (Seg.o Bnúmero 128–226),do Título ou Fatura;

    3. InstituiçãoEmpresa: destinoNome Empresa (Seg.Cadastro AEmpresa 21–23),x UOP);

    4. DataCNPJ Empresa: (Seg.Header ALote: 94–101),19 a 32;

    5. ValorConta Débito: (Seg.Header ALote: 163–177),

      59
      6. a
    6. 70

      Tipo de conta| Seg.Digito ZConta: pos. 15/18), o com base no cadastro (banco/agência/conta).71;

    7. Sem logotipo/SAC.

*Cenário 6: Parcela baixada sem dados complementares (botão desabilitado)

Passos

  1. Forçar baixa sem segmentos necessários (ex.: retorno incompleto) ou excluir dados complementares via massaTipo de teste.conta: Carrega conforme cadastro de contas bancárias da empresa.

  2. AbrirNome detalhePagador: Header Lote: 73 a 102;

  3. CNPJ Pagador: Header Lote: 19 a 32;

  4. Instituição Destino: Segmento A | 21 a 23;

  5. Nome: Segmento A | 44 a 73;

  6. CNPJ/CPF: Segmento B | 19 a 32;

  7. Chave Pix: Segmento B | 128 a 226 (exclusivo arquivo PIX);

  8. Agência: Segmento A | 24 a 28 (Dig. Pos 29);

  9. Conta: Segmento A | 30 a 41 (Dig. Pos 42);

  10. Valor (efetivo pago): Segmento A | 163 a 177;

  11. Identificador: Segmento Z | Pos. 15 | 18;

  12. Debitado da: (mesma informação do item 3 – Tipo);

  13. Instituição origem: Descrição do banco da parcela.baixa (sempre Bradesco nesse caso) ;

  14. Agência Débito: Header Lote: 53 a 57 | Digito Agência Débito: 58;

ResultadoArquivo esperadode retorno:image.png

Acessando a funcionalidade
image.png
image.png

Importando arquivo de retorno.

Na tela principal insira dos dados para baixa e importe o arquivo de retorno do banco.
Após importar o arquivo clique em Confirmar.

O sistema irá direcionar para dashboard, onde será possível verificar o processamento e baixar o relatório de conferência. 

Relatório de conferência.

Consulta do título no contas a pagar

Na tela principal de consulta de título clique no botão de anexo, ele vai exibir a opção Comprovante SisPag.

Comprovante eletrônico

Observações importantes

  • BotãCompatibilidade bancária:
    Este recurso é exclusivo para o “Comprovante”banco Bradesco. Arquivos de retorno de outros bancos não éserão exibidoprocessados oupara permanece desabilitado, conforme regra: só habilita quando Baixada e com dados complementares gravados.

Cenário 7: Fatura x Título (prioridadegeração de campos)

Passos

  1. Baixar fatura que agrega títulos e importar retorno correspondente.comprovantes.

  2. Gerar o comprovante pela parcela atrelada.

Resultado esperado

  • Para tipos previstos, o valor e o nº do documento respeitam a regra “se foi baixado por fatura imprimir da fatura (e não do título)”, conforme validação definida na impressão.

Cenário 8: Banco não cadastrado na base

Passos

  1. Importar retorno cujo códigoCadastro de banco destino: do boleto
    A não existe no cadastro.

  2. Imprimir comprovante.

Resultado esperado

  • A descrição do Bancobanco Destinode destino pode não ser impressaexibida corretamente corretamentecaso (dependênciao respectivo código de cadastro).banco Registrarnão comoesteja cadastrado no sistema.

  • pontoCadastro de atençtipo de conta:
    A descrição do tipo de conta e(ex.: solicitaçcorrente, poupança) só será apresentada se houver cadastro prévio dessa informação no ERP.

  • Disponibilidade da opção de cadastrocomprovante:
    A do banco.

Cenário 9: Rejeiçopção de arquivogerar o comprovante ficará disponível apenas para títulos baixados que possuam informações completas de pagamento registradas no sistema.
Se os dados complementares não-Bradescoo forem encontrados

Passos

  1. Tentar importarno arquivo CNAB 240 de outroretorno, banco.

    o

Resultado esperado

  • O projeto tratabotão exclusivamente“Comprovante” Bradescopermanecerá desabilitado; registrar bloqueio/alerta e não gerar dados para comprovante..

4.png

ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.

Voltar ao topo