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

====== Mapas de Pedido Pendentes ======
Este caso de uso permite ao fornecedor consultar os mapas de pedidos de material que estão pendente de recebimento pelo portal do fornecedor.

Pré-condição: É necessário que haja ao menos um mapa de pedido de material cadastrado para o fornecedor e que esse não tenha sido recebido.


===== Descrição do Caso de Uso =====
Este caso de uso inicia quando o fornecedor acessa a opção: SIPAC → Portal Fornecedor → empenhos → Mapas Pedido Pendentes.

====Passo 1====
Ao acessar, são exibidos os seguintes filtros para consulta:([[#principais_regras_de_negócio|RN01 e RN02]])

  * **Empenho(Número/Ano)**: Tipo NUMÉRICO. Formato:999999/AAAA.
  * **Material**: Tipo AUTOCOMPLETE. Formato: CÓDIGO DO MATERIAL - DENOMINAÇÃO DO MATERIAL. Entrada de dados: CÓDIGO OU DENOMINAÇÃO DO MATERIAL.
  * **Mapa de Pedido**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **Período**: Tipo DATA. Formato: DD/MM/AAAA até DD/MM/AAAA. Ao utilizar esse filtro, os mapas que foram cadastrados dentro do período informado serão listados.
  
Os mapas de pedidos encontrados são listados com as seguintes informações:

  * **__Mapa de Pedido__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Empenho__**: Tipo NUMÉRICO. Formato: 999999/AAAA.
  * **__Data de Entrega__**: Tipo DATA. Formato: DD/MM/AAAA.
  * **__Status__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN02]])
  * **__Valor__**: Tipo NUMÉRICO.
  * **__Total de Mapas__**: Tipo NUMÉRICO.
  * **__Total Valor__**: Tipo NUMÉRICO.

Para cada mapa listado é disponibilizada a opção de receber o mapa de pedido.

===Passo 2 - Receber===

Exibe as informações do mapa de pedido:

  * **__Data de entrega__**: Tipo DATA. Formato: DD/MM/AAAA.
  * **__Status__**: Tipo TEXTO. . ([[#principais_regras_de_negócio|RN02]])

E a listagem dos itens do mapa, ordenado por empenho:

  * **__Empenho__**: Tipo NUMÉRICO: Formato: 999999/AAAA
  * **__Código do Material__**: Tipo NUMÉRICO. Formato: CÓDIGO DO MATERIAL (9999999999999).
  * **__Denominação do material__**: Tipo TEXTO.
  * **__Quant. empenhada__**: Tipo NUMÉRICO. Quantidade total empenhado. ([[#principais_regras_de_negócio|RN07]])
  * **__Saldo de Quant.__**: Tipo NUMÉRICO. Diferença entre a quantidade empenhada e a quantidade já entregue em notas fiscais ou incluídas em outro mapa de pedido.
  * **__Quant. Solicitada__***: Tipo NUMÉRICO. Formato: 99,99. 
  * **__Quant. Recebida__**: Tipo NUMÉRICO. Formato: 99,99.
  * **__Valor do Item__**: Tipo NUMÉRICO.
  * **__Total solicitado__**: Tipo NUMÉRICO. Somatório das quantidades solicitadas.
  * **__Total Valor Solicitado__**: Tipo NUMÉRICO. Somatório do valor solicitado de cada item (Quant. Solicitada x Valor do Item).
  * **__Total Recebido__**: Tipo NUMÉRICO. Somatório das quantidades solicitadas.
  * **__Total Valor Recebido__**: Tipo NUMÉRICO. Somatório do valor solicitado de cada item (Quant. Solicitada x Valor do Item).

E são solicitadas as seguinte informações:

  * **__Responsável pelo recebimento__***: Tipo TEXTO.
  * **__Cargo__***: Tipo TEXTO.
  * **__CPF__***: Tipo TEXTO. Formato: 999.999.999-99.

Após preencher as informações, o mapa tem seu status alterado para pendente e o sistema envia um email para o responsável da unidade do almoxarifado com as seguintes informações:

O mapa de pedido número 9.../AAAA foi recebido em #DD/MM/AAAA HH:MM:SS# no sistema pelo usuário #NOMEDAPESSOA(LOGIN)#, sendo informado os seguintes dados do recebedor:

#RESPONSAVEL_RECEBIMENTO#

#CARGO#

#CPF#



O caso de uso é finalizado.
===== Principais Regras de Negócio =====

  * **RN01**: São exibidos somente os mapas de pedido do fornecedor logado no sistema.
  * **RN02**: Serão exibidas apenas os mapas com status pendente de recebimento.
 
==== Resoluções/Legislações Associadas ====
Não se Aplica.

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

^ Classe                                                                     ^ Tabela                                  ^
| br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedido.java              | almoxarifado.mapa_pedido                |
| br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedidoEmpenho.java       | almoxarifado.mapa_pedido_empenho        |
| br.ufrn.sipac.almoxarifado.mapapedido.dominio.MapaPedidoEmpenhoItens.java  | almoxarifado.mapa_pedido_empenho_itens  |







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

Sistema: SIPAC

Módulo: Portal do Fornecedor

Link(s): SIPAC → Portal do Fornecedor → Empenhos → Consulta de Mapa de Pedido de Material. 

Usuário: litudo (o usuário deve ser do tipo credor)


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

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

  - Cadastrar mais de um mapa de pedido de material para mais de um fornecedor, pelo almoxarifado;
  - Acessar o caso de uso e verificar se o fornecedor está vendo apenas os seus mapas;
  - Estornar um mapa de pedido;
  - Tentar buscar o mapa pelo número/ano e por quais filtros de busca;
  - Testar a busca utilizando cada filtro em separado e a junção de pelo menos dois; 
  
  
===== Dados para o Teste =====
Não se aplica.