~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Gerenciar Mapa de Pedido de Material ====== Mapa de pedido é um instrumento utilizados pelos gestores de almoxarifado para indicar ao fornecedor quais materiais devem ser entregues em que data. Através do mapa de pedido é possível dar transparência nas solicitações entre instituição e fornecedor para que ambos saibam o que, quando e quanto será entregue, sendo possível verificar atrasos e registrar recebimento dos materiais. Pré-condição: É necessário que haja empenhos associados a itens. Um empenho pode estar associado a itens através de um resumo de empenho de um processo de compra ou através de um empenho vinculado a uma solicitação de empenho de registro de preço. Pós-condição: Após cadastrado um mapa de pedido, o fornecedor será notificado e poderá consultar o mapa no módulo portal do fornecedor. ===== Descrição do Caso de Uso ===== O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Almoxarifado -> Aba Estoque -> Estoque -> Gerenciar Mapa de Pedido de Material. ===Passo 1=== O sistema exibe os seguintes filtros para consulta dos mapas de pedidos cadastrados: * **Almoxarifado**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN01]]) * **Empenho(Número/Ano)**: Tipo NUMÉRICO. Formato:999999/AAAA. * **Nº S.M**: Tipo NUMÉRICO. Formato: 9.../AAAA. Número da solicitação de material em registro de preço. * **Fornecedor**: Tipo AUTOCOMPLETE. Formato: RAZÃO SOCIAL - CNPJ. Entrada de dados: RAZÃO SOCIAL OU CNPJ. * **Grupo de Material**: Tipo AUTOCOMPLETE. Formato: CÓDIGO DO GRUPO - DENOMINAÇÃO DO GRUPO DE MATERIAL. Entrada de dados: CÓDIGO OU DENOMINAÇÃO DO GRUPO. * **Material**: Tipo AUTOCOMPLETE. Formato: CÓDIGO DO MATERIAL - DENOMINAÇÃO DO MATERIAL. Entrada de dados: CÓDIGO OU DENOMINAÇÃO DO MATERIAL. * **Mapa de Pedido**: Tipo NUMÉRICO. Formato: 9.../AAAA. Os mapas de pedidos encontrados são listados com as seguintes informações: * **__Mapa de Pedido__**: Tipo NUMÉRICO. Formato: 9.../AAAA. * **__Empenho__**: Tipo NUMÉRICO. Formato: 999999/AAAA. * **__Fornecedor__**: Tipo TEXTO. Formato: Formato: RAZÃO SOCIAL - CNPJ. * **__Grupo de Material__**: Tipo TEXTO. Formato: CÓDIGO DO GRUPO - DENOMINAÇÃO DO GRUPO DE MATERIAL. * **__Data de Entrega__**: Tipo DATA. Formato: DD/MM/AAAA. * **__Status__**: Tipo TEXTO. Exibe o status do mapa, que pode ser: ''AGUARDANDO ENTREGA'', ''FINALIZADO'', ''PENDENTE'' ou ''EM ATRASO''. ([[#principais_regras_de_negócio|RN02]]) * **__Valor__**: Tipo NUMÉRICO. * **__Total de Mapas__**: Tipo NUMÉRICO. * **__Total Valor__**: Tipo NUMÉRICO. Para cada mapa listado são disponibilizadas as opções de visualizar, estornar, finalizar, alterar e registrar recebimento. A opção de cadastrar novo mapa é disponibilizado para o usuário. ===Passo 2 - Cadastrar Mapa de Pedido=== É solicitado o empenho que possui os itens que serão incluídos no mapa:([[#principais_regras_de_negócio|RN03, RN04, RN05 e RN06]]) ***Almoxarifado***: Tipo TEXTO. ([[#principais_regras_de_negócio|RN01]]) ***Empenho(Número/Ano)***: Tipo NUMÉRICO. Formato:999999/AAAA. Os empenhos incluídos são listados com as seguintes informações: * **__Fornecedor__**: Tipo TEXTO. Formato: RAZÃO SOCIAL - CNPJ. * **__Empenho__**: Tipo NUMÉRICO. Formato: 999999/AAAA. * **__Valor__**: Tipo NUMÉRICO. * **__Saldo__**: Tipo NUMÉRICO. * **__Total Valor__**: Tipo NUMÉRICO. * **__Total Saldo__**: Tipo NUMÉRICO. É disponibilizado a opção de remover um empenho adicionado. ===Passo 2.1 - Cadastrar Mapa de Pedido=== São solicitadas seguintes informações: * **Data de entrega***: Tipo DATA. Formato: DD/MM/AAAA. Data de entrega válida para todos os itens escolhidos. É exibida uma lista com os itens dos empenhos incluídos, ordenados por empenho, sendo solicitadas a quantidade para entrega:([[#principais_regras_de_negócio|RN07 e RN08]]) * **__Empenho__**: Tipo NUMÉRICO: Formato: 999999/AAAA * **__Código do Material__**: Tipo NUMÉRICO. Formato: CÓDIGO DO MATERIAL (9999999999999). * **__Denominação do material__**: Tipo TEXTO. * **__Quant. empenhada__**: Tipo NUMÉRICO. Quantidade total empenhado. ([[#principais_regras_de_negócio|RN07]]) * **__Saldo de Quant.__**: Tipo NUMÉRICO. Diferença entre a quantidade empenhada e a quantidade já entregue em notas fiscais ou incluídas em outro mapa de pedido. * **Quant. Solicitada***: Tipo NUMÉRICO. Formato: 99,99. Quantidade solicitada pelo setor ao fornecedor para que seja entregue na data especificada. * **__Valor do Item__**: Tipo NUMÉRICO. * **__Total solicitado__**: Tipo NUMÉRICO. Somatório das quantidades solicitadas. * **__Total Valor Solicitado__**: Tipo NUMÉRICO. Somatório do valor solicitado de cada item (Quant. Solicitada x Valor do Item). É disponibilizada a opção de remover um item incluído na lista. Após a confirmação do cadastro, um email é enviado para o fornecedor. ([[#principais_regras_de_negócio|RN13]]) ===Passo 2 - Visualizar=== Exibe as informações do mapa de pedido: * **__Data de entrega__**: Tipo DATA. Formato: DD/MM/AAAA. * **__Almoxarifado__**: Tipo TEXTO. Almoxarifado que cadastrou o mapa de pedido. * **__Fornecedor__**: Tipo TEXTO. Formato: RAZÃO SOCIAL - CNPJ. * **__Usuário__**: Tipo TEXTO. Formato: NOME DO USUÁRIO (LOGIN). Usuário que fez o cadastro do mapa de pedido. * **__Data de cadastro__**: Tipo DATA. Formato: DD/MM/AAAA. * **__Status__**: Tipo TEXTO. Exibe o status do mapa, que pode ser: ''AGUARDANDO ENTREGA'', ''FINALIZADO'', ''PENDENTE'' ou ''EM ATRASO''. ([[#principais_regras_de_negócio|RN02]]) E a listagem dos itens do mapa, ordenado por empenho: * **__Empenho__**: Tipo NUMÉRICO: Formato: 999999/AAAA * **__Código do Material__**: Tipo NUMÉRICO. Formato: CÓDIGO DO MATERIAL (9999999999999). * **__Denominação do material__**: Tipo TEXTO. * **__Quant. empenhada__**: Tipo NUMÉRICO. Quantidade total empenhado. ([[#principais_regras_de_negócio|RN07]]) * **__Saldo de Quant.__**: Tipo NUMÉRICO. Diferença entre a quantidade empenhada e a quantidade já entregue em notas fiscais ou incluídas em outro mapa de pedido. * **__Quant. Solicitada__***: Tipo NUMÉRICO. Formato: 99,99. * **__Quant. Recebida__**: Tipo NUMÉRICO. Formato: 99,99. * **__Valor do Item__**: Tipo NUMÉRICO. * **__Total solicitado__**: Tipo NUMÉRICO. Somatório das quantidades solicitadas. * **__Total Valor Solicitado__**: Tipo NUMÉRICO. Somatório do valor solicitado de cada item (Quant. Solicitada x Valor do Item). * **__Total Recebido__**: Tipo NUMÉRICO. Somatório das quantidades solicitadas. * **__Total Valor Recebido__**: Tipo NUMÉRICO. Somatório do valor solicitado de cada item (Quant. Solicitada x Valor do Item). ===Passo 2 - Estornar=== Ao escolher essa opção é solicitado uma confirmação do usuário e, caso positivo, o mapa é estornado. ([[#principais_regras_de_negócio|RN09 e RN13]]) ===Passo 2 - Finalizar=== O sistema seta altera o status do mapa para ''FINALIZADO'', armazenando a quantidade recebida de cada item informada em momentos anteriores e, para os itens que não tiveram quantidade recebida informada, armazena com quantidade recebida igual a zero. ([[#principais_regras_de_negócio|RN13]]) ===Passo 2 - Alterar === O sistema segue para o [[#Passo 2 - Cadastrar Mapa de Pedido|Cadastro do Mapa de Pedido]], preenchendo os empenhos e os itens inseridos durante o cadastro do mapa de pedido de material. ([[#principais_regras_de_negócio|RN10, RN11 e RN13]]) ===Passo 2 - Registrar Recebimento=== O sistema lista conforme [[#Passo 2 - visualizar|Visualizar]], com a diferença que habilita o campo Quant. Recebida para que seja informada a quantidade entregue pelo fornecedor. ([[#principais_regras_de_negócio|RN12]]) É apresentada a opção de confirmar o recebimento ou finalizar o mapa. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - Caso o usuário não tenha a permissão de ''GESTOR GERAL DE ALMOXARIFADO'' ou ''AUDITOR'', o sistema lista os almoxarifados cuja unidade seja a do usuário ou o usuário possua a unidade do almoxarifado como unidade extra. * **RN02** - O status ''AGUARDANDO ENTREGA'' é aplicado aos mapas de pedidos que não tiveram seus itens entregues, mas que estão dentro do prazo de entrega. O status ''FINALIZADO'' é destinado aos mapas que já tiveram seus itens entregues e confirmados pelo gestor do almoxarifado. O status ''PENDENTE'' aplica-se aos mapas de pedidos que tiveram itens entregues, mas outros não, mas ainda estão dentro do prazo. Por fim, o status ''EM ATRASO'' é atribuído para os mapas que não tiveram todos os seus itens entregues e que a data de entrega já passou. * **RN03** - São aceitos apenas empenhos cadastrados ou importados para o SIPAC. * **RN04** - O empenho deve ser da natureza de despesa de material de consumo (339030). * **RN05** - É permitido selecionar mais de um empenho desde que tenham sido emitidos para um mesmo fornecedor. * **RN06** - Não é permitido incluir empenhos que já tiveram todos os itens incluídos em outro mapa de pedido. Para esse caso, o sistema deve exibir a seguinte mensagem: "O empenho número X não pode ser incluído pois todos os seus itens, com suas respectivas quantidades, já foram entregues ou foram incluídos em outro mapa de pedidos.". * **RN07** - O sistema permite informar a quantidade e inserir vários ou todos os itens de uma vez. * **RN08** - Quantidade solicitada para entrega na data informada. A quantidade deve permitir casas decimais para os casos de alimentação e combustíveis. O campo deve sugerir o saldo de quantidade do material e não pode ser superior ao saldo. * **RN09** - Só é permitido estornar mapa de pedido cujo status seja ''AGUARDANDO ENTREGA'' ou ''EM ATRASO'', desde que nenhum item tenha sido recebido. * **RN10** - Não é permitido remover itens recebidos. * **RN11** - Não é permitido alterar mapa de pedido cujo status seja ''FINALIZADO'' ou ''ESTORNADO''. * **RN12** - Não é permitido registrar recebimento de itens de mapas com status ''FINALIZADO'' ou ''ESTORNADO''. * **RN13** - Após o cadastro do pedido, alteração, estorno ou finalização um email é enviado ao fornecedor com o seguinte texto: Prezado #NOME_DO_FORNECEDOR#, O mapa de pedido de material nº #NUMERO_ANO_MAPA#, associado ao(s) empenho(s) #LISTA_DE_EMPENHO_DO_MAPA# foi #OPERACAO#. Acesse o SIPAC para consultar as informações desse Mapa de pedido. ==== Resoluções/Legislações Associadas ==== Não se aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela ^ | br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedido.java | almoxarifado.mapa_pedido | | br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedidoEmpenho.java | almoxarifado.mapa_pedido_empenho | | br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedidoEmpenhoItens.java | almoxarifado.mapa_pedido_empenho_itens | ====== Plano de Teste ====== Sistema: Sipac Módulo: Almoxarifado Links: Sipac -> Almoxarifado -> Estoque -> Gerenciar Mapa de Pedido de Material Usuário: genibaldo Papel que usuário deve ter: SipacPapeis.GESTOR_ALMOXARIFADO e SipacPapeis.GESTOR_GERAL_DE_ALMOXARIFADO ou SipacPapeis.AUDITOR ===== Cenários de Teste ===== Usuario: genibaldo 1 - Cadastrar ao menos três solicitações de material em registro de preço; Usuário: joice 2 - Registrar empenho associado a SM com a natureza de despesa de material de consumo(339030). repetir o processo e lembrar de manter o mesmo fornecedor; 3 - Registrar empenho associado a SM com a natureza de despesa de material de consumo(339030), mas OUTRO fornecedor; 4 - Registrar um empenho do tipo outros com outra natureza de despesa que NÃO seja material de consumo (339030); Usuário: genibaldo 5 - Cadastrar um mapa de pedido informando um número de empenho não cadastrado ou migrado para o SIPAC; Comportamento esperado: exibir uma mensagem informando que o empenho não está cadastrado. (TESTE RN03) 6 - Cadastrar um mapa de pedido informando o empenho do item 2 e depois inserir o empenho do item 4. Comportamento esperado: Exibir uma mensagem informando que o empenho não é da natureza de despesa de material de consumo(339030); (Testes da RN04) 7 - Cadastrar um mapa de pedido informando o empenho do item 2 e depois inserir o empenho do item 3. Comportamento esperado: Exibir uma mensagem informando que os empenhos não são do mesmo fornecedor;(Testes da RN05) 8 - Cadastrar um mapa de pedido com os empenhos do item 2. Comportamento esperado: sucesso;(TESTE RN05) 9 - No cadastro do mapa tentar inserir mais de um item por vez; (TESTE da RN07) 10 - Informar uma quantidade com valores decimais; (TESTE RN08) 11 - Informar uma quantidade superior ao saldo; (TESTE RN08) ===== Dados para o Teste ===== Não se aplica.