Revisão de Página para OS 91994 - MELHORIA - ...

OS 91994 - MELHORIA - DOC. ELETRÔNICO - DOWNLOAD DE XML EM LOTE

Objetivo:

Essa solicitação tem por objetivo implementar a nova rotina de download de arquivos XML de NF-e em lote no módulo Documentos Eletrônicos (NFE > Download em Lote), garantindo que:

Os filtros e regras de tela funcionem conforme especificação;
O download em lote (selecionados e todos) gere arquivos ZIP corretos;
A integração com Relatórios > Em Processamento esteja funcionando;
O download individual a partir do relatório seja concluído com sucesso;
A situação originalmente reportada na solicitação seja efetivamente corrigida no desenvolvimento final.

Premissas:

Necessário o ambiente estar atualizado com a versão: Compras de número XXXXX Genexus 17 ou superior;
Funcionalidade "wpDownLoteXML" precisa estar ativa via banco de dados, caso necessário entre em contato com a Send Solutions.
Usuário com permissão à empresa/filial onde existem NF-e emitidas.

Teste realizado após a atualização

Cenário 01 – Acesso à tela e regras de filtros

Objetivo do cenário:
Garantir que o acesso à tela respeite permissões e que os filtros iniciais sejam aplicados corretamente.

Passo a passo:

Acessar o módulo Documentos Eletrônicos.
Navegar até o menu NFE > Download em Lote.
Verificar os valores padrão dos campos Data Emissão Inicial e Data Emissão Final.
Conferir que apenas documentos do Tipo “Nota Fiscal Eletrônica” são listados no grid.
Informar uma Data de Emissão Final menor que a Data de Emissão Inicial e confirmar a pesquisa/aplicação do filtro.
Remover a permissão “wpDownLoteXML” do perfil do usuário (ou acessar com um usuário sem essa permissão) e tentar acessar novamente o caminho NFE > Download em Lote.

Resultado esperado:

Ao acessar o menu, a tela Download em Lote é exibida conforme layout definido.
As datas de emissão Inicial e Final são preenchidas automaticamente com o período dos últimos 15 dias.
O grid lista somente XML de notas do tipo NF-e.
Ao informar uma Data Final menor que a Data Inicial, o sistema zera a variável correspondente à Data Final (campo é limpo/ajustado) e impede a pesquisa inconsistente, conforme regra definida.
Usuário sem a funcionalidade “wpDownLoteXML” não consegue acessar a tela (menu oculto, acesso negado ou mensagem de permissão, conforme padrão do sistema).

Cenário 02 – Tentativa de “Baixar Selecionados” sem seleção no grid

Objetivo do cenário:
Validar a mensagem de alerta ao tentar baixar XML sem nenhum registro selecionado.

Pré-requisitos:

Cenário 01 validado.
Existência de NF-e listadas no grid.

Passo a passo:

Na tela NFE > Download em Lote, manter os filtros que retornem registros no grid.
Não marcar nenhuma linha no grid.
Clicar no botão “Baixar Selecionados”.

Resultado esperado:

O sistema não inicia nenhum processo de download.
É exibida mensagem de alerta informando que não há registros selecionados para download.
Nenhum arquivo ZIP é gerado.

Cenário 03 – Download em lote apenas dos registros selecionados na página

Objetivo do cenário:
Confirmar que o botão “Baixar Selecionados” gera um ZIP apenas com os XML selecionados na página atual.

Pré-requisitos:

Cenário 01 validado.
Grid com múltiplos registros paginados (mais de uma página de resultados).

Passo a passo:

Na tela NFE > Download em Lote, aplicar filtros que retornem mais de uma página de NF-e.
Na página atual do grid, marcar alguns registros desejados (ex.: 3 notas).
Confirmar que existem outras páginas com registros (sem marcar nada nas demais páginas).
Clicar no botão “Baixar Selecionados”.
Aguardar a geração do arquivo ZIP e o download pelo navegador.
Abrir o arquivo ZIP gerado e verificar seu conteúdo.

Resultado esperado:

O sistema exibe status de processamento (se aplicável) e em seguida o download do arquivo ZIP é iniciado.
O arquivo ZIP contém apenas os XML dos registros selecionados na página atual.
Não são incluídos XML de registros não selecionados ou de outras páginas do grid.
Os arquivos XML dentro do ZIP estão íntegros e com nomenclatura conforme padrão de NF-e.

Cenário 04 – Download de todas as notas (processamento em segundo plano)

Objetivo do cenário:
Validar o fluxo de “Baixar todos”, com geração do arquivo ZIP em segundo plano e acompanhamento pela tela Relatórios > Em Processamento.

Pré-requisitos:

Cenário 01 validado.
Existência de várias NF-e retornadas pela pesquisa.

Passo a passo:

Na tela NFE > Download em Lote, aplicar filtros que retornem um conjunto representativo de NF-e (múltiplas notas).
Clicar no botão “Baixar todos”.
Na mensagem de confirmação exibida, clicar em “SIM” para prosseguir.
Verificar se o sistema redireciona automaticamente para a tela Relatórios > Em Processamento.
Na tela de Em Processamento, localizar o registro do download em lote recém-gerado (pelo nome do relatório/descrição, data e usuário).
Aguardar o término do processamento.
Após a conclusão, clicar para baixar o arquivo ZIP gerado.
Abrir o ZIP e validar a quantidade e o conteúdo dos XML.

Resultado esperado:

Ao clicar em “Baixar todos”, o sistema exibe uma mensagem de confirmação.
Ao confirmar (SIM), o processo de geração do ZIP é enviado para processamento em segundo plano.
A tela Relatórios > Em Processamento é exibida automaticamente, mostrando o registro do processo de download em lote.
Após a conclusão, o arquivo ZIP fica disponível para download no dashboard.
O ZIP contém todos os XML das notas que atendem aos filtros aplicados (não apenas os da página atual).
Arquivos XML estão íntegros e consistentes com o filtro de pesquisa utilizado na tela de Download em Lote.

Cenário 05 – Download do arquivo/registro pela tela “Em Processamento”

Objetivo do cenário:
Validar a confirmação e o download do arquivo gerado via Relatórios > Em Processamento.

Pré-requisitos:

Cenário 04 executado com sucesso (processo concluído e arquivo disponível).

Passo a passo:

Acessar o módulo Relatórios e abrir o menu Em Processamento.
Localizar o registro do download em lote de XML (gerado nos testes anteriores).
Clicar na ação de download do arquivo.
Na mensagem de confirmação exibida, clicar em “SIM”.
Aguardar a conclusão do download pelo navegador.
Abrir o arquivo ZIP baixado e verificar o conteúdo.

Resultado esperado:

Ao clicar na opção de download, o sistema exibe mensagem de confirmação.
Após clicar em “SIM”, o arquivo ZIP é baixado imediatamente pelo navegador.
O ZIP contém os XML conforme o processo em questão (todos ou selecionados, conforme o solicitado).
Não ocorre erro/mensagem indevida durante o download.

Cenário 06 – Validação da situação originalmente reportada (regressão)

Observação: Aqui você pode detalhar o problema descrito na OS/solicitação (ex.: “antes não era possível baixar XML em lote”, “ZIP vinha vazio”, “erro ao filtrar por data” etc.). Vou deixar genérico para você substituir pelo texto exato do problema.

Objetivo do cenário:
Comprovar que a situação reportada na solicitação original foi efetivamente corrigida com a nova tela/rotina de download em lote de XML.

Pré-requisitos:

Conhecimento da situação relatada (ex.: erro anterior, comportamento indevido, ausência da funcionalidade etc.).
Ambiente com dados que reproduziam o cenário original (se aplicável).

Passo a passo (modelo):

Reproduzir o mesmo fluxo que ocasionava o problema antes da correção (ex.: aplicar determinados filtros, tentar baixar XML em lote, acessar sem permissão, etc.).
Executar o fluxo agora utilizando a nova tela de Download em Lote e/ou a rotina ajustada.
Comparar o comportamento atual com o comportamento reportado anteriormente.

Resultado esperado:

O comportamento indesejado original não ocorre mais.
O sistema passa a se comportar conforme os cenários 01 a 05 descritos acima.
Pode ser registrada uma evidência de “antes x depois” se o ambiente permitir reproduzir a situação antiga (ou apenas o comportamento atual correto).

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