Ir para o conteúdo principal

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

Objetivo:

Essa solicitação tem por objetivo para clientes que possuamimplementar a nova rotina de funcionalidadedownload “CLIENTE_TRANSPORTES”de ativaarquivos XML de NF-e em lote no módulo Documentos Eletrônicos (NFE > Download em Lote), osgarantindo campos Centro de Custo e Observação se tornem obrigatórios durante o processo de geração de Solicitação de Compra, impedindo a gravação/salvamento quando não atendidos.
Além disso, validar as seguintes regras complementares:que:

  • ObservaçãoOs devefiltros contere mínimoregras de 20tela caracteresfuncionem preenchidos.conforme especificação;

  • CentroO dedownload Custoem develote ser(selecionados informadoe notodos) rateiogere doarquivos item,ZIP quando a finalidade do material exigir CCU / Rateio.corretos;

  • AsA regrasintegração com nãoRelatórios > Em Processamento devemesteja serfuncionando;

    aplicadas
    • para
  • clientes

    O semdownload individual a funcionalidadepartir ativa.
    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 "CLIENTE_TRANSPORTESwpDownLoteXML" 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 – ValidarAcesso obrigatoriedadeà datela Observaçãe regras de filtros

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

Passo a passopasso:

  1. Acessar o módulo ComprasDocumentos → Menu Solicitante → Solicitação de CompraEletrônicos.

  2. ClicarNavegar até o menu NFE > Download em Inserir SolicitaçãoLote.

  3. ConfirmarVerificar aos geraçãvalores padrão dados solicitação.campos Data Emissão Inicial e Data Emissão Final.

  4. InserirConferir umque itemapenas nadocumentos solicitação.do Tipo “Nota Fiscal Eletrônica” são listados no grid.

  5. NaInformar telauma Data de Emissão Final menor que a Data de Emissão Inicial e confirmar a pesquisa/aplicação do item, deixar o campo Observação em branco.filtro.

  6. ClicarRemover 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 ConfirmarLote.

Resultado esperadoesperado:

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

  1. Na tela NFE > Download em Lote, manter os filtros que retornem registros no grid.

  2. Não marcar nenhuma linha no grid.

  3. Clicar no botão “Baixar Selecionados”.

Resultado esperado:

  • O sistema não permiteinicia confirmar.nenhum processo de download.

  • ExibeÉ mensagem:exibida “Observaçãmensagem de alerta informando que não éhá obrigatória”registros selecionados. para download.

  • ANenhum validaçãoarquivo ocorreZIP somenteé porque a FUNDADV está ativa.

Cenário 02 – Validar mínimo de 20 caracteres para o campo Observação

Passo a passo

  1. Acessar o módulo Compras e iniciar uma Solicitação.

  2. Inserir um item.

  3. Informar uma Observação com menos de 20 caracteres.

  4. Clicar em Confirmar.

Resultado esperado

  • O sistema não permite avançar.

  • Exibe mensagem: “Observação deve conter no mínimo 20 caracteres”.

  • Validação só ocorre devido à FUNDADV ativa.gerado.

Cenário 03 – ValidarDownload observaçãem lote apenas dos registros selecionados na página

Objetivo do cenário:
Confirmar que o válidabotã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 passopasso:

  1. AcessarNa otela móduloNFE Compras> eDownload iniciarem Lote, aplicar filtros que retornem mais de uma Solicitação.página de NF-e.

  2. InserirNa umpágina item.atual do grid, marcar alguns registros desejados (ex.: 3 notas).

  3. InformarConfirmar Observaçãoque existem outras páginas com 20registros ou(sem maismarcar caracteresnada nas demais páginas).

  4. Clicar emno botão Confirmar“Baixar Selecionados”.

  5. Aguardar a geração do arquivo ZIP e o download pelo navegador.

  6. Abrir o arquivo ZIP gerado e verificar seu conteúdo.

Resultado esperadoesperado:

  • O sistema aceitaexibe astatus observação.de processamento (se aplicável) e em seguida o download do arquivo ZIP é iniciado.

  • AvançaO paraarquivo aZIP telacontém apenas os XML dos registros selecionados na página atual.

  • Não são incluídos XML de Rateioregistros não selecionados ou de Centrooutras páginas do grid.

  • Os arquivos XML dentro do ZIP estão íntegros e com nomenclatura conforme padrão de Custos.NF-e.

Cenário 04 – ValidarDownload obrigatoriedadede todas as notas (processamento em segundo plano)

Objetivo do Centrocenário:
Validar o fluxo de Custo“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 passopasso:

  1. Na tela NFE > Download em Lote, aplicar filtros que retornem um conjunto representativo de Rateio,NF-e não(múltiplas informar nenhum CCU.notas).

  2. Clicar no botão “Baixar todos”.

  3. Na mensagem de confirmação exibida, clicar em Confirmar“SIM” para prosseguir.

  4. Verificar se o sistema redireciona automaticamente para a tela Relatórios > Em Processamento.

  5. 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).

  6. Aguardar o término do processamento.

  7. Após a conclusão, clicar para baixar o arquivo ZIP gerado.

  8. Abrir o ZIP e validar a quantidade e o conteúdo dos XML.

Resultado esperadoesperado:

  • OAo clicar em “Baixar todos”, o sistema nãoexibe permite confirmar o rateio.

  • Exibe mensagem:uma “Centromensagem de Custo é obrigatório”confirmação.

  • ValidaçAo confirmar (SIM), o processo de geração ocorredo 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 quandoos ada funcionalidadepágina estáatual).

    ativa.

  • 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 CCUa informadoconfirmação corretamentee 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 passopasso:

  1. NaAcessar telao módulo Relatórios e abrir o menu Em Processamento.

  2. Localizar o registro do download em lote de Rateio,XML informar(gerado umnos Centrotestes de Custo válido.anteriores).

  3. Clicar na ação de download do arquivo.

  4. Na mensagem de confirmação exibida, clicar em Confirmar“SIM”.

  5. Aguardar a conclusão do download pelo navegador.

  6. Abrir o arquivo ZIP baixado e verificar o conteúdo.

Resultado esperadoesperado:

  • RateioAo clicar na opção de download, o sistema exibe mensagem de confirmação.

  • Após clicar em “SIM”, o arquivo ZIP é inseridobaixado comimediatamente sucesso.pelo navegador.

  • O itemZIP ficacontém devidamenteos configurado.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 – ValidarValidaçã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 asa regrassituação NÃOreportada atuamna semsolicitação original foi efetivamente corrigida com a funcionaliadenova ativatela/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):

  1. CriarReproduzir umao Solicitaçmesmo fluxo que ocasionava o problema antes da correção de(ex.: Compraaplicar normalmente.determinados filtros, tentar baixar XML em lote, acessar sem permissão, etc.).

  2. InserirExecutar umo item.fluxo agora utilizando a nova tela de Download em Lote e/ou a rotina ajustada.

  3. DeixarComparar Observação emcomportamento branco.

    atual
    4. com

  4. Confirmar.

  5. Na tela de Rateio, não informarcomportamento Centroreportado de Custo.

  6. Confirmar.anteriormente.

Resultado esperadoesperado:

  • O sistemacomportamento indesejado original não bloqueiaocorre mais a gravação da observação.

  • Permite observação vazia ou com menos de 20 caracteres.

  • Permite salvar sem Centro de Custo.

  • Confirma a solicitação normalmente.

  • Ou seja: nenhuma validação deve ocorrer.

Cenário 07 – Verificar se a situação reportada foi atendida no desenvolvimento

Passo a passo

  1. Validar mensagens exibidas (texto, posição, cor padrão do sistema).

  2. ValidarO sistema passa a se comportar conforme os bloqueios acontecemcenários antes01 a 05 dadescritos gravação.acima.

  3. ConfirmarPode queser registrada uma evidência de “antes x depois” se o ambiente permitir reproduzir a obrigatoriedadesituação ocorre exclusivamente quando a funcionalidade está ativa.

  4. Validar que a lógica de mínimo de caracteres está corretaantiga (contarou espaços)apenas o comportamento atual correto).

  5. Verificar se após informar corretamente os campos, o processo flui normalmente.

Resultado esperado

  • Todas as regras aplicadas corretamente.

  • Nenhum erro adicional aparece.

  • Comportamento reproduz exatamente o solicitado na OS.

4.png

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

Voltar ao topo