====== Orçamento de Convênio ======

O orçamento pode ser realizado de duas maneiras distintas, por convênio ou sem convênio. Para poder selecionar um convênio é preciso ter o papel de EXECUTOR_CONVENIO. Quando um convênio é selecionado, influenciará em todas as operações realizadas no SCO (Sistema de Controle Orçamentário), de maneira tal que todas as consultas a base de dados irão levar em consideração o convênio, a célula orçamentária poderá está associada a um convênio ou não. Podendo assim  existir duas células orçamentárias com as mesmas características (Programa de Trabalho Resumido, Natureza da Despesa, Fonte de Recurso, Esfera, Plano Interno e Ano Orçamentário) sendo diferenciadas apenas pelo existência ou não do convênio. 

Para realizar a seleção de um convênio o usuário deverá acessar o link SCO -> Configurações -> Executar Orçamento de Convênio, existe uma caixa de texto onde é possível selecionar o Convênio desejado digitando uma seqüência de caracteres contidas no nome da Unidade do Convênio ou o código da Unidade do Convênio. Por exemplo, se digitarmos “cap”, serão listados todos os convênios que possuem em seu nome de unidade a seqüência de caracteres, ou ainda se digitarmos 8244, que é o código da unidade do Convênio CONVÊNIO CAPES PROAP. Caso não seja setado nenhum convênio a unidade gestora das operações será a unidade gestora do usuário logado, havendo um convênio selecionado a gestora será a unidade do convênio.

===== Unidade X Execução Orçamentária =====

Toda a execução orçamentária é feita considerando as células orçamentárias, onde cada célula é vinculada a uma unidade.

Existem duas categorizações para as unidades no contexto orçamentário, que são uma unidade ser gestora ou centro de custo.

  * **Unidade Gestora**: uma unidade é denominada de gestora se for investida do poder de gerir recursos orçamentários e financeiros, próprios ou sob descentralização. O seu controle orçamentário pode ser feito apenas no âmbito do sistema do governo SIAFI.
  * **Centro de Custo**: um centro de custo é uma unidade vinculada à uma unidade gestora para a qual se deseja controlar o orçamento. As unidades denominadas de centro de custo não tem o orçamento controlado pelo sistema SIAFI, já que este sistema só trata da gestora como um todo.

No contexto organizacional da UFRN, pode ser feita uma análise em cima do diagrama abaixo. As unidades marcadas em amarelo (UFRN, Centros Acadêmicos, Hospitals Univesitários) elas são  gestoras no SIAFI, ou seja, tem todo o orçamento gerenciado no âmbito do governo federal. 

{{:desenvolvimento:especificacoes:sipac:orcamentario:visaoorcamento.jpg|}}

No âmbito da instituição UFRN, é necessário controlar também o orçamento por unidades subordinadas às gestoras, que podem ser os próprios setores da universidade ou também, controlar a movimentação de orçamento de unidades que representa por exemplo, a gerência dos contratos da instituição. Estas unidades são denominadas de centro de custo. 

Existe uma gestora principal (UFRN) e um conjunto de outras gestoras vinculadas à ela (Centros Acadêmicos e Hospitais Universitários). A dotação do orçamento é feita na UFRN e em seguida, é feita uma distribuição de dotação para as gestoras vinculadas à ela. Dessa forma, cada gestora vai poder gerenciar o orçamento atribuído a ele, podendo até distribuir parte deste orçamento para os seus centros de custo. 

Com esta organização, no módulo orçamentário do SIPAC, é possível gerenciar o orçamento na visão da gestora e dos seus centros de custo. Entendido o conceito de unidade no âmbito orçamentário é importante ressaltar que na execução orçamentária com convênio as unidades vinculadas as unidades gestoras serão as [[desenvolvimento:especificacoes:sipac:convenios:negocio|unidades interessadas no convênio]].


===== Modelagem do Processo de Negócio de Termo de Cooperação=====

Modelagem de negócio relacionada a distribiuição do orçamento de Termo de Cooperação oriundo vindos de recursos da CAPES/PROAP.

{{:desenvolvimento:especificacoes:sipac:orcamentario:bpmn_orcamento_convenio.png|}}

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

Existem dois cenários que podem ser testados:

**1. Orçamento com Convênio:**

Para entender como selecionar um convênio veja a seção Cenário de Teste em [[desenvolvimento:especificacoes:sipac:orcamentario:orcamento_convenio  | Orçamento de Convênio]].


**2. Orçamento sem Convênio:**

Para executar Orçamento sem Convênio basta que não seja selecionado nenhum convênio. 
===== Dados para o Teste =====

  *  Consulta que retorna todos os convênios

<code sql>
    select u.codigo_unidade, u.nome from convenios.convenio c
        join comum.unidade u on (c.id_unidade_convenio = u.id_unidade)
    where u.categoria = 4 and u.unidade_orcamentaria = true
</code> 

  *  Consulta que retorna todas as unidade interessadas em um convênio:

<code sql>
  select u.* from convenios.convenio c
  join convenios.unidade_interessada ui on (c.id = ui.id_convenio)    
  join comum.unidade u on (u.id_unidade = ui.id_unidade)       
  where c.id_unidade_convenio = (select id_unidade from comum.unidade where codigo_unidade = <codigoUnidade> )
</code>

  *  Consulta que retorna todas as células orçamentárias de um determinado convênio para um determinado ano:
<code sql>
  select * from sco.celula_orcamentaria where ano = <anoOrcamentario> and id_convenio = 
    (select c.id from convenios.convenio c join comum.unidade u on (c.id_unidade_convenio = u.id_unidade) where u.codigo_unidade = <codigoUnidadeConvenio>)
</code>


  *  Consulta que retorna todas as informações acima por ano
<code sql>
    select u.codigo_unidade, * 
  from sco.celula_orcamentaria s
  join convenios.convenio co on (co.id = s.id_convenio) 
  join comum.unidade u on (u.id_unidade = co.id_unidade_convenio)
  WHERE s.ano =  <anoOrcamentario> 
</code>