~~ODT~~

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

====== Relatório Saldo por Unidade Gestora ======

Esta operação é utilizada pelos gestores de compras por registro de preço com a finalidade de verificar os saldos da unidades gestoras em relação aos itens das licitações. 

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

O caso de uso inicia-se quando o usuário acessa a opção: SIPAC -> Módulo Compras - Registros de Preços -> Aba Sistema de Registro de Preços -> Relatórios -> Saldo por Unidade Gestora.

Inicialmente é requerido que o usuário selecione um determinado processo de compra ([[##principais_regras_de_negócio|RN01]]) ou modalidade de licitação, através dos seguintes campos:

  ***Nº Processo:** Tipo NUMÉRICO, formato: 99999.999999/AAAA-99 (radical.número/ano-dv).([[##principais_regras_de_negócio|RN04]])
  ***Modalidade/Número/Ano:** Tipo TEXTO, formato: SIGLA MODALIDADE - 9.../AAAA.

Então o sistema exibe um relatório tal qual o modelo abaixo:

**RELATÓRIO DE SALDO POR UNIDADE GESTORA**

**__Licitação__**: 9.../AAAA

**__Gestora__**: UNIDADE (CÓDIGO UNIDADE)

**__Assunto__**: ASSUNTO

**__Tipo__**: TIPO

**__Status__**: STATUS

**__Abertura da Licitação__**: DD/MM/AAAA

**__Validade da Ata__**: DD/MM/AAAA

^ ITENS ^^^^^
^ Item ^ Material ^ Unidade ^ Marca ^ Valor ^
| 9... | DENOMINAÇÃO ITEM **EMPRESA:** DOCUMENTO EMPRESA - DENOMINAÇÃO EMPRESA | UNID. MEDIDA | DENOMINAÇÃO MARCA | R$ 99,99 |
| **Saldo por unidade gestora** [[#pRINCIPAIS REGRAS DE NEGÓCIO|(RN02)]] |||||
| **Unidade** |||| **Saldo** |
| DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE) |||| R$ 99,99 | 
| DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE) |||| R$ 99,99 | 
| ||| **Quantidade Licitada** [[#pRINCIPAIS REGRAS DE NEGÓCIO|(RN03)]]  ||
| ||| 99.99 ||
| |||||

Então o caso de uso é finalizado.

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

  ***RN01** - O relatório só é aplicável às Licitações de modalidade Pregão - PR.
  ***RN02** - O saldo para cada gestora será: ''quantidade licitada'' -  ''total empenhado'', onde o ''total empenhado'' é o somatório das quantidades solicitadas pela gestora.
  ***RN03** - A quantidade licitada do material é calculada da seguinte forma: ''quantidade'' - ''quantidade acrescida'' + ''quantidade cancelada'', onde ''quantidade'' é a quantidade recebida do item vindo de notas fiscais, ''quantidade acrescida'' é a quantidade acrescida do item após um processo carona, ''quantidade cancelada'' é a quantidade cancelada do item após um processo de supressão.
  ***RN04** - Dependendo da configuração do parâmetro UTILIZA_PROTOCOLO_SIPAC este campo pode apresentar duas formas de exibição:
    * Se o valor do parâmetro for //true//, será solicitado ao usuário 4 campos separados para a informação do número do processo de compra.
    * Se o valor do parâmetro for //false//, será solicitado ao usuário 1 campo único para a informação do número do processo de compra.
      * Formato do número do processo de compra: 99999.999999/9999-99 (radical.número/ano-dv)

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

^ Classe ^ Tabela |
| br.ufrn.sipac.compras.dominio.ItemProcessoCompra            | admnistrativo.compras.item_processo_compra                         |
| br.ufrn.sipac.requisicoes.material.dominio.Material         | admnistrativo.public.material                                      |
| br.ufrn.sipac.compras.licitacao.dominio.ItemProposta        | admnistrativo.compras.item_proposta                                |
| br.ufrn.comum.dominio.UnidadeGeral                          | admnistrativo.comum.unidade                                        |
| br.ufrn.sipac.compras.dominio.ParticipanteExternoItemCompra | admnistrativo.compras.adesao_registro_precos_nao_participante_item |

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

Sistema: SIPAC

Módulo: Compras - Registros de Preços

Link(s): Aba Sistemas de Registro de Preços -> Relatórios -> Saldo por Unidade Gestora

Usuário: paulinho

Papel que usuário deve ter: SipacPapeis.GESTOR_COMPRA_SRP


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

  * É importante que os testes sejam realizados com as duas configurações informadas abaixo:
    * Configuração 01:
      ***UTILIZA_PROTOCOLO_SIPAC** = //true//. 
    * Configuração 02:
      ***UTILIZA_PROTOCOLO_SIPAC** = //false//.

   * Quando for gerar o relatório, escolha a opção de busca por licitação e selecionar uma modalidade diferente de Pregão - PR. O Sistema não deve gerar o relatório.
   * Para verificar alterações no relatório acesse o link Portal Administrativo -> Requisições -> Material -> Solicitar em um Registro de Preços -> Solicitar Material em um Registro de Preços, e solicitar um material para o pregão utilizado na geração do relatório. Por exemplo, se foi selecionado o Pregão PR 5/2009 para geração do relatório, solicitar um material em registro de preço para esse pregão e observar as modificações no relatório.
   * O processos em registro de preço existentes pode ser consultados através do seguinte link: Módulos -> Sistemas de Registro de Preços -> Relatórios -> Processos Registros de Preços Existentes
 

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

Para visualizar os processos a serem utilizados para realizar a operação utilizar Menu Sistema de Registro de Preços → Relatórios → Processos Registros de Preços Existentes