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



====== Cadastrar Invoice ======

Invoice é um documento comercial que formaliza uma operação de compra e venda com o exterior, contendo quantidade, preço e condições de pagamento de mercadorias ou serviços prestados ([[http://www.fazenda.gov.br/|Glossário do Ministério da Fazenda]]). Esse caso de uso permite que o usuário com permissão de tombar os bens da unidade ou gestor do patrimônio realize o cadastro de um invoice. 

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Patrimônio -> Bens -> Invoice -> Cadastrar//.

==== Passo 1 ====

Ao acessar o caso de uso o sistema solicita os seguintes dados:

  * **Invoice***: Tipo TEXTO.
  * **Arquivo de Invoice**: Tipo - UPLOAD.
  * **Declaração de Importação**: Tipo TEXTO.
  * **Arquivo de Declaração**: Tipo - UPLOAD.
  * **Data de Emissão***: Tipo DATA.
  * **Fornecedor***: Tipo AUTOCOMPLETE. Formato: RAZÃO SOCIAL - CPF/CNPJ. Entrada de Dados: RAZÃO SOCIAL. Caso o fornecedor não esteja cadastrado, o sistema permite realizar o cadastro conforme descrito na especificação [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:cadastros:tombamento:fornecedores_tombamento_empenho:cadastrar|Cadastrar Fornecedor]]

==== Passo 2 ====

São exibidos os seguintes campos para buscar o material e incluí-lo no invoice:

  * **Código**: Tipo NUMÉRICO.
  * **Denominação**: Tipo TEXTO.

Também são exibidas os dados do invoice, a saber: 

  * **__Invoice__**: Tipo TEXTO.
  * **__Fornecedor__**: Tipo TEXTO. 
  * **__Tipo de Entrada__**: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA. 

Realizada a busca, o sistema exibe uma lista com os materiais encontrados:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Unid. Med.__**: Tipo TEXTO.
  * **__Preço__**:  Tipo NUMÉRICO. Formato: 99,99. 
  * **__Especificação__**: Tipo TEXTO.
  * Opção de adicionar o item no invoice.

O sistema exibe os dados do material e solicita as seguintes informações:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO. Esta informação já vem é exibida pelo sistema com a denominação do material selecionado. Porém pode ser editada antes de ser inclusa na nota.
  * **__Valor Estimado__**: Tipo NUMÉRICO. Formato: 99,99. É possível visualizar as últimas compras efetuadas para este material.
  * **__Unidade de Medida__**: Tipo TEXTO.
  * **__Especificação__**: Tipo TEXTO.
  * **Quantidade***: Tipo NUMÉRICO. 
  * **Valor Unitário (R$)***: Tipo NUMÉRICO. Formato: 99,99.
  * **Validade**: Tipo DATA.
  * **Garantia**: Tipo DATA.

O sistema permite inserir outros itens no invoice:

  * **Código**: Tipo NUMÉRICO.
  * **Denominação**: Tipo TEXTO.

Exibe os dados do invoice:
 
  * **__Invoice__**: Tipo NUMÉRICO.
  * **__Fornecedor__**: Tipo TEXTO. 
  * **__Tipo de Entrada__**: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA. 

E exibe os itens incluídos em uma listagem com as seguintes informações:

  * **__Código__**:  Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Quant.__**: Tipo NUMÉRICO. 
  * **__Valor__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Total__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Valor Total do Invoice__**: Tipo NUMÉRICO. Formato: 99,99.

Para cada item do invoice é possível alterar ou remover.

==== Passo 2.1 - Alterar Item ====

O sistema permite a alteração dos seguintes campos:

  * **Denominação**: Tipo TEXTO.
  * **Quant.**: Tipo Numérico.
  * **Valor**: Tipo Numérico. Formato: 99,99.

==== Passo 2.2 - Remover Item ====

O sistema solicita a confirmação e, em caso positivo, exclui o item do invoice.

==== Passo 3 ====

Após a confirmação dos itens, o sistema exibe as informações a seguir para confirmação:

Dados do Invoice:

  * **__Invoice__**: Tipo TEXTO.
  * **__Declaração Importação__**: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA.

Dados do Fornecedor:

  * **__Fornecedor__**: Tipo TEXTO.
  * **__CPF/CNPJ__**: Tipo TEXTO.
  * **__Endereço__**: Tipo TEXTO.

Itens do Invoice:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Validade__**: Tipo DATA.
  * **__Garantia__**: Tipo DATA.
  * **__Qtde__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Total__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Valor Total do Invoice__**: Tipo NUMÉRICO. Formato: 99,99.
  * **Deseja Criar Documento para Tramitação?**: Tipo LÓGICO. São exibido as opções ''Sim'' e ''Não''.
    * Ao escolher a opção "Sim", o sistema solicita a informação da unidade de destino:
    * **Unidade Responsável**: Tipo: TEXTO. Formato: UNIDADE (CÓDIGO DA UNIDADE). É permitido selecionar a unidade informando o código da unidade.
      * //Observa-se também a opção de **buscar unidade**, que ao ser selecionada exibe uma busca por unidade através do nome da mesma.//
  * **Obervações**: Tipo TEXTO.

==== Passo 4 ====

Após a confirmação, o invoice é cadastrado com sucesso e são exibidas as seguintes informações:

  * **__Invoice__**: Tipo TEXTO.
  * **__Declaração Importação__**: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA.
  * **__Data de Cadastro__**: Tipo DATA.
  * **__Usuário de Cadastro__**: Tipo TEXTO. Formato: NOME DO USUÁRIO (LOGIN).
  * **__Protocolo do Documento__**: Tipo TEXTO. Formato: 99999.999999/AAAA-99.  ([[#principais regras de negócio|RN01]]).
  * **__Status__**: Tipo TEXTO.

Dados do Fornecedor:

  * **__Fornecedor__**: Tipo TEXTO.
  * **__CPF/CNPJ__**: Tipo TEXTO.
  * **__Endereço__**: Tipo TEXTO.

Histórico de Mudança de Status:

  * **__Data__**: Tipo DATA. Formato: DD/MM/AAAA HH:MM
  * **__Usuário__**: Tipo TEXTO. Formato: LOGIN DO USUÁRIO.
  * **__Status__**: Tipo TEXTO.

Itens do Invoice:

  * **__Código__**: Tipo NUMÉRICO.
  * **__Denominação__**: Tipo TEXTO.
  * **__Medida__**: Tipo TEXTO.
  * **__Validade__**: Tipo TEXTO.
  * **__Garantia__**: Tipo DATA.
  * **__Qtde. Tombados__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Total__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Valor Total do Invoice__**: Tipo NUMÉRICO. Formato: 99,99.

Ao final, são exibidas as opções de tombamento e impressão do invoice e do documento protocolado, caso tenha sido gerado um documento de tramitação.

==== Passo 4.1 - Opções de Tombamentos ====

Ao final, são exibidas as seguintes opções de tombamento:

  *Tombamento Empenho: Mais informações acerca dessa opção, veja [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:tombamento:tombar_bens:empenho|Tombamento por Empenho]].
  *Tombamento Funpec: Mais informações acerca dessa opção, veja [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:tombamento:tombar_bens:funpec|Tombamento Funpec]]  ([[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:notas_fiscais:cadastrar#Principais Regras de Negócio|RN02]]). 
  *Continuar um Tombamento: Mais informações acerca dessa opção, veja [[desenvolvimento:especificacoes:sipac:patrimonio:desenvolvimento:especificacoes:sipac:patrimonio_movel:casos_de_uso:bens:tombamento:tombar_bens:continuar_tombamento|Continuar Tombamento]].

==== Passo 4.2 - Imprimir Invoice ====

É gerado um documento para impressão, com as seguintes informações:

**CABEÇALHO PADRÃO DO SISTEMA**

**INVOICE**

Dados do Invoice:

  * **__Invoice__**: Tipo TEXTO.
  * **__Declaração Importação__**: Tipo TEXTO.
  * **__Data de Emissão__**: Tipo DATA.
  * **__Fornecedor__**: Tipo TEXTO.
  * **__CPF/CNPJ__**: Tipo TEXTO.
  * **__Endereço__**: Tipo TEXTO.
  * **__Status__**: Tipo TEXTO.

^^^^^^^  Itens do Invoice  ^^^^^^^
|Código|Denominação|Medida|Qtde.|Tombados|Valor|Total|
||  <ESPECIFICAÇÃO>  |||||||
|  **Valor Total do Invoice**  |<99,99>||||||||


==== Passo 4.3 - Imprimir Documento ====

É gerado um documento para impressão conforme modelo a seguir:

**<CABEÇALHO PADRÃO DOS SISTEMAS>**

**DOCUMENTO:** Tipo NUMÉRICO. Formato: 99999.999999/AAAA-99.

Cadastrado em DD/MM/AAAA

**Assunto do Memorando:** Tipo TEXTO.

**Unidade de Origem:** Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE).

**Número:** Tipo NUMÉRICO.

**Tipo do Documento:** Tipo TEXTO.

**Observação:** Tipo TEXTO.

**Movimentações Associadas**
^Data Envio^ Destino ^
|DD/MM/AAAA| UNIDADE (CÓDIGO)|


**<RODAPÉ PADRÃO DOS SISTEMAS>**


O caso de uso é finalizado. 

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

  ***RN01** - O número do protocolo é exibido caso o campo **Deseja Criar Documento de Tramitação** tenha sido selecionado com a opção ''Sim''. Se o parâmetro UTILIZA_PROTOCOLO_SIPAC for verdadeiro, o número do processo será composto por RADICAL.NÚMERO/ANO-DV.
  ***RN02** - Caso o parâmetro TOMBAMENTO_FUNDACAO seja verdadeiro, esta opção estará disponível.



==== Resoluções/Legislações Associadas ====
  
Não se aplica. 

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

^ Classe ^ Tabela ^
| <PREENCHER>  | <PREENCHER>  | 

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

Sistema: SIPAC

Módulo: Patrimônio

Link(s): Aba de Bens -> Invoice -> Cadastrar

Usuários: paulinho, san

Papel que usuário deve ter: SipacPapeis.GESTOR_PATRIMONIO_GLOBAL ou SipacPapeis.GESTOR_TOMBAMENTO

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

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