Ir para o conteúdo principal

OS 104577 - MELHORIA - CONTRATOS - IMPORTAÇÃO EM MASSA DE MEDIÇÕES DE CONTRATOS VIA PLANILHA EXCEL

Objetivo:

A solicitação tem como objetivo, Disponibilizar ao usuário uma funcionalidade para criar medições de contratos em massa por meio da importação de uma planilha Excel padronizada, reduzindo o lançamento manual das medições e garantindo a validação das informações antes da criação dos registros no ERP.

A funcionalidade permite baixar um modelo de planilha, preencher os dados dos contratos e das medições, importar o arquivo e acompanhar o resultado do processamento por meio de um relatório contendo as linhas importadas com sucesso e as inconsistências identificadas.

As medições importadas corretamente devem ser criadas inicialmente com a situação Em elaboração, permitindo que o usuário realize posteriormente a conferência, finalização e aprovação dentro do ERP.

Premissas:

  • Necessário o ambiente estar atualizado com a versão:
    • CONTRATOS de número xxx ou superior. 

Teste realizado após a atualização

Cenário 01: Download e conferência do template de importação

Objetivo: Validar a disponibilização do modelo de planilha que será utilizado para preenchimento e importação das medições dos contratos.

Pré-condição:

  • Usuário com permissão de acesso à funcionalidade de importação de medições;

  • Funcionalidade

    image.png

    WpMedImp disponibilizada no ambiente;
  • Microsoft Excel ou aplicativo compatível instalado.

Passo a passo:

  1. Acessar a funcionalidade de importação de medições;
  2. Baixar o template disponibilizado pelo sistema;
  3. Abrir o arquivo;
  4. Conferir as colunas e as orientações de preenchimento.

Resultado Esperado: O sistema deve permitir o download do template Excel. O arquivo deve apresentar as colunas necessárias para preenchimento dos dados do contrato e da medição, contendo comentários ou orientações que auxiliem o usuário no preenchimento correto.

Acessando funcionalidade
image.png
image.png

Tela de Medição (Importação).


Na tela Importação de lançamentos de medição, clique no botão Baixar Template.image.png

Aguarde o download do arquivo.

Abra o template utilizando o Microsoft Excel ou outro aplicativo compatível.image.png

Confira se o arquivo apresenta as colunas necessárias para importação, como:

  • Tipo de contrato;

    • Número do contrato;
    • Finalidade;
    • Participante;
    • Período inicial;
    • Período final;
    • Código do produto;
    • Quantidade;
    • Número de repetições;
    • Observação.

    Observação: Posicione o cursor sobre as células ou títulos que possuam comentários e confira as orientações de preenchimento disponibilizadas no template.

    Salve uma cópia do arquivo para utilização nos próximos cenários.


    Cenário 02: Importação de medições preenchidas corretamente

    Objetivo: Validar a importação de uma planilha preenchida com dados válidos e a criação das respectivas medições no ERP.

    Pré-condição:

    • Template baixado por meio da funcionalidade;
    • Contrato cadastrado e com situação Vigente;
    • Período da medição compatível com a vigência e com a atividade do contrato;
    • Participante ativo e relacionado ao contrato;
    • Produto ou item relacionado ao contrato;
    • Usuário com acesso à importação e à consulta de medições;
    • Planilha preenchida com dados válidos.

    Passo a passo:

    1. Preencher o template com dados válidos;
    2. Selecionar o arquivo na tela de importação;
    3. Confirmar o processamento;
    4. Consultar o relatório de processamento;
    5. Verificar a medição criada no ERP.

    Resultado Esperado: O sistema deve processar o arquivo, apresentar a linha como importada com sucesso no relatório de processamento e criar a medição correspondente com a situação Em elaboração. Os dados da medição devem ser iguais aos informados na planilha.

    Planilha a ser importada
    Abra o template baixado no cenário anterior.P reencha uma linha com os dados de um contrato válido.

    • Informe o Tipo de contrato, conforme o código utilizado pelo ERP.
    • Informe o Número do contrato vigente.
    • No campo Finalidade, informe:
      • S para Serviço; ou
      • V para Venda.
    • Informe o participante relacionado ao contrato, quando aplicável.
    • Preencha o Período inicial da medição.
    • Preencha o Período final da medição.
    • Certifique-se de que:
      • O período inicial seja anterior ao período final;
      • O período esteja dentro da vigência do contrato, quando houver bloqueio configurado;
      • O período não seja anterior ao início da atividade do contrato.
    • Informe o Código do produto ou item relacionado ao contrato.
    • Informe uma Quantidade maior que zero.
    • No campo Número de repetições, deixe em branco ou informe um valor positivo de até 12.
    • Preencha a Observação, quando necessário.
    • Salve o arquivo no formato Excel utilizado pelo template.

    Acessando afuncionalidade
    image.png
    image.png

    funcionalidade

    Tela de Medição (Importação).

    Tela de Medição (Importação).

    No sistema, acesse Lançamentos > Medição > Medição (Importação).

    Na seção destinada à seleção do arquivo, clique em Escolher arquivo.

    Localize e selecione a planilha preenchida.

    Confira se o nome do arquivo foi apresentado na tela  e clique no botão Confirmar.

    Aguarde a mensagem de confirmação e o envio do processamento para o dashboard.

    Acesse a opção Em processamento, apresentada no menu lateral.

    Localize o processamento referente à importação das medições.

    Aguarde até que o processamento seja concluído e baixe ou abra o relatório gerado.

    Verifique se a linha importada apresenta uma mensagem de sucesso.

    Retorne ao menu Lançamentos.

    Acesse a rotina de Medição ou Medição Contrato.

    Utilize os filtros disponíveis para localizar o contrato informado na planilha.

    Clique em Pesquisar.

    Localize a medição criada.

    Confira os seguintes dados:

    • Número do contrato;
    • Produto ou item;
    • Período inicial;
    • Período final;
    • Quantidade;
    • Participante;
    • Observação.

    Verifique se a medição foi criada com a situação Em elaboração.


    Cenário 03: Validação de inconsistências no processamento da planilha

    Objetivo: Validar se o sistema identifica dados incorretos ou incompletos na planilha e apresenta as respectivas mensagens no relatório de processamento.

    Pré-condição:

    • Template disponibilizado pelo sistema;
    • Usuário com acesso à funcionalidade;
    • Planilha preparada com linhas contendo dados inválidos ou incompletos;
    • Existência de pelo menos uma linha válida para comparação do processamento, quando aplicável.

    Passo a passo:

    1. Preencher a planilha com informações inválidas;
    2. Importar o arquivo;
    3. Consultar o relatório de processamento;
    4. Verificar as mensagens apresentadas;
    5. Confirmar que as linhas inválidas não criaram medições.

    Resultado Esperado: O sistema deve analisar cada linha da planilha e apresentar no relatório as inconsistências identificadas. As linhas inválidas não devem gerar medições. Quando o mesmo arquivo possuir linhas válidas e inválidas, somente as linhas válidas devem ser importadas.


    1. Abra uma cópia do template de importação.
    2. Preencha diferentes linhas com uma ou mais das seguintes inconsistências:
      • Período inicial não informado;
      • Período final não informado;
      • Período inicial maior ou igual ao período final;
      • Período da medição fora da vigência do contrato;
      • Período inicial anterior à data de início da atividade do contrato;
      • Contrato com situação diferente de Vigente;
      • Número de contrato inexistente;
      • Número de repetições negativo;
      • Número de repetições superior a 12;
      • Finalidade diferente de S ou V;
      • Código do produto não informado;
      • Quantidade não informada;
      • Quantidade negativa;
      • Participante não relacionado ao contrato;
      • Participante inativo;
      • Produto ou item não relacionado ao contrato.

    Salve a planilha.

    No sistema, acesse Lançamentos > Medição > Medição (Importação).

    Clique em Escolher arquivo.

    Localize e selecione a planilha preparada para o teste.

    Clique em Confirmar.

    Aguarde a conclusão do envio para processamento.

    Acesse a opção Em processamento.

    Localize a importação realizada.

    Aguarde a conclusão do processamento.

    Baixe ou abra o relatório gerado.

    Confira se cada linha inválida apresenta uma mensagem correspondente à inconsistência identificada.

    Valide, conforme os dados utilizados, a apresentação de mensagens equivalentes a:

    • Período de início não informado;
    • Período final não informado;
    • Período de início deve ser menor que o período final;
    • Período de medição fora da vigência do contrato;
    • Período de início menor que a data de início da atividade do contrato;
    • Contrato informado deve estar com a situação Vigente;
    • Não foi possível identificar o contrato informado;
    • Repetições não podem possuir valor negativo e devem ser de até 12;
    • Finalidade deve ser S para Serviço ou V para Venda;
    • Código do produto não informado;
    • Quantidade não informada ou negativa;
    • Participante não localizado no contrato ou inativo;
    • Produto ou item não identificado no contrato.

    Retorne à rotina de consulta de medições.

    Pesquise pelos contratos utilizados nas linhas inválidas.

    Confirme que as linhas rejeitadas não geraram medições.

    Caso a planilha também possua uma linha válida, confirme que apenas essa linha foi criada com a situação Em elaboração.

    image.png

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