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

====== Acompanhar Solicitação de Anulação de Empenho ======

Este caso de uso tem como objetivo acompanhar um Processo de Solicitação de Anulação de Empenho.
Um Empenho pode ter várias requisições de anulação de ítens de compra. Essas requisições são associadas à um Processo de Solicitação de Anulação de Empenho no momento em que a solicitação é efetuada. Assim, cada solicitação é associada à um Processo de Anulação. Um Empenho pode ser anulado parcialmente ou totalmente.  O processo de anulação de empenho pode ser acompanhado através da capa do processo de anulação gerada pelo sistema. Mais informações do domínio podem ser encontradas no [[desenvolvimento:especificacoes:sipac:liquidacao_de_despesas:negocio|Documento de Negócio]].

O acompanhamento de anulações de empenhos é responsabilidade dos usuários do Departamento de Materiais e Patrimônio - DMP, mais especificamente do Setor de Liquidação. 

Pré-condições: 
   * O usuário deve possuir o perfil de Gestor de Liquidação de Despesas para executar esta funcionalidade.
   * Existir cadastro de solicitação de anulação.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Liquidação de Despesas -> Aba Liquidação de Despesas -> Consultas -> Acompanhar Solicitação de Anulação//.

===Passo 1===

O sistema solicita a consulta utilizando um ou mais dos seguintes critérios:
 
   * **Empenho**: Formato - 99999/AAAA, Tipo - NUMÉRICO. (O campo deve está marcado por padrão).
   * **Unidade Gestora**: Formato - CÓDIGO - NOME, Tipo - NUMÉRICO e TEXTO.
   * **Processo**: Formato - RADICAL.99999/AAAA-DÍGITOS, Tipo - NUMÉRICO.
   * **Período de datas de solicitação de anulação**: Formato - DD/MM/AAAA até DD/MM/AAAA, Tipo - DATA.
   * **Intervalo de valor da solicitação de anulação**: Formato - 9.999,99 até 9.999,99, Tipo - NUMÉRICO.

O Gestor confirma busca e sistema lista os empenhos exibindo com os seguintes dados:
   * **__Data da solicitação__**: Formato - DD/MM/AAAA, Tipo - DATA.
   * **__Valor da anulação__**: Tipo - NUMÉRICO.
   * **__Número e ano do empenho__**: Formato - 99999/AAAA, Tipo - NUMÉRICO.
   * **__Número e ano do processo__**: Formato - RADICAL.99999/AAAA-DÍGITOS, Tipo - NUMÉRICO.
   * Opção para visualizar o empenho.

===Passo 2===

O Gestor seleciona opção de visualizar e sistema exibe os seguintes dados do empenho selecionado:

Dados do Protocolo:
   * **__Número do Processo__**: Tipo - NUMÉRICO.
   * **__Ano do Processo__**: Formato - AAAA, Tipo - NUMÉRICO.
   * **__Unidade de Origem__**: Formato - NOME DA UNIDADE (99.99.99.99)
   * **__Assunto__**: Tipo - TEXTO.
   * **__Observações__**: Tipo - TEXTO.

Dados do Empenho
   * **__Número do Empenho__**:	Tipo - NUMÉRICO.
   * **__Ano do Empenho__**: Formato - AAAA, Tipo - NUMÉRICO.
   * **__Credor__**:Tipo - TEXTO.
   * **__Saldo__**:Tipo - NUMÉRICO.

Lista de Itens associados:
   * **__Material__**:Tipo - TEXTO.
   * **__Valor__**:Tipo - NUMÉRICO.
   * **__Total__**:Tipo - NUMÉRICO.
   * **__Anulados__**:Tipo - NUMÉRICO.

O sistema exibe opção para impressão da capa do processo: o documento pode ser visualizado através do caso de uso [[desenvolvimento:especificacoes:sipac:protocolo:casos_de_uso:consultas_relatorios:relatorios:capa_do_processo|Capa do Processo]] no módulo de protocolo/SIPAC.

O caso de uso é então finalizado.
   

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

Não se aplica.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.arq.interop.orcamento.Empenho | administrativo.patrimonio.empenho |
| br.ufrn.sipac.liquidacao.pagamento.dominio.SolicitacaoAnulacaoEmpenho.java | administrativo.sco.solicitacao_anulacao |
| br.ufrn.sipac.protocolo.dominio.TipoProcesso.java |administrativo.protocolo.tipoprocesso |
| br.ufrn.sipac.compras.dominio.ItemProcessoCompra.java |administrativo.compras.item_processo_compra |
| br.ufrn.sipac.protocolo.dominio.Processo.java | administrativo.protocolo.processo |

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

Sistema: SIPAC

Módulo: Liquidação de Despesas

Link(s): Aba Consultas -> Acompanhar Solicitação de Anulação

Usuário: Paulinho

Papel que usuário deve ter: SipacPapeis.GESTOR_LIQUIDACAO

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

Testar as opções de busca combinando-as de diferentes maneiras.

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

Para consultar os Empenhos cadastrados no sistema acessar o link Módulos -> Liquidação de Despesas -> Consultas e no formulário de busca informar o número, ano e unidade gestora do empenho. Para visualizar o número, ano e identificador da unidade gestora de todos os empenhos cadastrados no bancos utilizar o seguinte script:

  SELECT cod_empenho, ano,  id_unidade_gestora
     FROM sco.empenho;