~~ODT~~

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

====== Consultar Cotas Orçamentárias ======

Este caso de uso é utilizado pelos ordenadores de DDO com o objetivo de mostrar as [[desenvolvimento:especificacoes:sipac:ddo:casos_de_uso:operacoes:cota_orcamentaria:cadastrar|cotas orçamentárias]] e suas respectivas despesas.

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

O caso de uso é acessado através do caminho: SIPAC → Orçamento → Disponibilidade Orçamentária → Consultas/Relatórios → Cotas Orçamentárias.

O sistema solicita ao gestor que informe pelo menos um dos seguintes dados:

  * **Exercício Financeiro**: Formato - AAAA, Tipo - NUMÉRICO.
  * **Unidade Gestora**: Formato - NOME DA GESTORA (CÓDIGO), Tipo - AUTOCOMPLETE. Entrada de dados: NOME DA GESTORA OU CÓDIGO.([[#Principais regras de negócio|RN01]])
  * **Programa de Trabalho Resumido**: Formato - NOME DO PROGRAMA (CÓDIGO), Tipo - AUTOCOMPLETE. Entrada de Dados: NOME DO PROGRAMA OU CÓDIGO
  * **Plano Interno**: Formato - NOME DO PI (CÓDIGO), Tipo - AUTOCOMPLETE. Entrada de dados: NOME DO PLANO OU CÓDIGO.
  * **Fonte de Recurso**: Formato - NOME DA FONTE (CÓDIGO), Tipo - AUTOCOMPLETE. Entrada de dados: NOME DA FONTE OU CÓDIGO.
  * **Natureza da Despesa**: Formato - DENOMINAÇÃO DA NATUREZA (CÓDIGO), Tipo - AUTOCOMPLETE. Entrada de dados: DENOMINAÇÃO OU CÓDIGO.


Confirmando a busca, o sistema exibe lista com as cotas orçamentárias, conforme modelo abaixo. Se o usuário não informar nenhuma dado para pesquisa, o sistema mostra todas as movimentações de cotas:


**RELATÓRIO DE MOVIMENTAÇÃO DA COTA ORÇAMENTÁRIA**
^  Plano Interno^  Fonte^  Natureza da Despesa^  Data  ^  Ano^ Tipo^  DDO ^  Valor ^  Saldo da Cota ^
|  **Unidade Gestora: NOME DA UNIDADE (CÓDIGO)**  ||||||||||
|  NUMÉRO PLANO INTERNO |  NÚMERO FONTE |  NÚMERO DESPESA |  DD/MM/AAAA  | AAAA | TIPO DDO |  -  |  R$ 99,99 |  R$ 99,99 |
|  NUMÉRO PLANO INTERNO |  NÚMERO FONTE |  NÚMERO DESPESA |  DD/MM/AAAA  | AAAA | TIPO DDO |  -  |  R$ 99,99 |  R$ 99,99 |
|   **Saldo Atual: R$ 99,99**||||||||||
|  NUMÉRO PLANO INTERNO |  NÚMERO FONTE |  NÚMERO DESPESA |  DD/MM/AAAA  | AAAA | TIPO DDO |  -  |  R$ 99,99 |  R$ 99,99 |
|  NUMÉRO PLANO INTERNO |  NÚMERO FONTE |  NÚMERO DESPESA |  DD/MM/AAAA  | AAAA | TIPO DDO |  -  |  R$ 99,99 |  R$ 99,99 |
|   **Saldo Atual: R$ 99,99 **||||||||||
|   **Saldo da Unidade: R$ 99,99 **||||||||||

**Valor:** corresponde ao valor solicitado da despesa.

**Saldo Atual:** corresponde ao valor debitado (atualizado), à medida que, cada despesa é incrementada.

**Saldo Atual:** corresponde ao soma dos saldos atualizados.

**Saldo da Unidade:** É a soma de todos os totais das cotas orçamentárias.


O gestor pode visualizar os detalhes de cada DDO, através da coluna DDO. O sistema apresenta os dados:

===Detalhes da DDO===
  * **__DDO__**: Formato - 9../AAAA, Tipo - NUMÉRICO.
  * **__Gestão__**: Tipo - NUMÉRICO.
  * **__Unidade Gestora__**: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO e NUMÉRICO.
  * **__Unidade Orçamentária__**: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO e NUMÉRICO. Exemplo:	CURSO DE ESPECIALIZAÇÃO EM TERAPIA COGNITIVO-COMPORTAMENTAL (99.99.99.99)
  * **__Data__**: Formato - DD/MM/AAAA, Tipo - NUMÉRICO.
  * **__Tipo__**: Tipo - TEXTO. Exemplo: Contrato (Nova Contratação)
  * **__Programa de Trabalho Resumido__**: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO e NUMÉRICO.
  * **__Plano Interno__**: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO.
  * **__Fonte__**: Formato - NOME DA UNIDADE (CÓDIGO), Tipo - TEXTO e NUMÉRICO.
  * **__Registrado por__**: Formato - NOME COMPLETO DO REGISTRADOR (LOGIN), Tipo - TEXTO
  * **__Valor Total__**: Tipo - NUMÉRICO.

  * O sistema apresenta também os dados da DDO Anterior:
    * **__DDO__**: Formato - 9.../AAAA, Tipo - NUMÉRICO.
    * **__Contrato__**: Formato - 9.../AAAA, Tipo - NUMÉRICO.
    * **__Credor__**: Formato - NOME DO CREDOR (NUMERO DO DOCUMENTO 999.999.999-99)
    * **__Vigência do Contrato__**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA.
    * **__Valor do Contrato Atual__**: Tipo - NUMÉRICO.
  
  * O sistema apresenta lista com os detalhes da DDO com seguintes dados:
    * **__Natureza da Despesa__**: Formato - NATUREZA (CÓDIGO), Tipo - TEXTO e NUMÉRICO.
    * **__SubItem__**: Tipo - TEXTO.
    * **__A = Quantidade de Meses__**: Tipo - NUMÉRICO.
    * **__B = Valor__**: Tipo - NUMÉRICO.
    * **__Total (A X B)__**: Tipo - NUMÉRICO.
    * **__Resultado__**: Tipo - NUMÉRICO.
    * **Total**: Tipo - NUMÉRICO. O Total corresponde a soma do valor total de cada Natureza de Despesa.

  * O sistema apresenta o histórico (a finalidade do histórico de movimentação, é controlar usuário, a data e o status para o qual ele foi movimentado) com os seguintes dados:
    * **__Status__**: Tipo - TEXTO. Para o Status podem ser apresentadas as seguintes opções:        
          * 712 - "EM ANÁLISE" – Valor padrão para as DDOs CONTRATOS recém cadastradas ou alteradas pelo ator.
          * 713 - "ANALISADA" – Valor padrão para as DDOs PESSOAL recém cadastradas ou alteradas pelo ator e valor padrão, também, para as DDOs CONTRATOS encaminhadas para o Coordenador pelos atores.
          * 600 - "AUTORIZADA" – Status de declarações autorizadas pelor ORDENADOR DDO CENTRAL (caso de uso Autorizar Declaração).
          * 5 - "RECUSADA (NEGADA)" – Status para quando a DDO for recusada ou negada, após análise.
          * 6 - "EXCLUÍDA (ESTORNADA)" – Valor padrão quando o ator nos perfis: CONTRATO, PESSOAL, ORDENADOR DDO CENTRAL excluir DDO Cadastrada. Status para quando a Declaração for excluída.
          * 714 - "PENDENTE": Valor padrão quando o ator nos perfis: ORDENADOR DDO CENTRAL, CONTRATO, PESSOAL retornar a declaração para correção.
    * **__Usuário__**: Formato - NOME COMPLETO (LOGIN), Tipo - TEXTO.
    * **__Data__**: Formato - DD/MM/AAAA, Tipo - DATA.
    * **__Valor__**: Tipo - NUMÉRICO.
 

O caso de uso é finalizado.

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

  * **RN01**: Só poderá escolher a unidade gestora como filtro do relatório, o usuário que for Ordenador Central, Gestor Contrato ou Pessoal.

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

Não se aplica.

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


^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.ddo.dominio.CotaOrcamentaria|administrativo.sco.cota_orcamentaria|
|br.ufrn.sipac.orcamento.ddo.dominio.DeclaracaoDispOrcamento|administrativo.sco.declaracao_disp_orcamento|
|br.ufrn.sipac.orcamento.ddo.dominio.MovimentacaoCota|administrativo.sco.movimentacao_cota|



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

Sistema: SIPAC

Módulo: DDO

Link(s): Aba DDO -> Consultas/Relatórios -> Cotas Orçamentárias.

Usuário: marcilia (ORDENADOR CENTRAL), seomejc (CONTRATO), seodcf (PESSOAL), seocchla01 (ORDENADOR DESCENTRALIZADO)

Papeis: ScoPapeis.GESTOR_DDO_CONTRATO, ScoPapeis.GESTOR_DDO_PESSOAL, ScoPapeis.ORDENADOR_DDO_CENTRAL, ScoPapeis.ORDENADOR_DDO_DESCENTRALIZADO

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

  * [[desenvolvimento:especificacoes:sipac:ddo:casos_de_uso:ddo:cota_orcamentaria:cadastrar|Cadastrar]], [[desenvolvimento:especificacoes:sipac:ddo:casos_de_uso:ddo:cota_orcamentaria:listar_alterar_cotas|remover e alterar]] uma cota orçamentária, e verificar o relatório.

  * [[desenvolvimento:especificacoes:sipac:ddo:casos_de_uso:ddo:ddo:cadastrar_ddo_de_contrato|Cadastrar]] uma nova contratação e verificar o link da DDO com o detalhamento.

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

  * Ano: 2010

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

  * Buscar **Programa de Trabalho Resumido** em Orçamento -> Cadastros -> Programa de Trabalho Resumido
  * Buscar **Plano Interno** em Orçamento -> Cadastros -> Plano Interno
  * Buscar **Fonte de Recurso** em Orçamento -> Cadastros -> Fonte de Recurso
  * Buscar **Natureza da Despesa** em Orçamento -> Cadastros -> Natureza da Despesa