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

====== Fornecedores com Ocorrência ======

Cada fornecedor apresenta um registro de ocorrências para a instituição. Uma ocorrência pode ser de vários do tipos: multa, advertência, atraso na entrega de materiais/serviços, entre outras. 
Esse caso de uso tem a finalidade de emitir um relatório dos fornecedores com os seus registros de ocorrências. Envolvidos: DMP (Departamento de Material e Patrimônio) - Setor de Liquidação de Despesas.

Pré-condições: O usuário deve possuir um dos seguintes perfis: Gestor de Liquidação de Despesas, Gestor de Compras, Gestor de Licitação, Gestor de Almoxarifado ou Excutor de Orçamento Global para executar esta funcionalidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Liquidação de Despesas → Aba Relatórios → Fornecedor → Fornecedores com Ocorrência.//

O sistema solicita que informe no mínimo umas dos seguintes dados para busca:
  * **Unidade Gestora***: Formato - SIGLA DA UNIDADE (CÓDIGO), TIPO - TEXTO.
  * **Tipo de Ocorrência**: Tipo - TEXTO.
  * **Período**: Formato - DD/MM/AAAA a DD/MM/AAAA, Tipo - DATA. Corresponde ao Período das ocorrências.
  * **Fornecedor**: Tipo - TEXTO. Entrada de dados: NÚMERO DO DOCUMENTO ou NOME DO FORNECEDOR. Este campo corresponde ao Fornecedor que apresenta as ocorrências.

O sistema emite o relatório com as ocorrências agrupadas pelos seus tipos. Modelo do documento:

**__Tipo de Ocorrências__.**

^Data ^Número ^Processo^Fornecedor^Valor^Empenho(s)^Status^Observação^
|DD/MM/AAAA|9.../AAAA|9.../AAAA|99.999.999/9999-99 - NOME | R$ 9,99 | 9.../AAAA |CADASTRADA |Multa aplicada através da Portaria nº9.../AAAA-X, de DD/MM/AAAA |
|DD/MM/AAAA|9.../AAAA|9.../AAAA|99.999.999/9999-99 - NOME | R$ 9,99 | 9.../AAAA |CADASTRADA |Multa aplicada através da Portaria nº9.../AAAA-X, de DD/MM/AAAA |
| |||||||**Número de Ocorrências: 2**|

**Total Geral de Ocorrências: 2**


Para determinados tipos de ocorrência, o sistema exibe dados adicionais:
  * A informação do **Processo**: é exibida apenas para os tipos : ''MULTA'', ''SUSPENSÃO'', ''ADVERTÊNCIA'' e ''REATIVAÇÃO''.
  * As informações dos **Empenhos**: é exibida em quase todos os tipos. Apenas quando as ocorrências forem do tipo ''SUSPENSÃO'' ou ''CONTATO COM O FORNECEDOR'' os empenhos serão omitidos.
  * Para o tipo ''SUSPENSÃO'', o sistema exibe:
      * **__Multa Associada__**
      * **__Período de Suspensão__**
  * Para o tipo MULTA, o sistema exibe:
      * **__Valor__**

O caso de uso é finalizado.


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

  * **RN01** - O usuário logado só poder ver dados para as unidades que o papel GESTOR LIQUIDAÇÃO tem permissão. Por exemplo, o usuário com login: pedro pertence a unidade 14.00(CT), mas foi cadastrada a permissão de GESTOR LIQUIDAÇÃO para (11.00) e (23.00) então ele possui a permissão para ver dados apenas da 11.00 e 23.00 e não possui permissão para 1400. Já o usuário que tiver o papel GESTOR LIQUIDAÇÃO e tiver unidade de permissão igual a nulo poderá ver os dados de todas as unidades. 
==== Resoluções/Legislações Associadas ====

Não se Aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.liquidacao.acompanhamento.dominio.OcorrenciaFornecedor | administrativo.liquidacao.ocorrencia_fornecedor |
| br.ufrn.sipac.liquidacao.acompanhamento.dominio.TipoOcorrenciaFornecedor | administrativo.liquidacao.tipo_ocorrencia_fornecedor|
| br.ufrn.sipac.cadastro.dominio.Pessoa (Fornecedor)| administrativo.public.pessoa  |

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

Sistema: SIPAC

Módulo: Liquidação de Despesa

Link(s): 
  * Liquidação de Despesas -> Relatórios -> Fornecedores com Ocorrência

Usuário: paulinho

Papel que usuário deve ter: SipacPapeis.GESTOR_LIQUIDACAO
  
===== Cenários de Teste =====

Não se aplica. 

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

As ocorrências podem ser consultadas no sistema pelo caminho:

  * Liquidação de Despesas -> Acompanhamento de Entregas -> Penalização -> Consultar/Alterar Ocorrência

Caso se deseje registrar uma ocorrência para um fornecedor, para após ser verificado no relatório, isto pode ser feito pelo caminho: 

  * Liquidação de Despesas -> Acompanhamento de Entregas -> Penalização -> Registrar Ocorrência para o Fornecedor