~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Atender Requisições de Serviços/Obras ====== Um processo de compra, relacionado a serviços/obras, inicia-se a partir do atendimento de uma requisição de serviços. Atender uma requisição de serviço ou de obras significa cadastrar uma ou mais requisições que serão utilizadas no processo licitatório. A(s) nova(s) requisição(ões) de serviço criada(s) será(ão) utilizada(s) para o cadastro do processo de licitação de serviços e está(arão) associada(s) à(s) requisição(ões) de serviço(s) que a(s) originou(aram). Este caso de uso permite aos servidores do setor de compras responsáveis pelo atendimento desse tipo de requisição, realizar o atendimento. ===== Descrição do Caso de Uso ===== A fim de que se possa realizar o atendimento de serviços/obras, o usuário autorizado acessa o caso de uso, iniciando-o, pelo caminho //Sipac -> Compras/Licitação -> Compras -> Requisições -> Atender Requisições de Serviços/Obras//. ====Passo 1==== Uma consulta de requisições é disponibilizada, com apenas um dos seguintes dados: * **Todas as Requisições de Serviços/Obras**: Tipo - LÓGICO. * **Número/Ano/Tipo:** Tipo NUMÉRICO, formato: 9.../AAAA/TIPO DA REQUISIÇÃO. São disponibilizados os tipos ''REQUISIÇÃO DE OBRAS'' e ''REQUISIÇÃO DE SERVIÇOS''. * **Unidade de Requisitante:** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). É permitido escolher a unidade informando o código da unidade. * //Observa-se também a opção de **buscar unidade**, que ao ser selecionada exibe uma busca por unidade através do nome.// * **Unidade de Custo:** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). É permitido escolher a unidade informando o código da unidade. * //Observa-se também a opção de **buscar unidade**, que ao ser selecionada exibe uma busca por unidade através do nome.// * **Status**: Tipo Checkbox com as opções "Sem Atendimento" e "Parcialmente Atendida". Após a busca, são exibidas as listagens de requisições de obras e de serviços ([[#Principais regras de negócio|RN01]]), com os seguintes dados: * **__Status__:** Tipo - Imagem. Para cada requisição, o status informa se a requisição está sem atendimento ou foi parcialmente atendida. * **__Requisição__:** Tipo - NUMÉRICO. Formato - 9.../AAAA. * **__Unidade Orçamentária__:** Tipo - TEXTO. Formato: CÓDIGO DA UNIDADE - SIGLA DA UNIDADE. * **__Descrição__:** Tipo - TEXTO. ([[#Principais regras de negócio|RN05]]) * **__Observação__:** Tipo - TEXTO. ([[#Principais regras de negócio|RN06]]) * **__Data__:** Tipo - DATA. É possível visualizar detalhes da requisição ao clicar no número da requisição, conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_servico|Visualizar requisição de serviço]]. ====Passo 2===== Realizada a escolha da requisição a ser atendida, é exibido o resumo da requisição. Os dados do resumo depende do tipo de requisição e serão descritos nas próximas seções: == Requisição de Obras == * **__Número da Requisição__**: Tipo - NUMÉRICO. Formato: 9.../AAAA. * **__Data__**: Tipo - DATA. * **__Tipo da Requisição__**: Tipo - TEXTO. * **__Unidade Requisitante__**: Tipo TEXTO. Formato: NOME DA UNIDADE. * **__Descrição da Obra__**: Tipo - TEXTO. * **__Valor__**: Tipo - NUMÉRICO. * **__Observações__**: Tipo - TEXTO. == Requisição de Serviços == * **__Tipo da Requisição__:** Tipo - TEXTO. Formato: NOME DO TIPO DA REQUISIÇÃO. * **__Grupo de Serviço__:** Tipo - TEXTO. Formato: 9999 - NOME DO GRUPO. * **__Requisição__:** Tipo - NUMÉRICO. Formato: 9.../AAAA. * **__Unidade Requisitante__:** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). * **__Unidade de Custo__:** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). * **__Usuário__:** Tipo TEXTO. Formato: LOGIN USUÁRIO - NOME USUÁRIO (Ramal: 9999). * **__Data__:** Tipo - DATA. * **__Observações__**: Tipo - TEXTO. * **__Status__**: Tipo - TEXTO. * **Lista de Serviços Cadastrados** * **__Descrição do Serviço__:** Tipo - TEXTO. * **Lista dos Bens Associados ** ([[#Principais regras de negócio|RN07]]) * **__Nº Tombamento__:** Tipo - NUMÉRICO. * **__Denominação__:** Tipo - TEXTO. * **__Termo__:** Tipo - NUMÉRICO. Formato - 9.../AAAA. * **__Valor__:** Tipo - NUMÉRICO São disponibilizadas as opções de analisar, negar ou retornar a requisição. ==== Passo 3 - Analisar==== Caso deseje continuar com o atendimento da requisição detalhada, o usuário utiliza esta opção. O usuário é remetido ao fluxo em que visualiza, caso a requisição já tenha sido atendida ou apenas tenha cadastrado o seu atendimento parcial, as requisições associadas, sendo possível a criação de novas requisições associadas. Os campos exibidos e solicitados dependem dos tipos de requisição e se elas foram ou não parcialmente atendidas. === Requisição de Obras === ==Passo 3.1== São exibidas as seguintes informações: ([[#Principais regras de negócio|RN08]]) * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA - TIPO DA REQUISIÇÃO. É permitido ao usuário visualizar os detalhes da requisição, conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_obras|Visualizar Requisição de Obras]]. É exibido uma lista das requisições a serem licitadas: * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA. * **__Grupo de Material__**: Tipo TEXTO. Formato: 9999 - NOME DO GRUPO DE MATERIAL. * **__Valor__**: Tipo NUMÉRICO. Formato: 99,99. Para cada requisição, é disponibilizado a opção de cadastrar nova requisição, alterar ou remover. As opções de cadastrar nova requisição e alterar seguem conforme descrito nos passos a seguir. A opção de remover exclui a requisição. ==Passo 3.2== São exibidas as seguintes informações: * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA - TIPO DA REQUISIÇÃO. É permitido ao usuário visualizar os detalhes da requisição, conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_obras|Visualizar Requisição de Obras]]. . e solicitado as seguintes informações: * **Grupo de Material:*** Tipo TEXTO. Formato: GRUPO DE MATERIAL. É permitido escolher o grupo do material através do código do material. * **Unidade de Custo:*** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE). É permitido escolher a unidade informando o código da unidade. * //Observa-se também a opção de **buscar unidade**, que ao ser selecionada exibe uma busca por unidade através do nome.// * **Observações:*** Tipo - TEXTO. ==Passo 3.3== Em seguida, é solicitado a inserção dos serviços na requisição selecionada, sendo exibida as seguintes informações: * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA - TIPO DA REQUISIÇÃO. É permitido ao usuário visualizar os detalhes da requisição, conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_obras|Visualizar Requisição de Obras]] Serviço da Requisição de Obras: * **__Serviço__**: Tipo TEXTO. * **__Valor__**: Tipo NUMÉRICO. É disponibilizado ao usuário a opção de consultar os serviços já codificados, ou seja, cadastrados no catálogo de materiais e inserir um serviço. ==Passo 3.4 - Consultar Serviço Codificado== Ao escolher essa opção, serão solicitados os dados do serviço para consulta e inserção na requisição de serviço, conforme especificado no fluxo [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_buscar_serviço_codificado|Buscar Serviço Codificado]]. ==Passo 3.4 - Inserir Serviço== É solicitado as informações dos dados do serviço a ser inserido: * **__Grupo Serviço__**: Tipo TEXTO. * **Denominação***: Tipo TEXTO. * **Valor***: Tipo NUMÉRICO * **Quantidade***: Tipo NUMÉRICO. * **Código CATMAT**: Tipo NUMÉRICO. * **Unidade de Medida***: Tipo TEXTO. * **Especificação**: Tipo TEXTO. ==Passo 3.5 == Após a inserção dos serviços na requisição, exibe as seguintes informações: * **__Requisição__**: Tipo NUMÉRICO. Formato: 9.../AAAA - TIPO DA REQUISIÇÃO. É permitido ao usuário visualizar os detalhes da requisição, conforme especificado em [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_obras|Visualizar Requisição de Obras]] Serviços já inseridos na nova requisição: * **__Código__**: Tipo NUMÉRICO. * **__Denominação__**: Tipo TEXTO. * **__Unidade__**: Tipo TEXTO. Unidade de medida do serviço. * **__Quant.__**: Tipo NUMÉRICO. * **__Valor__**: Tipo NUMÉRICO. Formato: 99,99. * **__Total__**: Tipo NUMÉRICO. Formato: 99,99. Total do item. * **__Total__**: Tipo NUMÉRICO. Formato: 99,99. Total de todos os itens inseridos. Serviço da Requisição de Obras: * **__Serviço__**: Tipo TEXTO. * **__Valor__**: Tipo NUMÉRICO. São disponibilizadas as opções de atender parcialmente ou finalizar o atendimento. A diferença entre atender parcialmente e finalizar o atendimento é que a primeira opção registra as alterações permitindo posterior alteração, enquanto a segunda encerra as alterações e envia as requisições para o passo seguinte no processo licitatório. == Atender Parcialmente == Ao atender parcialmente, a requisição registra as alterações e permite que a ela seja alterada posteriormente. São exibidos os dados da requisição: * **__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA. * **__Valor__**: Tipo - NUMÉRICO. * **__Tipo__**: Tipo - TEXTO. São exibidos os dados das requisições associadas: * **__Requisição__**: Tipo - NUMÉRICO. Formato: 9.../AAAA. * **__Grupo__**: Tipo - TEXTO. Formato: 9999 - NOME DO GRUPO. * **__Valor__**: Tipo - NUMÉRICO. == Finalizar Atendimento == Ao finalizar o atendimento, as alteração são salvas e a requisição é encaminhada para o processo de licitação. São exibidas as seguintes informações: * **__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA. * **__Valor__**: Tipo - NUMÉRICO. * **__Tipo de Requisição__**: Tipo - TEXTO. * **__Unidade Requisitante__**: Tipo - TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE. * **__Unidade de Custo__**: Tipo - TEXTO. Formato: CÓDIGO DA UNIDADE - NOME DA UNIDADE. * **__Usuário__**: Tipo TEXTO. Formato: LOGIN DO USUÁRIO - NOME DO USUÁRIO (Ramal: 9999). * **__Data__**: Tipo DATA. * **__Observações__**: Tipo TEXTO. Requisições de Serviço Associadas: * **__Requisição__**: Tipo - NUMÉRICO. Formato: 9.../AAAA. * **__Grupo__**: Tipo - TEXTO. Formato: 9999 - NOME DO GRUPO. * **__Valor__**: Tipo - NUMÉRICO. === Requisição de Serviço === Para as requisições de serviço, os passos seguem conforme descrito na [[#requisição_de_obras|requisição de obras]], com excessão do passo 3.2. ==Passo 3.2== Segue conforme especificado no [[#passo_3.2|passo 3.2 da requisição de obras]], com exceção de que agora Grupo de Material lista os grupos de acordo com os elementos de despesa parametrizados para Pessoa Física ou Jurídica, além da adição do seguinte campo: * **Tipo Serviço***: Tipo TEXTO. São apresentadas as opções ''PESSOA FÍSICA'' e ''PESSOA JURÍDICA''. ==== Passo 3 - Negar ==== São exibidas as informações gerais da requisição, exatamente como descrito no [[#Passo 2|passo 2]]. O sistema solicita uma justificativa para a negação da requisição: ***Justificativa**: Tipo TEXTO. Após a confirmação da negação, são exibidos os dados da requisição: * **__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA. * **__Valor__**: Tipo - NUMÉRICO. * **__Tipo__**: Tipo - TEXTO. ==== Passo 3 - Retornar Requisição ==== O sistema exibe as informações gerais da requisição e pede uma justificativa para o retorno: ([[#principais regras de negócio|RN04]]) * **__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA. Este campo apresenta um link para [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:requisicoes:material_requisicoes:acompanhar_requisicoes_enviadas#passo 3|Visualizar Requisição]]. * **__Tipo da Requisição__**: Tipo - TEXTO. * **__Unidade Solicitante__**: Tipo - TEXTO. Formato - NOME DA UNIDADE (99.99...). * **__Unidade de Custo__**: Tipo - TEXTO. Formato - NOME DA UNIDADE (99.99...). * **__Status__**: Tipo - TEXTO. * **__Valor__**: Tipo - NUMÉRICO. * **__Data de Cadastro__**: Tipo - DATA. * **Justificativa do Retorno**: Tipo - TEXTO. Após confirmação, são exibidos os dados da requisição: * **__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA. Este campo apresenta um link para [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:requisicoes:material_requisicoes:acompanhar_requisicoes_enviadas#passo 3|Visualizar Requisição]]. * **__Data__**: Tipo - DATA. * **__Tipo da Requisição__**: Tipo - TEXTO. * **__Unidade de Custo__**: Tipo - TEXTO. Formato - NOME DA UNIDADE (99.99...). * **__Status__**: Tipo - TEXTO. * **__Unidade Requisitante__**: Tipo - TEXTO. Formato - NOME DA UNIDADE (99.99...). * **__Valor da Requisição__**: Tipo - NUMÉRICO. ===== ===== O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - Não são exibidas requisições que ainda não foram enviadas ou que já foram completamente atendidas. * **RN02** - Não pode ser excluída a requisição que possua item(ns) associado(s) a algum processo de compra. * **RN03** - O atendimento não poderá ser finalizado se não forem cadastradas requisições para serem licitadas. * **RN03** - A requisição de serviço que tiver algum processo de compra cadastrado não poderá ser negada. * **RN04** - Somente é possível retornar a requisição se ela tiver sido requisitada pela unidade de lotação do usuário, ou se ele ou a unidade possuir papeis como GESTOR_SERVICO, GESTOR_PF ou GESTOR_PJ. A requisição, neste caso, não pode estar atendida. * **RN05** - O campo **Descrição** é exibido para as requisições de obras. (Adicionado em 08/02/2012, referente a tarefa 78324) * **RN06** - O campo **Observação** é exibido para as requisições de Serviço. (Adicionado em 08/02/2012, referente a tarefa 78324) * **RN07** - As informações dos bens associados são exibidas caso tenha sido associado um bem no cadastro da requisição. (Adicionado em 08/02/2012, referente a tarefa 78324) * **RN08** - Esse passo é exibido caso a requisição esteja com o status ''Parcialmente Atendida''. (Adicionado em 08/02/2012, referente a tarefa 78324) * **RN09** - Os gestores de compra podem autorizar qualquer requisição. (Adicionado em 10/05/2012, referente a tarefa 90570) ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.requisicoes.servico.dominio.RequisicaoServico | administrativo.requisicoes.requisicao_servicos | | br.ufrn.sipac.requisicoes.servico.dominio.ItemReqServico | administrativo.requisicoes.item_servico | | br.ufrn.sipac.requisicoes.servico.dominio.BemReqServico | administrativo.requisicoes.bem_req_servico | | br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material | | br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | comum.grupo_material | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Compras/Licitação Link(s): Aba Compras -> Requisições -> Atender Requisições de Serviços/Obras Usuário: nnaa, paulinho. Papel que usuário deve ter: * SipacPapeis.GESTOR_COMPRA, * SipacPapeis.GESTOR_IMPORTACAO, * SipacPapeis.GESTOR_SERVICOS_COMPRAS, * SipacPapeis.GESTOR_RELATORIOS_COMPRAS, * SipacPapeis.GESTOR_PAGAMENTO_SERVICO_PF. ===== Cenários de Teste ===== Realizar o cadastro com seleção final de gravar e enviar por meio do caso de uso [[:desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:servicos:cadastrar_requisicao|Cadastrar Requisição de Serviço]] e em seguida consultar a requisição por meio do passo 1 do caso de uso. ===== Dados para o Teste ===== Para verificar requisições disponíveis ao atendimento, assim como as informações inseridas junto a mesma utilizar o caso de uso [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:servicos:acompanhar_portal_administrativo:requisicoes_enviadas|Acompanhar requisições enviadas]].