~~ODT~~

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


====== Consulta de Entradas Avulsas ======

Esse caso de uso é utilizado pelos gestores dos almoxarifados da instituição com a finalidade de permitir a listagem dos registros de todas as [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:entrada_avulsa:registrar_entrada_avulsa|entradas avulsas]] já inseridas no sistema. 

===== 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 Entradas Avulsas.

Inicialmente o sistema mostrará a relação de entradas avulsas realizadas. Mostra nesta mesma tela as seguintes opções de filtragem:

  ***Almoxarifado***: Tipo AUTOCOMPLETE ([[#principais_regras_de_negócio|RN03]])
  * **Número/Ano**: Tipo NUMÉRICO, formato: 9999/AAAA.
  * **Período**: Tipo DATA, formato: DD/MM/AAAA à DD/MM/AAAA.
  * **Todas**

São mostrados os seguintes dados das entradas avulsas:

  * **__Número__**: Tipo NUMÉRICO, formato: 9999/AAAA.
  * **__Data__**: Tipo DATA, formato: DD/MM/AAAA.
  * **__Código__**: Tipo NUMÉRICO.
  * **__Material__**. Tipo TEXTO.
  * **__Fornecedor__**: Tipo TEXTO.
  * **__Qtd.__**: Tipo NUMÉRICO.
  * **__Valor Total (R$)__**: Tipo NUMÉRICO, formato: R$ 99,99.

//Para cada entrada listada, são exibidas as opções de alterá-la ou remover.// (De acordo com a [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:consultas:consulta_de_entradas_avulsas#principais_regras_de_negócio|RN01]] e [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:consultas:consulta_de_entradas_avulsas#principais_regras_de_negócio|RN02]]).

Caso seja escolhida a opção de alterar uma entrada avulsa ([[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:consultas:consulta_de_entradas_avulsas#principais_regras_de_negócio|RN01]]), poderão ser alterados os seguintes dados:
  * **__Dados da Entrada Avulsa__**:
    * **__Data__**: Tipo DATA, formato: DD/MM/AAAA à DD/MM/AAAA.
    * **__Fornecedor__**: Tipo TEXTO (Mostrado caso exista o nome do fornecedor no sistema).
    * **__Material__**: Tipo TEXTO.
    * **Validade**: Tipo DATA, formato: DD/MM/AAAA à DD/MM/AAAA.
    * **Quantidade***: Tipo NUMÉRICO.
    * **Valor Unitário***: Tipo VALOR, formato: R$ 99,99.
    * **Observação**: Tipo TEXTO.

Caso seja escolhida a opção de remover uma entrada avulsa ([[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:consultas:consulta_de_entradas_avulsas#principais_regras_de_negócio|RN01]]), será solicitada a confirmação da operação com as seguintes informações sobre a entrada selecionada:

  * **__Dados da Entrada Avulsa__**:
    * **__Data__**: Tipo DATA, formato: DD/MM/AAAA à DD/MM/AAAA.
    * **__Fornecedor__**: Tipo TEXTO (Mostrado caso exista o nome do fornecedor no sistema).
    * **__Material__**: Tipo TEXTO.
    * **__Especificação__**: Tipo TEXTO.
    * **__Quantidade__**: Tipo NUMÉRICO.
    * **__Valor Unitário__**: Tipo VALOR, formato: R$ 99,99. Valor unitário do material.
    * **__Valor Total__**: Tipo VALOR, formato: R$ 99,99. Valor total dos materiais.

O caso de uso então é finalizado.

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

  * **RN01** - Uma entrada só pode ser alterada ou removida se a data de movimentação estiver dentro do calendário vigente.
  * **RN02** - As opções de //Alterar e Remover// Entradas Alvulsas serão mostradas se for possível realizar a entrada de material de forma avulsa no almoxarifado da unidade do usuário.
  * **RN03** - Apenas deve apresentar os dados da unidade do usuário logado, exceto se o mesmo possuir o perfil AUDITOR no qual deve apresentar uma opção para selecionar o almoxarifado ou a opção de todos almoxarifados.
===== 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): Sipac-> Almoxarifado -> Estoque -> Consultas -> Consulta de Entradas Avulsas.

Usuário: genibaldo, pedro.

Papel que usuário deve ter: SipacPapeis.GESTOR_ALMOXARIFADO ou SipacPapeis.AUDITOR_ALMOXARIFADO ou SipacPapeis.GESTOR_GERAL_ALMOXARIFADO ou SipacPapeis.AUDITOR.

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

Caso deseje cadastrar um calendário de evento do tipo ''Calendário para Alterações em Entradas/Saídas do Almoxarifado/Patrimônio'', utilize o usuário com papel de "GESTOR_CALENDARIO_CONTABIL" no caso de uso: Sipac -> Portal Administrativo -> Outros -> Calendário -> Calendário Contábil ([[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:outros:calendario:cadastrar_listar|Calendário Contábil]]).


===== Dados para o Teste =====
Verificar se o almoxarifado da unidade do usuário logado possue permissão para alterar a data da movimentação. Se possuir a data poderá ser digitada pelo usuário, caso contrário deverá aparecer apenas a data atual, sem possibilidade de alteração. Para realizar essa verificação, utilize a consulta abaixo:

  SELECT usuario.login, denominacao, almoxarifado.almoxarifado.id_unidade,
         almoxarifado.almoxarifado.id_usuario, almoxarifado.almoxarifado.data_cadastro,
         unidade_responsavel, todo_grupo, bloqueado, libera_entrada_avulsa,
         altera_data_saida_avulsa, permite_transf_estoque
         
         FROM almoxarifado.almoxarifado
              INNER JOIN comum.usuario ON comum.usuario.id_unidade = almoxarifado.almoxarifado.id_unidade
                    WHERE altera_data_saida_avulsa IS NOT NULL AND altera_data_saida_avulsa = 't';

Para registrar novas entradas, pode-se utilizar o caso de uso de [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:entrada_avulsa:registrar_entrada_avulsa|Registrar Entrada Avulsa]].