~~ODT~~

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


======Analisar solicitação de devolução de material ======

Este caso de uso é utilizado pelos gestores de depósito para analisar as solicitações de devolução de materiais que estão armazenados no depósito. 

Pré-condição: Deve haver uma solicitação de retirada/devolução cadastrada e pendente de autorização.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Atendimento de Requisições -> Depósito -> Analisar solicitação de devolução de material


===Passo 1===

Ao acessar o caso de uso, as solicitações são exibidas, com a possibilidade de filtrá-las através dos seguintes campos: ([[#principais regras de negócio|RN01]]).

  * **__Numero/Ano__**: Tipo NUMÉRICO.
  * **Depósito**: Tipo TEXTO. 
  * **Tipo de Armazenamento**: Tipo TEXTO.
  * **Tipo de Volume**: Tipo TEXTO.
  * **Material**: Tipo AUTOCOMPLETE.  ([[#principais regras de negócio|RN02]]).
  * **Período**: Tipo DATA. formato: DD/MM/AAAA a DD/MM/AAAA. Período de cadastro da solicitação de armazenamento de material.
  * **Unidade**: Tipo AUTOCOMPLETE. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE. Entrada de dados: CÓDIGO OU NOME DA UNIDADE. Filtra as solicitações considerando a unidade que requisitou o armazenamento de material.

As solicitações são exibidas com as seguintes informações:

  * **__Numero/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA. Número e ano da solicitação de devolução de material.
  * **__Data para Retirada__**: Tipo DATA. Data em que o material deverá ser retirado ou devolvido.
  * **__Status__**: Tipo TEXTO. Status da solicitação de devolução.
  * **__Unidade Requisitante__**: Tipo TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE.
  * **__Depósito__**: Tipo TEXTO. Depósito selecionado para o armazenamento do material.
  * **__Quant. Volumes__**: Tipo NUMÉRICO. Total de volumes inseridos na solicitação de devolução.
  * **__Peso(kg)__**: Tipo NUMÉRICO. Peso total da solicitação baseado na soma dos pesos dos volumes cadastrados.
  * **__Volume(m3)__**: Tipo NUMÉRICO. Volume total da solicitação baseada no cálculo das alturas x larguras x profundidade dos volumes inseridos na solicitação de devolução.

Para cada solicitação o sistema disponibiliza a opção de analisar a solicitação.

===Passo 2===

Ao selecionar a solicitação para analise, são exibidos os dados gerais da solicitação:

  * **__Numero/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA
  * **__Unidade Requisitante__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Usuário__**: Tipo TEXTO. Formato: LOGIN - NOME DO USUÁRIO. Usuário que cadastrou a solicitação de devolução de material.
  * **__Data de Cadastro__**: tipo DATA. Data que a solicitação foi cadastrada.
  * **__Depósito__**: Tipo TEXTO. Depósito selecionado para o armazenamento do material.
  * **__Quant. Volumes__**: Tipo NUMÉRICO. Total de volumes inseridos na solicitação de devolução.
  * **__Peso(kg)__**: Tipo NUMÉRICO. Peso total da solicitação baseado na soma dos pesos dos volumes cadastrados.
  * **__Volume(m3)__**: Tipo NUMÉRICO. Volume total da solicitação baseada no cálculo das alturas x larguras x profundidade dos volumes inseridos na solicitação de devolução.


E os dados dos volumes inseridos na solicitação são exibidos em uma listagem:

  * **__Codigo do volume__**: Tipo NUMÉRICO. Identificação do volume.
  * **__Tipo de volume__**: Tipo TEXTO.
  * **__Data prevista de envio__**: tipo DATA.
  * **__Altura(cm)__**: Tipo NUMÉRICO.
  * **__Largura(cm)__**: Tipo NUMÉRICO.
  * **__Profundidade__**: Tipo NUMÉRICO.
  * **__Peso(kg)__**:  Tipo NUMÉRICO.
  * **__Volume Total(m3)__**:  Tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.

Para cada solicitação o sistema disponibiliza a opção de registrar a saída, retornar ou negar a solicitação.

===Registrar Saída===

Após a confirmação o espaço é liberado para novas ocupações.


===Retornar===

Ao escolher essa opção, o sistema solicita uma justificativa:

  * **Justificativa***: Tipo TEXTO. Justificativa para o retorno da solicitação. A justificativa será exibida para o solicitante ao acessar o caso de uso [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:outros:deposito:minhas_solicitacoes|Minhas solicitações]].

===Negar===

Ao escolher essa opção, o sistema solicita uma justificativa:

  * **Justificativa***: Tipo TEXTO. Justificativa para a negação da solicitação. A justificativa será exibida para o solicitante ao acessar o caso de uso [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:outros:deposito:minhas_solicitacoes|Minhas solicitações]].

O caso de uso é finalizado.

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

   * **RN01** - São listadas as solicitações com status ''PENDENTE DE AUTORIZAÇÃO DE RETIRADA/DEVOLUÇÃO''.
   * **RN02** - São listados apenas os materiais cadastrados no módulo catálogo de materiais da natureza de despesa de material de consumo e material permanente.

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

<ifauth @admin>

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

^ Classe                                                                             ^ Tabela                                                 ^
| br.ufrn.sipac.requisicoes.deposito.dominio.DepositoMateriais                       | REQUISICOES.DEPOSITO_MATERIAIS                         |
| br.ufrn.sipac.requisicoes.deposito.dominio.SolicitacaoArmazenamentoMaterial        | REQUISICOES.SOLICITACAO_ARMAZENAMENTO_MATERIAL         |
| br.ufrn.sipac.requisicoes.deposito.dominio.SolicitacaoDevolucaoMaterial            | REQUISICOES.SOLICITACAO_DEVOLUCAO_MATERIAL             |
| br.ufrn.sipac.requisicoes.deposito.dominio.StatusSolicitacaoArmazenamentoMaterial  | REQUISICOES.STATUS_SOLICITACAO_ARMAZENAMENTO_MATERIAL  |
| br.ufrn.sipac.requisicoes.deposito.dominio.VolumeDeposito                          | REQUISICOES.VOLUME_DEPOSITO                            |
| br.ufrn.sipac.requisicoes.deposito.dominio.MovimentoSolicitacaoDevolucaoMaterial   | REQUISICOES.MOVIMENTO_SOLICITACAO_DEVOLUCAO_MATERIAL   |
| br.ufrn.sipac.requisicoes.deposito.dominio.VolumeMaterial                          | REQUISICOES.VOLUME_MATERIAL                            |
| br.ufrn.sipac.requisicoes.deposito.dominio.RegistroOcupacao                        | REQUISICOES.REGISTRO_OCUPACAO                          |
| br.ufrn.sipac.requisicoes.deposito.dominio.RegistroOcupacaoVolume                  | REQUISICOES.REGISTRO_OCUPACAO_VOLUMES                  |

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

Sistema: SIPAC

Módulo: Atendimento de Requisições

Link(s): Depósito ->  Analisar solicitação de devolução de material

Usuários: 

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_DEPOSITO

===== Cenários de Teste =====
Não se aplica.


===== Dados para o Teste =====
Não se aplica.

</ifauth>