~~ODT~~ 
<PHP>
echo "<div style='display:block;float:right;'>";
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>



====== Solicitar Atualização de Preço ======

Ao solicitar um cadastro de material, é informado o valor estimado desse material. Esse valor é atualizado automaticamente a medida que o material é adquirido através de um [[desenvolvimento:especificacoes:sipac:compras::negocio|Processo de Compra]] ou [[desenvolvimento:especificacoes:sipac:compras_-_registros_de_precos:negocio|Sistema de Registro de Preço]]. Contudo, o usuário, ao requisitar determinado material (veja como cadastrar uma [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:material:catalogo:cadastrar_material|requisição de material]]) pode perceber que ele está com preço desatualizado, devido ao longo tempo desde a sua última aquisição. Este caso de uso permite aos gestores do catálogo de materiais e o usuários com permissão de requisitar materiais, solicitar a atualização do preço de um material.

===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Material -> Catálogo -> Solicitar Atualização de Preço//.


==== Passo 1 ====
Ao acessar o caso de uso, o sistema permite consultar o material através de filtros, conforme descrito no [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_consulta_de_materiais|Fluxo Consulta de Materiais]].


O sistema disponibilida as operações de //Solicitar// e de //Cotações//.

==== Fluxo Alternativo 01 ====

Caso seja escolhido a opção //Cotações//.

É exibido os dados do material:

  * **__Código__:** Tipo NUMÉRICO. 
  * **__Código CATMAT__:** Tipo NUMÉRICO.
  * **__Denominação__:** Tipo TEXTO.
  * **__Grupo de Material__:** Tipo TEXTO. Formato: NOME DO GRUPO.
  * **__Und. Medida__:** Tipo TEXTO.
  * **__Especificação__:** Tipo TEXTO.
  * **__Valor Estimado__:** Tipo NUMÉRICO.
  * **__Preço de Compra__:** Tipo NUMÉRICO.

Abaixo é disponibilizado o formulário para cadastro das cotações do materia, com as seguintes informações:

  * **Fonte Externa:** Tipo TEXTO. [[#principais_regras_de_negócio|(RN01)]]
  * **Fornecedor:*** Tipo AUTOCOMPLETE. [[#principais_regras_de_negócio|(RN02)]]
  * **Marca:*** Tipo TEXTO. 
  * **Valor Cotado:*** Tipo MOEDA. 
  * **Data da Cotação:*** Tipo DATA. [[#principais_regras_de_negócio|(RN02)]]
  * **Arquivo:** Tipo UPLOAD. 

Após inserir as cotações é exibido a listagem com as informações:
  * **__Fornecedor/Fonte Externa__**: Tipo - TEXTO.
  * **__Marca__**: Tipo - TEXTO.
  * **__Valor Cotado__**: Tipo - MOEDA.
  * **__Data da Cotação__**: Tipo - DATA.
  * **__Proc. de Origem__**: Tipo - TEXTO.
  * **__Nome do Arquivo__**: Tipo - TEXTO.
    * Opção para Alterar; preenche os dados do formulários para serem alterados.
    * Opção para Remover;

No fim da tela é disponibilizado o botão de ação //**Adicionar Cotações**//. [[#principais_regras_de_negócio|(RN03)]]

==== Fluxo Alternativo 02 ====

Caso seja escolhido a opção //Solicitar//.

O sistema permite solicitar a atualização para os materiais encontrados. São exibidas os dados do material e solicitadas as seguintes informações:

  * **__Código__:** Tipo NUMÉRICO. 
  * **__Código CATMAT__:** Tipo NUMÉRICO.
  * **__Denominação__:** Tipo TEXTO.
  * **__Grupo de Material__:** Tipo TEXTO. Formato: NOME DO GRUPO.
  * **__Und. Medida__:** Tipo TEXTO.
  * **__Especificação__:** Tipo TEXTO.
  * **__Valor Estimado__:** Tipo NUMÉRICO.
  * **__Preço de Compra Antigo__:** Tipo NUMÉRICO.
  * **Preço de Compra a Atualizar:** Tipo NUMÉRICO.
  * **Observação:** Tipo TEXTO.

==== Passo 3 ====

Após a solicitação, são exibidas as informações da solicitação:

Dados do Material:
  * **__Código__:** Tipo NUMÉRICO. 
  * **__Código CATMAT__:** Tipo NUMÉRICO.
  * **__Denominação__:** Tipo TEXTO.
  * **__Grupo de Material__:** Tipo TEXTO. Formato: NOME DO GRUPO.
  * **__Unidade de Medida__:** Tipo TEXTO.
  * **__Especificação__:** Tipo TEXTO.
  * **__Valor Estimado__:** Tipo NUMÉRICO.
  * **__Preço de Compra__:** Tipo NUMÉRICO.

Dados da Solicitação:
  * **__Unidade Requisitante__:** Tipo TEXTO.
  * **__Usuário__:** Tipo TEXTO.
  * **__Preço de Compra__:** Tipo NUMÉRICO.
  * **__Preço de Compra a Atualizar__:** Tipo NUMÉRICO.
  * **__Observação__:** Tipo TEXTO.
  * **__Status da Solicitação__:** Tipo TEXTO.

Então o caso de uso é finalizado. 

===== Principais Regras de Negócio ===== 

  ***RN01** - Exibido somente no fluxo de cadastro.
  ***RN02** - Apenas de exibição no fluxo de alteração.
  ***RN03** - Deve haver pelo menos uma cotação inserida ou removida para finalizar a operação.
==== Resoluções/Legislações Associadas ====
  
Não se aplica. 

===== Classes Persistentes e Tabelas Envolvidas ===== 

^ Classe ^ Tabela ^
| <PREENCHER>  | <PREENCHER>  | 

===== Plano de Teste ===== 

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Aba de Requisições -> Material -> Catálogo -> Solicitar Atualização de Preço

Usuários: diretordmp, marcilia.

Papel que usuário deve ter: SipacPapeis.GESTOR_CADASTRO_MATERIAL ou SipacPapeis.GESTOR_CADASTRO_MATERIAL_RESTRITO ou SipacPapeis.REQUISITOR ou SipacPapeis.REQUISITOR_MATERIAL

===== Cenários de Teste ===== 

===== Dados para o Teste =====