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, permitir parametrizar E-mail de Cobrança por Unidade Operacional (UOP) incluindo:
    • Servidor/credenciais de envio por UOP.

    • Assunto e layout (template) do e-mail por UOP.

    • Disparo agrupando títulos por UOP.

    • Rotina de inicialização que replique a configuração vigente para todas as UOPs existentes (ponto de partida).

Premissas:

  • Necessário o ambiente estar atualizado com as versões:
    • Contas a Receber de número xxxx Genexus 17 ou superior;
    • Script de número 117760 SQL / 117761 SQLPostgre ou superior.

Teste realizado após a atualização

Cenário 1: Replicação inicial das configurações para todas as UOPs

Objetivo: Garantir que o script populou uma configuração por UOP a partir da configuração vigente.
Passos:

  1. Após execução do script 

  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.

Acessando a funcionalidade
image.png
image.png

Tela de parâmetros gerais

Na tela de parâmetros gerais note que foram carregadas as configurações para todas as Unidades Operacionais.
Para modificar, basta editar a unidade desejada.image.png

Edição da Unidade Operacional.

Na edição é possível realizar a alteração por Unidade Operacional.image.png

Observação: Para novas unidades operacionais, a configuração deve ser feita de forma manual.


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 14 (Exemplo).

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

  3. Salvar.

  4. Trocar para UOP 21 (Exemplo) e verificar que os campos permanecem com os valores da UOP 21.

Resultado esperado:

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

  • Outras UOPs não são afetadas.

Acessando a funcionalidade
image.png
image.png

Tela de configuração UOP 14

Para exemplificar foram alteradas algumas informações.image.png

Tela de configuração UOP 21
Note que as alterações feitas na UOP 14 não afetaram a UOP 2.1.image.pngimage.png


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.

  • Alerta aponta ausência de configuração da UOP. Isso no momento de execução.

Observação: para as UOP's atuais, o script cobre todas.



Cenário 4:3: Disparo e agrupamento por UOP.

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 UOP_B…1, UOP 14...).

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

Programa após execução.

  1. Programa a ser executado;
  2. Unidade Operacional 1;
  3. Unidade Operacional 14.

image.png


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 14, definir assunto com identificador (ex.: [Cobrança UOP_A]) e um texto exclusivo no template.

  2. Para UOP 2, 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 > Parceiros > Limite de Crédito.

  2. Preencher o campo “Qtd. de Títulos” para o parceiro X.

  3. Executar o programa de cobrança.

Resultado esperado:

  • Somente parceiros com o campo “Qtd. de Títulos” informado são considerados na validação de inadimplência (conforme Step img 1).

  • E-mails gerados contemplam a regra.

4.png

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