~~ODT~~

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

====== Consultar Anulação de Empenho ======

Esse caso de uso é utilizado pelos gestores da instituição e pelos auditores com a finalidade de realizar consultas às [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:empenho:anular_empenho|anulações de empenhos]] realizadas através do sistema. 

Pré-condições: 
   * O usuário deve ter o perfil de GESTOR DE INSTITUIÇÃO;
   * Ter sido cadastrado um empenho e anulações de empenho no sistema.

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

O caso de uso é acessado através do caminho: //SIPAC → Orçamento → Consultas → Empenho -> Anulação de Empenho//.

O Gestor pode realizar a consulta informando ao sistema (o sistema permite a seleção de mais de um campo para efetuar a busca):

  * **Número do Empenho**: Tipo - NUMÉRICO.
  * **Número do Documento**: Tipo - NUMÉRICO.
  * **Intervalo de data**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA.
  * **Intervalo de Valores**: Tipo - NUMÉRICO.

Com a confirmação da consulta, o sistema exibe uma lista de anulação dos empenhos (caso exista mais de um resultado), com os seguintes dados ([[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:consultas:empenho:anulacao_de_empenho#principais_regras_de_negócio|RN01]]):

  ***__Documento__**: Tipo - NUMÉRICO.
  ***__Data__**: Formato: DD/MM/AAAA, Tipo - DATA.
  ***__Empenho__**: Formato: 9.../AAAA, Tipo - NUMÉRICO.
    * Sisteme exibe opção para visualizar os detalhes do empenho através do caso de uso [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:consultas:empenho:empenho|detalhes do empenho]].
  ***__Unidade__**: Formato - UNIDADE (CÓDIGO UNIDADE), Tipo - TEXTO.
  ***__Valor__**: Tipo - NUMÉRICO.
  *Opção para visualizar os dados da anulação do empenho. É exibida uma lista com os dados:
     * **__Empenho__**: Formato - 9.../AAAA, Tipo - NUMÉRICO.
     * **__Unidade__**: Formato - NOME UNIDADE, Tipo - TEXTO.
     * **__Código da Célula Orçamentária__**: Tipo - NUMÉRICO.
     * **__Tipo__**: Tipo - TEXTO. Os tipos de Anulação de Empenho são: ''ANULAÇÃO PARCIAL DE EMPENHO'' (Apenas zera os saldos de todos os subempenhos, mas o empenho não se torna inválido), ''ANULAÇÃO PARCIAL DE TODOS OS SALDOS'' (zera o saldo restante em todos os subempenhos do empenho informado) e ''ANULAÇÃO TOTAL'' (Invalida o empenho, ou seja, o empenho nao poderá mais ser utilizado. Nesta anulação, o saldo será zerado também).
     * **__Tipo do Evento__**: Tipo - TEXTO. Os tipos de eventos que podem ser apresentados pelo sistema são: ''ANULAÇÃO DE EMPENHO'', ''REFORÇO DO EMPENHO'' e ''CANCELAMENTO DO EMPENHO''.
     * **__Valor(R$)__**: Tipo - NUMÉRICO.
     * **__Observações__**: Tipo - TEXTO.
     * **__Movimentador__** Formato - NOME MOVIMENTADOR (USUÁRIO), Tipo - TEXTO.
     * Sistema apresenta opção para visualizar os dados do movimentador:
       ***__Login__**: Tipo - TEXTO.
       ***__Nome__**: Tipo - TEXTO.
       ***__Unidade__**: Tipo - TEXTO.
       ***__Email__**: Tipo - TEXTO.
       ***__Telefone__**: Tipo - NUMÉRICO.
       ***__Ramal__**: Tipo - NUMÉRICO.

O Caso de Uso é finalizado.

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

  * **RN01** Não são apresentados empenhos com registro de estorno.

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

Não se aplica.

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

|^ Classe ^ Tabela |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho | administrativo.sco.empenho |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.SubEmpenhoRequisicao | administrativo.sco.sub_empenho_requisicao |
|br.ufrn.sipac.arq.interop.orcamento.CelulaOrcamentariaAdapter | administrativo.sco.celula_orcamentaria |
|br.ufrn.sipac.orcamento.movimentacoes.dominio.EventoEmpenho | administrativo.sco.evento_empenho |
|br.ufrn.sipac.cadastro.dominio.Unidade | sistemas_comum.comum.unidade |

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

Sistema: SIPAC

Módulo: Orçamento

Link(s):  Orçamento -> Consultas -> Empenho -> Anulação de Empenho

Usuário: larrubia2

Papel que usuário deve ter: SipacPapeis.GESTOR_INSTITUICAO 

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

  * Verificar se o fluxo do caso de uso está funcionando corretamente.

  * Para cadastrar anulações de empenhos, pode-se utilizar o caso de uso Orçamento -> Movimentações -> Empenho -> Anular Empenho e verificar se estão sendo exibidas na consulta.

  * Já para realizar o estorno das anulações (Orçamento -> Estornos -> Estorno -> Anulação de Empenho), e verificar se não aparecem nesta consulta.

  * Também deve-se testar as regras de negócio e a paginação.

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

Pesquisa todas as anulações:

<code sql>  
    select *
	from sco.evento_empenho eventoempe0_
	inner join sco.celula_orcamentaria celulaorca1_ on eventoempe0_.id_celula_orcamentaria=celulaorca1_.id_celula
	inner join comum.UNIDADE unidadeger2_ on celulaorca1_.id_unidade=unidadeger2_.ID_UNIDADE
	inner join sco.sub_empenho subempenho3_ on eventoempe0_.id_sub_empenho=subempenho3_.id_sub_empenho
	inner join sco.empenho empenho4_ on subempenho3_.id_empenho=empenho4_.id_empenho
	inner join comum.UNIDADE unidade7_ on empenho4_.id_unidade_gestora=unidade7_.ID_UNIDADE
	inner join COMUM.USUARIO usuario5_ on eventoempe0_.id_usuario=usuario5_.ID_USUARIO
	inner join COMUM.PESSOA pessoa6_ on usuario5_.ID_PESSOA=pessoa6_.ID_PESSOA
	left outer join siafi.anulacao_empenho anulacaoem8_ on eventoempe0_.id_anulacao_empenho_siafi=anulacaoem8_.id_anulacao
	left outer join siafi.cancelamento_empenho cancelamen9_ on eventoempe0_.id_cancelamento_empenho_siafi=cancelamen9_.id_cancelamento_empenho
	left outer join siafi.reforco_empenho reforcoemp10_ on eventoempe0_.id_reforco_empenho_siafi=reforcoemp10_.id_reforco
	inner join sco.tipo_evento tipoevento11_ on eventoempe0_.id_tipo_evento=tipoevento11_.id_tipo_evento
		where (eventoempe0_.id_registro_estorno is null) and eventoempe0_.id_tipo_evento=1
			order by tipoevento11_.nome, eventoempe0_.ano desc, eventoempe0_.data desc

</code>