~~ODT~~

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


====== Demandas para Compra ======

Este caso de uso tem como finalidade exibir as requisições que foram enviadas para o setor de compras para serem incluídas em um processo licitatório que não configurará um [[desenvolvimento:especificacoes:sipac:compras_-_registros_de_precos:negocio|SRP]]. O caso de uso é utilizado pelos usuários responsáveis pelas aquisições das unidades e centros.

===== Descrição do Caso de Uso =====
O caso de uso se inicia quando a opção //Sipac -> Compras -> Compras -> Processo de Compra/Licitação -> Demandas Pendentes -> Demandas para Compra sem Registro de Preços// é acessada.

A busca poderá ser filtrada por:
  * **Período da Solicitação***: Formato - DD/MM/AAAA à DD/MM/AAAA; Tipo - DATA. [[#principais_regras_de_negócio|RN07]]
  * **Unidade Requisitante**: Formato - NOME-CÓDIGO; Tipo - AUTOCOMPLETE.
  * **Unidade de Custo**: Formato - NOME-CÓDIGO; Tipo - AUTOCOMPLETE.
  * **Grupo de Material**: Formato - CÓDIGO-DENOMINAÇÃO; Tipo - AUTOCOMPLETE.
  * **Material**: Formato - DENOMINAÇÃO-CÓDIGO-UNIDADE DE MEDIDA; Tipo - AUTOCOMPLETE.
 

As requisições listadas serão agrupadas por grupo de material de cada requisição [[#principais_regras_de_negócio|RN01, RN02]]. Na listagem serão exibidos:
  * **__Número__**: Formato - 999/AAAA; Tipo - NUMÉRICO.
  * **__Data__**: Formato - DD/MM/AAA; Tipo - DATA.
  * **__Usuário__**: Formato - NOME; Tipo - TEXTO.
  * **__Unidade Requisitante__**: Formato - NOME; Tipo - TEXTO.
  * **__Valor__**: Formato - R$999,99; Tipo - NUMÉRICO.
    * Opção **//Visualizar Requisição//**;
    * Opção **//Analisar Requisição//**;
    * Opção **//Retornar Requisição//**;
    * Opção **//Estornar Requisição//**;

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.
    * **__Unidade de Custo__**: 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.

==== Fluxo Alternativo 02 ====

Caso seja escolhida a opção **//Analisar Requisição//**,será exibido os seguintes dados:
  * **__Dados da Requisição__**
    * **__Número da Requisição__**: Tipo - NUMÉRICO.
    * **__Tipo__**: Tipo - TEXTO.
    * **__Convênio__**: Tipo - LÓGICO.
    * **__Grupo de Material__**: Tipo - TEXTO e NUMÉRICO.
    * **__Unidade Requisitante__**: Tipo - TEXTO e NUMÉRICO.
    * **__Destino da Requisição__**: Tipo - TEXTO.
    * **__Usuário__**: Tipo - TEXTO.
    * **__Data__**: Formato : 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__**: Formato - 999, 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.
    * **__Processo__**: Tipo - TEXTO.
    * **__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.
    * **__Especificação__**: Tipo - TEXTO.[[#principais_regras_de_negócio|RN06]]
      * Opção **//Exibir Especificação//**.[[#principais_regras_de_negócio|RN04]]
      * Opção **//Ocutar Especificação//**.[[#principais_regras_de_negócio|RN05]]
      * Opção **//Visualizar Detalhes//**.
      * Opção **//Alterar Dados do Material//**.
        
Cada um desses itens poderão ser selecionados para terem seus status alterados de acordo com as opções disponíveis: **//Marcar como Analisado(s)//**, **//Marcar como Cancelado(s)//**([[#principais_regras_de_negócio|RN08]]) ou **//Marcar como Cadastrado(s)//** [[#principais_regras_de_negócio|RN03]].

=== Fluxo Alternativo 02.1 ===

Caso seja escolhida a opção **//Visualizar Detalhes//**,será exibido os seguintes dados:
  * **__Dados do Material__**
    * **__Código__**: Tipo - NUMÉRICO.
    * **__Código CATMAT__**: Tipo - NUMÉRICO.
    * **__Denominação__**: Tipo - TEXTO.
    * **__Grupo de Material__**: Tipo - TEXTO.
    * **__Unidade de Medida__**: Tipo - TEXTO.
    * **__Especificação__**: Tipo - TEXTO.
    * **__Valor Estimado__**: Tipo - MOEDA.
    * **__Preço de Compra__**: Tipo - MOEDA.
  * **__Histórico de Modificações__**
    ***__Data__**: Tipo - DATA.
    ***__Usuário__**: Tipo - TEXTO.
    ***__Unidade__**: Tipo - TEXTO.
  * **__Situação do material__**
    * **__Registros de Preço Vigentes para o Material__**
    * **__Licitações em Andamento para o Material__**
  
=== Fluxo Alternativo 02.2 ===

Caso seja escolhida a opção **//Alterar Dados do Material//**,será seguido o fluxo descrito na especificação: [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:cadastro:cadastro:material_servico:autorizacao_tecnica_do_material:listar|Listar/Alterar Material]]

==== Fluxo Alternativo 03 ====

Caso seja escolhida a opção **//Retornar Requisição//**,será exibido em uma nova janela as informações:
  * **__Informações Gerais da Requisição__**
    * **__Requisição__**: Tipo - NUMÉRICO.
    * **__Tipo da Requisição__**: Tipo - TEXTO.
    * **__Unidade Solicitante__**: Tipo - TEXTO.
    * **__Unidade de Custo__**: Tipo - TEXTO.
    * **__Status__**: Tipo - TEXTO.
    * **__Valor__**: Tipo - MOEDA.
    * **__Data de Cadastro__**: Tipo - DATA.
    * **Justificativa do Retorno**: Tipo - TEXTO.

==== Fluxo Alternativo 04 ====

Caso seja escolhida a opção **//Estornar Requisição//**,será exibido em uma nova janela as informações:
  * **__Informações Gerais da Requisição__**
    * **__Requisição__**: Tipo - NUMÉRICO.
    * **__Tipo da Requisição__**: Tipo - TEXTO.
    * **__Unidade Solicitante__**: Tipo - TEXTO.
    * **__Unidade de Custo__**: Tipo - TEXTO.
    * **__Status__**: Tipo - TEXTO.
    * **__Valor__**: Tipo - MOEDA.
    * **__Data de Cadastro__**: Tipo - DATA.
    * **Justificativa do Estorno**: Tipo - TEXTO.

===== Principais Regras de Negócio =====
  * **RN01** - Só serão exibidas as requisições que possuírem o status de ''ENVIADA'', ''ATENDIDA'', ''FINALIZADA'', ''FINALIZADO ATENDIMENTO'', ''A EMPENHAR'' ou ''ENVIADA PARA LICITAÇÃO'', e que sejam do tipo material.
  * **RN02** - Logo que o caso de uso é iniciado serão listadas as requisições que estejam em conformidade com a RN01 e cuja data de solicitação esteja no período entre o primeiro dia do ano corrente e a data atual.
  * **RN03** - Na opção de //Analisar Requisição// não é permitido selecionar itens que já foram inseridos em processos de compra.
  * **RN04** - Exibe a informação da especificação. Somente exibido quando o botão **//Ocutar Especificação//** é acionado.
  * **RN05** - Oculta a informação da especificação. Somente exibido quando o botão **//Exibir Especificação//** é acionado.
  * **RN06** - Somente exibido quando o botão **//Exibir Especificação//** é acionado.
  * **RN07** - Checkbox já vem marcado pois é o único campo obrigatório da consulta.
  * **RN08** - Não é permitido cancelar itens que estão associados a um processo de compra. Para cancelar é necessário remover o item do processo e então alterar seu status neste caso de uso.
  * <del>**RN09** - Não serão exibidas as requisições cujo os itens estejam cancelados ou analisados.</del>


==== Resoluções/Legislações Associadas ====

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material |
| br.ufrn.sipac.requisicoes.material.dominio.ItemRequisicao | administrativo.requisicoes.item_requisicao |
| br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.comum.unidade |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | administrativo.comum.grupo_material |
| br.ufrn.sipac.requisicoes.material.dominio.Material | administrativo.comum.material |

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

Sistema: SIPAC

Módulo: Compras

Link(s): Aba Compras -> Processo de Compra/Licitação -> Demandas Pendentes -> Demandas para Compra sem Registro de Preços

Usuário: nnaa

Papel que usuário deve ter: SipacPapeis.GESTOR_COMPRA_SRP


===== Cenários de Teste =====
Verificar se na seção de analise da requisição os status são alterados de acordo com o que foi definido pelos botões de ação disponíveis.

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

  * Para consultar o status e o tipo da requisição, acessar o link: **//Sipac -> Portal Administrativo -> Requisições -> Material -> Compras -> Acompanhar Requisições Enviadas//**

  * As requisições que são geradas de um processo de compra de dispensa de licitação terão associadas a elas um Processo de Compra com modalidade Dispensa de Licitação. Esse processo pode ser visualizado ao selecionar ícone [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_material|Visualizar Requisição]].

  * Após atualizar o status dos itens de uma requisição para CANCELADA COMPRA através do ícone //Analisar Requisição//:
    * Acessar o caso de uso de [[desenvolvimento:especificacoes:sipac:compras:casos_de_uso:compras:processo_de_compra_licitacao:cadastrar_processo_de_compra_licitacao| Cadastrar Processo de Compra]];
    * Escolher como tipo de processo MATERIAL e marcar SIM para o Sistema de Registro de Preço;
    * Na tela de busca de requisições, buscar pela requisição que teve a compra do item cancelada e visualizar se o mesmo se encontra desabilitado.