~~ODT~~

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

====== Estornar GRU ======

Esta operaç;ão permite o integrador do SIAFI e o executor do orçamento estornar Guias de Recolhimento da União.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Orçamento -> Aba Estornos -> Estorno -> GRU//.

O sistema solicita os filtros para a busca por GRUs:

  * **Número de Referência**: Tipo - NUMÉRICO.
  * **Contribuinte**: Tipo - NUMÉRICO.
  * **Tipo GRU**: Tipo - TEXTO.
  * **Código Recolhimento**: Tipo - NUMÉRICO.
  * **Vencimento**: Tipo - DATA.
  * **Liquidação**: Tipo - DATA.
  * **Competência**: Tipo - NUMÉRICO.
  * **Convênio**: Tipo - NUMÉRICO.
  * **Unidade Favorecida**: Tipo - TEXTO.
  * **Arrecadadas**: Tipo - LÓGICO.

O sistema exibe os dados das GRUS localizadas conforme abaixo:

  * **__Número Referência__**: Tipo - NUMÉRICO.
  * **__Tipo __**: Tipo - TEXTO.
  * **__Convênio__**: Tipo - NUMÉRICO.
  * **__Cód. Recolhimento__**: Tipo - NUMÉRICO.
  * **__Contribuinte__**: Tipo - NUMÉRICO.
  * **__Competência__**: Tipo - TEXTO.
  * **__Unidade Favorecida__**: Tipo - TEXTO.
  * **__Data Vencimento__**: Tipo - DATA.
  * **__Data Liquidação__**: Tipo - DATA.
  * **__Valor Total__**: Tipo - MOEDA.

Para cadas GRU o usuário poderá visualizar a GRU ou selecinar para estorno.

Ao visualizar será exibidas as seguintes informações:

  * **__Tipo__**: Tipo - TEXTO.
  * **__Tipo de Contribuição__**: Tipo - TEXTO.
  * **__Tipo de Pagamento__**: Tipo - TEXTO.
  * **__Contribuinte__**: Tipo - NUMÉRICO.
  * **__Unidade Favorecida__**: Tipo - TEXTO.
  * **__Código de Recolhimento__**: Tipo - NUMÉRICO.
  * **__Número de Referência__**: Tipo - NUMÉRICO.
  * **__Competência__**: Tipo - NUMÉRICO.
  * **__UG/Gestão__**: Tipo - NUMÉRICO.
  * **__Valor do Documento__**: Tipo - MOEDA.
  * **__Desconto/Abatimento__**: Tipo - MOEDA.
  * **__Outras Deduções__**: Tipo - MOEDA.
  * **__Mora/Multa__**: Tipo - MOEDA.
  * **__Juros/Encargos__**: Tipo - MOEDA.
  * **__Outros Acréscimos__**: Tipo - MOEDA.
  * **__Valor Total__**: Tipo - MOEDA.
  * **__Vencimento__**: Tipo - DATA.
  * **__Data de Liquidação__**: Tipo - DATA.
  * **__Número do Convênio__**: Tipo - NUMÉRICO.
  * **__Número de Autenticação__**: Tipo - NUMÉRICO.
  * **__Agente Financeiro__**: Tipo - TEXTO.

Ao selecionar para estorno será exibido as informações abaixo:

  * **__Tipo__**: Tipo - TEXTO.
  * **__Tipo de Contribuição__**: Tipo - TEXTO.
  * **__Tipo de Pagamento__**: Tipo - TEXTO.
  * **__Contribuinte__**: Tipo - NUMÉRICO.
  * **__Unidade Favorecida__**: Tipo - TEXTO.
  * **__Código de Recolhimento__**: Tipo - NUMÉRICO.
  * **__Número de Referência__**: Tipo - NUMÉRICO.
  * **__Competência__**: Tipo - NUMÉRICO.
  * **__UG/Gestão__**: Tipo - NUMÉRICO.
  * **__Valor do Documento__**: Tipo - MOEDA.
  * **__Desconto/Abatimento__**: Tipo - MOEDA.
  * **__Outras Deduções__**: Tipo - MOEDA.
  * **__Mora/Multa__**: Tipo - MOEDA.
  * **__Juros/Encargos__**: Tipo - MOEDA.
  * **__Outros Acréscimos__**: Tipo - MOEDA.
  * **__Valor Total__**: Tipo - MOEDA.
  * **__Vencimento__**: Tipo - DATA.
  * **__Data de Liquidação__**: Tipo - DATA.
  * **__Número do Convênio__**: Tipo - NUMÉRICO.
  * **__Número de Autenticação__**: Tipo - NUMÉRICO.
  * **__Agente Financeiro__**: Tipo - TEXTO.
  
O usuário acionar o botão **Estornar GRU** e o caso de uso é finalizado.



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

  * **RN01** - Não é possível estornar uma GRU já estornada anteriormente.;
  * **RN02** - Não é possível estornar uma GRU já arrecadada.
  * **RN03** - Caso a GRU tenha sido consolidada é necessário desfazer os dados (Data de Pagamento, Valor Pago e Quitada) da GRU correspondente em na base de COMUM;
  * **RN04** - A GRU estornada não deve ser removida da base de dados e sim ter as suas informações (Data de Estorno e Registro Estorno) populadas;


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

Não se aplica.

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


^ Classe ^ Tabela |
| br.ufrn.sipac.siafi.dominio.GRU | siafi.gru |


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

Sistema: SIPAC

Módulo: Orçamento

Link(s): Aba Estornos -> Estorno -> GRU.

Usuário: larrubia2

Papeis: 
  * SipacPapeis.INTEGRADOR_SIAFI_GESTORA;
  * SipacPapeis.INTEGRADOR_SIAFI_GLOBAL;
  * SipacPapeis.EXECUTOR_ORCAMENTO;
  * SipacPapeis.EXECUTOR_ORCAMENTO_GLOBAL

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

Realizar o estorno de GRUs e verificar se esta atendendo as RNs estabelecidas.

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

Utilizar o filtro **Tipo GRU**, pois é bastante genérico e possui GRU para realização do estorno.