# OS 103486 - MELHORIA - CONTRATOS – CONTROLE E ARMAZENAMENTO DE DOCUMENTOS NAS MEDIÇÕES

#### **Objetivo:**

A solicitação tem como objetivo permitir o **controle, armazenamento e consulta dos documentos relacionados ao processo de medição de contratos diretamente no ERP**, mantendo os arquivos vinculados à respectiva medição.

Com a implementação, o usuário poderá incluir documentos manualmente enquanto a medição estiver **em elaboração**, classificar cada arquivo por tipo de documento, informar uma descrição e posteriormente consultar ou realizar o download dos documentos armazenados.

Além disso, o arquivo utilizado no processo de **Aprovação do Retorno da Medição** passa a ser automaticamente armazenado junto à medição, permitindo manter o histórico documental do processo centralizado e disponível para consulta.

#### **Premissas:**

- Necessário o ambiente estar atualizado com as versões: 
    - Contratos de número **147823 / 147713 CNPJ** ou superior;
    - Script de número **147565 SQL / 147564 SQLPostgre** ou superior.

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

#### <span role="text">**Cenário 01: I**</span><span role="text">**ncluir e consultar documentos na medição.**</span>

**Objetivo:** validar a inclusão, armazenamento e consulta dos documentos vinculados diretamente à medição do contrato.

**Pré-condição:**

- Deve existir um contrato com uma medição cadastrada na situação **"Em Elaboração"**.
- O usuário deve possuir acesso à manutenção das medições e deve haver um arquivo disponível para utilização no teste.

<p class="callout info">**Resultado Esperado:** O sistema deve permitir a inclusão do documento enquanto a medição estiver **Em Elaboração**, armazenando o arquivo vinculado à respectiva medição. Após a inclusão, o documento deve ser apresentado na aba **Documentos Anexos**, mantendo suas informações de identificação.  
O arquivo deve permanecer disponível mesmo após sair e acessar novamente a medição, permitindo também seu download para consulta.</p>

**Acessando a funcionalidade.** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/qkpiV7yRQWqoJqtJ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/qkpiV7yRQWqoJqtJ-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/NNuwOayLEyhEscAk-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/NNuwOayLEyhEscAk-image.png)

**Medição do contrato.** Na tela principal, utilize os filtros disponíveis para localizar a medição desejada.  
Clique em editar, na manutenção da medição, confirme que sua situação está como "**Em Elaboração"**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/MmJN8A55U5M3CuFB-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/MmJN8A55U5M3CuFB-image.png)

Acesse a aba **Documentos Anexos**. Clique em **Inserir**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/jJzLcPRy0Hm7wwjB-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/jJzLcPRy0Hm7wwjB-image.png)

Na tela apresentada, clique em **"Selecionar tipo do arquivo"** e, depois, em **"Adicionar arquivos".**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Wq2MmG3RhGSiu4LA-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Wq2MmG3RhGSiu4LA-image.png)

Localize em seu computador o documento que deseja vincular à medição e selecione-o.  
Informe uma **descrição** que facilite a identificação do documento.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/ffLhJteIIR3dbcvk-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/ffLhJteIIR3dbcvk-image.png)

Repita isso para todos os arquivos que deseja anexar.  
Confira se o arquivo foi apresentado na relação de documentos que serão vinculados.  
Clique em **Confirmar** para concluir a operação.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/ShoUealvY7lBqeLP-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/ShoUealvY7lBqeLP-image.png)

Confirme a gravação dos anexos.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/E0SuNHp4uoq9v4vC-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/E0SuNHp4uoq9v4vC-image.png)

Na aba **Documentos Anexos**, confirme que o documento incluído passou a ser apresentado na relação.  
Após confirmação, é possível realizar **download** (1) e **excluir** (2) quando necessário.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/RzLCJhL8EjzWLu5Y-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/RzLCJhL8EjzWLu5Y-image.png)

---

#### <span role="text">**Cenário 02: Validar armazenamento do documento da aprovação do retorno da medição.**</span>

**Objetivo:** validar que o arquivo informado durante a **Aprovação do Retorno da Medição** seja armazenado automaticamente e permaneça vinculado à respectiva medição.

**Pré-condição:**

- Deve existir uma medição apta a seguir pelo fluxo de aprovação, e o usuário deve possuir acesso às rotinas necessárias para envio e aprovação do retorno.
- Também deve haver um arquivo disponível para ser informado durante a aprovação.

<p class="callout info">**Resultado Esperado:** Ao concluir a **Aprovação do Retorno da Medição** com um arquivo informado, o sistema deve finalizar a aprovação normalmente e **armazenar automaticamente esse arquivo na própria medição**. Ao acessar a aba **Documentos Anexos**, o arquivo utilizado na aprovação deve estar disponível para consulta e download, identificado com o tipo **Aprovação Retorno Medição**.  
  
O documento armazenado deve corresponder ao mesmo arquivo selecionado durante a aprovação, **sem necessidade de o usuário realizar uma nova inclusão manual**.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/qkpiV7yRQWqoJqtJ-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/qkpiV7yRQWqoJqtJ-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/NNuwOayLEyhEscAk-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/NNuwOayLEyhEscAk-image.png)

**Medição do contrato.** Na tela principal, localize a medição que está com o status **"Envio para aprovação"** e clique em **Retorno de medição.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/Z3QuisoqHgpwdbl7-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/Z3QuisoqHgpwdbl7-image.png)

Confirme a operação no pop-up. Aguarde o processamento e verifique que a medição avançou para a etapa.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/GyXEmzyssFFYxMfj-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/GyXEmzyssFFYxMfj-image.png)

Na área destinada ao arquivo da aprovação do retorno, clique em **Adicionar Arquivo** (1) e depois em **Confirmar** (2) para a aprovação do retorno.**.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/jZgrbmAEvIl9gayR-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/jZgrbmAEvIl9gayR-image.png)

Retorne à rotina **Gestão de Contratos &gt; Lançamentos &gt; Medição**.  
Localize e consulte a medição utilizada no teste.  
A medição deve estar com o status **Aprovado** (1). Para verificar o anexo, clique em consultar (2).[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/NaYDHmYTxC7nsfny-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/NaYDHmYTxC7nsfny-image.png)

Acesse a aba **Documentos Anexos** (1) e localize o arquivo informado durante a aprovação (2).  
Confirme que o documento está identificado com o tipo **Aprovação Retorno Medição**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/G8rwoydCK0zfvOR8-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/G8rwoydCK0zfvOR8-image.png)

<p class="callout warning">**Atenção:** O arquivo informado na **Aprovação do Retorno da Medição** é armazenado automaticamente pelo sistema. Portanto, não é necessário realizar uma nova inclusão manual desse mesmo documento na medição.  
O tipo **Aprovação Retorno Medição** não é exclusivo da inclusão automática. Esse tipo também pode ser selecionado em uma inclusão manual enquanto a medição estiver **Em Elaboração**.</p>

#### <span role="text"> </span>[![Ficou com alguma dúvida .png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/scaled-1680-/3LKSgbAcJ0XTTlsS-ficou-com-alguma-duvida.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-08/3LKSgbAcJ0XTTlsS-ficou-com-alguma-duvida.png)

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