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

====== Atender Solicitação de Cadastro ======

O material é utilizado em diversas situações como na manutenção do estoque do almoxarifado, criação de licitações, tombamento de bens, etc. A [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:material:catalogo:solicitar_cadastro|solicitação de cadastro]] é feita mediante necessidade de algum usuário em ter determinado material cadastrado no sistema. A solicitação será analisada pelo responsável por realizar a manutenção da lista de materiais cadastrada na base dados, que pode atender (realizando o cadastro) ou negar a solicitação realizada.

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

O caso de uso se inicia através do link: //SIPAC -> Compras/Licitação -> Cadastros -> Cadastro -> Material/Serviço -> Atender Solicitação de Cadastro//.


====Passo 1====

Inicialmente, são disponibilizados os seguintes filtros para consulta das solicitações pendentes de autorização:

  * **Período**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA.
  * **Grupo de Material**: Tipo AUTOCOMPLETE, Entrada de dados: NOME OU CÓDIGO DO GRUPO, Formato 9999 - NOME DO GRUPO.
  * **Usuário**: Tipo AUTOCOMPLETE, Entrada de dados: NOME DO USUÁRIO ou LOGIN, Formato - NOME DO USUÁRIO (LOGIN).
  * **Unidade**: Tipo AUTOCOMPLETE, Entrada de dados: NOME DA UNIDADE ou CÓDIGO, Formato - NOME DA UNIDADE.
  ***Todas as pendentes de atendimento**: Tipo LÓGICO.
  ***Formato de Relatório**: Tipo LÓGICO.

====Passo 2====

Realizada a busca, o sistema exibe as solicitações de cadastro à espera de atendimento:

  * __**Número/Ano**__: Formato - 99/AAAA, Tipo - Numérico.
  * __**Denominação**__: Tipo - Texto.
  * __**Grupo de Material**__: Formato - 9999 - Nome do Grupo de Material, Tipo - Texto
  * __**Unidade de medida**__:Tipo - Texto
  * __**Preço**__: Formato - 9999,99, Tipo - Numérico ([[#principais regras de negócio|RN02]])
  * __**Especificação**__: Tipo - Texto
  * __**Usuário**__: Formato - Login(Ramal: 9999), Tipo - Texto
  * __**Unidade**__: Tipo - Texto
  * __**Data**__: Tipo - DATA.

Escolhida a solicitação, o sistema exibe os seguintes dados:

  * __**Número/Ano**__: Formato - 99/AAAA, Tipo - Numérico
  * __**Nome**__: Tipo - Texto
  * __**Unidade**__: Tipo - Texto
  * __**E-mail**__: Tipo - Texto
  * __**Ramal**__: Tipo - Numérico
  * __**Data de cadastro**__: Tipo - DATA.

É permitido ao usuário atender, negar ou retornar (por insuficiência de informações) a solicitação. 

===Atender===
São exibidos os dados informado na solicitação de cadastro, sendo permitido sua edição:

  * **Denominação***: Tipo - Texto.
  * **Valor Estimado***: Tipo - Numérico.
  * **Grupo de Material***: Tipo - Texto. ([[#principais regras de negócio|RN01]])
  * **Unidade de Medida***: Tipo - Texto.
  * **Especificação***: Tipo - Texto.
  * **Links de Busca**: Tipo - Texto.
  * **Aplicação**: Tipo - Texto.
  * **Sugestão de Fornecedores (Razão Social, Telefone, E-mail)**: Tipo TEXTO.
  * **Código CATMAT**: Tipo - Numérico.
  * **Arquivo da Foto**: Tipo - Arquivo.
  * __**Arquivo de Orçamento**__: Tipo - Arquivo.

===Negar ou Retornar===
O sistema exibe os dados da solicitação e solicita uma justificativa:

  * __**Número/Ano**__: Formato - 99/AAAA, Tipo - Numérico.
  * __**Denominação**__: Tipo - Texto.
  * __**Valor Estimado**__: Tipo - Numérico([[#principais regras de negócio|RN02]]).
  * __**Especificação**__: Tipo - Texto.
  * __**Grupo de Material**__: Tipo - Numérico/Texto.
  * __**Unidade de Medida**__: Tipo - Texto.
  * __**Código CATMAT**__: Tipo - Numérico.
  * __**Status da Solicitação**__: Tipo - Texto.
  * __**Solicitante**__: Tipo - Texto.
  * __**Data de cadastro**__: Tipo - DATA.
  * **Justificativa***: Tipo - Texto.

Há a opção de visualizar arquivo, se houver.

Ao confirmar a operação são exibidos os mesmos dados que acima, porém incluindo os dados a seguir:

==Negação==
  ***__Justificativa da Negação__**: Tipo TEXTO.
  ***__Data de Negação__**: Tipo DATA.
  ***__Usuário de Negação__**: Tipo TEXTO. Formato NOME DO USUÁRIO.

==Retorno==
  ***__Justificativa do Retorno__**: Tipo TEXTO.
  ***__Usuário do Retorno__**: Tipo TEXTO. Formato NOME DO USUÁRIO.

Então o caso de uso é finalizado.


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

  ***RN01** - Ao determinar o grupo de material, o sistema automaticamente procurará por subgrupos associados ao grupo como também por respectivos descritores de materiais associados ao grupo. Se houver algum subgrupo associado, seu preenchimento é obrigatório. Caso existam descritores associados ou ao grupo ou ao subgrupo, o gestor poderá também preenchê-los.
  ***RN02** - O campo de valor estimado manterá o preço cadastrado pelo usuário no qual solicitou o cadastro só ficará disponível até ser cadastrados cotações de preço para a primeira compra no caso de uso: //SIPAC -> Licitação -> Cotações -> Cotações -> Cotar Materiais do Catálogo//.

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

Não se Aplica.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.material.dominio.SolicitacaoCadMaterial | admnistrativo.comum.solicitacao_cad_material |
| br.ufrn.sipac.requisicoes.material.dominio.Material | admnistrativo.comum.material |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | admnistrativo.comum.grupo_material |
| br.ufrn.sipac.requisicoes.material.dominio.DescritorGrupoMaterial |  admnistrativo.comum.descritor_grupo_material |

====== Plano de Teste ======
Sistema: SIPAC

Módulo: Compras/Licitação

Link(s): Cadastros - > Cadastro → Material/ Serviço → Atender Solicitação de Cadastro

Usuário: diretordmp

Papel que usuário deve ter: SipacPapeis.GESTOR_IMPORTAÇÃO ou SipacPapeis.GESTOR_SERVIÇOS_COMPRAS ou SipacPapeis.GESTOR_RELATÓRIO_COMPRAS ou SipacPapeis.GESTOR_PAGAMENTO_SERVIÇO_PF e SipacPapeis.GESTOR_CADASTRO_MATERIAL.


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

Não se aplica.

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

Consulta que deve retornar **Solicitações de material à espera de atendimento** com alguns dados:

<code sql>
 select m.denominacao, -- Denominação do material
 m.data_cadastro, -- Data de cadastro no sistema
 m.valor_estimado, -- Preço
 gm.codigo, -- Código do Grupo Material
 gm.denominacao, -- Denominação do Grupo Material
 p.nome, -- Nome do usuário que cadastrou
 u.login, -- Login do usuário que cadastrou
 un.nome, -- Unidade do usuário que cadastrou
 umed.denominacao -- Unidade de medida do material
        from comum.solicitacao_cad_material m 
	       join comum.grupo_material gm on(m.id_grupo = gm.id)
	       join comum.usuario u on (u.id_usuario = m.id_usuario)
	       join comum.pessoa p on (p.id_pessoa = u.id_pessoa)
	       join comum.unidade un on (un.id_unidade = u.id_unidade)
	       join comum.unidade_medida umed on (umed.id = m.id_unidade_medida)
	       where id_status = 101 and gm.exclusivo = false
</code>


Para cadastrar novas solicitações de cadastro de material:
  - Caminho: Portal Administrativo -> Requisições -> Material -> Catálogo -> Solicitar Cadastro.
  - Preencher 'Grupo Material' com: 3023 e marcar todas as 'Opções Avançadas'. Deve ficar disponível a opção 'Solicitar Cadastro de Material'.
  - Clicar em 'Solicitar Cadastro de Material'.
  - Escolher tipo de material: Material de Consumo.
  - Selecionar: 3023	UNIFORMES, TECIDOS E AVIAMENTOS.
  - Preencher as opções obrigatórias da etapa seguinte.
  - Fim do cadastro.


Esse procedimento deve gerar mais itens para o atendimento de **solicitação de cadastro de materiais**.

</ifauth>