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

====== Registrar Saídas Avulsas ======

O registro de saídas avulsas consiste na baixa de um determinado item do estoque sem a necessidade de haver uma requisição associada, por exemplo, na doação de materiais ou para materiais que são inservíveis para a instituição. Existem vários [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:cadastros:tipo_de_saida_avulsa:cadastrar|tipos de saídas avulsas]].

O caso de uso é utilizado pelos almoxarifes dos diversos almoxarifados da instituição.

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

Este caso de uso é iniciado ao acessar o link no caminho: Sipac -> Almoxarifado -> Estoque -> Estoque -> Saída Avulsa(Perda, Consumo Imediato, etc.) -> Registrar Saída Avulsa

===Passo 1===

Inicialmente o sistema solicita:
  * **Material***: Tipo AUTOCOMPLETE. Formato: DENOMINAÇÃO DO MATERIAL (9999999999999) UNIDADE DE MEDIDA, Entrada de dados: DENOMINAÇÃO DO MATERIAL ou CÓDIGO DO MATERIAL.

Inicialmente o sistema solicita o material a ter a saída registrada. Para cada item inserido o sistema exibe uma lista com:

  * __**Código**__ : Tipo NUMÉRICO.
  * __**Material***__: Tipo TEXTO. 
  * __**Medida**__: Tipo TEXTO
  * __**Saldo Estoque**__: Tipo NUMÉRICO.
  * __**Valor Total Estoque**__: Tipo NUMÉRICO.
  * **Qtde.**: Tipo NUMÉRICO. 

É permitido remover os itens inseridos.

===Passo 2===

Neste passo o sistema exibe os mesmos dados exibidos na listagem anterior e em adição:
  * **__Data da Saída__**: Tipo - DATA  ([[#principais_regras_de_negócio|RN01]])
  * **Tipo da saída***: Tipo - TEXTO . Opções definidas no caso de uso [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:cadastros:tipo_de_saida_avulsa:cadastrar|Tipos de Saídas Avulsas]].
  * **Unidade Requisitante***: Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). É permitido escolher a unidade informando o código da unidade.
      * //Observa-se também a opção de **buscar unidade**, que ao ser selecionada exibe uma busca por unidade através do nome.// ([[#principais_regras_de_negócio|RN02]])
  * **Entidade Beneficiada***: Tipo AUTOCOMPLETE, formato: NOME DA UNIDADE - 99.999.999/9999-99, entrada de dados: NOME DA UNIDADE. ([[#principais_regras_de_negócio|RN03]])
  * **Processo**: Tipo NUMÉRICO, formato: RADICAL.NÚMERO/ANO-DV. ([[#principais_regras_de_negócio|RN04]])
  * **Justificativa **: Tipo TEXTO.
  
  Além desses campos é exibida uma opção de anexar arquivos ao registro de saída do material.
  
===Passo 3===

O sistema exibe uma tela de confirmação com a listagem de saídas registradas e os seguintes dados:
  * __**Número**__: Tipo NUMÉRICO, formato: 9.../AAAA.
  * __**Data**__: Tipo DATA.
  * __**Processo**__: Tipo NUMÉRICO, formato: 99999.999999/AAAA-99. ([[#principais_regras_de_negócio|RN04]])
  * __**Código**__: Tipo NUMÉRICO.
  * __**Material**__: Tipo TEXTO
  * __**Unidade de medida**__: Tipo TEXTO
  * __**Quantidade**__: Tipo NUMÉRICO.
  * __**Total**__: Tipo NUMÉRICO.

O sistema exibe uma opção para //Cadastrar uma nova saída avulsa//, //[[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:saida_avulsa:imprimir_comprovante|Imprimir comprovante]]// e outra de //Menu do Almoxarifado//.

O caso de uso é finalizado.
===== Principais Regras de Negócio =====
 
  * **RN01** - Registro de saída avulsa deve ser para a data atual, caso o almoxarifado não tenha permissão para alterar a data de saída
  * **RN02** - Quando o Tipo de saída avulsa informado for ''Consumo Imediato'' ou ''Saída'' o campo **Unidade Requisitante** será solicitado, pois a coluna almoxarifado.sub_tipo_movimentacao_estoque.exibir_unidade_requisitante é configurado como verdadeiro para esses tipos.
  * **RN03** - Quando o Tipo de saída avulsa informado for ''Doação'' o campo **Entidade Beneficiada** será solicitado, pois a coluna almoxarifado.sub_tipo_movimentacao_estoque.exibir_entidade_beneficiente é configurado como verdadeiro para esses tipos.
  * **RN04** - Caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja configurado como falso, será exibido um campo único para a informação do número do processo no formato radical.número/ano-dv. Esse campo é mascarado, ou seja, não é necessário o usuário informar os "./-". Caso o  parâmetro esteja configurado como verdadeiro será solicitado os valores de forma separada, sendo quatro campos: **radical** . **número** / **ano** - **dv**. As informações desse campo são exibidas também no formato radical.número/ano-dv.
  * <del>**RN05** - O campo data do processo é exibido caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja configurado como verdadeiro. (Adicionado em 20/06/2015, referente a tarefa 150212)</del>(Regra removida em 17/12/2015 referente a tarefa 169702)

==== 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 -> Estoque -> Saída Avulsa(Perda, Consumo Imediato, etc.) -> Registrar Saída Avulsa

Usuário: genibaldo, pedrofernandes, kmbso

Papel que usuário deve ter: SipacPapeis.GESTOR_ALMOXARIFADO

===== Cenários de Teste =====
Utilize materiais cujo saldo seja maior que zero obitidos no módulo do Almoxarifado -> aba Relatório -> Gerais/Unidade Rel. de Estoque - Inventário. Informe um grupo qualquer de material (Ex: 301600000107). Anote o saldo do material que irá utilizar para ao teste, proceda com a saída avulsa e retorne para este relatório para confirmar a mudança do saldo.

===== Dados para o Teste =====
Para localizar um produto para teste, entre no módulo de **Almoxarifado -> aba Relatório -> Movimentação -> Movimentação por Material**, informe um período qualquer (ex: 01/01/2010 a 31/01/2010) e informe o nome parcial de um material de uso comum como agua mineral, toner, cartucho, etc.

Verificar se o almoxarifado da unidade do usuário logado possui 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.

Validar se as regras acima descritas estão sendo respeitadas. 

A consulta ao arquivo anexado pode ser feita através da Consulta de Saídas Avulsas em **Almoxarifado -> Estoque -> Consultas -> Consulta de Saídas Avulsas**

A Consulta abaixo informando os sub-tipos de movimentação:
<code sql>
SELECT id_sub_tipo_mov_est, denominacao, exige_unidade_requisitante,exige_entidade_beneficente FROM almoxarifado.sub_tipo_movimentacao_estoque;

-- Buscar material no estoque
select m.denominacao, m.codigo from almoxarifado.estoque_material e join comum.material m
		on m.id_material = e.id_material where  e.id_almoxarifado in ( ID_DO_ALMOXARIFADO DO USUÁRIO )
	group by m.denominacao, e.saldo, m.codigo having e.saldo > 0
	
</code>