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



====== Solicitar Cadastro ======

O cadastro de materiais é necessário para a inclusão de itens em uma nota fiscal, durante o tombamento de bens, nas requisições de materiais, para dar entrada de material em um almoxarifado, dentre outros. Quando o usuário necessita de um material que não está cadastrado e ele não possui permissão para cadastrar um material, ele utiliza esse caso de uso para solicitar o cadastro do material desejado. 

===== 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 -> Catálogo -> Solicitar Cadastro.

SIPAC -> Compras Compartilhadas -> Compras Compartilhadas -> Material -> Consultar e Solicitar Cadastro

==== Passo 1 ====
Ao acessar o caso de uso, são solicitadas as seguintes informações ([[#principais regras de negócio|RN01]]):

  * **Período de Cadastro**: Tipo DATA, formato: DD/MM/AAAA a DD/MM/AAAA.
  * **Código**: Tipo NUMÉRICO.
  * **Código CATMAT**: Tipo NUMÉRICO.
  * **Denominação**: Tipo TEXTO.
  * **Especificação**: Tipo TEXTO.
  * **Grupo de Material**: Tipo AUTOCOMPLETE, formato: CÓDIGO - GRUPO DE MATERIAL, entrada de dados: CÓDIGO DO GRUPO DE MATERIAL ou NOME DO GRUPO DE MATERIAL.
Descritores do Material ([[#principais regras de negócio|RN02]]):
  * **Nome**: Tipo TEXTO.
  * **Valor**: Tipo NUMÉRICO.
  * Opção para selecionar o descritor
Opções Avançadas:
  * **Formato Relatório**: Tipo LÓGICO.
  * **Listar apenas materiais em estoque**: Tipo: LÓGICO.
  * **Apenas materiais em Sistemas Registro de Preço (Pregões Abertos)**: Tipo: LÓGICO.
  * **Apenas materiais em Processos de Compras em Andamento**: Tipo: LÓGICO.
  * **Materiais em Contratos**: Tipo LÓGICO.
  * **Exceto COLEÇÕES E MATERIAIS BIBLIOGRÁFICOS**: Tipo LÓGICO. ([[#PRINCIPAIS_REGRAS_DE_NEGOCIO|RN08]])


==== Passo 2 ====
Realizada a consulta, caso a opção avançada //**Formato Relatório**// não tenha sido escolhida, será exibida uma lista com os materiais encontrados e as seguintes informações ([[#principais regras de negócio|RN03]]):

  * **__Código__**: Tipo NUMÉRICO, Formato: 999999999999.
  * **__CATMAT__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Unid. Medida__**: Tipo TEXTO.
  * **__Grupo de Material__**: Tipo TEXTO, formato: CÓDIGO - NOME DO GRUPO DE MATERIAL. ([[#principais_regras_de_negócio|RN04]])
  * Opção de mostrar a especificação.

São exibidas as opções de [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_material|Visualizar Material]], [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_demandar_nova_compra|Demandar para Compra]] ([[#principais regras de negócio|RN05]]), [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_solicitar_material_ao_almoxarifado|Solicitar ao Almoxarifado]] ([[#Principais regras de negócio|RN06]]) e [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_solicitar_empenho_do_material|Solicitar empenho (Registro de Preço) do material]] ([[#Principais regras de negócio|RN07]]).

Caso a opção avançada //**Formato Relatório**// seja escolhida, será exibida em formato de relatório uma lista com os materiais encontrados e as seguintes informações:

  * **__Código__**: Tipo NUMÉRICO, Formato: 999999999999.
  * **__CATMAT__**: Tipo NUMÉRICO.
  * **__Data de Cadastro__**: Tipo DATA, Formato: dd/MM/AAAA.
  * **__Denominação__**: Tipo TEXTO.
  * **__Unid. Medida__**: Tipo TEXTO.
  * **__Grupo de Material__**: Tipo TEXTO, formato: CÓDIGO - NOME DO GRUPO DE MATERIAL.

No //Código// é disponibilizado um link para [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_material|Visualizar Material]].

==== Passo 3 - Solicitar Cadastro de Material ====

São exibidas as escolhas do tipo de material:

  * Material permanente: Aquele de duração superior a dois anos. Exemplos: mesas, máquinas, tapeçaria, equipamentos de laboratórios, ferramentas, veículos, semoventes, etc.
  * Material de consumo: Aquele cuja duração é limitada a curto lapso de tempo. Exemplos: artigos de escritório, de limpeza e higiene, material elétrico e de iluminação, gêneros alimentícios, artigos de mesa, combustíveis etc. Fonte: Tesouro Nacional 

=== Material Permanente ===

É exibida uma lista com os grupos de materiais permanentes com as seguintes informações:

  * **Código**: Tipo NUMÉRICO.
  * **Denominação**: Tipo TEXTO.
  * **__Total de Registros encontratos__**: Tipo NUMÉRICO.
  * Opção para selecionar o Grupo.

Em seguida, o sistema solicita as seguintes informações para o cadastro do material:

  ***__Grupo de Material__**: Tipo TEXTO, Formato: CÓDIGO - NOME DO GRUPO. ([[#principais_regras_de_negócio|RN02]])
  * **Denominação***: Tipo TEXTO.
  * **Unidade de Medida***: Tipo TEXTO.
  * **Valor Estimado***: Tipo NUMÉRICO.
  * **Especificação***: Tipo TEXTO.
  * **Links de Busca***: Tipo TEXTO.
  * **Aplicação do Material**: Tipo TEXTO.
  * **Sugestão de Fornecedores(Razão Social, Telefone, Email)**: Tipo TEXTO.
  * **Foto do Material**: Tipo TEXTO.
  * **Orçamento do Material**: Tipo TEXTO.

=== Material de Consumo ===

É exibida uma lista com os grupos de materiais de consumo com as seguintes informações:

  * **Código**: Tipo NUMÉRICO.
  * **Denominação**: Tipo TEXTO.
  * **__Total de Registros encontrados__**: Tipo NUMÉRICO.
  * Opção para selecionar o Grupo.

Em seguida, o sistema solicita as seguintes informações para o cadastro do material:

  ***__Grupo de Material__**: Tipo TEXTO, Formato: CÓDIGO - NOME DO GRUPO. ([[#principais_regras_de_negócio|RN02]])
  * **Denominação***: Tipo TEXTO.
  * **Unidade de Medida***: Tipo TEXTO.
  * **Valor Estimado***: Tipo NUMÉRICO.
  * **Especificação***: Tipo TEXTO.
  * **Links de Busca***: Tipo TEXTO.
  * **Aplicação do Material**: Tipo TEXTO.
  * **Sugestão de Fornecedores(Razão Social, Telefone, Email)**: Tipo TEXTO.
  * **Foto do Material**: Tipo TEXTO.
  * **Orçamento do Material**: Tipo TEXTO.

O sistema exibe os dados da solicitação de material:

  * **__Número/Ano__**: Tipo NUMÉRICO, Formato: NÚMERO/AAAA.
  * **__Denominação__**: Tipo TEXTO.
  * **__Valor Estimado__**: Tipo NUMÉRICO.
  * **__Especificação__**: Tipo TEXTO.
  * **__Data de Cadastro__:** Tipo DATA, Formato DD/MM/AAAA.
  * **__Sites de Busca__:** Tipo TEXTO.
  * **__Aplicação do Material__**: Tipo TEXTO.
  * **__Sugestão de Fornecedores__ (Razão Social, Telefone, Email)**: Tipo TEXTO.
  * **__Grupo de Material__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN02]])
  * **__Unidade de Medida__**: Tipo TEXTO.
  * **__Solicitante__:** Tipo TEXTO.
  * **__Status da Solicitação__:** Tipo TEXTO.
  * Opção para efetuar nova consulta.



O caso de uso é finalizado.



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

  ***RN01** - Caso exista CADASTRADA alguma requisição de Material que irá estimar uma licitação que configurará um novo registro de preço no [[suporte:sipac:compras:srp|SRP]], será exibida, no início do caso de uso, a opção de //Finalizar os Carrinhos de Compra// que foram gerados por cada uma dessas requisições.
  ***RN02** - Caso o grupo de material tenha descritores cadastros, é permitido consultar por descritores.
  ***RN03** - Para cada material listado, é informado se o mesmo está presente em um almoxarifado, possui um processo de compra ativo, um processo de compra bloqueado ou um processo de compra cancelado.
  ***RN04** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]].
  ***RN05** - Os materiais que estão em estoque não podem ser incluídos em uma requisição de compra de material.
  ***RN06** - A opção de solicitar ao almoxarifado é permitida para materiais que estejam em algum almoxarifado.
  ***RN07** - A opção de solicitar empenho (Registro de Preço) do material é permitida para materiais que possuem um registro de preço.
  ***RN08** - Exclui os materiais do grupo definido no parâmetro ''1_600_68 	COLECOES_E_MATERIAL_BIBLIOGRAFICO''.
==== 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: Portal Administrativo ou Compras Compartilhadas.

Link(s): Portal Administrativo -> Aba Requisições -> Material/Serviço -> Catálogo -> Solicitar Cadastro

Compras Compartilhadas -> Compras Compartilhadas -> Material -> Consultar e Solicitar Cadastro.

Usuários: marcilia, pedro, san, gestor_cc.

Papel que usuário deve ter: SipacPapeis.REQUISITOR ou SipacPapeis.REQUISITOR_MATERIAL ou SipacPapeis.GESTOR_CADASTRO_MATERIAL ou SipacPapeis.GESTOR_COMPRAS_COMPARTILHADAS.

===== Cenários de Teste ===== 
NÃO SE APLICA.

===== Dados para o Teste ===== 
NÃO SE APLICA.