~~ODT~~
<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>
====== Relatório de Materiais a Vencer ======

Esse caso de uso é utilizado pelos gestores de almoxarifado com a finalidade de criar um relatório contendo os materiais que possuem sua data de validade dentro de um determinado período, definido pelo usuário. Este relatório é de uso constante pelos almoxarifes.


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

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Almoxarifado -> Aba de Relatórios -> Material -> Materiais a Vencer.

As seguintes opções de filtragens são exibidas:

  * **Período de Validade***: Tipo DATA, formato: DD/MM/AAAA a DD/MM/AAAA.
  * **Material**: Tipo - AUTOCOMPLETE. Formato - DENOMINAÇÃO (CÓDIGO) UNIDADE, Entrada de Dados - DENOMINAÇÃO ou CÓDIGO.
  * **Grupo do Material**: Formato - CÓDIGO OU DENOMINAÇÃO, Tipo - TEXTO. ([[#principais_regras_de_negocio|RN03]])
  * **Mostrar materiais com estoque zerado**: Formato - SIM/NÃO, Tipo - TEXTO.


Então o sistema exibe um relatório conforme o modelo abaixo, observando que as entradas que ainda possuirem material em estoque serão mostradas em negrito([[#principais_regras_de_negócio|RN02]]):

**Materiais a Vencer - NOME ALMOXARIFADO **

**Período de Validade:** 	DD/MM/AAAA a DD/MM/AAAA.

**__Material__**: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX

**__Grupo do Material__**: XXXXXXXXXXXXXXXXXXXXXXXXXXXXX ([[#principais_regras_de_negocio|RN03]])

**Mostrar materiais com estoque zerado**: XXX

^ Código ^ Denominação ^  Saldo ^  Movimentação  ^^^^^^ 
|  |  |   ^ Tipo de Entrada ^ Número  ^  Quant.Entrada ^ Vencimento ^  Quant.Estoque Calculado ^
| CÓDIGO MATERIAL | DENOMINAÇÃO |  999,9 | Nota Fiscal | 1760/U([[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:relatorios:material:materiais_a_vencer#principais_regras_de_negócio|RN01]])|  50.0 | 17/10/2010 |  0.0 |

**Quant. Entrada = ** Quantidade do material vinculada à entrada.

**Estoque = ** Quantidade atual em estoque do material 

Então o caso de uso é finalizado.

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

   * **RN01** - Quando não houver o número da entrada avulsa, é exbido "---".

   * **RN02** - Deve-se indicar para qual entrada ainda tem materiais em estoque. Esta indicação deve ser feita colocando em negrito o conteúdo das linhas (tipo entrada, número, quant. entrada, estoque, validade e preço atual).

  ***RN03** - 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]].

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.almoxarifado.entradas.dominio.NotaFiscal | sipac.liquidacao.nota_fiscal |
| br.ufrn.sipac.almoxarifado.entradas.dominio.ItemNotaFiscal | sipac.liquidacao.item_nota_fiscal |
| br.ufrn.sipac.almoxarifado.comuns.dominio.MovimentacaoEstoque | sipac.almoxarifado.movimentacao_estoque |

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

Sistema: SIPAC

Módulo: ALMOXARIFADO

Link(s): Aba de Relatórios -> Material -> Materiais a Vencer

Usuários: genibaldo (ALMOXARIFADO CENTRAL)

Papel que usuário deve ter: SipacPapeis.GESTOR_ALMOXARIFADO
===== Cenários de Teste =====
A inserção de novas [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:nota_fiscal:cadastrar|notas fiscais]], [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:entrada_avulsa:registrar_entrada_avulsa|entradas avulsas]] ou [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:receber_estornar_nota_de_fornecimento|Recebimento de Notas de Fornecimento]], deve alterar as informações mostradas neste relatório, desde que nestes cadastros sejam informados data de vencimento dentro do período indicado na emissão do relatório.

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

Informar um período qualquer bem abrangente (01/01/2000 a 01/01/2020) e de posse do resultado obtido realizar novas filtragens utilizando Grupos de Material e Materiais que foram listados neste.