# 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 **145732 /** **145867 CNPJ** ou superior.

#### **Teste realizado após a atualização**

#### <span role="text">**C**</span>**ená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;  
    [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/bvo7DcqkSOD9SI1X-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/bvo7DcqkSOD9SI1X-image.png)
- 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.

<p class="callout info">**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.</p>

**Acessando funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7dCkX2605QoJzBCD-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7dCkX2605QoJzBCD-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/MYJnO4Nny4cepda6-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/MYJnO4Nny4cepda6-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](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/wOo5w7TqoOGh0ZNE-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/wOo5w7TqoOGh0ZNE-image.png)

Aguarde o download do arquivo. Abra o template utilizando o Microsoft Excel ou outro aplicativo compatível.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7OalDKRROj2wunrA-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7OalDKRROj2wunrA-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;
- Item;
- Código do produto;
- Quantidade;
- Número de repetições;
- 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.

---

#### **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.

<p class="callout info">**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.</p>

**Planilha a ser importada** Abra o template baixado no cenário anterior. Preencha as linhas com os dados de um contrato válido.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/zDyKNiCW3r8MUK0k-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/zDyKNiCW3r8MUK0k-image.png)

- 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 **número do item** correspondente ao produto vinculado ao contrato que será utilizado na medição.
- 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 funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/7dCkX2605QoJzBCD-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/7dCkX2605QoJzBCD-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/MYJnO4Nny4cepda6-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/MYJnO4Nny4cepda6-image.png)

**Tela de Medição (Importação)**.  
Na seção destinada à seleção do arquivo, clique em **Escolher arquivo,** selecione a planilha preenchida e clique no botão **Confirmar**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/KzuzzNEzlFzeBIPj-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/KzuzzNEzlFzeBIPj-image.png)

O siste direcionará para tela de dashboard, onde é possivel acompanhar o processamento e posteriormente baixar o resultado.  
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.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/kLSecxnYRIFFvN18-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/kLSecxnYRIFFvN18-image.png)

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/QSaoBSM3wyda7Eto-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/QSaoBSM3wyda7Eto-image.png)

Retorne ao menu **de Lançamento - Medição** para verificar a medição criada.  
Utilize os filtros disponíveis para localizar o contrato informado na planilha. Clique em **Pesquisar**.

Localize a medição criada e 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**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/X7mgvadf7fdJFNmx-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/X7mgvadf7fdJFNmx-image.png)

---

#### **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.

<p class="callout info">**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.</p>


No sistema, acesse **Lançamentos &gt; Medição &gt; Medição (Importação)**.  
Clique em **Escolher arquivo,** selecione a planilha preparada para o teste e clique em **Confirmar**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/tY6F9VshSTDKBkIw-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/tY6F9VshSTDKBkIw-image.png)

Aguarde até que o processamento seja concluído e baixe ou abra o relatório gerado.  
Verifique se a linha importada apresenta uma mensagem da 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.

[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/h9W0vJPZGOCfjwcj-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/h9W0vJPZGOCfjwcj-image.png)

#### <span role="text"> </span>

####  [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/scaled-1680-/0RWMPc69Kz8CuBd2-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/0RWMPc69Kz8CuBd2-image.png)

<p class="callout danger">**ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.**</p>