OS 91429 - MELHORIA - CORPORATIVO - ENDEREÇO DO PARCEIRO SEM CEP

Objetivo:

Essa solicitação tem por objetivo implementar a criação/ajusteobrigatoriedade do relatóriocampo NotasCEP Fiscaisno porcadastro Períodode endereços de parceiros (ComCliente Vencimentos)& para listar os vencimentos das parcelas das notas fiscais lançadasFornecedor), garantindo que:

• Onão relatórioseja somentemais esteja disponípossível esalvar/confirmar retorneum dados quando endereço clientesem possuir a FUNDAD CLIENTE_TRANSPORTES (Primax) ativa.CEP;

• Oseja relatóriopossível respeitecadastrar osum filtrosnovo CEP a partir da tela de períodoparceiros, equando gereo ExcelCEP cominformado asnão colunas ajustadas, incluindo Vencimento da Parcela e as Informações digitadas na Solicitação de forma sequencial/concatenada conforme solicitado.existir;

• Oas relatóriodemais atendaregras integralmenteda àtela de endereços e contatos permaneçam inalteradas;

• o processo de recebimento funcione corretamente para parceiros com CEP preenchido, eliminando a situação reportada.reportada (cadastro sem CEP impedindo o recebimento).

Premissas:

• Necessário o ambiente estar atualizado com asa versões:versão:
  • RecebimentoCorporativo de número 125855XXXX Genexus 17 ou superior;
    
  • Script de número 125659 SQL e 125670 PosGree.

  • Cliente com funcionalidade CLIENTE_TRANSPORTES ativa no banco.

  • Base com notas fiscais lançadas dentro dos períodos de teste, contemplando parcelas (1x, 2x, 3x+, diferentes datas de vencimento) e situações: normal, cancelada, estornada.
    

  • Usuário com a funcionalidade wpRelNotasPeriodo vinculada ao perfil.
    

    

    

    

  Teste realizado após a atualização

  Cenário 1: GeraçãInserir novo endereço do relatório(cliente com FUNDADCEP Ativa).obrigatório (CEP já cadastrado)

  Objetivo:Objetivo do cenário
  Garantir que o campo CEP é obrigatório ao inserir um novo endereço de parceiro e que, ao informar um CEP já cadastrado, o endereço é salvo normalmente.

  Passo a passo

  1. 1. Acessar o módulo Corporativo Validar> fluxomenu principalParceiro > Cliente & Fornecedor.

        • Evidência: 01 - CliFil.png

     2. Localizar e selecionar um parceiro qualquer (cliente ou fornecedor).

     3. Acessar a guia Endereços.

        • Evidência: 02 - Guia Endereços.png

     4. Clicar em Inserir para clienteincluir um novo endereço.

     5. Tentar confirmar o endereço sem informar o CEP (preencher os demais campos obrigatórios de endereço, mas deixar CEP em branco).

        Resultado esperado 5:

        • O sistema não permite salvar o endereço.

        • Deve ser exibida mensagem de validação indicando que o CEP é obrigatório (mensagem conforme padrão do sistema).

        • O foco deve retornar ao campo CEP ou permanecer na tela sem gravar o registro.

        • Evidência: 03 - CEP obrigatório.png (ou print similar com funcionalidadea mensagem).

     6. Informar um CLIENTE_TRANSPORTESCEP válido já cadastrado ativa.na
        base.

     7. Preencher os demais campos do endereço, se necessário, e clicar em Preparação:Confirmar.

        Usuário

        Resultado esperado 7:

        • O sistema aceita o CEP informado sem exigir cadastro adicional.

        • O endereço é inserido com permissão;sucesso períodopara o parceiro.

        • O novo endereço aparece na grade/listagem de endereços do parceiro.

        • Evidência: 08 - Endereços inseridos.png (endereço incluído na listagem).

  Cenário 2: Inserir novo endereço com notasCEP não cadastrado (cadastro de CEP em linha)

  Objetivo do cenário
  Verificar se, ao informar um CEP inexistente na base, o sistema permite o cadastro de CEP a partir da própria tela de parceiros e parcelas.retorna
  corretamente as informações após o cadastro.

  Passos:Passo a passo

  1. Acessar o módulo RecebimentoCorporativo > Relatóriosmenu Parceiro > NotasCliente Fiscais& > Por Período (Com Vencimentos)Fornecedor. 
     

     
     

     

      

  2. InformarSelecionar Períodoum parceiro (ex.:cliente/fornecedor) 01/09/2025e acessar a 31/09/2025)guia Endereços.
     

     

  3. Clicar em ExcelInserir para gerar.incluir um novo endereço.

  4. AguardarInformar processamentoum eCEP baixar.que
     não esteja cadastrado na base.

     • Evidência: 04 - CEP não cadastrado.png (tela demonstrando o CEP inexistente).

     Resultado esperado 4:

     • O sistema identifica que o CEP não está cadastrado.

     • AbrirDeve disponibilizar a opção arquivo“Cadastro ede validarCEP” colunas(botão, elink dados.
       

       ou

       atalho conforme implementado).

Clicar em Cadastro de CEP.

Na tela de Cadastro de CEP, informar os dados obrigatórios do CEP (logradouro, bairro, cidade, UF, etc.) e clicar em Confirmar.

• Evidência: 05 - Cadastro CEP.png

Resultado Esperadosesperado 6:

• O CEP é cadastrado com sucesso na base de CEPs.

• É exibida mensagem de sucesso (conforme padrão do sistema).

Retornar à tela de Endereços do parceiro (se o fluxo não retornar automaticamente, voltar manualmente).

Verificar que, após o cadastro do CEP, as informações de logradouro/bairro/cidade/UF são retornadas automaticamente para o endereço em edição (conforme regra já existente).

• Evidência: 06 - Confirme.png

Resultado esperado 8:

• O CEP recém-cadastrado é associado ao endereço.

• Demais dados do endereço são preenchidos de acordo com o cadastro do CEP.

Completar os demais campos de endereço, se necessário, e clicar em Confirmar.

Resultado esperado:esperado 9:Excel

gerado

contendo
• as

  O colunasendereço mínimas,é salvo corretamente com Vencimento da Parcela preenchido corretamente e Informações da Solicitação concatenadas/ordenadas.novo CEP cadastrado.

• O endereço aparece na lista de endereços do parceiro.

• Evidência: 08 - Endereços inseridos.png.

Cenário 2:3 Usuário– semEditar permissãendereço wpRelNotasPeriodoexistente garantindo obrigatoriedade do CEP

Objetivo:Objetivo do cenário
Validar que, ao editar Validarum controleendereço deexistente, acesso.o
Preparação:sistema Usuário semmantém a funcionalidadeobrigatoriedade nodo perfil.CEP,
impedindo a gravação se o campo for apagado.

Passos:Passo a passo

1. Acessar o módulo Corporativo > menu Parceiro > Cliente & Fornecedor.

2. Selecionar um parceiro com endereço já cadastrado e acessar a guia Endereços.

3. Selecionar um endereço existente e clicar em Editar.

4. Apagar o valor do relatório.CEP e tentar confirmar o endereço.

   Resultado esperado:esperado 4:

   • O sistema não permite salvar Acessoo bloqueado/ocultoendereço ousem CEP.

   • Deve ser exibida mensagem de permissãvalidação insuficiente.indicando
     que o CEP é obrigatório.

   • O registro não é gravado sem CEP.

5. Informar um CEP válido (cadastrado ou, se não cadastrado, seguir fluxo do Cenário 2 para cadastrar o CEP).

6. Confirmar a edição do endereço.

   Resultado esperado 6:

   • O endereço é atualizado com sucesso.

   • O CEP permanece preenchido.

   • Os demais campos da tela continuam com o comportamento normal (sem alterações de regra).

---

Cenário 4 – Contatos do endereço (garantir que não houve mudança de regra)

Objetivo do cenário
Confirmar que as regras de contatos no cadastro de endereços não foram alteradas pela nova obrigatoriedade do CEP.

Passo a passo

1. Acessar o módulo Corporativo > menu Parceiro > Cliente & Fornecedor.

2. Selecionar um parceiro, acessar a guia Endereços e inserir ou editar um endereço com CEP válido (conforme Cenário 1 ou 2).

3. Na etapa de contatos do endereço, informar ou alterar os dados de contato (telefone, e-mail, contato principal, etc.).

   • Evidência: 07 - Contatos.png

4. Confirmar a operação até concluir o cadastro/edição do endereço.

   Resultado esperado 4:

   • O cadastro de contatos funciona normalmente, sem novas validações indevidas relacionadas ao CEP.

   • Contatos são mantidos e gravados conforme regra já existente antes da mudança.

---

Cenário 5 – Verificar a situação reportada: recebimento com parceiro sem CEP x com CEP

Objetivo do cenário
Garantir que o problema originalmente reportado foi sanado:

• antes, era possível cadastrar parceiro/endereço sem CEP e, no recebimento, não era possível concluir o processo;

• agora, com o CEP obrigatório, não haverá parceiro novo sem CEP, e o recebimento deve ocorrer normalmente para parceiros com CEP informado.

Observação: este cenário deve ser adaptado ao módulo/tela de Recebimento efetivamente utilizado pelo cliente (ex: Recebimento de NF, Recebimento de Mercadorias, etc.).

Parte A – Validar bloqueio no cadastro (não permitir novo parceiro sem CEP)

1. Tentar cadastrar um novo parceiro ou um novo endereço, sem CEP, conforme Cenário 1, passo 5.

   Resultado esperado A:

   • O sistema bloqueia o cadastro sem CEP.

   • Isso impede que surjam novos cadastros incompletos que gerem problema no recebimento.

Parte B – Ajustar parceiro antigo sem CEP (se existir) e testar recebimento

2. Localizar um parceiro já existente que possuía endereço sem CEP (caso ainda exista na base de testes).

3. Editar o endereço do parceiro, informar o CEP corretamente (Cenário 2 ou 3) e confirmar.

   Resultado esperado 3:

   • O parceiro passa a ter endereço com CEP válido e cadastrado.

4. Acessar o módulo/tela de Recebimento utilizado na operação (ex.: Recebimento de Mercadorias).

5. Iniciar um processo de recebimento para este parceiro (inserir documento, NF, pedido, conforme fluxo padrão).

6. Tentar concluir o recebimento.

   Resultado esperado 6:

   • O sistema permite concluir o recebimento normalmente.

   • Não ocorre mais o bloqueio/erro anteriormente reportado devido à ausência de CEP.

   • Caso exista mensagem de erro, ela não deve estar relacionada a CEP, e sim a outra regra (se for o caso).

7. Repetir o teste com um parceiro novo já cadastrado com CEP obrigatório (criado após a correção).

   Resultado esperado 7:

   • O recebimento também é concluído normalmente para parceiros novos, comprovando que o fluxo completo (cadastro + recebimento) está consistente com a nova regra.

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