====== Alocação de Custeio ======

A operação de Alocação de Custeio segue o mesmo principio da transferência [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:movimentacoes_orcamentarias:centros_de_custos:alocacao_para_centros_de_custo| Alocação de Centro de Custo]], tendo a particularidade que os dados da célula de destino: Programa de Trabalho Resumido, Natureza de Despesa e Fonte de Recurso já virão preenchidos com os dados de Custeio.
 

A operação de Alocação de Centros de Custo irá impactar nos seguintes dados da célula orçamentária:

| ^Total Transferido^Total Distribuido^  Saldo  | 
|^Célula Origem |  Adicionado  |  -  |  Subtraido  |
|^Célula Destino |  -  |  Adicionado  |  Adicionado  |

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

Para realizar o remanejamento é necessário informar se a geração do número do documento será automática ou manual. Caso escolha como manual, será necessário informar o número do documento. A data e o valor são obrigatórios. O processo só deverá ser informado se existir algum associado a transferência que está sendo realizada; caso seja informado o número do processo existente, logo após o preenchimento do ano do processo, aparecerá a descrição do mesmo. O item Negociação de Orçamento Indica se a movimentação orçamentária partiu de uma negociação de orçamento de exercício anterior. Por exemplo, se no ano orçamentário anterior um centro de custo não for utilizar seu orçamento todo, existe a possibilidade de negociar este orçamento com outro centro de custo. Ou seja, este segundo centro de custo utilizaria este orçamento no exercício anterior e no próximo exercício o primeiro centro de custo receberia um orçamento referente a esta negociação.

A partir daí o usuário precisar informar os seguintes dados da célula de origem:
  * Unidade Orçamentária
  * Programa de Trabalho Resumido
  * Natureza da Despesa
  * Fonte de Recurso
  * Esfera
  * Plano Interno

Na célula de destino é necessário informar somente a unidade orçamentária, a esfera e o plano interno, visto que as outras informações vem preenchidas como custeio.

Ao final, o sistema exibe um resumo da operação realizada e a opção de realizar novamente a mesma operação reaproveitando os dados anteriores. ([[#principais_regras_de_negócio|RN06]])

===== 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** - Não poderá ser realizada uma Alocação de Custeio de uma célula para ela mesma;
  * **RN03** - O valor deverá ser maior que zero;
  * **RN04** - A unidade da célula de origem deverá ser a unidade gestora do usuário logado;
  * **RN05** - A unidade da célula de destino deverá ser uma unidade subordinada a unidade gestora do usuário e não ser uma unidade gestora;
  *<del> **RN06** - Os responsáveis das unidades movimentadas serão notificados via email.</del>
  * **RN06** - 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).


===== 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: SCO (Sistema de Controle Orçamentário)

Link(s): SCO -> Movimentações -> Movimentações Orçamentárias -> Alocação de Custeio

Usuário: 

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.

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

    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, onde ? é o código da gestora que se deseja a lista da unidades subordinadas.

  * Consulta que traz todos as unidade gestoras:

    select * from unidade where categoria = 1 and tipo = 2


  * 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>

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

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

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

  * SCO -> Relatórios -> Movimentações Orçamentárias  -> Transferências por Unidades
     * Na opção Tipo de Transferência deverá ser selecionado Alocação de Centro de Custos. 
 
  * SCO -> Relatórios -> Movimentações Orçamentárias  -> Transferências entre Unidades
    * Na opção Tipo de Transferência deverá ser selecionado Alocação de Centro de Custos.