~~ODT~~

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


====== Consulta de Notas de Fornecimento ======

Esse caso de uso é utilizado pelos gestores de almoxarifado setorial para consultar as notas de fornecimento cadastradas no sistema. A nota de fornecimento é o documento pelo qual o almoxarifado setorial recebe materiais que foram solicitados ao almoxarifado central.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Almoxarifado -> Aba Estoque -> Consultas -> Consulta de Notas de Fornecimento.

Inicialmente é requerido que o usuário informe o número da nota de fornecimento, com os seguintes campos:

  ***Número***: Tipo NUMÉRICO.
  ***Ano***: Tipo DATA, formato: AAAA.

Então são exibidos os dados da nota consultada, com as seguintes informações:

  ***__Número da Requisição__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  ***__Status__**: Tipo TEXTO.
  ***__Grupo do Material__** : Tipo TEXTO, formato: NOME GRUPO MATERIAL ([[#Principais regras de negócio|RN01]]).
  ***__Unidade Orçamentária__**: Tipo TEXTO, formato: NOME UNIDADE.
  ***__Unidade Requisitante__**: Tipo TEXTO, formato: NOME UNIDADE.
  ***__Data__**: Tipo DATA, formato: DD/MM/AAAA.
  ***__Valor Total__**: Tipo NUMÉRICO.
  ***__Valor Atendido__**:  Tipo NUMÉRICO.
  ***__Observações__**: Tipo TEXTO.

Também são exibidos uma listagem contendo os materiais referentes, com os seguintes dados:

  ***__Código__**: Tipo NUMÉRICO.
  ***__Denominação__**: Tipo TEXTO.
  ***__Atendidos__**: Tipo NUMÉRICO.
  ***__Devolvidos__**: Tipo NUMÉRICO.
  ***__Recebidos__**: Tipo NUMÉRICO.
  ***__Validade__**: Tipo DATA.
  ***__Garantia__**: Tipo DATA.

Caso a nota ainda não tenha sido recebida, o usuário pode escolher uma dentre a seguintes opções:

  * Receber Todos: Recebe todos os materiais exibidos na lista.
  * Negar Todos: Nega todos os materiais exibidos na lista.
  * Voltar.
  * Cancelar.
  
Escolhendo a opção **Receber Todos**, o usuário segue para a tela de confirmação, onde terá as seguintes opções:
    * Confirmar Recebimento: Confirmação da operação.
    * Voltar.
    * Cancelar.

Escolhendo **Negar Todos**, o usuário segue para a tela de confirmação, onde terá as seguintes opções:
    * Confirmar Negação de recebimento: Confirmação da operação.
    * Voltar.
    * Cancelar.

Caso contrário (a nota já foi recebida), o usuário tem a opção de //Imprimir Comprovante//. 

Caso o usuário deseje //Imprimir Comprovante//, é exibido um tal qual a figura:

**COMPROVANTE DE RECEBIMENTO**

**Data:** 	DD/MM/AAAA

**Número da Requisição:** 	NÚMERO/ANO

**Status:** STATUS

**Grupo do Material ([[#Principais regras de negócio|RN01]]):** 	NOME GRUPO

**Unidade Orçamentária:** 	NOME UNIDADE

**Unidade Requisitante:** 	NOME UNIDADE

**Data: 	** DD/MM/AAAA

**Valor Total:** 	R$ 99,99

**Valor Atendido:** 	R$ 99,99

**Observações: 	** OBSERVAÇÕES

^ Código ^ Denominação ^ Requisitados ^ Atendidos ^ Recebidos ^ Validade ^ Garantia ^
| CÓDIGO MATERIAL | DENOMINAÇÃO MATERIAL | 99 | 99 | 99 | DD/MM/AAAA | DD/MM/AAAA |

**RESUMO CONTÁBIL**
^ Grupo de Material ^ Denominação ^  Quantidade ^  Total ^
| CÓDIGO GRUPO | DENOMINAÇÃO GRUPO MATERIAL| 999 | 999,99 |


O caso de uso então é finalizado.

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

  ***RN01** - 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.comuns.dominio.MovimentacaoEstoque | administrativo.almoxarifado.movimentacao_estoque |

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

Sistema: SIPAC

Módulo: Almoxarifado

Link(s): Estoque -> Consultas -> Consulta de Notas de Fornecimento

Usuário: pedrofernandes, kmbso

Papel que usuário deve ter: SipacPapeis.GESTOR_ALMOXARIFADO

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

Verificar se o esperado para a busca de acordo com os dados informados (Número e Ano) estão aparecendo corretamente.

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

  * Para obter uma nota de fornecimento, utilizar o código SQL abaixo:
<code sql>
select numero, ano from requisicoes.requisicao_material;
</code>