~~ODT~~

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


====== Relatório de Entradas ======

Este caso de uso é utilizado pelos gestores de almoxarifado com a finalidade de criar um relatório contemplando todas as entradas de bens num determinado período de tempo.


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

Esse caso de uso é iniciado quando o usuário acessa a opção: SIPAC -> Almoxarifado -> Relatórios -> Movimentação -> Relatório de Entradas. 


O sistema solicita que o Gestor de Almoxarifado informe o período inicial e final para gerar o relatório:
  ***Almoxarifado***: Tipo TEXTO. ([[#principais_regras_de_negocio|RN03]])
  ***Período:*** Tipo - DATA, Formato - DD/MM/AAAA a DD/MM/AAAA.

O sistema deve permitir gerar o relatório para um ou mais materiais/grupos. Para isso, solicita as seguintes informações: ([[#principais_regras_de_negocio|RN05]])

  ***Grupo de Material:** Tipo Autocomplete. Formato: CÓDIGO - NOME DO GRUPO. Entrada de dados: CÓDIGO OU NOME DO GRUPO DE MATERIAL. ([[#principais_regras_de_negocio|RN06]])
  ***Material:** Tipo AUTOCOMPLETE. Formato: CÓDIGO - NOME DO MATERIAL. Entrada de dados: CÓDIGO OU NOME DO MATERIAL ([[#principais_regras_de_negocio|RN06]])

Caso tenha sido informado o grupo de material, uma lista com os grupos inseridos é exibida com as seguintes informações:

  * **__Grupo de Material__**: Tipo TEXTO. Formato: CÓDIGO - NOME DO GRUPO DO MATERIAL

Caso tenha sido informado material(is), uma lista com o(s) material(is) inseridos é exibida com as seguintes informações:

  * **__Material__**: Tipo TEXTO. Formato: CÓDIGO - NOME DO MATERIAL


Então é exibido um relatório conforme o modelo abaixo:

**Relatório de Entradas por Período** ([[#principais_regras_de_negocio|RN04]])

**__Período__:**	DD/MM/AAAA a DD/MM/AAAA

**__Almoxarifado__:** 	NOME ALMOXARIFADO

^ Tipo de Entrada ^ Fornecedor ^ Data ^ Documento ^ Código ^ Denominação ^ Quant. ^ Preço ^ Total ^ 
|CÓDIGO MATERIAL - NOME GRUPO MATERIAL ([[#principais_regras_de_negocio|RN02]]) |||||||
|TEXTO|NOME DO FORNECEDOR| DD/MM/AAAA | 9.../AAAA ([[#Principais Regras de Negócio|RN01]]) | CÓDIGO MATERIAL | DENOMINAÇÃO | 99 | R$ 99,99 | R$ 99,99 |  
|TEXTO|NOME DO FORNECEDOR| DD/MM/AAAA | 9.../AAAA ([[#Principais Regras de Negócio|RN01]])| CÓDIGO MATERIAL | DENOMINAÇÃO | 99 | R$ 99,99 | R$ 99,99 | 
| **Total do Grupo**: R$ 99,99 |||||||
| CÓDIGO MATERIAL - NOME GRUPO MATERIAL ([[#principais_regras_de_negocio|RN02]]) |||||||
|TEXTO|NOME DO FORNECEDOR| DD/MM/AAAA | 9.../AAAA ([[#Principais Regras de Negócio|RN01]])| CÓDIGO MATERIAL | DENOMINAÇÃO | 99 | R$ 99,99 | R$ 99,99 |  
|TEXTO|NOME DO FORNECEDOR| DD/MM/AAAA | 9.../AAAA ([[#Principais Regras de Negócio|RN01]])| CÓDIGO MATERIAL | DENOMINAÇÃO | 99 | R$ 99,99 | R$ 99,99 | 
| **Total do Grupo**: R$ 99,99 |||||||
|  **Total Geral**: R$ 99,99|||||||

O campo documento representa o Número da Entrada do material, que pode ser uma Nota Fiscal, Entrada Avulsa de Material, Número e ano da requisição em caso de Nota de Fornecimento.


O caso de uso é finalizado.

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

  * **RN01** - Esse campo é um link, para mais detalhes visualize a especificação: [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:nota_fiscal:listar_alterar|Listar/Alterar Nota Fiscal]].
  * **RN02** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]].
  * **RN03** - Caso o usuário não possua os papéis de: SipacPapeis.GESTOR_INSTITUICAO, SipacPapeis.AUDITOR, SipacPapeis.GESTOR_DIRECAO, o campo **Almoxarifado** não será exibido.
  * **RN04** - Esse relatório deve incluir as entradas por notas fiscais orçamentárias, notas fiscais extraorçamentária, nota de fornecimento, devolução e entrada avulsa. [Adicionado em 10/03/2014, referente a tarefa 150392]
  * **RN05** - É permitido inserir mais de um grupo ou material. Contudo, somente podem ser informados um ou outro, ou seja, o relatório é gerado por materiais ou por grupos.


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

Não se aplica.


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


^ Classe                                                         ^ Tabela                             ^
| br.ufrn.sipac.requisicoes.material.dominio.Material            | comum.MATERIAL                     |
| br.ufrn.sipac.almoxarifado.entradas.dominio.ItemNotaFiscal     | liquidacao.ITEM_NOTA_FISCAL        |
| br.ufrn.sipac.almoxarifado.entradas.dominio.NotaFiscal         | liquidacao.NOTA_FISCAL             |
| br.ufrn.sipac.almoxarifado.comuns.dominio.MovimentacaoEstoque  | almoxarifado.MOVIMENTACAO_ESTOQUE  |


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

Sistema: SIPAC

Módulo: Almoxarifado

Link(s): Relatórios -> Movimentação -> Relatório de Entradas

Usuário: fabianoiasd2 (almoxarifado/CB)

Papel que usuário deve ter: SipacPapeis.GESTOR_DO_ALMOXARIFADO

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

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