~~ODT~~
====== Notificar Fornecedor ======

Este Caso de Uso tem a finalidade de notificar o fornecedor de que existe alguma pendência com a instituição.

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

O caso de uso é acionado quando o usuário acessa a opção: //SIPAC → Módulo Contratos → Aba Geral → Contrato → Contratos a Vencer//, e seleciona a funcionalidade de "Notificar Fornecedor".

Ao selecionar o contrato para Notificação do Fornecedor serão exibidos os Dados (Tela:"//Notificar Fornecedor//").
Teremos dois fluxos diferentes que serão direcionados dependendo do tipo de contrato em atraso.

=== Fluxo 1 - Notificar Contratos de Obras e Engenharia ===

Selecionando um contrato de obras e engenharia, será exibido os dados do contrato de obra:

  * **Título da janela**:"//Resumo da Obra//"
  * **__Requisição__**: O sistema exibirá o Número da Requisição/Ano. Formato 99999/AAAA. Tipo: NUMÉRICO
  *  **__Area (m²)__**: Area de construção da obra. Tipo NUMÉRICO.
  * **__Descrição da Obra__**: Informações sobre os servições realizados. Tipo TEXTO.
  * **__Unidade__**. Formato NOME UNIDADE (CODIGO). Tipo TEXTO.
  * **__Fonte de Recursos__**: Orgão que enviou os recursos. Exemplo: TESOURO - EDUCAÇÃO. Tipo TEXTO.
  * **__Empresa__**: Nome da empresa. Formato NOME EMPRESA - CNPJ. Tipo Texto.
  * **__Cargo do Fiscal__**: Nome da função do contrato. Tipo TEXTO.
  * **__Fiscal__**: Nome do Fiscal. Tipo TEXTO.
  * **__Status__**: Situação do contrato. Tipo TEXTO.
  * **__Dias da Vigência__**: Quantidade dias do contrato. Formato 999. Tipo NUMÉRICO.
  * **__Período de Vigência__**: Formato DD/MM/AAAA a DD/MM/AAAA. Tipo DATA.
  * **__Período de Execução da Obra__**: Formato DD/MM/AAAA a DD/MM/AAAA. Tipo DATA.


 O sistema exibirá um formulário com os campos para preenchimento, conforme são descritos (Nome da janela: "//Dados da Notificação//"):

  * **Número**: Formato: 999, Tipo: NUMÉRICO.
  * **Ano**: Formato AAAA, Tipo: DATA.
  * **Prazo máximo (dias)**: Formato: 999, Tipo: NUMÉRICO ([[#PRINCIPAIS REGRAS DE NEGÓCIO|RN01]]).
  * **Data Cadastro**: Formato: DD/MM/AAAA, Tipo: DATA. Por padrão o sistema deverá exibir a data de corrente.
  * **Documento**: Tipo: TEXTO. Refere-se ao tipo do documento, número e ano.
  * **Solicitante**: Tipo: TEXTO.
  * **Tipo**: Tipo: LÓGICO. O sistema deverá exibir duas opções, Fornecedor (opção padrão) ou Prazo.
  * **Informações Adicionais**: Tipo: TEXTO. Informações adicionais a notificação([[#PRINCIPAIS REGRAS DE NEGÓCIO|RN02]]).
  * **Considerar na Notificação**: Tipo: LÓGICO. Qual a data padrão deverá ser utilizada na notificação de prazo. Esse campo só deverá ser exibido quando a notificação for do tipo "Prazo".
  * **Destinatário**: Tipo: TEXTO. O usuário poderá adicioncar informações em relação ao fornecedor, como Nome, CNJP entre outras informações.


O usuário confirmando a notificação, o sistema exibirá o modelo do documento, conforme segue:

{{ :desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:screenshot221.png |Notificação Fornecedor.png}}


=== Fluxo 2 - Notificar outros tipos de Contratos ===

Selecionando um contrato de outros tipos, serão exibidos os dados de contratos, especificados em: [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:contrato_detalhado|Contrato Detalhado.]]
 
 O sistema exibirá um formulário com os campos para preenchimento, conforme são descritos (Nome da janela: "//Dados da Notificação//"):

  * **Número**: Formato: 999, Tipo: NUMÉRICO.
  * **Ano**: Formato AAAA, Tipo: DATA.
  * **Prazo máximo (dias)**: Formato: 999, Tipo: NUMÉRICO ([[#PRINCIPAIS REGRAS DE NEGÓCIO|RN01]]).
  * **Data Cadastro**: Formato: DD/MM/AAAA, Tipo: DATA. Por padrão o sistema deverá exibir a data de corrente.
  * **Documento**: Tipo: TEXTO. Refere-se ao tipo do documento, número e ano.
  * **Solicitante**: Tipo: TEXTO.
  * **Tipo**: Tipo: LÓGICO. O sistema deverá exibir duas opções, Fornecedor (opção padrão) ou Prazo.
  * **Informações Adicionais**: Tipo: TEXTO. Informações adicionais a notificação. O campo só deverá ser exibido quando a notificação for tipo "Fornecedor".
  * **Destinatário**: Tipo: TEXTO. O usuário poderá adicioncar informações em relação ao fornecedor, como Nome, CNJP entre outras informações.


O usuário confirmando a notificação, o sistema exibirá o modelo do documento, conforme segue:

{{ :desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:notificacao_outros_contratos.jpg |Notificação outros contratos.jpg}}


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

  * **RN01**- O prazo tem que ser maior do que zero.
  * **RN02**- Para os Contratos de Obras e Engenharia, o campo //Informações Adicionais// só deverá ser exibido quando a notificação for tipo "Fornecedor". Os outros tipos de contrato ele será de preenchimento obrigatório.
  * **RN03**- Para os Contratos de Obras e Engenharia, o campo //Considerar na Notificação// só deverá ser exibido quando a notificação for tipo "Prazo".

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


^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato                              | administrativo.contratos.contrato                |
| br.ufrn.sipac.contratos.dominio.SubTipoContrato                       | administrativo.contratos.SubTipoContrato         |
| br.ufrn.sipac.contratos.dominio.TipoCaptacaoRecurso                   | administrativo.convenios.TipoCaptacaoRecurso     |
| br.ufrn.sipac.cadastro.dominio.Unidade                                | administrativo.comum.unidade                     |
| br.ufrn.sipac.liquidacao.acompanhamento.dominio.NotificacaoFornecedor | administrativo.liquidacao.NOTIFICACAO_FORNECEDOR |

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

Sistema: SIPAC

Módulo: Contrato

Link(s): SIPAC → Módulo Contratos → Aba Geral → Contrato → Contratos a Vencer   
  
Usuário: rcsl

Papel que usuário deve ter: SipacPapeis.GESTOR_OBRAS, SipacPapeis.GESTOR_SISTEMA_INFRA_ESTRUTURA, SipacPapeis.GESTOR_INSTITUICAO, SipacPapeis.GESTOR_CONTRATO, SipacPapeis.GESTOR_CONTRATOS_GLOBAL ou SipacPapeis.GESTOR_OBRAS_FUNDACAO

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

  * Tentar selecionar um contrato a vencer, e notificar um fornecedor sobre a irregularidade.

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

Pode-se cadastrar um contrato no caso de uso de Cadastrar Contrato ( [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:cadastrar_editar_contrato:academico|Acadêmico]], [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:cadastrar_editar_contrato:despesa|Despesa]], [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:cadastrar_editar_contrato:auto_incremento|Auto incremento]] ou [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:geral:contrato:cadastrar_editar_contrato:receita|Receita]]) cadastrando com a data de término próxima da data atual para que ele entre nas condições de estar prestes a vencer, ou mesmo pode se utilizar de contratos já existentes que atendam a essa necessidade.