====== Empenhos Emitidos ====== Esta função permite ao usuário gerar um relatório dos empenhos emitidos por período. O usuário pode extrair as informações por Empenho/ano, Requisição/ano, Tipo Requisição, Período, Modalidade, Gestor de Empenho, Credor, Natureza da Despesa, Fonte de Recurso, Plano Interno, PTRES, Empenhos Liquidados, Empenhos Pagos e Orçamento. Pré-condição: Para acessar esta funcionalidade necessita ser usuário do portal do administrativo. ===== Descrição do Caso de Uso ===== Este caso de uso inicia-se quando o usuário acessa a opção SIPAC -> Orçamento -> Empenhos Emitidos ([[#principais_regras_de_negocio|RN03]]) A consulta disponibiliza as seguintee opções de filtragem: * ** Empenho/Ano **: Formato - 9.../AAAA, Tipo NUMÉRICO. ([[#principais_regras_de_negocio|RN01]]) * ** Requisição/Ano **: Formato - 9.../AAAA, Tipo NUMÉRICO. ([[#principais_regras_de_negocio|RN02]]) * ** Tipo Requisição **: Tipo - TEXTO . ([[#principais_regras_de_negocio|RN02]]) * ** Período do Empenho* **: Tipo - DATA. Formato - DD/MM/AAAA - DD/MM/AAAA * ** Período da Requisição **: Tipo - DATA. Formato - DD/MM/AAAA - DD/MM/AAAA ([[#principais_regras_de_negocio|RN09]]) * ** Modalidade **: Tipo - TEXTO. * ** Unidade **: Tipo - TEXTO. ([[#principais_regras_de_negocio|RN08]]) * Opção de Mostrar unidades desativadas. * **Incluir Unidades/Centros de Custo Vinculados** Habilitado se a unidade for selecionada pelo o usuário. ([[#principais_regras_de_negocio|RN08]]) * ** Credor **: Tipo - TEXTO. * ** Natureza da Despesa **: Tipo - TEXTO. * ** Fonte de Recurso **: Tipo - TEXTO. * ** Plano Interno **: Tipo - TEXTO. * ** PTRES **: Tipo - TEXTO. * ** Empenhos Liquidados **: Tipo - SIM/NÃO. * ** Empenhos Pagos **: Tipo - SIM/NÃO. * **Orçamento Oficial** * **Orçamento Negociado**: Corresponde ao orçamento que uma unidade pede emprestado a outra no Orçamento Oficial para repor na próxima execução orçamentária; * **Orçamento Oficial e Negociado**: retorna os registros oficiais e negociados. Então são exibidos os empenhos em forma de listagem, com os seguintes campos: ***Empenho:** Tipo TEXTO. ***PTRES:** Tipo TEXTO. ***Valor:** Tipo NUMÉRICO. ***Valor Reforçado:** Tipo NUMÉRICO. ***Valor Anulado:** Tipo NUMÉRICO. ***Valor Total:** Tipo NUMÉRICO. ***Valor Cancelado:** Tipo NUMÉRICO. ***Saldo:** Tipo NUMÉRICO. ***Modalidade:** Tipo TEXTO. ***Data:** Tipo - DATA. ***Credor:** Tipo TEXTO. ***Observação:** Tipo TEXTO. Sistema gera relatório com resultado da consulta, conforme modelo: ([[#principais_regras_de_negócio|RN04, RN05, RN06, RN07]]) === Modelo de Relatório === **RELATÓRIO DE EMPENHOS EMITIDOS** **__Unidade Gestora__:** Formato - UNIDADE GESTORA(CÓDIGO), tipo TEXTO. **__Unidade__:** UNIDADE **__Credor__:** NOME CREDOR **__Elemento__:** NOME ELEMENTO **__Período__:** Formato - DD/MM/AAAA a DD/MM/AAAA, tipo - DATA. **P.T.:**Plano de Trabalho **F.R.:** Fonte de Recurso **E.D:** Natureza de Despesa **Es.:** Esfera **P.I.:** Plano Interno ^ Empenho^P.T.Res. / F.R. / N.D. / Es. / P.I. ^ Valor ^ Valor Reforçado ^ Valor Anulado ^ Valor Total ^ Valor Cancelado ^Saldo ^ |9.../AAAA - UNIDADE GESTORA| P.T.Res.:9999 / F.R.:99999999 / E.D.:999999 / Es.:999 / P.I.:999999999| R$ 99.99 | R$ 99.99 | R$ 99.99| R$ 99.99| R$ 99.99|R$ 99.99| |**Modalidade**: MODALIDADE|||||||| |**Data**: DD/MM/AAAA|||||||| |**Credor**: NOME CREDOR - DOCUMENTO|||||||| |**Observação**: 9999 - ATENDER DESPESAS COM DIARIAS INTERNACIONAIS |||||||| |**Reforços do Empenho**: NÚMERO (DD/MM/AAAA) - Valor ou **Anulações do Empenho:** NÚMERO (DD/MM/AAAA) - Valor ou **Cancelamentos do Empenho:** NÚMERO (DD/MM/AAAA) - Valor|||||||| | |||||||| |9.../AAAA - UNIDADE GESTORA| P.T.Res.:9999 / F.R.:99999999 / E.D.:999999 / Es.:999 / P.I.:999999999| R$ 99.99 | R$ 99.99 | R$ 99.99| R$ 99.99| R$ 99.99|R$ 99.99| |**Modalidade**: MODALIDADE|||||||| |**Data**: DD/MM/AAAA|||||||| |**Credor**: NOME CREDOR - DOCUMENTO|||||||| |**Observação**: 9999 - ATENDER DESPESAS COM DIARIAS INTERNACIONAIS |||||||| |**Reforços do Empenho**: NÚMERO (DD/MM/AAAA) - Valor ou **Anulações do Empenho:** NÚMERO (DD/MM/AAAA) - Valor ou **Cancelamentos do Empenho:** NÚMERO (DD/MM/AAAA) - Valor|||||||| | **Total**||R$99,99|R$99,99|R$99,99|R$99,99|R$99,99|R$99,99| Sistema possibilita visualizar o [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:consultas:empenho:empenho|detalhamento do empenho]]. **Valor Total =** Valor + Valor Reforcado - Valor Anulado. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== ***RN01** - Ao selecionar a busca pelo empenho/ano, as outras opções serão desabilitadas. ***RN02** - Ao selecionar a busca pela requisição/ano, o tipo também deve ser informado. ***RN03** - Quando acessado pelo portal administrativo não é considerado o ano orçamentário. Caso seja acessado pelo módulo de orçamento o sistema deve considerar o ano orçamentário. * **RN04**- Os empenhos apresentados no relatório não devem possuir registro de estorno associados. Caso não tenha sido selecionado um convênio junto ao módulo orçamentário é levado em consideração o orçamento próprio. Não são apresentados os valores de saldo para empenhos ordinários. * **RN05** - É desconsiderado convênio e a gestora do empenho. * **RN06** - Não são considerados empenhos ou subempenhos associados a estorno. * **RN07** - Se a consulta retornar mais de 2000 registros, será apresentada uma mensagem de erro solicitando ao usuário refinar mais a consulta de forma que seja possível exibir o relatório. * **RN08** - O sistema deve exibir quando o caso de uso for acessado pelo módulo orçamentário. * **RN09** - Ao selecionar o período da requisição o usuário deve informar o tipo da requisição. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | |br.ufrn.sipac.cadastro.dominio.Pessoa| comum.pessoa| |br.ufrn.sipac.cadastro.dominio.Unidade| comum.unidade | |br.ufrn.sipac.orcamento.dominio.ProgramaTrabalhoResumido| sco.programa_trabalho_resumido| |br.ufrn.sipac.orcamento.jsf.OrcamentoMBean| | |br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho| sco.empenho| |br.ufrn.sipac.orcamento.movimentacoes.dominio.EventoEmpenho| sco.evento_empenho| |br.ufrn.sipac.orcamento.movimentacoes.dominio.ModalidadeEmpenho| | |br.ufrn.sipac.orcamento.dominio.CelulaOrcamentaria | administrativo.sco.celula_orcamentaria | |br.ufrn.sipac.orcamento.dominio.Esfera | administrativo.sco.esfera | |br.ufrn.sipac.orcamento.dominio.FonteRecurso | administrativo.sco.fonte_recurso | |br.ufrn.sipac.orcamento.dominio.ElementoDespesa | administrativo.sco.elemento_despesa | |br.ufrn.sipac.orcamento.dominio.PlanoInterno | administrativo.sco.plano_interno | |br.ufrn.sipac.orcamento.dominio.ProgramaTrabalho | administrativo.sco.programa_trabalho | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Orçamento Link(s): Orçamento → Empenhos Emitidos. Usuário: carvalho (Portal Administrativo), joice (módulo orçamentário) ===== Cenários de Teste ===== * Pode-se consultar empenhos emitidos através do caso de uso //** SIPAC → Orçamento→ Orçamento → Empenhos Emitidos**// ===== Dados para o Teste ===== Não se aplica.