~~ODT~~

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

====== Cadastrar Requisição em uma Intenção de Registro de Preços ======

Esse caso de uso tem o intuito possibilitar o cadastro de requisições de materiais para um novo registro de preços a partir de uma intenção de registro de preços. A intenção antecede a etapa de licitação e concentram requisições já cadastradas e sugestões de itens que foram licitadas em outros momentos.

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

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Portal Administrativo -> Material/Serviço -> Solicitar em uma Intenção -> Cadastrar Requisição. 

===== Passo 01 =====

O sistema disponibiilza a busca por uma intenção pública já cadastrada no sistema, com os seguintes filtros:

  * **Intenção***: Tipo - NUMÉRICO. Formato: Número/Ano.
    * Opção //Buscar//;  
    * Opção //Cancelar//;

===== Passo 02 =====

Caso o sistema localize a intenção informada no passo anterior, o usuário será direcionada para a página de construção da requisição a partir da seleção dos itens que compõem a intenção de registro de preços informada.

O sistema disponibiliza busca para filtras os itens inseridos na intenção de registro de preços:
  * **Requisição** 
    * **Período da Solicitação**: Tipo - DATA.
    * **Requisição**: Tipo - NUMÉRICO.
    * **Unidade Requisitante**: Tipo - AUTOCOMPLETE.
    * **Unidade de Custo**: Tipo - AUTOCOMPLETE.
    * **Grupo de Material**: Tipo - AUTOCOMPLETE.
    * **Material**: Tipo - AUTOCOMPLETE.
  * **Processo de Compra/Licitação** 
    * **Processo de Compra/Licitação:** Tipo - NÚMERICO.
  * Opção de //Buscar//. ([[#principais_regras_de_negócio|RN16]])
  * Opção de //Cancelar//.
    
Abaixo dos filtros é exibido o resumo da requisição para novo registro de preços:
  * **Nova Requisição de Material**
    * **__Número/Ano__**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN01]])
    * **__Itens Inseridos__**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN02]])
    * **__Grupo do Material__**: Tipo - NUMÉRICO. ([[#principais_regras_de_negócio|RN03]])

Abaixo do resumo da intenção serão exibidos as requisições com itens inseridos na intenção informada pelo usuário no Passo 01:
  * **Requisições Encontradas**
  * **Opção de seleção**: Tipo - CheckBox.  
    * **__Requisição__**: Tipo - NUMÉRICO.
    * **__Grupo de Mat.__**: Tipo - TEXTO.
    * **__Status__**: Tipo - TEXTO.
    * **__Data__**: Tipo - DATA.
    * **__Usuário__**: Tipo - TEXTO.
    * **__Unidade Req.__**: Tipo - TEXTO.
    * **__Valor (R$)__**: Tipo - MOEDA.
      * Opção //Visualizar Requisição //; ([[#principais_regras_de_negócio|RN05]])
      * Opção //Expandir Itens//; ([[#principais_regras_de_negócio|RN06]])
      * Opção //Ocultar Itens//; ([[#principais_regras_de_negócio|RN07]])
        * **Opção de seleção**: Tipo - CheckBox. 
        * **__Item__**: Tipo - NUMÉRICO.
        * **__Código__**: Tipo - NUMÉRICO.
        * **__Denominação__**: Tipo - TEXTO.
        * **__Proc. Compra__**: Tipo - TEXTO.
        * **__Qtd. Sol.__**: Tipo - NUMÉRICO.
        * **__Qtd. Req.__**: Tipo - NUMÉRICO.
        * **__Valor (R$)__**: Tipo - MOEDA.
        * **__Total (R$)__**: Tipo - MOEDA.
  * Opção de //Adicionar Itens Selecionados na Requisição//. ([[#principais_regras_de_negócio|RN08]])
  * Opção de //Desmarcar Todos os Itens Selecionados//. ([[#principais_regras_de_negócio|RN9]])
  * Opção de //Cancelar//.
  * Opção de //Continuar// ([[#principais_regras_de_negócio|RN04]])
  
==== Passo 03 ====

Ao clicar em //Continuar// ou //Visualizar Requisição// o sistema direcionará o usuário para a tela de confirmação dos dados inseridos, antes da confirmação será possível remover itens ou voltar para inserir mais.

É exibido os //Dados da Requisição//:
  * **__Número/Ano__**: Tipo - NUMÉRICO.
  * **__Intenção Associada__**: Tipo - NUMÉRICO. Formato: Número/Ano.
  * **__Tipo__**: Tipo - TEXTO.
  * **__Data de cadastro__**: Tipo - DATA.
  * **__Grupo do Material__**: Tipo - TEXTO.
    * Opção de //<< Voltar//. ([[#principais_regras_de_negócio|RN13]])
    * Opção de //Cancelar//. ([[#principais_regras_de_negócio|RN13]])

Abaixo são exibidas os //Itens Inseridos na Requisição de Material//: ([[#principais_regras_de_negócio|RN12]])
    * **Opção de seleção**: Tipo - CheckBox. 
    * **__Item__**: Tipo - NUMÉRICO.
    * **__Código__**: Tipo - NUMÉRICO.
    * **__Denominação__**: Tipo - TEXTO.
    * **__Proc. Compra__**: Tipo - TEXTO.
    * **__Qtd. Sol.__**: Tipo - NUMÉRICO.
    * **__Qtd. Orig.__**: Tipo - NUMÉRICO.
    * **Qtd. Req.**: Tipo - NUMÉRICO.
    * **__Valor (R$)__**: Tipo - MOEDA.
    * **__Total (R$)__**: Tipo - MOEDA.
  * Opção de //Remover Itens Selecionados da Requisição//. ([[#principais_regras_de_negócio|RN14]])
  * Opção de //Desmarcar Todos os Itens Selecionados//. ([[#principais_regras_de_negócio|RN15]])
  * Opção de //Gravar//. ([[#principais_regras_de_negócio|RN10 e RN12]])
  * Opção de //Gravar e Enviar//. ([[#principais_regras_de_negócio|RN11 e RN12]])
  * Opção de //Voltar//.
  * Opção de //Cancelar//.

Ao final de cada item da listagem é disponibilizado um botão para o usuário cadastrar uma observação para o item. Ao selecioná-lo o sistema redirecionará para uma tela onde são apresentados os dados já cadastrados do item assim como um campo de texto para registro da observação. 
==== Passo 04 ====

Ao //Gravar// ou //Gravar e Enviar// a requisição é exibida a página de comprovante dos dados cadastrados.

É exibido os //Dados da Requisição//:
  * **__Número/Ano__**: Tipo - NUMÉRICO.
  * **__Intenção Associada__**: Tipo - NUMÉRICO. Formato: Número/Ano.
  * **__Tipo__**: Tipo - TEXTO.
  * **__Data de cadastro__**: Tipo - DATA.
  * **__Grupo do Material__**: Tipo - TEXTO.
  * **__Unidade Req.__**: Tipo - TEXTO.
  * **__Valor da Requisição__**: Tipo - MOEDA.
  * **__Status__**: Tipo - TEXTO.

Abaixo são exibidas os //Itens Inseridos na Requisição de Material//: 
  * **__Item__**: Tipo - NUMÉRICO.
  * **__Código__**: Tipo - NUMÉRICO.
  * **__Denominação__**: Tipo - TEXTO.
  * **__Proc. Compra__**: Tipo - TEXTO.
  * **__Qtd. Sol.__**: Tipo - NUMÉRICO.
  * **__Qtd. Req.__**: Tipo - NUMÉRICO.
  * **__Valor (R$)__**: Tipo - MOEDA.
  * **__Total (R$)__**: Tipo - MOEDA.
    * Opção de //Solicitar outra Requisição a partir de uma Intenção de Registro de Preços//. 

O caso de uso é finalizado.

==== Fluxo Alternativo 01 ====

Caso seja escolhida a opção **//Visualizar Requisição//**,será exibido em uma nova janela as informações:
  * **__Dados da Requisição__**
    * **__Número da Requisição__**: Tipo - NUMÉRICO.
    * **__Tipo__**: Tipo - TEXTO.
    * **__Convênio__**: Tipo - TEXTO.
    * **__Grupo de Material__**: Tipo - TEXTO.
    * **__Unidade Requisitante__**: Tipo - TEXTO.
    * **__Destino da Requisição__**: Tipo - TEXTO.
    * **__Usuário__**: Tipo - TEXTO.
    * **__Data__**: Tipo - DATA.
    * **__Valor da Requisição__**: Tipo - MOEDA.
    * **__Opção Orçamentária__**: Tipo - TEXTO.
    * **__Custeada por CONVÊNIO?__**: Tipo - LÓGICO.
    * **__Observações__**: Tipo - TEXTO.
    * **__Status Atual__**: Tipo - TEXTO.
  * **__Itens da Requisição__**
    * **__Item__**: Tipo - NUMÉRICO.
    * **__Código__**: Tipo - NUMÉRICO.
    * **__Denominação__**: Tipo - TEXTO.
    * **__Unid. Med.__**: Tipo - TEXTO.
    * **__Quant.__**: Tipo - NUMÉRICO.
    * **__Valor__**: Tipo - MOEDA.
    * **__Total__**: Tipo - MOEDA.
    * **__A__**: Quantidade atendida. Tipo - NUMÉRICO.
    * **__D__**: Quantidade devolvida. Tipo - NUMÉRICO.
    * **__C__**: Quantidade em processo de compra. Tipo - NUMÉRICO.
    * **__E__**: Quantidade empenhada. Tipo - NUMÉRICO.
    * **__L__**: Quantidade em liquidação. Tipo - NUMÉRICO.
    * **__Status__**: Tipo - TEXTO.
      * Opção **//Visualizar Detalhes//**.
  * **__Histórico da Requisição__**
    * **__Data/Hora__**: Tipo - DATA.
    * **__Status__**: Tipo - TEXTO.
    * **__Usuário__**: Tipo - TEXTO.
    * **__Observações__**: Tipo - TEXTO.
  * **__Detalhes da Aquisição dos Itens__**
    * **__Compras__**: Tipo - TEXTO.
    * **__Empenhos__**: Tipo - TEXTO.
    * **__Notas Fiscais__**: Tipo - TEXTO.
    * **__Processos de Pagamento__**: Tipo - TEXTO.

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

  * **RN01** - A numeração da requisição é gerada na confirmação do cadastro, será gerada automaticamente pelo sistema.
  * **RN02** - A quantidade de itens mudará de acordo com a realização das inserções.
  * **RN03** - O grupo de material da requisição assumirá o valor do grupo do material do primeiro item a ser inserido.
  * **RN04** - O usuário será direcionado para a tela de confirmação dos dados da intenção, onde será exibido todos os dados inseridos até o momento com a possibilidade de efetivar o cadastro.
  * **RN05** - Abrirá um popup com os dados da requisição detalhados no //Fluxo Alternativo 01//.
  * **RN06** - Exibe os itens da requisição.
  * **RN07** - Oculta os itens da requisição.
  * **RN08** - Insere os itens selecionados na intenção, a quantidade de itens adicionadas será somada ao que já foi adicionada no quadro //Intenção de Compra em Registro de Preços//.
  * **RN09** - Desmarca todos os itens selecionados pelo usuário, não implica na remoção dos itens da intenção.
  * **RN10** - Apenas grava a requisição, o status da requisição ficará como CADASTRADA, nesse momento os itens ainda não será adicionados na intenção de registro do preços, será possível fazer alterações posteriormente.
  * **RN11** - Grava e envia a requisição, o status da requisição ficará como ENVIADA, nesse momento os itens serão adicionados na intenção de registro do preços, não será possível fazer alterações posteriormente.
  * **RN12** - Exibido somente se houver itens inseridos na intenção de registro de preços.
  * **RN13** - Exibido somente se não houver itens inseridos na intenção de registro de preços.
  * **RN14** - Remove os itens inserdios na requisição.
  * **RN15** - Apenas desmarca os itens selecionados.
  * **RN16** - A busca será baseada nas requisições, processo de compra e itens que já foram adicionados na intenção de regsitro de preços.

==== Resoluções/Legislações Associadas ====
Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe                                                        ^ Tabela                                         |
| br.ufrn.sipac.cadastro.dominio.Unidade                        | administrativo.comum.unidade                   |
| br.ufrn.sipac.compras.dominio.IntencaoSRP                     | administrativo.compras.intencao_srp            |
| br.ufrn.sipac.compras.dominio.ItemIntencaoSRP                 | administrativo.compras.item_intencao_srp       |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial      | administrativo.comum.grupo_material            |
| br.ufrn.sipac.requisicoes.material.dominio.Material           | administrativo.comum.material                  |
| br.ufrn.sipac.compras.dominio.ProcessoCompra                  | administrativo.compras.processo_compra         |
| br.ufrn.sipac.compras.licitacao.dominio.ModalidadeLicitacao   | administrativo.compras.modalidade_licitacao    |
| br.ufrn.sipac.protocolo.dominio.Processo                      | administrativo.protocolo.processso             |
| br.ufrn.sipac.requisicoes.material.dominio.ItemRequisicao     | administrativo.requisicoes.item_requisicao     |
| br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material |


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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Requisições -> Material/Serviço -> Compra -> Solicitar em uma Intenção -> Cadastrar Requisição

Usuário: dilson

Papel que usuário deve ter: SipacPapeis.REQUISITOR ou SipacPapeis.REQUISITOR_MATERIAL ou não seja SipacPapeis.NAO_COMPRADOR.

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

  * Realizar testes de acordo com as RNs citadas na especificação.
  * As requisições gravadas devem ficar disponíveis no caso de uso de modificar requisição.
    * Portal Administrativo -> Requisições -> Material/Serviço -> Compra -> Solicitar em uma Intenção -> Modificar Requisição
  * As requisições enviadas devem ser adicionadas na intenção.
    * Portal Administrativo -> Requisições -> Material/Serviço -> Compra -> Solicitar em uma Intenção -> Cadastrar Requisição 
      * Informar a intenção a qual a requisição foi gravada e enviada, ela deve está associada.
===== Dados para o Teste =====

  * Cadastrar uma intenção de registro de preços e defini-la como pública.
    * Sipac → Compras/Licitação → Compras → Processo de Compra/Licitação → Demandas Pendentes → Intenção de Registro de Preços → Cadastrar