echo "";
echo "Última atualização: ";
ver('', false);
echo "
";
====== Cadastrar Requisição ======
Este caso de uso tem o objetivo de solicitar a devolução de materiais de requisições que foram atendidas para o almoxarifado. Ele é usado pelos requisitores de materiais e requisitor global.
Pré-condições:
* A requisição deve ser da unidade do usuário logado.
* A requisição deve ter sido enviada primeiramente para atendimento (no módulo de 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 -> Devolução -> Cadastrar Requisição//.
===Passo 1===
Usuário informa dados da requisição ou material para efetuar a busca ([[#principais_regras_de_negócio|RN01]]):
* **Número/Ano**: Tipo NUMÉRICO. Formato: 9.../AAAA.
* **Material**: Tipo TEXTO.
É exibida uma lista com as requisições encontradas:
* **__Data__:** Formato - DD/MM/AAAA, Tipo - DATA.
* **__Número/Ano__:** Formato - 9.../AAAA, Tipo - NUMÉRICO.
* **__Usuário__:** Tipo - TEXTO.
* **__Almoxarifado__:** Tipo - TEXTO.
* **__Valor__:** Tipo - NUMÉRICO.
* //Opção para selecionar a requisição que deseja efetuar a devolução.//
* //Opção para visualizar a requisição.//
Ao selecionar a opção de visualizar a requisição, são exibidas as informações conforme especificado no fluxo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_material|Visualizar Requisição de Material]]. ([[#principais_regras_de_negócio|RN02, RN03, RN04, RN05, RN06, RN07, RN08, RN09, RN10, RN11]])
Ao selecionar uma requisição, o sistema exibe as informações da requisição e solicita a quantidade a ser devolvida:
* **__Dados da Requisição__**:
* **__Requisição Original__:** Formato - 9.../AAAA. Tipo - NUMÉRICO.
* **__Tipo__:** Tipo - TEXTO.
* **__Status__:** Tipo - TEXTO.
* **__Grupo de Material__:** Tipo - TEXTO.
* **__Unidade Orçamentária__:** Tipo - TEXTO.
* **__Unidade Requisitante__:** Tipo - TEXTO.
* **__Destino da Requisição__:** Tipo - TEXTO.
* **__Data__:** Formato - DD/MM/AAAA, Tipo - DATA.
* **__Valor da Devolução__:** Tipo - NUMÉRICO.
* **__Observações__:** Tipo - TEXTO.
* **__Lista de Materiais da Requisição__**: ([[#principais_regras_de_negócio|RN12, RN13]])
* **__Número__:** Tipo - NUMÉRICO.
* **__Código__:** Tipo - NUMÉRICO.
* **__Denominação__:** Tipo - TEXTO.
* **__Unid. Medida__:** Tipo - TEXTO.
* **__R__:** Tipo - NUMÉRICO. É a quantidade Requisitada.
* **__A__:** Tipo - NUMÉRICO. É a quantidade Atendida.
* **__DD__:** Tipo - NUMÉRICO. É a quantidade quantidade disponível para devolução.
* **DEV:*** Tipo - NUMÉRICO. É a quantidade a ser devolvida.
São disponibilizadas as opções de ''Gravar'' ou ''Gravar e Enviar'' a requisição devolvida. Para essas opções, são exibidos os seguintes dados:
* **__Dados da Requisição__**
* **__Requisição Original__**: Formato - 9../AAAA. Tipo NUMÉRICO. É permitido visualizar as informações da requisição conforme especificado no fluxo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_material|Visualizar Requisição de Material]]
* **__Requisição de Devolução__**: Formato - 9../AAAA. Tipo NUMÉRICO. É permitido visualizar as informações da requisição conforme especificado no fluxo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_material|Visualizar Requisição de Material]]
* **__Data__**: Formato - DD/MM/AAAA. Tipo DATA.
* **__Tipo da Requisição__**: Tipo TEXTO.
* **__Status__**: Tipo TEXTO.
* **__Unidade Requisitante__**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). Tipo TEXTO.
* **__Valor da Devolução__**: Formato - R$ 9.999,99. Tipo NUMÉRICO.
* **__Observações__**: Tipo TEXTO.
* //É disponibilizado a opção de solicitar outra devolução.//
O caso de uso é finalizado.
===== Principais Regras de Negócio =====
* **RN01** - Só serão consultadas as requisições do tipo ''Material'' e com status de ''FINALIZADA'' ou ''FINALIZADA ATENDIMENTO''.
* **RN02** - A informação de **Justificativa para Negação** só será exibida caso exista alguma justificativa.
* **RN03** - As informações sobre **Movimentações de Documentos** só serão exibidas caso exista movimentações de documentos.
* **RN04** - As informações sobre **Contingenciamentos** só serão exibidas caso exista contingenciamentos.
* **RN05** - As informações sobre **Transferências** só serão exibidas caso exista transferências.
* **RN06** - As informações sobre **Autorizações** só serão exibidas caso exista autorizações.
* **RN07** - As informações sobre **Empenhos da Requisição** só serão exibidas caso exista empenhos associados à requisição.
* **RN08** - As informações sobre **Notas Fiscais Associadas à Requisição** só serão exibidas caso exista notas fiscais associadas à requisição.
* **RN09** - As informações sobre **Processos de Pagamento Associados à Requisição** ssó serão exibidas caso exista processos de pagamento associados à requisição.
* **RN10** - As informações sobre **Bens Associadas à Requisição** só serão exibidas caso algum bem associado à requisição.
* **RN11** - As informações sobre **Termos de Responsabilidade Associados à Requisição** só serão exibidas caso exista termos associados à requisição.
* **RN12** - A quantidade informada dos itens não podem ser maior que a quantidade solicitada para devolução.
* **RN13** - Não será possivel fazer uma requisição de devolução se a mesma já foi processada.
==== Resoluções/Legislações Associadas ====
Não se aplica.
===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material |
| br.ufrn.sipac.requisicoes.material.dominio.ItemRequisicao | administrativo.requisicoes.item_requisicao |
| br.ufrn.sipac.requisicoes.material.dominio.Material | administrativo.comum.material |
| br.ufrn.comum.dominio.UsuarioGeral | administrativo.comum.usuario |
| br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.comum.unidade |
===== Plano de Teste =====
Sistema: SIPAC
Módulo: Portal Administrativo
Link(s): Aba Requisições -> Material/Serviço -> Almoxarifado -> Devolução -> Cadastrar Requisição
Usuário: marcilia, pedro
Papel que usuário deve ter: SipacPapeis.REQUISITOR ou SipacPapeis.REQUISITOR_MATERIAL
===== Cenários de Teste =====
Testar se todo o fluxo do caso de uso está correto. E se todas as regras de negócio são respeitadas.
===== Dados para o Teste =====
* Para obter os dados das requisições para os testes, pode-se utilizar a consulta abaixo informando o login do usuário: