~~ODT~~

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

====== Alocação para Centros de Custo ======

A operação de Alocação de Centros de Custo é uma operação para distribuição do orçamento da unidade gestora em que se está executando, para os [[desenvolvimento:especificacoes:sipac:orcamentario:negocio#unidade_x_execução_orçamentária | Centros de Custo]] subordinados a ela. Os SEOs (Setor de Execução Orçamentária) são os responsáveis por utilizar está funcionalidade. O Executor do Orçamento Global também poderá realizar está operação.

Pré-condições:
  * O usuário deve ter perfil de Executor de Orçamento Global ou Local para executar esta funcionalidade.
  * Para efetuar a operação de alocação de centro de custo, a UG (Unidade Gestora), o Programa de Trabalho Resumido (PTRes), a Natureza da Despesa, a Fonte de Recurso, a Esfera e o Plano Interno (PI) devem ter sido cadastrados no sistema;


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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Orçamento → Aba Movimentações → Movimentações Orçamentárias → Centros de Custo -> Alocação para Centros de Custo//. 

===Passo 1===

O caso de uso inicia exibindo as seguintes informações:
  * __**Ano Orçamentário:**__ Formato - AAAA, Tipo - NUMÉRICO.  ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo#principais_regras_de_negócio |RN01]])
  * __**Gestora:**__ Tipo - TEXTO. A gestora corresponde a unidade de movimentação do orçamento.

Sistema solicita os dados da transferência:
  * **Número do Documento***: Formato - 999999999, Tipo - NUMÉRICO.
       *Opção //Gerar Automaticamente//: Tipo - LÓGICO. Se esta opção for desmarcada (a padrão vem marcada),o sistema solicita para o usuário informar o número, preenchido com o número da Nota de Dotação (ND) realizada no SIAFI. Caso contrário, o número é gerado pelo sistema.
  * **Data***: Formato - DD/MM/AAAA, Tipo - DATA.
  * ** Se é negociação de orçamento**: Tipo - LÓGICO. Indica se a movimentação orçamentária partiu de uma negociação de orçamento de exercício anterior. São apresentadas as opções ''SIM'' e ''NÃO'' para seleção do gestor.
  * ** Se é processo de outra instituição**: Tipo - LÓGICO. São apresentadas as opções ''SIM'' ou ''NÃO''.  ([[#principais_regras_de_negócio |RN02 e RN19]])
  * **Processo**: TIPO - NUMÉRICO, FORMATO - 99999.999999/9999-99, Entrada de Dados: (radical.número/ano-dv). ([[#principais_regras_de_negócio| RN18 ]])
    * Se o processo não for de outra instituição o número é validado e é exibido o **__assunto__**. No campo **__assunto__**, o sistema deverá apresentar: Solicitação de Pagamento - Valor: Tipo - NUMÉRICO.
  * **Valor***: Tipo - NUMÉRICO. ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo#principais_regras_de_negócio |RN05]]) 
  * **Dotação Automática**: Tipo - LÓGICO. Marcando a opção //Dotação Automática// a operação dotará orçamento para a célula de origem, antes de realizar a transferência de orçamento entre as células de origem e destino. ([[#Principais Regras de Negócio|RN20]])
da célula origem:
  * **Unidade***: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: NOME ou CÓDIGO DA UNIDADE.([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo#principais_regras_de_negócio |RN03, RN06, RN17]])
  * **Programa de Trabalho Resumido***: Formato - NOME DO PROGRAMA DE TRABALHO (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: NOME ou CÓDIGO DO PTRes.
  * **Natureza da Despesa***: Formato - NOME DA NATUREZA DE DESPESA (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: DENOMINAÇÃO ou CÓDIGO DA NATUREZA. ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo#principais_regras_de_negócio |RN08]])
  * **Fonte de Recurso***: Formato - NOME DA FONTE DE RECURSO (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: DENOMINAÇÃO ou CÓDIGO DO RECURSO.
  * **Esfera***: Formato - NOME DA ESFERA (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: NOME ou CÓDIGO DA ESFERA.
  * **Plano Interno**: Formato - NOME DO PLANO INTERNO (CÓDIGO), Tipo - AUTOCOMPLETE, entrada de dados: NOME ou CÓDIGO DO PI.

da célula de destino:
  * **Unidade***: Caso o usuário contenha o papel de Executor de Orçamento Global, o sistema mostra todas as unidades, independente de hierarquia, e critica se a selecionada for gestora. Para os demais papéis, o sistema mostra apenas centros de custos subordinados a gestora do usuário logado. ([[#principais_regras_de_negócio |RN07, RN17]])
  * Sistema exibe opção para copiar os dados informados na célula de origem.
  * **Programa de Trabalho Resumido***.
  * **Natureza da Despesa***.  ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo#principais_regras_de_negócio |RN08]])
  * **Fonte de Recurso***.
  * **Esfera***.
  * **Plano Interno**.

da célula de origem e destino:
  * **Observações**: Tipo - TEXTO.


O usuário adiciona uma ou mais movimentações preenchidas na lista utilizando opção "inserir movimentação".

O sistema exibe a lista de movimentações inseridas com os dados da célula de origem e destino (Unidade, PTRes, Natureza de Despesa, Fonte de Recurso, Esfera, Plano Interno e Observações) podendo alterar, remover ou criar uma nova transferência utilizando dados anteriores.

O usuário confirma transferências adicionadas e o sistema realiza as transações orçamentárias transferindo o orçamento da celula de origem para a de destino exibindo confirmação no Passo 2. [[#Principais Regras de Negócio| RN04, RN09, RN10, RN11, RN12, RN13, RN14, RN15, RN16 ]]) 



===Passo 2===

O sistema exibe as transferências realizadas com as informações:

  * __**Nº do Documento**__: Tipo - NUMÉRICO.
  * __**Valor**__: Tipo - NUMÉRICO.
  * __**Data**__: Formato - DD/MM/AAAA, Tipo - DATA.
  * __**Movimentador**__: Formato - (CÓDIGO) - NOME DO MOVIMENTADOR (LOGIN), Tipo - TEXTO. Sistema apresenta opção e exibe os atributos **__Login__**, **__Nome__**,  **__Unidade__**, **__Email__**, **__Telefone__** e **__Ramal__** associados ao movimentador.
  * __**Tipo**__: Tipo - TEXTO. Refere-se ao ao tipo de ação realizada, por exemplo, a //Distribuição de Dotação Orçamentária.//
  * __**Processo**__: Formato - NUMÉRO DO PROCESSO/AAAA (INSTITUIÇÃO), Tipo - NUMÉRICO.
  * __**Observações**__: Tipo - TEXTO.


  * __**Célula de Origem**__: Tipo - NUMÉRICO.
  * __**Célula de Destino**__: Tipo - NUMÉRICO.
  
  *Os dados abaixo serão exibidos para a célula origem e destino:
     * __**Unidade**__: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO.
     * __**Programa de Trabalho Resumido**__: Formato - NOME DO PTRES(CÓDIGO), Tipo - TEXTO.
     * __**Natureza da Despesa**__: Formato - NOME DA NATUREZA DE DESPESA (CÓDIGO), Tipo - TEXTO.
     * __**Fonte de Recurso**__: Formato - NOME DA FONTE DO RECURSO (CÓDIGO), Tipo - TEXTO.
     * __**Esfera**__: Formato - NOME DA ESFERA (CÓDIGO), Tipo - TEXTO.
     * __**Plano Interno**__: Formato - NOME DO PI (CÓDIGO), Tipo - TEXTO.  
     * __**Convênio**__: Tipo - TEXTO.

Após a geração da transferência será gerado uma movimentação orçamentária de débito para célula de origem e uma movimentação de crédito para a célula de destino; 

O sistema envia email para os envolvidos informando que houve um crédito ou um débito na unidade.

O caso de uso é finalizado. ([[#Principais Regras de Negócio|RN21, RN22]])


===== Layout do email =====

Assunto:  movimentação orçamentária de <débito ou crédito> realizada

Prezado(a) Sr(a). <nome do usuário>,

 

A seguinte movimentação orçamentária, associada a unidade <Nome da Unidade(código)>, foi registrada no Sistema de Controle Orçamentário do SIPAC como um <crédito ou débito>. 

 

Data: dd/mm/aaaa

Movimentação: <nome da movimentação>

Documento: <número do documento>

Ano Orçamentário: <ano>

Valor: <numérico>

Usuário: <nome do usuário(login)>




SIPAC - Sistema Integrado de Patrimônio, Administração e Contratos

ESTA MENSAGEM FOI ENVIADA AUTOMÁTICAMENTE PELO SISTEMA. POR FAVOR,NÃO RESPONDER ESTA MENSAGEM.

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

As seguintes regras devem ser satisfeitas para que uma Alocação de Centros de Custo seja realizada:

  * **RN01** - O ano orçamentário das células orçamentárias devem ser iguais;
  * **RN02** - Caso a opção Processo de Outra Instituição seja selecionada, o processo não será validado, ou seja, não irá verificar se está cadastrado na base do Protocolo;
  * **RN03** - Quando a Unidade Gestora for a Unidade de Direito Global, no caso da UFRN a própria, será possível selecionar qualquer unidade na Unidade de Origem;
  * **RN04** - Não poderá ser realizada uma Alocação de Centros de Custo de uma célula para ela mesma;
  * **RN05** - O valor deverá ser maior que zero;
  * **RN06** - A unidade da célula de origem deverá ser a unidade gestora do usuário logado, caso a Unidade Gestora não seja a Unidade de Direito Global;
  * **RN07** - <del>A unidade da célula de destino deverá ser uma unidade subordinada a unidade gestora do usuário, caso a Unidade Gestora não seja a Unidade de Direito Global e não ser uma unidade gestora;</del>
  * **RN08** - A Natureza de Despesa da célula de origem e destino devem ser iguais, com a exceção de quando a Natureza de Despesa de uma das células forem de CUSTEIO;
  * **RN09** - Total Transferido não poderá ser atualizado para um valor negativo;
  * **RN10** - Total Distribuído não poderá ser atualizado para um valor negativo;
  * **RN11** - [[desenvolvimento:especificacoes:sipac:orcamentario:configuracoes_de_orcamento | Verificação de Saldo Negativo]], verificar regras de negócio;
  * **RN12** - Se for [[desenvolvimento:especificacoes:sipac:orcamentario:orcamento_convenio |Execução de Convênio]] as unidades das células serão as unidades interessadas no convênio.
  * **RN13** - O **Total Transferido** da célula de origem será adicionado com o valor da transferência;
  * **RN14** - O **Saldo** da célula de origem será subtraído com o valor da transferência;
  * **RN15** - O **Total Distribuído** da célula de destino será adicionado com o valor da transferência;
  * **RN16** - O **Saldo** da célula de destino será adicionado com o valor da transferência;
  * **RN17** - Caso o usuário seja  um Executor do Orçamento Global:
          -  Será possível selecionar qualquer unidade, sendo Beneficiada em um convênio ou não, ou seja quaisquer unidade;
          -  Caso seja feito uma Alocação de Centro de Custo de uma Unidade não Beneficiada no Convênio para uma Beneficiada, deverá ser criado uma célula sem convênio na origem e uma célula de convênio no destino;
  * **RN18** - De acordo com o parâmetro UTILIZA_PROTOCOLO_SIPAC será apresentado duas formas de entrada de dados para o campo **Processo**:
    * Caso o valor esteja configurado como true, será disponibilizado para o usuário 4 campos de entradas que representam a formatação completa do processo. (RADICAL.NÚMERO/ANO-DV)
    * Caso o valor esteja configurado como false, será disponibilizado apenas um campo onde será informado pelo usuário o processo através de uma máscara a qual forçará o usuário seguir o padrão da formatação completa do processo. (radical.número/ano-dv)
  * **RN19** - Se o parâmetro UTILIZA_PROTOCOLO_SIPAC estiver configurado como false o campo **Se é processo de outra instituição** não será exibido.
  * **RN20** - Caso a unidade de origem informada seja uma gestora, o campo DOTAÇÃO AUTOMÁTICA será exibido.
  *<del> **RN21** - Os responsáveis das unidades movimentadas serão notificados via email.</del>
  ***RN21** - Ao realizar movimentações orçamentárias no módulo orçamentário, automaticamente é gerado um email para o responsável da unidade para as operações de crédito e débito. Esta operação funciona com base nos parâmetros ENVIA_EMAIL_POR_MOVIMENTACAO_ORCAMENTARIA que permite a instituição configurar se serão gerados os emails após as movimentações orçamentarias e MOVIMENTACOES_ORCAMENTARIAS_ENVIAR_EMAIL que identifica quais as movimentações lançarão emails. Os parâmetros deverão estar configurados como true.(Adicionado em 08/07/2011 referente à tarefa 64945).
  * **RN07** - A unidade da célula de destino para a operação não deverá ser uma unidade gestora.
  * **RN22** - Para unidades do tipo CONVÊNIO, só é permitido realizar a alocação quando a mesma for associada a um projeto (Utilizar caso de uso para associar a unidade interessada ao projeto no caso de uso orçamento -> aba configurações  -> associar projeto a centro de custo). (Adicionada em 14/08/2012)



==== Resoluções/Legislações Associadas ====

Não se Aplica. 

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

^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.Transferencia | administrativo.sco.transferencia |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.MovimentacaoOrcamentaria | administrativo.sco.movimentacao_orcamentaria |

===== Plano de Teste =====

Sistema: SIPAC

Módulo: Orçamento

Link(s): Orçamento -> Movimentações -> Movimentações Orçamentárias -> Centros de Custos -> Alocação de Centros de Custo

Usuário: 
  * seomejc (ScoPapeis.EXECUTOR_ORCAMENTO)
  * larrubia2 (ScoPapeis.EXECUTOR_ORCAMENTO_GLOBAL)

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



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

Existem dois cenários que podem ser testados: 

**1. Orçamento de 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:** 

Sem Orçamento de Convênio basta que não seja selecionado nenhum convênio.

A diferença nestes dois testes serão nas unidades das células, quando a execução for de Convênio as unidades disponíveis para seleção serão as unidades interessadas no convênio e quando não for Execução de Convênio serão unidades gestoras e subunidades da unidade gestora do usuário logado.

Para analisar os resultados tanto de orçamento de convênio como sem convênio os seguintes relatórios estão disponíveis:

  * Orçamento -> Relatórios -> Movimentações Orçamentárias  -> Movimentação Orçamentária por Unidade
     * Selecione Apenas a Operação de: **Transferência**
 
  * Orçamento -> Relatórios -> Saldos  -> Saldo Orçamentário por Unidade
    * Selecione a unidade. Após realizar esta operação o saldo da célula de origem deverá ter sido subtraído.

===== Dados para o Teste =====

As informações das células orçamentárias poderão ser consultadas nos links:
  * Programa de Trabalho: Orçamento -> Cadastros -> Programa de Trabalho Resumido -> Listar/Alterar
  * Natureza da Despesa: Orçamento -> Cadastros -> Natureza da Despesa -> Listar/Alterar 
  * Fonte de Recurso: Orçamento -> Cadastros -> Fonte de Recurso -> Listar/Alterar
  * Esfera: Orçamento -> Cadastros -> Esfera -> Listar/Alterar
  * Plano Interno: Orçamento -> Cadastros -> Plano Interno -> Listar/Alterar


  *  Para visualizar os convênios utilizar a seguinte consulta:
<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 traz todos as unidade subordinadas de uma determinada gestora:
<code sql>
    select * from unidade where hierarquia like '%.' ||(select id_unidade from unidade where codigo_unidade = <codigoUnidade>)||'.%' and unidade_orcamentaria = true   </code>

  * Consulta que traz todos as unidade gestoras:
<code sql>
    select * from comum.unidade where categoria = 1 and tipo = 2 and unidade_orcamentaria = true
</code>


  * Consulta que traz todos os responsáveis da unidade de acordo com o id:

<code sql>
    SELECT DISTINCT RU.*, U.NOME AS NOME_UNIDADE,S.SIAPE AS MATRICULA,P.NOME AS NOME_SERVIDOR, P.ID_PESSOA AS ID_PESSOA, P.EMAIL AS EMAIL_PESSOA
    FROM COMUM.RESPONSAVEL_UNIDADE RU, COMUM.UNIDADE U,RH.SERVIDOR S,comum.PESSOA P
    WHERE S.ID_SERVIDOR = RU.ID_SERVIDOR AND S.ID_PESSOA = P.ID_PESSOA
    AND RU.ID_UNIDADE = ? AND U.ID_UNIDADE = RU.ID_UNIDADE AND RU.ID_REGISTRO_ENTRADA_EXCLUSAO IS NULL ORDER BY RU.DATA_FIM DESC,U.NOME ASC
</code>