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



====== Cadastrar Requisição para Compra ======

O gestor da biblioteca utiliza esse caso de uso para enviar a solicitação de aquisição de materiais informacionais para o setor de compras. A requisição é cadastrada após o atendimento, pela biblioteca, das requisições de materiais informacionais cadastradas por alunos, professores ou unidades da instituição. 

Para realizar esta operação é necessário ter [[desenvolvimento:especificacoes:sipac:biblioteca:casos_de_uso:requisicoes:atendimento_compras:atender_requisicoes|requisições de materiais informacionais atendidas]] pela biblioteca.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Biblioteca -> Requisições -> Atendimento/Compras -> Requisição de Material -> Cadastrar Req. p/ Compra//.

====Passo 1====

São exibidos os seguintes filtros para consulta das requisições: ([[#principais_regras_de_negocio|RN01]])

  * **Unidade***: Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). É permitido buscar a unidade pelo código ou pelo nome da unidade. Essa campo refere-se a unidade que cadastrou a requisição de material informacional que foi atendida.
  * **Período***: Tipo DATA. Formato: DD/MM/AAAA a DD/MM/AAAA. Data referente ao cadastro da requisição.
  * **Editora**: Tipo TEXTO.

É exibida uma listagem com as requisições encontradas:

  * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Unidade__**: Tipo TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE.
  * **__Valor Atendimento__**: Tipo NUMÉRICO. Valor dos itens inseridos na requisição baseado no valor estimado desses itens.

Para cada uma das requisições listadas, são exibidas as informações se a requisição possui algum item, além de opções para visualizar a requisição, analisar a requisição ([[#principais_regras_de_negocio|RN02]]) e finalizar a requisição ([[#principais_regras_de_negocio|RN03]]).

=== Visualizar Requisição ===

  * **__Tipo da Requisição__**: Tipo TEXTO.
  * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Status__**: Tipo TEXTO.
  * **__Unidade__**: Tipo TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE.
  * **__Fonte Orçamentária__**: Tipo TEXTO. Fonte escolhida no cadastro da requisição de material informacional.
  * **__Usuário__**: Tipo TEXTO. Formato: login - NOME DO USUÁRIO (Ramal: 9999)
  * **__E-mail__**: Tipo TEXTO.
  * **__Telefone__**: Tipo NUMÉRICO.
  * **__Data__**: Tipo DATA.
  * **__Data da Autorização__**: Tipo DATA. ([[#principais_regras_de_negocio|RN04]]) 
  * **__Total da Requisição__**: Tipo NUMÉRICO.

É exibida uma lista dos livros da requisição:

  * **__Título__**: Tipo TEXTO.
  * **__Autor__**: Tipo TEXTO.
  * **__ISBN__**: Tipo TEXTO.
  * **__Editora__**: Tipo TEXTO.
  * **__Quant.__**: Tipo NUMÉRICO.
  * **__Quant. Aut.__**: Tipo NUMÉRICO.
  * **__Acervo__**: Tipo NUMÉRICO.
  * **__Quant. A.__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO.

Para os livros que estão no acervo da biblioteca, é disponibilizada a opção de visualizar as informações conforme especificado em [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:processos_tecnicos:pesquisas_no_acervo:opecacoes_adicionais:visualizar_informacoes_dos_materiais|Visualizar informações dos materiais informacionais]], do módulo biblioteca do SIGAA. ([[#principais_regras_de_negocio|RN05]])

Caso a requisição possua periódicos, são exibidas as seguintes informações: ([[#principais_regras_de_negocio|RN06]])

  * **__ISSN__**: Tipo NUMÉRICO.
  * **__Editora__**: Tipo TEXTO.
  * **__Periodicidade__**: Tipo TEXTO.
  * **__Ano__**: Tipo DATA. formato: AAAA.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total de Periódicos__**: Tipo NUMÉRICO.

Caso a requisição possua itens de materiais especiais, são exibidas as seguintes informações: ([[#principais_regras_de_negocio|RN07]])

  * **__Descrição__**: Tipo TEXTO.
  * **__1º Autor__**: Tipo TEXTO.
  * **__Editora__**: Tipo TEXTO.
  * **__Tipo__**: Tipo TEXTO.
  * **__Quant.__**: Tipo NUMÉRICO.
  * **__Quant. Atendida__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO.
  * **__Total de Materiais Especiais:__**: Tipo NUMÉRICO.

São exibidas também as movimentações da requisição:

  * **__Data__**: Tipo DATA. Formato: DD/MM/AAAA HH:MM
  * **__Status__**: Tipo TEXTO.
  * **__Usuário__**: Tipo TEXTO.
  * **__Observações__**: Tipo TEXTO.

E as movimentações de documentos: ([[#principais_regras_de_negocio|RN08]])

  * **__Data Origem__**: Tipo DATA.
  * **__Unidade Destino__**: Tipo TEXTO. Formato: SIGLA DA UNIDADE.
  * **__Enviado Por__**: Tipo TEXTO. Formato: LOGIN DO USUÁRIO.
  * **__Recebido Em:__** Tipo DATA.
  * **__Recebido Por__**: Tipo TEXTO. Formato: LOGIN DO USUÁRIO.
  * **__Obs.:__** Tipo TEXTO.

Caso a requisição tenha sido negada, é informado a justificativa da negação: ([[#principais_regras_de_negocio|RN09]])

  * **__Justificativa da negação da Requisição:__** Tipo TEXTO.

Se a requisição possuir requisições de materiais associadas, são exibidas as seguintes informações: ([[#principais_regras_de_negocio|RN10]])

  * **__Nº/Ano__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Status__**: Tipo TEXTO.
  * **__Data__**: Tipo DATA. 
  * **__Unid. Custo__**:

=== Analisar Requisição ===

Ao escolher a opção de analisar a requisição, o sistema exibe uma lista com as informações do(s) item(ns) da requisição:

**Lista de Livros:**
  * **__Editora__**: Tipo TEXTO.
  * **__Autor(es)__**: Tipo TEXTO.
  * **__ISBN__**: Tipo NUMÉRICO.
  * **__Título__**: Tipo TEXTO.
  * **__Edição__**: Tipo NUMÉRICO.
  * **__Quant.__**: Tipo NUMÉRICO.
  * **__Quant.Compra__**: Tipo NUMÉRICO.
  * **__Preço Un.__**: Tipo NUMÉRICO.
  * **__Total Compra__**: Tipo NUMÉRICO.

**Lista de Periódicos:**
  * **__Título__**: Tipo TEXTO.
  * **__ISSN__**: Tipo NUMÉRICO.
  * **__Volume__**: Tipo TEXTO.
  * **__Número__**: Tipo NUMÉRICO.
  * **__Ano__**: Tipo DATA. Formato: AAAA.
  * **__Status__**: Tipo TEXTO.
  * **__Preço R$__**: Tipo NUMÉRICO.

**Lista de Materiais Especiais:**

  * **__Descrição__**: Tipo TEXTO.
  * **__Tipo__**: Tipo TEXTO.
  * **__Qtd__**: Tipo NUMÉRICO.
  * **__Qtd. Atendida__**: Tipo NUMÉRICO.
  * **__Preço Un.__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO.

Ao escolher o item, são solicitados as informações do material do catálogo que será associado ao material informacional:

  * **Código**: Tipo NUMÉRICO. Formato: 9999999999999. Código do material do catálogo de materiais.
  * **Denominação**: Tipo TEXTO. Denominação do material do catálogo de materiais.
  * **Especificação**: Tipo TEXTO. Permite buscar um material por uma palavra ou trecho da especificação.

São listados os materiais encontrados:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**:Tipo TEXTO.
  * **__Unid.Medida__**: Tipo NUMÉRICO.
  * **__Preço__**: Tipo NUMÉRICO.
  * **__Última Compra__**: Tipo NUMÉRICO.
  * **__Especificação__**: Tipo TEXTO.

Após a inserção do material são exibidas as seguintes informações:

  * **__Req. Mat. Inform.__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Item__**: Tipo NUMÉRICO.
  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Quant.__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO.

Por fim, são exibidos os dados da requisição de material e disponibilizado a opção de gravar e enviar:

  * **__Req. Mat. Inform.__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Item__**: Tipo NUMÉRICO.
  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Quant.__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO.
	 
A opção de gravar armazena os dados informados, permitindo que sejam modificados e enviados posteriormente. 

No caso de enviar, a requisição enviada passa pelo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_vinculo_orcamentario_requisicoes|vínculo orçamentário]] para ser encaminhada para o setor solicitar ao fornecedor.

=== Finalizar Requisição ===

O sistema exibe as informações gerais da requisição:

  * **__Tipo da Requisição__**: Tipo TEXTO.
  * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Status__**: Tipo TEXTO.
  * **__Unidade__**: Tipo TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE.
  * **__Fonte Orçamentária__**: Tipo TEXTO.
  * **__Usuário__**: Tipo TEXTO. Formato: login - NOME DO USUÁRIO (RAMAL: 9999).
  * **__E-mail__**: Tipo TEXTO.
  * **__Telefone__**: Tipo NUMÉRICO.
  * **__Data__**: Tipo DATA.
  * **__Total da Requisição__**: Tipo NUMÉRICO.

Então o caso de uso é finalizado. 
===== Principais Regras de Negócio ===== 

  * **RN01** - São exibidas as requisições que foram atendidas pela biblioteca. Para atender uma requisição, consulte a documentação do caso de uso [[desenvolvimento:especificacoes:sipac:biblioteca:casos_de_uso:requisicoes:atendimento_compras:atender_requisicoes|atender requisição de material informacional]].
  * **RN02** - Só é permitido analisar requisição de material informacional que possua itens que ainda não foram incluídos em uma requisição de material para compra.
  * **RN03** - Só é permitido finalizar requisições de material informacional que não possua itens a serem inseridos em uma requisição de material. Esse comportamento ocorre quando todos os itens da requisição de material informacional foram associados a materiais e incluídos em uma requisição de material para compra.
  * **RN04** - Esse campo é exibido caso a requisição tenha sido autorizada.
  * **RN05** - Essa opção somente é exibida caso haja o item no acervo e o módulo biblioteca do sigaa em funcionamento.
  * **RN06** - Essas informações são exibidas caso a requisição de material informacional seja de periódicos.
  * **RN07** - Essas informações são exibidas caso a requisição de material informacional seja de materiais especiais.
  * **RN08** - Essas informações são exibidas caso a requisição tenha gerado movimentação de documentos.
  * **RN09** - A justificativa é exibida nas requisições que foram negadas.
  * **RN10** - São exibidas as informações das requisições de materiais associadas. Uma requisição de material é associada após analisar e incluir um material na requisição de material informacional, conforme descrito no passo [[#Analisar Requisição|Analisar Requisição]].

==== Resoluções/Legislações Associadas ====
  
Não se aplica. 

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

^ Classe ^ Tabela ^
| <PREENCHER>  | <PREENCHER>  | 

===== Plano de Teste ===== 

Sistema: SIPAC

Módulo: Biblioteca

Link(s): Aba de Requisições -> Atendimento/Compras -> Requisição de Material -> Cadastrar Req. p/ Compra

Usuários: olga

Papel que usuário deve ter: SipacPapeis.GESTOR_BIBLIOTECA

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

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