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

====== Consulta Ordens de Recebidas ======
Este caso de uso permite aos fornecedores visualizar as ordens de fornecimentos recebidas. As ordem de fornecimento são recebidas pelo caso de uso: SIPAC → Portal Administrativo → Contratos → Ordem de Fornecimento → Receber Ordem de Fornecimento.

===== Descrição do Caso de Uso =====
Este caso de uso inicia quando o fornecedor acessa a opção: SIPAC → Portal Fornecedor → Contratos → Consulta de Ordens Recebidas.

====Passo 1====
Ao entrar no UC o usuário deve buscar suas ordens atráves do filtro:

  * **Número Contrato/Ano:** Tipo NUMÉRICO, formato: 9.../AAAA.  
  * **Número Ordem/Ano:** Tipo NUMÉRICO, formato: 9.../AAAA.  
  * **Data de Recebimento: ** Tipo DATA, formato: DD/MM/AAAA a Tipo DATA, formato: DD/MM/AAAA.
  * **Endereço**: Tipo TEXTO.
  * **UF**: Tipo TEXTO, formato: SIGLA ESTADO, representa o UF onde a garagem está localizada.
  * **Cidade **: Tipo TEXTO.
  * ** Emitir Formato de Relatório**: Seleciona quando o usuário quiser listar em formato para impressão.
  
Após a consulta é listado as ordem de fornecimento da seginte forma seguintes dados:

  * **__Número Contrato/Ano__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **__Prazo de Entrega__**:  Tipo DATA, formato: DD/MM/AAAA. 
  * **__Prazo de Instalação__**:  Tipo DATA, formato: DD/MM/AAAA. 

Abaixo tem as endereços da ordem. 
    * **__Razão Social__**: Tipo - TEXTO.
    * **__Endereço__**: Tipo TEXTO.
    * **__Cidade__**: Tipo TEXTO.
    * **__UF__***: Tipo TEXTO, formato: SIGLA ESTADO, representa o UF onde a garagem está localizada.
    
Para cada enderço pode aparecer vários //Itens Contrato// ou //Itens de Valores Total//:
  
Item Contrato 
    * **__Título__**: Título do item. Tipo TEXTO.
    * **__Descrição__**: Descrição de item. Tipo TEXTO.
    * **__Quantidade__**: Unidade itens disponível. Tipo NÚMERICO
    * **__Valor__**: Valor unitário do item. Tipo MONETÁRIO.
    * **__Total__**: Valor unitário do item. Tipo MONETÁRIO.

Item Valor Total
 
    * **__Tipo__**: Título do item. Tipo TEXTO.
    * **__Descrição__**: Descrição de item. Tipo TEXTO.
    * **__Quantidade__**: Valor unitário do item. Tipo MONETÁRIO.
    * **__Valor__ **: Tipo NÚMERICO
    

O caso de uso é finalizado.

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

  * **RN01**: São exibidas somente as ordens recebida pelo fornecedor.
 
==== Resoluções/Legislações Associadas ====
Não se Aplica.

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

^ Classe                                                  ^ Tabela                                             ^
| br.ufrn.sipac.contratos.dominio.OrdemFornecimento       | administrativo.contratos.ordem_fornecimento        |
| br.ufrn.sipac.contratos.dominio.StatusOrdemFornecimento | administrativo.contratos.status_ordem_fornecimento |




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

Sistema: SIPAC

Módulo: Contratos

Link(s): SIPAC → Portal Administrativo → Contratos → Consulta de Ordens Recebidas. 

Fornecedor: Miranda Computação e Comercio LTDA. - CNPJ: 11.982.113/0005-80 (login:mirandapc)

Usuário: mirandapc


Papel que usuário deve ter: 
  * SipacPapeis.FORNECEDOR
  

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

  * Cadastrar um contrato para um fornecedor X.
  * Cadastrar uma Ordem de fornecimento no caso de uso  [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:contratos:cadastro_ordem_fornecimento|Cadastro Ordem de Fornecimento]]  para o contrato cadastrado anteriormente.
  * Receber Ordem: O fornecedor X entrar no caso de uso de receber Ordem de Fornecimento e efetua o recebimento.
  * Para finalizar: O fornecedor X deve visualiar a ordem de fornecimento recebida anteriormente.
    
  
  
  
===== Dados para o Teste =====

Para verificar o status da ordem:

<code sql>
    SELECT *   FROM contratos.ordem_fornecimento ordem
    JOIN contratos.status_ordem_fornecimento status ON(ordem.id_status = status.id_status_ordem_fornecimento)
</code>