OS 81135 - MELHORIA - RECEBIMENTO - RELATORIO - NOTAS FISCAIS - POR PERIODO

Objetivo:

Essa solicitação tem por objetivo a criação/ajuste do relatório Notas Fiscais por Período (Com Vencimentos) para listar os vencimentos das parcelas das notas fiscais lançadas, garantindo que:

• O relatório somente esteja disponível e retorne dados quando o cliente possuir a FUNDAD CLIENTE_TRANSPORTES (Primax) ativa.

• O relatório respeite os filtros de período e gere Excel com as colunas ajustadas, incluindo Vencimento da Parcela e as Informações digitadas na Solicitação de forma sequencial/concatenada conforme solicitado.

• O relatório atenda integralmente à situação reportada.

Premissas:

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

• Cliente com FUNDADfuncionalidade CLIENTE_TRANSPORTES ativa no banco.

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

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

• Parâmetros de ambiente sem cache antigo de relatório (se aplicável).

Teste realizado após a atualização

Cenário 1: Geração do relatório(cliente com FUNDAD Ativa).

Objetivo: Validar fluxo principal para cliente com FUNDAD CLIENTE_TRANSPORTES ativa. Preparação: Usuário com permissão; período com notas e parcelas. Passos:

1. Acessar Recebimento > Relatórios > Notas Fiscais > Por Período (Com Vencimentos). (Evidência: 01 - wpRelNotasPeriodo.png)

2. Informar Período (ex.: 01/10/2025 a 31/10/2025).

3. Clicar em Excel para gerar. (Evidência: 02 - Imprimir Relatório.png)

4. Aguardar processamento e baixar. (Evidência: 03 - Em Processamento.png)

5. Abrir o arquivo e validar colunas e dados. (Evidência: 04 - Relatório.png) Resultado esperado: Excel gerado contendo as colunas mínimas, com Vencimento da Parcela preenchido corretamente e Informações da Solicitação concatenadas/ordenadas.

Resultado Esperados

Cenário 2: Cliente sem FUNDAD (inapto)

Objetivo: Garantir que o relatório não retorne dados indevidamente. Preparação: Trocar para cliente sem FUNDAD CLIENTE_TRANSPORTES ativa. Passos:

1. Repetir fluxo do Cenário 01. Resultado esperado: Mensagem de cliente não habilitado ou relatório sem dados (conforme regra), sem erro técnico. (Evidência sugerida: 05 - Relatório (sem dados).png)

Cenário 3: Usuário sem permissão wpRelNotasPeriodo 

Objetivo: Validar controle de acesso. Preparação: Usuário sem a funcionalidade no perfil. Passos:

1. Acessar o menu do relatório. Resultado esperado: Acesso bloqueado/oculto ou mensagem de permissão insuficiente. (Evidência: 06 - Sem Permissão.png)

Cenário 4: Período sem notas/parcelas

Objetivo: Verificar resposta para período válido sem dados. Passos:

1. Informar período onde não existam lançamentos.

2. Gerar Excel. Resultado esperado: Excel gerado vazio com cabeçalho ou mensagem “sem registros”, sem exceções. (Evidência: 07 - Excel Vazio.png)

Cenário 5: Vencimentos múltiplos (parcelas 1/3,2/3, 3/3)

Objetivo: Garantir listagem uma linha por parcela com respectivos vencimentos. Preparação: NF com 3 parcelas em datas diferentes. Passos:

1. Gerar relatório para período que inclua a NF parcelada.

2. Verificar linhas por parcela e colunas. Resultado esperado: Três linhas distintas da mesma NF com Parcela e Vencimento da Parcela corretos. (Evidência: 08 - Parcelas Multiplas.png)

Cenário 6: Formatação de data e ordenação por vencimento

Objetivo: Validar formato dd/MM/yyyy e ordenação/organização. Passos:

1. Gerar relatório.

2. Validar formato nas células do Excel e ordenação padrão (por emissão ou vencimento, conforme especificação; se previsto, testar ordenação). Resultado esperado: Datas no padrão dd/MM/yyyy; ordenação conforme regra de negócio. (Evidência: 09 - Formato e Ordenacao.png)

Cenário 7: Informações da Solicitação (sequencias/ concatenadas)

Objetivo: Garantir exibição contínua e na ordem de registro das informações digitadas na solicitação. Preparação: Solicitação com múltiplos campos livres/observações. Passos:

1. Registrar/editar solicitação com 2+ blocos de informação.

2. Gerar relatório e validar coluna Informações da Solicitação. Resultado esperado: Campo apresenta todas as informações concatenadas em ordem sequencial, sem truncamento e sem quebras indevidas. (Evidência: 10 - Informacoes Solicitação.png)

Cenário 8: Inclusão de notas canceladas/estornadas (regras)

Objetivo: Validar regra de exibição de status. Preparação: Notas canceladas/estornadas no período. Passos:

1. Gerar relatório abrangendo as notas em diferentes status. Resultado esperado: Exibição conforme regra: exibir com status identificado OU não exibir e documentar a decisão; em qualquer caso, sem afetar a numeração/parcela das demais. (Evidência: 11 - Status Notas.png)

Cenário 9: Filtro de período (bordas do período)

Objetivo: Garantir inclusão/exclusão correta na borda do período. Preparação: Notas/parcelas exatamente em 01/mm/aaaa e último dia/mm/aaaa. Passos:

1. Rodar relatório com período X e X+1. Resultado esperado: Registros nas bordas aparecem conforme o intervalo inclusivo/exclusivo definido. (Evidência: 12 - Borda Periodo.png)

Cenário 10: Performance e volume

Objetivo: Avaliar tempo de geração com volume representativo. Preparação: Massa com ≥ X mil parcelas. Passos:

1. Gerar o relatório. Resultado esperado: Geração concluída em tempo aceitável (definir SLA) e arquivo íntegro. (Evidência: 13 - Performance.png)

Cenário 11: Validação de layout/ortografia

Objetivo: Verificar cabeçalhos, acentuação e nomes de colunas. Passos:

1. Conferir visualmente o Excel. Resultado esperado: Cabeçalhos corretos, sem erros tipográficos. (Evidência: 14 - Layout Colunas.png)

Cenário 12: Segurança (download e acesso ao arquivo)

Objetivo: Garantir que somente usuários autorizados baixem o arquivo. Passos:

1. Validar controles do dashboard de processamento. Resultado esperado: Nenhum vazamento de link/arquivo para usuários sem permissão. (Evidência: 15 - Segurança Download.png)

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