~~ODT~~
echo "";
echo "Última atualização: ";
ver('', false);
echo "
";
====== Cadastrar Requisição ======
Uma requisição de material é o instrumento pelo qual o usuário solicita um material para a instituição. Este caso de uso permite aos secretários e chefes de unidades com permissão de requisitar material cadastrar requisições de material a um almoxarifado.
===== Descrição do Caso de Uso =====
Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Material/Serviço -> Almoxarifado -> Cadastrar Requisição.//
=== Passo 1 ===
São apresentados os almoxarifados cadastrados para a Unidade do usuário e o almoxarifado central, sendo permitido escolher apenas um: ([[#principais_regras_de_negócio|RN01,RN04, RN09, RN13]])
* **Almoxarifado - SIGLA**: Tipo LÓGICO.
* **Almoxarifado CENTRAL**: Tipo LÓGICO.
=== Passo 2 ===
É solicitado o Grupo de Material: ([[#principais_regras_de_negócio|RN02,RN05]])
* **Grupo de Material***: Tipo - TEXTO. Formato: CÓDIGO - NOME DO GRUPO.
*//Observa-se a opção de buscar grupo de material, que realiza a busca do grupo por nome.//
=== Passo 3 ===
São disponibilizados os seguintes filtros para buscar o material([[#principais_regras_de_negócio|RN14]]):
* **Código**: Tipo NUMÉRICO.
* **Denominação**: Tipo - TEXTO.
* **Listar apenas material em estoque?** Tipo - TEXTO. São exibidas as opções ''SIM'' ou ''NÃO''. ([[#principais_regras_de_negócio|RN08]])
===Passo 4===
É exibido uma lista com os materiais encontrados:
***__Código__**: Tipo - NUMÉRICO.
***__Denominação__**: Tipo TEXTO.
***__Grupo de Material__**: Tipo - NUMÉRICO.([[#Principais regras de negócio|RN17]]):
***__Unidade de Medida__**: Tipo TEXTO.
***__Valor__**: Tipo - NUMÉRICO.
São disponibilizadas as opções de Exibir Detalhes do Material e de Selecionar Material.
=== Passo 5===
Após a seleção do material são exibidas as informações do material e são disponibilizados dois campos: a quantidade a ser incluída na requisição além de um campo de observação sobre o material:
Situação do Material:
* **__Em estoque?__** Tipo - TEXTO. São apresentadas as opções ''SIM'' ou ''NÃO''.
Registros de Preço Vigentes para o Material ([[#Principais regras de negócio|RN10]]):
* **__Licitação__**: Tipo TEXTO, formato: SIGLA - 9.../AAAA - SIGLA UNIDADE
* **__Validade da Ata__**: Tipo DATA, formato: DD/MM/AAA à DD/MM/AAAA.
* **__Marca__**: Tipo TEXTO.
* **__Valor__**: Tipo NUMÉRICO.([[#Principais regras de negócio|RN15]])
* **__Situação__**: Tipo TEXTO. ([[#Principais regras de negócio|RN16]])
* **__Firma__**: Tipo TEXTO.
É disponibilizada a opção de visualizar informações sobre um registro de preço conforme descrito em [[desenvolvimento:especificacoes:sipac:compras_-_registros_de_precos:casos_de_uso:sistema_de_registro_de_precos:relatorios:visualizar_ata_de_um_registro_de_precos#Passo 2|Visualizar Ata de um registro de preço]] do módulo compras.
Licitações em Andamento para o Material ([[#Principais regras de negócio|RN10]]):
* **__Processo__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
* **__Licitação__**: Tipo TEXTO. Formato: PR-99/AAAA - SIGLA.
* **__Situação__**: Tipo TEXTO.
É permitido visualizar informações sobre o processo de compra, onde são exibidos os seguintes dados:
* **__Numero/Ano__**: Tipo TEXTO. Formato: 9.../AAAA (Sistema de Registro de Preço) ([[#Principais regras de negócio|RN11]])
* **__Modalidade Licitação__**: Tipo TEXTO.
* **__Data de Cadastro__**: Tipo DATA.
* **__Usuário que Cadastrou__**: Tipo TEXTO.
* **__Assunto__**: Tipo TEXTO.
* **__Tipo__**: Tipo TEXTO.
* **__Status__**: Tipo TEXTO.
* **__Unidade Gestora__**: Tipo TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE
* **__Valor Total (Estimado)__**: Tipo NUMÉRICO.
Informações do Material para Inserção:
* **__Código__**: Tipo - NUMÉRICO.
* **__Grupo de Material__**: Tipo - NUMÉRICO.
* **__Denominação__**: Tipo - TEXTO.
* **__Especificação__**: Tipo - TEXTO.
* **__Valor (R$)__**: Tipo - NUMÉRICO.
* **__Foto do Material__**: Imagem ilustrativa do material, caso exista no banco de dados.
* **__Unidade Medida__**: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN18]])
* **Quantidade***: Tipo - NUMÉRICO.
=== Passo 6 ===
Confirmada a inclusão do material, é exibida uma lista com os materiais adicionados e a opção de buscar novos materiais para inclusão:([[#principais_regras_de_negócio|RN05]])
Buscar Material para Inserção na Lista:
* **Código**: Tipo NUMÉRICO.
* **Denominação**: Tipo - TEXTO.
* **Listar apenas material em estoque?** Tipo - TEXTO. São exibidas as opções ''SIM'' ou ''NÃO''. ([[#principais_regras_de_negócio|RN08]])
Lista de Materiais:
* **__Nº__**: Tipo - TEXTO.
* **__Código__**: Tipo - NUMÉRICO.
* **__Denominação__**: Tipo - TEXTO.
* **__Grupo de Material__**: Tipo - ALFANUMÉRICO.
* **__Quantidade__**: Tipo - TEXTO.
* **__Valor__**: Tipo - NUMÉRICO.
* **__Total__**: Tipo - NUMÉRICO.
*Opção de alterar material: Permite alterar a quantidade informada para o item.
*Opção de visualizar as cotações do material.
*Opção de remover material: Exclui o material da lista.
=== Passo 7 ===
São exibidos os dados da requisição e dos materiais inseridos:
Dados da requisição:
* **__Tipo da Requisição__**: Tipo - TEXTO.
* **__Grupo de Material__**: Formato - CÓDIGO - NOME. Tipo - TEXTO.
* **__Unidade Requisitante__**: Formato - CÓDIGO - NOME. Tipo - TEXTO.
* **__Usuário__**: Formato - LOGIN - NOME (Ramal: NÚMERO). Tipo - TEXTO.
* **__Destino da Requisição__**: Tipo TEXTO.
* **__Valor da Requisição__**: Tipo - NUMÉRICO.
* **__Opção Orçamentária__**: Tipo - TEXTO.
* **Local da Entrega**: Tipo - TEXTO. ([[#principais regras de negócio|RN19]])
* **Servidor Responsável pelo Recebimento**: Tipo - AUTOCOMPLETE. ([[#principais regras de negócio|RN19]])
* **Horário Preferencial de Entrega**: Tipo - HORA. Formato - HH:MM às HH:MM. ([[#principais regras de negócio|RN19]])
* **Observações**:Tipo - TEXTO.
Lista de Materiais:
* **__Nº__**: Tipo - TEXTO.
* **__Código__**: Tipo - NUMÉRICO.
* **__Denominação__**: Tipo - TEXTO.
* **__Grupo de Material__**: Tipo - ALFANUMÉRICO.
* **__Unid. de Medida__**: Tipo - TEXTO.
* **__Quant.__**: Tipo - NUMÉRICO.
São disponibilizados as opções de ''Gravar'' e ''Gravar e Enviar''. ([[#principais_regras_de_negócio|RN03, RN06, RN07, RN12]])
=== Passo 8 - Gravar ===
A requisição é gravada e segue o descrito no passo 7 - Gravar da especificação [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:material:compra:cadastrar_requisicao#passo_7_-_gravar|Cadastrar Requisição de Compra]] do Módulo Portal Administrativo.
=== Passo 8 - Gravar e enviar ===
A requisição é gravada e encaminhada para o fluxo orçamentário, conforme descrito no [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_vinculo_orcamentario_requisicoes|Fluxo Vínculo Orçamentário]].
===Envio e Modelo de email===
Finalizado a requisição, o sistema envia correio eletrônico ao Gestor de Almoxarifado conforme modelo:
Assunto: Notificação do Cadastro de Requisição
Caro(a) NOME DO SERVIDOR,
Foi cadastrada uma requisição de REQUISIÇÃO DE MATERIAL(número 9.../AAAA) no SIPAC/UFRN para a sua unidade por NOME DO SERVIDOR com as seguintes características:
Solicitado ao Almoxarifado: NOME DO ALMOXARIFADO
Unidade Requisitante: NOME DA UNIDADE
Unidade de Custo: NOME DA UNIDADE
Itens da Requisição:
Material Quant. Unid. Med. Valor Valor Total
NOME DO MATERIAL 3200MPF 2.0 UNIDADE R$ 99,99 R$ 99,99
Total da Requisição: R$ 99,99
Para maiores detalhes consulte o SIPAC.
Esta mensagem é automática e não deve ser respondida
O caso de uso é finalizado.
===== Principais Regras de Negócio =====
* **RN01** - Se o almoxarifado estiver bloqueado para pedido, não é permitido fazer requisição de material para ele.
* **RN02** - Se o material estiver bloqueado para pedido em determinado almoxarifado, não é permitido requisitar o material ao almoxarifado em que se encontra bloqueado.
* **RN03** - Se o almoxarifado tiver sido definido como orçamentário, a requisição passa pelo vínculo orçamentário.
* **RN04** - Se for indicado que o almoxarifado recebe atendimento em uma mesma requisição, materiais de um único grupo de material, a requisição só poderá ser formada por materiais do mesmo grupo. Caso contrário, poderá ser formada por materiais de grupos diferentes.
* **RN05** - A requisição encaminhada a um almoxarifado, apenas pode ser feita incluindo materiais cujo grupo de material tenha natureza da despesa MATERIAL DE CONSUMO.
* **RN06** - Caso o almoxarifado seja eletrônico(on-line) será enviado um email para o chefe da unidade informando que a requisição está pendente de autorização e a requisição ficará com o status ''PENDENTE AUTORIZAÇÃO DA CHEFIA''. Se a requisição for cadastrada pelo chefia da unidade, tal email não é enviado e a requisição ficará com o status ''ENVIADA''.
* **RN07** - Caso o almoxarifado seja eletrônico(on-line) a requisição não pode ser enviada se não houver chefe ou vice cadastrado para a unidade.
* **RN08** - Será exibido se o parâmetro PERMITIR_LISTAR_TODOS_OS_MATERIAIS for verdadeiro, caso contrário listará somente os materiais em estoque.
* **RN09** - Caso os parametros do sistema ''BLOQUEIO_REQUISICOES_FICHA_ACOMPANHAMENTO_CONTRATO, BLOQUEIO_REQUISICOES_FREQUENCIA_BOLSISTA, BLOQUEIO_REQUISICOES_HOMOLOGACAO_FREQUENCIA_SERVIDORES, BLOQUEIO_REQUISICOES_PROPOSTA_PROJETO_ACAO_ENSINO_EXTENSAO, BLOQUEIO_REQUISICOES_RECEBIMENTO_BENS, BLOQUEIO_REQUISICOES_RECEBIMENTO_PROCESSOS e BLOQUEIO_REQUISICOES_TICKET_PASSAGEM'' sejam configurados como verdadeiros e houver pendências em relação aos parâmetros informados, será exibida um tela informando a(s) pendência(s) que está(ão) bloqueando o cadastro de requisição conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_atendimento_de_pendencias|Fluxo atendimento de Pendências]]. (Adicionado em 12/08/2011 referente a tarefa 69250)
* **RN10** - As informações sobre **Registro de Preços Vigente para o Material** e **Licitação em Andamento para o material** são exibidas caso o material esteja em um registor de preço vigente ou em uma licitação para um processo de compra.(Adicionado em 12/08/2011 referente a tarefa 69250)
* **RN11** - O texto ''Sistema de Registro de Preço'' apenas é exibido caso o item esteja em um registro de preço vigente.(Adicionado em 12/08/2011 referente a tarefa 69250)
* **RN12** - Caso a requisição não seja cadastrada pela chefia da unidade, a requisição ficará com o status ''PENDENTE AUTORIZAÇÃO DA CHEFIA''. (Adicionado em 12/08/2011 referente a tarefa 69250)
* **RN13** - Serão exibidos todos almoxarifados, sendo possível acessar apenas os que não possuirem bloqueios para o período da solicitação definido no bloqueio. [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:cadastros:cadastrar_periodo_de_bloqueio_de_requisicao:cadastrar_listar|Cadastrar Período de Bloqueio de Requisição]].
* **RN14** - Após inserido um material não é mais permitido alterar o grupo de materiais
* **RN15** - O label desse campo é alterado de acordo com as seguintes regras: se o material não tiver em estoque e não tiver sido compra anteriormente, o campo exibido é valor estimado. Caso tenha sido adquirido em um processo de compra anteriormente e não tenha em estoque, o label será Preço de Compra. Se tiver no almoxarifado, será valor. (Adicionado em 30/09/2013, referente a tarefa 120489)
* **RN16** - Essa informação é exibida apenas quando o item foi bloqueado ou cancelado. (Adicionado em 30/09/2013, referente a tarefa 120489)
* **RN17** - Essa informação só exibida se o almoxarifado de destino permite grupos diferentes.
* **RN18** - É exibida uma mensagem em negrito abaixo do campo da unidade, caso exista alguma relação de conversão de unidade para o material. Essa mensagem apresenta o seguinte formato: **Atenção! Atualmente o almoxarifado atende o material com base na relação: Unidade A ---- Unidade B.** Onde a unidade "A" em questão é a unidade antes da alteração de atendimento, e a unidade "B" é a nova unidade definida na funcionalidade [[desenvolvimento:especificacoes:sipac:Almoxarifado:casos_de_uso:Requisicoes:Material_Requisicoes:Alterar_Unidade_do_Atendimento|Alterar Unidade Do Atendimento ]]. (Adicionado em 25/04/2016 referente a tarefa 176533 )
* **RN19** - O campo em questão só estará disponível se a opção "detalhamento de entrega" esteja habilitada nas opções do almoxarifado para o qual a requisição será encaminhada.
==== Resoluções/Legislações Associadas ====
Não se aplica.
===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.Material | administrativo.comum.material |
| br.ufrn.sipac.requisicoes.material.dominio.ItemRequisicao | administrativo.requisicoes.item_requisicao |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | administrativo.comum.grupo_material |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoMaterial | administrativo.comum.descritor_grupo_material |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoOpcaoValor | administrativo.comum.descritor_grupo_opcao_valor |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoValor | administrativo.comum.descritor_grupo_valor |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorSubGrupo | administrativo.comum.descritor_sub_grupo |
| br.ufrn.sipac.requisicoes.material.dominio.ModificacaoMaterial | administrativo.comum.modificacao_material |
| br.ufrn.sipac.requisicoes.material.dominio.MovimentoItemRequisicao | administrativo.requisicoes.movimento_item_requisicao |
| br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material |
| br.ufrn.sipac.requisicoes.material.dominio.SolicitaAtualizacaoPrecoMat | administrativo.comum.solicitacao_atualiza_preco_mat |
| br.ufrn.sipac.requisicoes.material.dominio.SolicitacaoCadMaterial | administrativo.comum.solicitacao_cad_material |
| br.ufrn.sipac.requisicoes.material.dominio.SubGrupoMaterial | administrativo.comum.sub_grupo_material |
====== Plano de Teste ======
Sistema: SIPAC
Módulo: PORTAL ADMINISTRATIVO
Link(s): Requisições -> Material/Serviço -> Almoxarifado -> Cadastrar Requisição
Usuário: marcilia
Papel que usuário deve ter: SipacPapeis.REQUISITOR
===== Cenários de Teste =====
Cadastrar uma requisição de material para um almoxarifado e verificar se no e-mail enviado aparece os nomes das unidades requisitante e de custo. Para verificar se o e-mail foi preenchido corretamente, consulte o e-mail que é armazenado em comum.sistemas_comum.infra.emails_enviados e também a mensagem enviada para o email de testes, pois ele é armazenado nessa tabela. E para consultar a requisição que foi cadastrada acessar o caso de uso pelo caminho //Sipac -> Portal Administrativo -> Requisições -> Material/Serviço -> Almoxarifado -> Acompanhar requisições enviadas//.
**FLUXO DA REQUISIÇÃO**
**1.** Cadastrar uma requisição de Material em SIPAC -> Portal Administrativo -> Requisições -> Material/Serviço -> Almoxarifado -> Cadastrar Requisição (anote o número da requisição).
**1.1.** É possível fazer uma requisição também pelo módulo de almoxarifado através do caminho SIPAC -> Almoxarifado -> Estoque -> Estoque -> Requisição de Material -> Cadastrar Requisição.
**1.2.** Ao tentar enviar a requisição, será solicitada ao usuário a definição do vínculo orçamentário das requisições. Se a unidade do usuário não tiver saldo o suficiente para arcar com o valor requerido, o requisitante pode definir outra unidade orçamentária para isso através da opção "Solicitar Autorização". Nesse caso, será necessário entrar no sistema com o chefe (ou autorizador orçamentário) dessa unidade e autorizá-la em SIPAC -> Requisições -> Autorizações -> Requisições Pendentes de Autorização Orçamentária.
**2.** Atender a requisição em SIPAC -> Almoxarifado -> Requisições -> Atendimento de Requisições -> Atender Requisição. Uma movimentação do tipo SAIDA_ATENDIMENTO é criada no almoxarifado para cada item da requisição, com a quantidade e o valor total atendidos.
**2.1.** O comprovante de atendimento da requisição pode ser visualizado em SIPAC -> Almoxarifado -> Requisições -> Atendimento de Requisições -> Comprovantes -> Atendimento
**3.** É possível alterar/estornar o atendimento em SIPAC -> Almoxarifado -> Requisições -> Atendimento de Requisições -> Alterar Atendimento.
**3.1.** Se a quantidade de um item for alterada para um valor maior que o anterior, uma movimentação do tipo SAIDA_ATENDIMENTO deve ser criada para o item alterado com a diferença de quantidade/valor.
**3.2.** Se a quantidade de um item for alterada para um valor menor que o anterior ou se o atendimento for estornado, uma movimentação de ENTRADA_ATENDIMENTO deve ser criada para o material alterado.
As movimentações podem ser conferidas nos seguintes relatórios:
* SIPAC -> Almoxarifado -> Relatórios -> Movimentações -> Extrato de Movimentação
* SIPAC -> Almoxarifado -> Relatórios -> Movimentações -> Movimentações por Grupo de Material
* SIPAC -> Almoxarifado -> Relatórios -> Movimentações -> Movimentações por Material
* SIPAC -> Almoxarifado -> Relatórios -> Movimentações -> RMA Analítico (deve exibir a mesma quantidade e valor total que o Inventário)
* SIPAC -> Almoxarifado -> Relatórios -> Movimentações -> RMA Sintético
* SIPAC -> Almoxarifado -> Relatórios -> Material -> Inventário (deve exibir a mesma quantidade e valor total que o RMA Analítico)
===== Dados para o Teste =====
Esse caso de uso se encontra dentro do fluxo de [[desenvolvimento:especificacoes:sipac:requisicoes:plano_de_teste:requisicao_material_almoxarifado|Requisição de Material do Almoxarifado]].
Ao buscar material para inserir na lista, observar que deve-se buscar o material de acordo com o grupo selecionado.
Para encontrar os grupos de materiais, pode-se utilizar a seguinte consulta:
SELECT codigo, denominacao
FROM comum.grupo_material;
E para encontrar os materiais de um determinado grupo, basta utilizar a consulta abaixo, passando o código do grupo do material desejado após o sinal de igual:
SELECT mat.denominacao, mat.codigo
FROM comum.material mat
INNER JOIN comum.grupo_material grupo
ON grupo.id = mat.id_grupo
WHERE grupo.codigo = ?;