~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Consultar Material ====== Este caso de uso tem como principal função facilitar a busca de materiais e realizar assim algumas operações sobre os mesmos. O caso de uso é utilizado pelos usuários que possuem permissão para requisitar material. Esse caso de uso segue o especificado em [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:material:catalogo::solicitar_cadastro|Solicitar Cadastro de Material]]. ===== Descrição do Caso de Uso ===== Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Catálogo de Materiais -> Operações -> Material -> Consultar. ==== 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]]) * **Exibir Materiais desativados**: Tipo LÓGICO. ([[#PRINCIPAIS_REGRAS_DE_NEGOCIO|RN04]]) ==== Passo 2 ==== Realizada a consulta, sem opções avançadas, será exibida uma lista com os materiais encontrados e as seguintes informações * **__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. 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. * **__Status__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN09]]) * **__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. * **__Status__**: 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 ([[#principais regras de negócio|RN10]]). * **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 ([[#principais regras de negócio|RN10]]). * **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 ([[#principais regras de negócio|RN10]]). * **__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''. ***RN09** - Para materiais que estejam com o status de desativados não será permitido solicitar novo registro de preços, ao almoxarifado ou solicitar empenho do material. ***RN10** - Valor Estimado: Deve ser calculado entre as cotações selecionadas no caso de uso: //SIPAC -> Licitação -> Cotações -> Cotações -> Cotar Materiais do Catálogo// e últimas compras feita dentro de 180 dias antes(Valores cadastrados no caso de uso SIPAC -> Módulo de Licitação -> Aba Licitação -> Licitação -> Julgar Propostas). ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.requisicoes.material.dominio.Material | administrativo.comum.material | | br.ufrn.sipac.almoxarifado.comuns.dominio.Almoxarifado | administrativo.almoxarifado.almoxarifado | | br.ufrn.sipac.compras.dominio.ItemProcessoCompra | administrativo.compras.item_processo_compra | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Requisições Link(s): Portal Administrativo -> Requisições -> Material/Serviço -> Catálogo -> Consultar Material Usuário: jbb,aluizio,marcilia Papel que usuário deve ter: SipacPapeis.REQUISITOR_MATERIAL ou SipacPapeis.REQUISITOR ou SipacPapeis.GESTOR_CADASTRO_MATERIAL. ===== Cenários de Teste ===== Não se aplica. ===== Dados para o Teste ===== Para consultar se o material possui estoque existe um relatório no menu Almoxarifado, chamado [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:consultas:consulta_de_materiais_disponiveis_em_outros_almoxarifados|Consulta de Materiais Disponíveis em Outros Almoxarifados]]. Para visualizar todos os grupos de material ativos no sistema, use a consulta abaixo: SELECT codigo, denominacao FROM comum.grupo_material WHERE ativo = true ORDER BY denominacao ASC;