~~ODT~~

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

====== Relatório de Saldo Resumido por Unidade ======

O caso de uso Saldo Orçamentário Resumido por Unidade, demonstra o saldo (total de dinheiro), saldo dos empenhos e total de uma determinada unidade e de suas filhas em um determinado ano orçamentário. O DCF (Departamento de Contabilidade e Finanças), os SEOs (Setor de Execução Orçamentária) e os Executores de Convênio utilizam este processo.


Pré-condições: 
   * Deve ter sido cadastradas as unidades orçamentárias;
   * Usuário deve ter perfil de EXECUTOR_ORCAMENTO, EXECUTOR_ORCAMENTO_GLOBAL ou EXECUTOR_CONVENIO.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Orçamento → Aba Relatórios → Saldos → Saldo Resumido por Unidade//.

O Gestor informa a unidade, e o sistema exibe lista com Saldo Orçamentário Resumido por Unidade, no formato padrão, caso não tenha sido selecionada a opção **formato impressão**. Os atributos exibidos são: ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN01]]), ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN02]]),
([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN03]]), ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN04]]), ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN05]]), ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN06]]), ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:relatorios:saldos:saldo_resumido_por_unidade#principais_regras_de_negócio|RN07]])

   * **Unidade:** Tipo - TEXTO.
   * **Saldo:** Tipo - NUMÉRICO.
   * **Saldo dos Empenhos:** Tipo - NUMÉRICO.
   * **Total:** Tipo - NUMÉRICO.

O Gestor informa a unidade e sistema gera relatório, conforme o modelo, caso tenha sido selecionada a opção **Formato Impressão**:

**SALDO ORÇAMENTÁRIO RESUMIDO POR UNIDADE**

**__Unidade:__** Tipo - TEXTO

^Unidade ^Saldo ^Saldo dos Empenhos ^Total ^
|NOME DA UNIDADE (99.99) | 99,99 | 99,99 | 99,99 |
|------ | ------ | ------ | ------ |
|------ | ------ | ------ | ------ |
|**Totais** | **99,99** | **99,99** | **99,99** |

Caso a opção de **gerar o gráfico** tenha sido selecionada, é exibido também um gráfico comparativo do //saldo// entre as //unidades//.

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

  ***RN01** - O relatório deve exibir somente as movimentações referentes ao ano orçamentário configurado no sistema;
  ***RN02** - O relatório deve exibir somente os saldos orçamentários referentes a unidade gestora e filhas;
  ***RN03** - As unidades do relatório devem ser exibidas em ordem alfabética.

Se o relatório não for emitido no ambiente (módulo) orçamentário(exemplo: Portal Administrativo):

  ***RN04** - Será exibido ao usuário uma lista com as unidades que o usuário tem responsabilidade;
  ***RN05** - O convênio não deverá influenciar no resultado;
  ***RN06** - Apenas servidores que sejam responsáveis por unidades poderão emitir o relatório;
  ***RN07** - Caso o relatório não esteja sendo executado no ambiente orçamentário (Portal da Reitoria, Portal da Direção e Portal Auditoria), deve ser desconsiderado o convênio e a gestora do empenho.


 


 

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

^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.dominio.CelulaOrcamentaria |administrativo.sco.celula_orcamentaria |
|br.ufrn.info.sco.dominio.Esfera | administrativo.sco.esfera |
|br.ufrn.sipac.cadastro.dominio.Unidade | sistemas_comum.public.unidade |
|br.ufrn.sipac.convenios.dominio.Convenio | administrativo.convenios.convenio |
===== Plano de Teste =====

Sistema: SIPAC

Módulo: SCO

Link(s): SCO -> Relatórios -> Saldos -> Saldo Resumido por Unidade

Usuário: 

  * seocchla01: Executor do Orçamento Local
  * larrubia2: Executor do Orçamento Global
  * raiula: Executor de Convênio  

Papel que usuário deve ter: ScoPapeis.EXECUTOR_ORCAMENTO, ScoPapeis.EXECUTOR_ORCAMENTO_GLOBAL ou ScoPapeis.EXECUTOR_CONVENIO

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

Realizar operações que modifiquem o saldo das unidades (como por exemplo as operações em SCO -> Movimentações -> Movimentações Orçamentárias) e o saldo dos empenhos (como por exemplo as operações em SCO -> Movimentações -> Empenho) e verificar se as alterações se refletem no saldo das unidades.

Realizar testes também com [[desenvolvimento:especificacoes:sipac:orcamentario:orcamento_convenio|Convênios]].
===== Dados para o Teste =====

Utilizar um usuário que possua um dos papéis especificados acima. 

Para verificar se o relatório está correto é possível comparar o Saldo da Unidade do Saldo Resumido por Unidade com o Total da Unidade no Relatório SCO -> Relatórios -> Saldos -> Saldo Orçamentário por Unidade. Em ambos os relatórios é necessário que se escolha a mesma unidade. Porém, no segundo relatório será necessário informar apenas a unidade e nenhum dos outros parâmetros.

 * Consulta que traz todos as unidade subordinadas de uma determinada gestora:

<code sql>
select * from unidade u join unidade uorg on (u.id_unid_resp_org = uorg.id_unidade) 
         where u.hierarquia like '%.' ||(select id_unidade from unidade where codigo_unidade = ?)||'.%' and u.unidade_orcamentaria = true, 
</code>

onde ? é o código da gestora que se deseja a lista da unidades subordinadas.