Ir para o conteúdo principal

OS 79707 - MELHORIA - CONTAS A RECEBER - GERAÇÃO DE E-MAIL COBRANÇA POR UNIDADE OPERACIONAL

Objetivo:

  • Esta solicitação tem por objetivo, automatizarpermitir oparametrizar processoE-mail de títulosCobrança registradospor noUnidade mercadoOperacional financeiro,(UOP) visando garantir:incluindo:
    • A flexibilização da regra

      Servidor/credenciais de beneficiárioenvio por meio de novo campo no cadastro de parceiros;

    • A limpeza de registros anteriores ao importar novo arquivo;

    • A desconciliação automática de títulos não pagos;UOP.

    • AAssunto conciliaçãoe comlayout faturas(template) alémdo dee-mail títulospor Contas a Pagar;UOP.

    • ADisparo visualizaçagrupando títulos por UOP.

    • Rotina de inicialização que replique a configuração evigente gravaçãopara todas as UOPs existentes (ponto de valores de multa, juros e desconto.partida).

Premissas:

  • Necessário o ambiente estar atualizado com as versões:
    • Contas a PagarReceber de número 116371xxx Genexus 16 / xxxx Genexus 17 ou superior;
    • Corporativo de número 116017 Genexus 17 ou superior;
    • Script de número 116141xxx SQL / 116142xxx SQLPostgre ou superior.

Teste realizado após a atualização

Cenário 1: CadastroReplicação deinicial Parceirodas -configurações Flagpara Beneficiário.todas as UOPs

NaObjetivo: interface de cadastro de parceiros o novo campo criado será para tratar exceção de regra na conciliação. Como exemplo poderá acontecer de um título ser protestado e seu beneficiário ser alterado, com isso a condição para conciliação deGarantir que o títuloscript dopopulou mercadouma financeiro e configuração títulopor contasUOP a pagarpartir ouda fatura a ser conciliado precisar ter configuração mesmo beneficiário não deve ser aplicada, pois nesse caso o título / fatura terá o beneficiário “A” enquanto o título mercado financeiro terá o beneficiário de origem "B".

vigente.
Passos:

  1. Executar o script de inicialização.

  2. Acessar Contas a Receber > Cadastros > Parâmetros Gerais.

  3. Selecionar cada UOP na interface e inspecionar os campos (servidor, porta, remetente, assunto, template).
    Resultado esperado:

  • Existe um registro de configuração por cada UOP.

  • Os valores replicados coincidem com a configuração global anterior (ponto de partida).

  • Sem erros no log.

Cenário 2: Criação/edição da configuração de e-mail para uma UOP específica

Objetivo: Manter dados independentes por UOP.
Passos:

  1. Em Parâmetros Gerais, selecionar UOP_A.

  2. Informar/alterar Servidor SMTP, Usuário, Remetente, Assunto e Template (corpo do e-mail).

  3. Salvar.

  4. Trocar para UOP_B e verificar que os campos permanecem com os valores da UOP_B.
    Resultado esperado:

  • Alterações persistem somente para a UOP editada.

  • Outras UOPs não são afetadas.

  • Mensagem de sucesso exibida.

Cenário 3: Validação de bloqueio/alerta quando faltar configuração

Objetivo: Garantir comportamento seguro em UOP sem configuração (caso de nova UOP futura).
Passos:

  1. Criar uma UOP nova (ou simular ausência de parâmetros).

  2. Executar o disparo de cobrança.
    Resultado esperado:

  • Sistema bloqueia o envio para a UOP sem parâmetros ou aplica fallback definido (se previsto).

  • Log/alerta aponta ausência de configuração da UOP.

 

Observação: para as UOPs atuais, o script cobre todas — este teste garante robustez para futuras UOPs.

 

Cenário 4: Disparo e agrupamento por UOP (execução do programa)

Objetivo: Verificar que os e-mails são enviados separadamente por UOP.
Passos:

  1. Executar o programa que verifica títulos inadimplentes e dispara os e-mails de cobrança.

  2. Acompanhar o log/console da execução.

  3. Conferir a caixa de saída (ou e-mails recebidos em ambiente de homologação).
    Resultado esperado:

  • O log demonstra lotes por UOP (UOP_A, UOP_B…).

  • São enviados e-mails distintos, um por UOP, apenas com os títulos da respectiva UOP.

Cenário 5: Conteúdo do e-mail respeitando a configuração da UOP

Objetivo: Garantir assunto e template específicos por UOP.
Passos:

  1. Para UOP_A, definir assunto com identificador (ex.: [Cobrança UOP_A]) e um texto exclusivo no template.

  2. Para UOP_B, definir outro assunto (ex.: [Cobrança UOP_B]) e texto distinto.

  3. Executar o disparo (Cenário 4).
    Resultado esperado:

  • E-mail da UOP_A chega com assunto e corpo conforme a configuração da UOP_A.

  • E-mail da UOP_B chega com assunto e corpo conforme a configuração da UOP_B.

  • As evidências (detalhes img 2) mostram o template editado por UOP e os e-mails recebidos com o conteúdo correspondente.

Cenário 6: Tabela de títulos e totais por UOP no corpo do e-mail

Objetivo: Validar as informações financeiras exibidas.
Passos:

  1. Preparar títulos em aberto em cada UOP, com datas/valores distintos.

  2. Disparar os e-mails.

  3. Abrir os e-mails e conferir a tabela de títulos (colunas, soma, total por UOP).
    Resultado esperado:

  • Cada e-mail contém somente os títulos da sua UOP.

  • Somas e totais corretos (validar amostra vs. base).

  • Nas evidências (detalhes img 2) os quadros exibem a UOP, as colunas/valores e o total esperado.

Cenário 7: Regra “Qtd. de Títulos” no Parceiro (Filtro de inadimplência)

Objetivo: Honrar a regra informada no processo.
Passos:

  1. Acessar Módulo Corporativo > CadastroParceiros > ParceirosLimite de Crédito

  2. Editar um fornecedor..

  3. MarcarPreencher a opção campo "Ignora“Qtd. validaçãde Títulos” para o beneficiário"parceiro na aba "Auxiliar".

Resultado Esperado:

  • Campo está visível e editável.X.

  • PermiteExecutar conciliação futura com faturasprograma de beneficiáriocobrança.
    Resultado diferente.esperado:

  • Acessando a funcionalidade
    image.png
    image.png


    Tela de cadastro doSomente parceiros

    Na tela de cadastro de parceiro, encontre o parceiro desejado e clique em "Editar".image.png

    Note que foi criadocom o campo “Qtd. Ignorade Títulos” informado são considerados na validação de beneficiárioinadimplência na(conforme conciliaçãoStep img 1).

    Regra

    da
    • funcionalidade:
  • Caso

    E-mails campogerados “Ignoracontemplam validaçãoa Beneficiárioregra.

    na
    • Conciliação” for marcado no cadastro, ao selecionar um registro na tela “títulos mercado financeiro” e clicar em conciliar, permitirá listar títulos ou faturas de beneficiário diferente.image.png

Cenário 2:8: ImportaçãoPermissão/segurança deda Arquivo DDA.interface

Objetivo: Garantir controle de acesso à parametrização.
Passos:

  1. ImportarAutenticar novocom arquivousuário DDA.sem permissão de parametrização.

  2. VerificarTentar seacessar/alterar osParâmetros títulosde comE-mail.
    Resultado status "Aguardando Conciliação" anteriores foram excluídos.

  3. Verificar se títulos "Conciliados" e ainda não pagos foram desconciliados automaticamente.esperado:

Resultado Esperado:

  • RegistrosAcesso anterioresnegado comou statustela "Aguardandosomente Conciliação"leitura; alterações não são excluídos.

  • Títulos conciliados, mas não pagos, são desconciliados automaticamente.

  • Títulos conciliados e pagos permanecem inalterados.permitidas.

Acessando a funcionalidade
image.png
image.png

Tela de importação

Ao entrar na tela note que há registros conciliados e registros aguardando conciliação. Para importar um novo arquivo, basta clicar no botão Importar Título.image.pngOs registros que estão com o status conciliados e o título não foi baixado, exibe o botão para poder cancelar a conciliação. Já os registros que o título foi baixado, não é permitido o cancelamento da conciliação.

Importando arquivo

Selecione o arquivo e clique em Confirmar.image.png

O sistema irá direcionar para tela de dashboard e realiza em segundo plano o processamento do arquivo.image.png

O resultado do processamento poder ser analisado ao baixar o arquivo gerado.image.png

Regras da funcionalidade:

  • Após importar um novo arquivo, que não possui os mesmos códigos de barras já importados:
    • Os registros com o status Conciliados e o título baixado, continua sua exibição sem alteração de status.
    • Os registros com o status Conciliados e o título em aberto, continua sua exibição sem alteração de status.
    • Os registros com o status Aguardando conciliados, são excluídos da tela.
  • Após importar um novo arquivo, que possui os mesmos códigos de barras já importados:
    • Os registros com o status Conciliados e o título baixado, continua sua exibição sem alteração de status.
    • Os registros com o status Conciliados e o título em aberto, voltam para o status Aguardando conciliados
    • Os registros com o status Aguardando conciliados, são excluídos da tela.

Exemplo quando importa novo arquivo, com códigos de barras já importados.

  • Registro com o status Conciliado (com baixa).

Tela com o registro:image.png

Consulta do título baixado (1) e com o código de barras (2) vinculado:image.png

Após importar o novo arquivo - Tela de registro.  image.png

Consulta do título:
image.png

  • Registro com o status Conciliado (título em aberto).

Tela com o registro:image.png

Consulta do título em aberto (1) e com o código de barras (2) vinculado:image.png

Após importar o novo arquivo - Tela de registrosimage.png

Consulta do título que estava vinculado em aberto (1), não deve ter o código de barras (2) gravado.image.png

  • Registro com o status Aguardando Conciliação.

Tela com o registro:image.png

Após importar o novo arquivo:image.png

Análise do relatório de processamento:image.png

Cenário 3: Visualização de Juros, Multa e Desconto

Passos:

  1. Confirmar que as colunas "Juros", "Multa" e "Desconto" estão disponíveis no grid.

  2. Validar que os valores são corretamente preenchidos conforme posições (Segmentos G e H).

Resultado Esperado:

  • As três colunas são exibidas no grid.

  • Valores são consistentes com os informados no arquivo importado.

Acessando a funcionalidade
image.png
image.png

Tela de títulos registrados no mercado financeiro.

Foram adicionadas as colunas juros, multa e desconto. Campos utilizado para como informativo, não utilizados em outras funcionalidades.image.png

Validando com arquivo importado.

  • Juros: Segmento G - Posição 190 até 204;
  • Desconto: Segmento G - Posição 214 até 228;
  • Multa: Segmento H - Posição 131 até 145.

image.png

Cenário 4: Conciliação com Título do Contas a Pagar ou Fatura

Passos:

  1. Após importação do arquivo.

  2. Clicar em "Conciliar".

  3. Visualizar o prompt com títulos e faturas disponíveis.

Resultado Esperado:

  • Exibe grid com títulos e faturas.

  • Aplica regra de mesmo beneficiário, exceto quando o campo “Ignora validação Beneficiário na Conciliação” esteja marcado.

Acessando a funcionalidade
image.png
image.png

Tela de títulos em mercado financeiro

Ao entrar na tela, utilize os filtros para encontrar o registro.image.pngApós isso, clique no botão Conciliar, o sistema irá exibir um pop-up com os títulos/faturas que atendam a conciliação.

Exemplo de regra com o mesmo beneficiário - Título.

Note que somente título do beneficiário é exibido.
Para conciliar, clique no botão Conciliar da tela principal (1) e ao achar o título, clique no botão de selecionar (2)image.png

O sistema exibira a mensagem de sucesso.image.png

Na consulta do título, note que o código de barras foi vinculado ao título.image.png

Exemplo de regra com o mesmo beneficiário - Fatura

Note que somente título do beneficiário é exibido.
Para conciliar, clique no botão Conciliar da tela principal (1) e ao achar a fatura, clique no botão de selecionar (2).image.png

O sistema exibira a mensagem de sucesso.image.png

Na consulta da fatura, note que o código de barras foi vinculado à fatura.image.png

Exemplo de regra com beneficiário diferente - Título

Observe que o título exibido não corresponde ao beneficiário original. Isso ocorre porque a opção Ignorar validação de beneficiário na conciliação está marcada no cadastro do parceiro.
Para conciliar, clique no botão Conciliar da tela principal (1) e ao achar o título, clique no botão de selecionar (2).image.png

O sistema exibira a mensagem de sucesso.image.png

Na consulta do título, note que o código de barras foi vinculado ao título.image.png

Exemplo de regra com beneficiário diferente - Fatura

Observe que a fatura exibida não corresponde ao beneficiário original. Isso ocorre porque a opção Ignorar validação de beneficiário na conciliação está marcada no cadastro do parceiro
Para conciliar, clique no botão Conciliar da tela principal (1) e ao achar a fatura, clique no botão de selecionar (2).image.png

O sistema exibira a mensagem de sucesso.image.png

Na consulta da fatura, note que o código de barras foi vinculado à fatura.image.png

4.png

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

Voltar ao topo