====== Continuar Tombamento ======

Tombar alguma coisa de acordo com normas legais, equivale a registrar, com o objetivo de proteger, controlar, guardar. Tombamento, também chamado tombo, significa inventário, arrolamento, registro. O tombamento de bens, visando a sua preservação e restauração, é de interesse do estado e da sociedade.
Este caso de uso possibilita continuar o tombamento de livros recebidos por doação nas bibliotecas da univerisidade. Neste caso de uso, é necessário informar o doador do bem, assim como o tipo de documento e a unidade responsável pelo bem.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Módulo Biblioteca -> Aba Patrimônio -> Tombamento de Materiais Informacionais -> Continuar Tombamento//.
==== Passo 1 ====
Ao acessar o caso de uso o sistema irá exibir as seguintes informações para refinar a consulta:
  * **Termo de Responsabilidade**: Tipo NUMÉRICO. Formato: 9..9/AAAA.
  * **Período**: Tipo DATA. Formato: DD/MM/AAAA a DD/MM/AAAA.
  * **Grupo de Material**: Tipo NUMÉRICO. Formato: 9..9 - NOME. (Pode-se utlizar o nome ou o código)
  * **Bem**: Tipo TEXTO. (Autocomplete)
  * **Unidade**: Tipo TEXTO. Formato: 9..9 - NOME. (Pode-se utlizar o nome ou o código)
  * **Responsável da Unidade**: Tipo TEXTO. (Autocomplete)
  * **Nota Fiscal**: Tipo TEXTO. (Autocomplete)
  * **Empenho (Número/Ano - Gestora)**: Tipo NUMÉRICO/TEXTO. Formato: 9..9/AAAA - UNIDADE.

Os termos encontrados irá conter as seguintes informações:
  * **__Número/Ano__**: Tipo NUMÉRICO. Formato: 9..9/AAAA.
  * **__Unidade Responsável__**: Tipo NUMÉRICO.
  * **__Tipo de Tombamento__**: Tipo TEXTO.

==== Passo 2 ====
O termo selecionado terá as seguintes informações:
  * **Número**: Tipo NUMÉRICO. Formato: 9..9/AAAA.
  * **Unidade Gestora**: Tipo NUMÉRICO. Formato: 9..9 - NOME.

Os empenhos já adicionados terá as seguintes informações:
  * **__Número__**: Tipo NUMÉRICO. Formato 9..9/AAAA.
  * **__Unidade Gestora__**: Tipo NUMÉRICO. Formato: 9..9 - NOME.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Saldo__**: Tipo NUMÉRICO.

Além disso as seguintes informações adicionais será solicitada:
  * **Associar ao tombamento de livros?**: Tipo TEXTO. Formato: Sim ou Não.
  * **__Unidade Responsável__**: Tipo TEXTO. Formato: NOME (9..9).

==== Passo 3 ====

Os seguintes dados do tombamento será exibido:
  * **__Unidade Gestora Patrimonial__**: Tipo TEXTO. Formato: NOME (9..9).
  * **__Data de Tombamento__**: Tipo DATA.
  * **__Setor Responsável__**: Tipo TEXTO. Formato: NOME (9..9).

Os dados dos empenhos associados terá as seguintes informações:
  * **__Número/Ano__**: Tipo NUMÉRICO. Formato: 9..9/AAAA.
  * **__Fornecedor__**: Tipo TEXTO.
  * **__CPF/CNPJ__**: Tipo NUMÉRICO.
  * **__Data__**: Tipo DATA.
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Saldo__**: Tipo NUMÉRICO.

Os seguintes dados será exibidos para inserir os itens da nota fiscal:
  * **Nota Fiscal***: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA.
  * **__Data do Atesto__**: Tipo DATA.

Para os itens da nota fiscal informada terá o seguinte formato:
  * **__Código__**: Tipo NUMÉRICO.
  * **Denominação***: Tipo TEXTO.
  * **Marca***: Tipo TEXTO. (Autocomplete)
  * **Finalidade***: Tipo TEXTO.
  * **Valor (R$)***: Tipo NUMÉRICO.
  * **__Qtd. disponível__**: Tipo NUMÉRICO.
  * **Quantidade***: Tipo NUMÉRICO.
  * **Data de Término Garantia***: Tipo DATA.
  * **Data de Balanço**: Tipo DATA.
  * **Observações**: Tipo TEXTO.
  * **Deseja Agregar Outros Itens da Nota para este Bem?**: Tipo TEXTO. Formato: Sim ou Não.
  * **Tombamento Antigo**: Tipo TEXTO. [[#Principais_Regras_de_Negócio| RN02 ]]

Os bens adicionados terá os seguintes informações:
  * **__Material__**: Tipo TEXTO. Formato: NOME (9..9).
  * **__Nota Fiscal__**: Tipo TEXTO.
  * **__Quant__**: Tipo NUMÉRICO.
  * **__Valor do Item (R$)__**: Tipo NUMÉRICO.
  * **__Total__**: Tipo NUMÉRICO. (Total do valor dos bens)

==== Passo 4 ====

As seguintes informações a respeito do termo de responsabilidade será exibido:
  * **__UGP__**: Tipo TEXTO. Formato: 9..9 - NOME.
  * **__Unidade Responsável__**: Tipo TEXTO. Formato: 9..9 - NOME.
  * **__Fornecedor__**: Tipo TEXTO.
  * **__Endereço__**: Tipo TEXTO.

Dados do Fornecedor:
  * **__Nota Fiscal__**: Tipo TEXTO. 
  * **__Data__**: Tipo DATA.
  * **__Empenho__**: Tipo NUMÉRICO. Formato: 9..9/AAAA.

Informações dos bens a tombar e tombados:
  * **__Tombamento__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Quantidade__**: Tipo NUMÉRICO.
  * **__Data de Garantia__**: Tipo DATA.
  * **__Valor Unitário__**: Tipo NUMÉRICO.
  * **__Valor Total__**: Tipo NUMÉRICO.
  * **__Cód. do Grupo__**: Tipo NUMÉRICO.
  * **__Especificação__**: Tipo TEXTO.
  * **__Total de Bens__**: Tipo NUMÉRICO.
  * **__Valor Total__**: Tipo NUMÉRICO.

Observações:
  * **__Usuário__**: Tipo TEXTO.
  * **__Data__**: Tipo DATA.
  * **Observações**: Tipo TEXTO.

Observações das Notas Fiscais Associadas ao Termo:
  * **__Número__**: Tipo NUMÉRICO.
  * **__Observação__**: Tipo TEXTO.

Ao final, o sistema apresenta a opção de impressão do [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:consultas:movimentacoes:termo_de_responsabilidade|Termo de Responsabilidade]], do [[desenvolvimento:especificacoes:sipac:patrimonio:casos_de_uso:relatorios:termo_de_responsabilidade:gerar_resumo_contabil_por_termo|Resumo Contábil]], de de [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio movel:casos_de_uso:bens:tombamento:gerar_etiquetas_de_patrimonio|imprimir etiquetas de patrimônio]].

O caso de uso é finalizado.

===== Principais Regras de Negócio =====
  * **RN01** - As informações: Denominação, Especificação, Valor, Qtd. disponível referente ao matérial será preenchido automaticamente ao selecionar o matérial da nota fiscal. (Adicionado em 02/08/2012 referente a tarefa 96126)
  * **RN02** - Caso a quantidade do item seja igual a 1 os campos "Deseja Agregar Outros Itens da Nota para este Bem?" e "Tombamento Antigo" serão exibidos.(Adicionado em 02/08/2012 referente a tarefa 96126)
===== Regras de Negócio =====

Para o papel SipacPapeis.GESTOR_PATRIMONIO_BIBLIOTECA, na hora de tombar, o sistema só permite tombar materiais do grupo de MATERIAL BIBLIOGRÁFICO NÃO IMOBILIZADO e não mais para nenhum outro.

Só é possível continuar um tombamento caso o tombamento não seja de movimentação.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.patrimonio.comuns.dominio.Doador | administrativo.patrimonio.doador |
| br.ufrn.info.sco.negocio.dominio.Empenho | administrativo.patrimonio.empenho |
| br.ufrn.sipac.patrimonio.tombamento.dominio.TermoResponsabilidade | administrativo.patrimonio.termo_responsabilidade |
| br.ufrn.sipac.requisicoes.biblioteca.dominio.Livro | administrativo.requisicoes.livro |


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

Sistema: SIPAC

Módulo: Biblioteca

Link(s):  Menu Biblioteca -> Aba Patrimônio -> Tombamento de Materiais Informacionais -> Continuar Tombamento 
  
Usuário:  crystinoco

Papeis:
  * SipacPapeis.GESTOR_PATRIMONIO_BIBLIOTECA

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

O sql abaixo gera o numero da nota fiscal associada com o empenho informado e o nome do fornecedor, basta subistituir valor do campo "e.cod_empenho" e "e.ano" pelo código e ano do empenho que deseja encontrar notas associadas.

<code sql>
SELECT n.numero , p.nome FROM sco.empenho AS e, comum.pessoa AS p, liquidacao.empenho_notafiscal AS en, liquidacao.nota_fiscal AS n
WHERE en.id_empenho = e.id_empenho AND en.id_nota_fiscal = n.id_nota_fiscal 
AND n.id_fornecedor = p.id_pessoa AND e.cod_empenho = 902491 AND e.ano = 2010
</code>