~~ODT~~

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


======Relatório de materiais retirados/devolvidos======

Este caso de uso é utilizado pelos gestores de depósito para gerar um relatório que exiba informações sobre as saídas dos materiais.

Pré-condição: Deve haver um depósito cadastrado e registros de ocupação no sistema.

===== 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 -> Relatórios -> Relatório de materiais retirados/devolvidos.


===Passo 1===

Ao acessar o caso de uso, os seguintes filtros são disponibilizados para o usuário: 

  * **Depósito**: Tipo TEXTO. ([[#principais regras de negócio|RN01]])
  * **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. ([[#principais regras de negócio|RN03]])
  * **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 seguintes informações são exibidas:

  * **__Número/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA. ([[#principais regras de negócio|RN04]])
  * **__Código do volume__**: Tipo NUMÉRICO. Identificação do volume.
  * **__Tipo de volume__**: Tipo TEXTO.
  * **__Data de envio__**: Tipo DATA.
  * **__Permanência__**: Tipo DATA.
  * **__Data de saída__**: Tipo NUMÉRICO. 
  * **__Volume Total(m3)__**:  Tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.

É disponibilizado a opção de visualizar os detalhes dos volumes, sendo exibidas as seguintes informações:

  * **__Número/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA. Número e ano da solicitação de armazenamento. É permitido consultar as informações das solicitações, conforme especificado em [[desenvolvimento:especificacoes:sipac:atendimento_de_requisicoes:casos_de_uso:deposito:requisicoes:analisar_solicitacao_armazenamento_material|Analisar solicitação de armazenamento de material]].
  * **__Código do volume__**: Tipo NUMÉRICO. Identificação do volume.
  * **__Tipo de volume__**: Tipo TEXTO.
  * **__Data de envio__**: Tipo DATA.
  * **__Permanência__**: Tipo DATA.
  * **__Data de saída__**: Tipo DATA.
  * **__Altura(cm)__**: Tipo NUMÉRICO.
  * **__Largura(cm)__**: Tipo NUMÉRICO.
  * **__Profundidade(cm)__**: Tipo NUMÉRICO.
  * **__Peso(kg)__**:  Tipo NUMÉRICO.
  * **__Volume Total(m3)__**:  Tipo NUMÉRICO. Obtido pela multiplicação da altura x largura x profundidade.


O caso de uso é finalizado.

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


   * **RN01** - O sistema exibe uma lista dos depósitos ativos.
   * **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.
   * **RN03** - O período de considerar a data de saída do material, informada no registro de saída de material ou ao atender uma solicitação de retirada/devolução de material.
   * **RN04** - Número e ano da solicitação de retirada/devolução de material. Caso a saída tenha sido realizada sem essa solicitação, são exibidas o número e ano da solicitação de armazenamento do material. É permitido consultar as informações das solicitações, conforme especificado em [[desenvolvimento:especificacoes:sipac:atendimento_de_requisicoes:casos_de_uso:deposito:requisicoes:analisar_solicitacao_armazenamento_material|Analisar solicitação de armazenamento de material]].

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

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.deposito.dominio.SolicitacaoDevolucaoMaterial  | administrativo.requisicoes.solicitacao_devolucao_material  |
| br.ufrn.sipac.requisicoes.deposito.dominio.TipoArmazenamento             | administrativo.requisicoes.tipo_armazenamento_deposito     |
| br.ufrn.sipac.requisicoes.deposito.dominio.TipoVolumeDeposito            | administrativo.requisicoes.tipo_volume_deposito            |
| br.ufrn.sipac.requisicoes.deposito.dominio.DepositoMateriais             | administrativo.requisicoes.deposito_materiais              |
| br.ufrn.sipac.requisicoes.material.dominio.Material                      | comum.comum.material                              |
| br.ufrn.comum.dominio.PessoaGeral                                        | comum.comum.pessoa                                |


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

Sistema: SIPAC

Módulo: Atendimento de Requisições

Link(s): SIPAC -> Atendimento de Requisições -> Depósito -> Relatórios -> Relatório de materiais retirados/devolvidos.

Usuários: gisellesn

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

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

As operações a seguir influenciam no relatório:  

1 - Cadastrar uma Solicitação de Armazenamento de Material em SIPAC → Portal Administrativo → Outros → Depósito → Solicitar Armazenamento de Material

2 - Realizar a Análise da Solicitação de Armazenamento de Material em SIPAC → Atendimento de Requisições → Depósito → Analisar Solicitação de Armazenamento de Material

3 - Fazer o Registro de Ocupação da Solicitação de Armazenamento de Material em SIPAC → Atendimento de Requisições → Depósito → Requisições → Atendimento → Registrar Ocupação

4 - Cadastras uma Solicitação de Retirada/Devolução em SIPAC → Portal Administrativo → Outros → Depósito → Solicitar devolução de material

5 - Realizar a Análise da Solicitação de Retirada/Devolução em SIPAC → Atendimento de Requisições → Depósito → Analisar solicitação de devolução de material

6 - Fazer a Devolução em SIPAC → Atendimento de Requisições → Depósito → Registrar Saída de Material.
===== Dados para o Teste =====

* É disponibilizado a opção de visualizar os detalhes dos volumes.

* No volume é permitido consultar as informações das solicitações.

</ifauth>