====== Cadastrar Almoxarifado ======

Encontrado no módulo de cadastro (seletor do cabeçalho do sistema) através da opção de cadastro, está disponibilizada para os administradores do SIPAC a opção de cadastrar os almoxarifados da instituição sempre que for necessário.
===== Descrição do Caso de uso =====

Esse caso de uso realiza o cadastro de almoxarifados. O caso de uso se inicia quando acessamos //SIPAC -> Menu Mudar de Sistema -> Cadastro -> Almoxarifado -> Cadastrar//. O almoxarifado é a unidade administrativa responsável pelo controle e pela movimentação dos bens de consumo, que são registrados de acordo com as normas vigentes. Para cadastrar um almoxarifado é necessário fornecer as seguintes informações:
  * **Nome***: Tipo - TEXTO
  * **Unidade***: Formato - (99.99) NOME DA UNIDADE . Tipo - NUMÉRICO e TEXTO. Unidade onde o almoxarifado está localizado (obrigatório). Existe uma opção para buscar unidade através do nome, onde são retornadas as unidades e os códigos encontrados, com a opção de selecionar a unidade. ([[#principais regras de negócio|RN01, RN03 e RN04]])
  * **Unidade Responsável**: Formato - (99.99) NOME DA UNIDADE . Tipo - NUMÉRICO e TEXTO. Unidade responsável pelo almoxarifado. Existe a mesma opção citada na informação anterior.
  * **Unidade Destino do Documento**: Formato - (99.99) NOME DA UNIDADE . Tipo - NUMÉRICO e TEXTO. Unidade direcionada pelos documentos. Existe a mesma opção citada na informação anterior.
  * **Email de Contato**: Tipo - TEXTO. Email do contato do almoxarifado. Além do carater informativo, é utilizado para recebimento de notificações automáticas.
  * **Tipo**: que pode ser: Opções - ''SETORIAL, CENTRAL ou VIRTUAL''. Tipo - TEXTO
  * **Orçamentário**:  Tipo - TEXTO. Opções ''SIM ou NÃO''.  Caso um almoxarifado seja definido como orçamentário, no momento que uma unidade crie uma requisição de material para ele, o sistema irá bloquear (contingenciar) o valor total da requisição do orçamento de sua unidade de custo. O valor total da requisição é calculado considerando o preço médio de cada material solicitado. Outro ponto importante é que com o atendimento da requisição, o orçamento contido da unidade é liberado e o sistema registra uma transferência orçamentária da unidade de custo para a unidade que representa o almoxarifado;
    * //SIM//:caso um almoxarifado seja definido como orçamentário, no momento que uma unidade crie uma requisição de material para ele, o sistema irá bloquear (contingenciar) o valor total da requisição do orçamento de sua unidade de custo. O valor total da requisição é calculado considerando o preço médio de cada material solicitado. Outro ponto importante é que com o atendimento da requisição, o orçamento contido da unidade é liberado e o sistema registra uma transferência orçamentária da unidade de custo para a unidade que representa o almoxarifado;
    * //NÃO//:durante o envio da requisição ao almoxarifado, o sistema não contingencia o orçamento da unidade. Durante o atendimento da requisição, o sistema não transfere o orçamento da unidade para o orçamento da unidade que representa o almoxarifado.
  * **Permite Solicitar Ítens de Grupos de Materiais Diferentes**: Opções - ''SIM ou NÃO''. Tipo - TEXTO. Indica se em uma mesma requisição o usuário pode solicitar ao almoxarifado ítens de grupos de materiais diferentes; pode ser SIM/NÃO.
  * **Cálculo de Preço**: Opções : ''PREÇO MÉDIO, UEPS, PEPS''. Tipo - TEXTO descreve como pode é realizado o cálculo do preço,que pode ser:
    * //Preço Médio//: também chamado de método da média ponderada ou média móvel, baseia-se na aplicação dos custos médios em lugar dos custos efetivos.
    * //UEPS//:(último a entrar, primeiro a sair) o custo do estoque é determinado como se as unidades mais recentes adicionadas ao estoque (últimas a entrar) fossem as primeiras unidades vendidas (saídas) (primeiro a sair). Supõe-se, portanto, que o estoque final consiste nas unidades mais antigas e é avaliado ao custo destas unidades.
    * //PEPS//: com base nesse critério, dá-se saída no custo da seguinte maneira: o primeiro que entra é o primeiro que sai (PEPS). À medida que ocorrem as vendas, vamos dando baixas no estoque a partir das primeiras compras, o que eqüivaleria ao raciocínio de que vendemos/compramos primeiro as primeiras unidades compradas/produzidas, ou seja, a primeira unidade a entrar no estoque é a primeira a ser utilizada no processo de produção o ou a ser vendida. Dentro desse procedimento, o estoque é representado pelos mais recentes preços pagos apresentando, dessa forma, uma relação bastante significativa com o custo de reposição. Obviamente, com a adoção desse método, o efeito da flutuação dos preços sobre os resultados é significativo, as saídas são confrontadas com os custos mais antigos.
  * **Publicado**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . indica se ele deve ou não ser listado durante o cadastro de uma requisição; 
  * **Recebe Nota Fiscal**: Tipo - TEXTO. Opções ''SIM ou NÃO''  .Identifica se o almoxarifado pode ou não receber uma nota fiscal; 
  * **On Line**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se o processo de envio de requisições ao almoxarifado ocorre online ou via fluxo normal, por malote físico;
  * **Data início**: Tipo - Data. Formato: DD/MM/YYYY . Data a partir da qual as requisições devem ser impressas no almoxarifado
  * **Libera Entrada Avulsa**: Tipo - TEXTO. Opções ''SIM ou NÃO'' .Indica se neste almoxarifado é possível realizar a entrada de material de forma avulsa; 
  * **Altera Data de Saída Avulsa**: Tipo - TEXTO. Opções ''SIM ou NÃO'' .Indica se a data de saída avulsa pode ser alterada para uma data anterior a data atual;
  * **Permite Transferência de Estoque**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se é permitido para o almoxarifado a realização da transferência de estoque do material;
  * **Permite Exibir Saldo de Materiais na Consulta**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se o saldo em estoque do material no almoxarifado deve ser exibido na consulta;
  * **Permite que Seja Gerado um Documento no Protocolo**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se o almoxarifado deve gerar um documento no protocolo;
  * **Permite troca de material por um de grupo diferente**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se o almoxarifado pode trocar o produto por um outro que seja de um grupo de material diferente;
  * **Permite detalhar entrega de material**: Tipo - TEXTO. Opções ''SIM ou NÃO''. Indica se serão solicitadas informações adicionais sobre local, horário e responsável pelo recebimento.
  * **Bloqueado**: Tipo - TEXTO. Opções ''SIM ou NÃO'' . Indica se o almoxarifado está bloqueado para o recebimento de requisições;
  * **Mensagem Bloqueio**:  Tipo - TEXTO ([[#principais regras de negócio|RN02]])
 
O caso de uso se encerra.

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

  * **RN01** -  Um almoxarifado deve ser vinculado a uma única unidade e esta não pode possuir mais que um almoxarifado;
  * **RN02** - O campo **Mensagens de Bloqueio** somente é exibido quando o campo **Bloqueado** é marcado como ''SIM''.
  * **RN03** - O gestor deve estar lotado na unidade do almoxarifado. Caso não haja almoxarifado para a unidade do usuário, o sistema buscará pelos almoxarifados em que a unidade do gestor é a responsável;
  * **RN04** - A unidade do almoxarifado não deve ser uma unidade gestora (tipo = 2, em comum.unidade).

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.almoxarifado.comuns.dominio.Almoxarifado  | sipac.almoxarifado.almoxarifado  |
| br.ufrn.sipac.cadastro.dominio.Unidade  | sipac.comum.unidade  |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial  | sipac.comum.grupo_material  |
====== Plano de Teste ======

Sistema: SIPAC

Módulo: Cadastro

Link(s): Menu Mudar de Sistema -> Cadastro -> Almoxarifado -> Cadastrar

Usuário: itamir

Papel que usuário deve ter: SipacPapeis.ADMINISTRADOR_SIPAC

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

Para o teste, verificar se o almoxarifado foi realmente cadastrado verificando se o mesmo é listado na opção almoxarifado -> [[desenvolvimento:especificacoes:sipac:cadastro:casos_de_uso:almoxarifado:listar_alterar|listar/alterar]].

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

Não se aplica!