~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Cadastrar Contrato ====== Este caso de uso serve para que o usuário possa cadastrar um contrato externo, ou seja, um contrato referente a fundação. Uma visão mais ampla sobre os contratos pode ser vista no [[desenvolvimento:especificacoes:sipac:contratos:negocio| Documento de Negócio]] referente ao módulo de contratos. O caso de uso se encontra no menu Portal de Fundação na aba Contratos e deve ser utilizado pelo gestor de contratos da fundação. ===== Descrição do Caso de Uso ===== O acesso a este caso de uso pode ser realizado seguindo o caminho SIPAC -> Portal da Fundação -> Contratos -> Operações -> Cadastrar Contrato. ===Passo 1=== O caso de uso inicia solicitando o preenchimento obrigatório dos Dados do Contrato: * **Número/Ano***: Tipo - NUMÉRICO, formato: ...9/AAAA. * __**Subtipo**__: Tipo - TEXTO. * **Data de Assinatura***: Tipo - DATA, Formato - DD/MM/AAAA. * **Período do Contrato***: Tipo - DATA, Formato - DD/MM/AAAA a DD/MM/AAAA. * **Data de Publicação ***: Tipo DATA, Formato - DD/MM/AAAA. * **Valor Original (R$)***: Tipo - NUMÉRICO, Formato - 9.999,99. * **__Opções do Contrato__**: * **Necessita atesto?**: Tipo - LÓGICO. * **Continuado?**: Tipo - LÓGICO. Quando o contrato pode ser renovável por no máximo 5 anos. * **Permite inserção de notas fiscais pelas gestoras?**: Tipo - LÓGICO. * **Permite acréscimo?**: Tipo - LÓGICO. * **__Denominação/Programa__**: * **Denominação/Programa**: Tipo TEXTO. * **__Objeto do Contrato__**: Campo de descrição com informações completas acerca do contrato referenciado. * **Descrição**: Tipo TEXTO. * **__Dados do Fornecedor__**: * **Razão social**: Tipo - AUTOCOMPLETE, formato: DENOMINAÇÃO FORNECEDOR - DOCUMENTO CORRESPONDENTE. * **__Dados da licitação__**: * **Modalidade***: Tipo - TEXTO, Formato: NOME DA MODALIDADE. * **Número/Ano***: Tipo - NUMÉRICO, Formato: 9999/AAAA. * **Lei***: Tipo - TEXTO. Para as modalidades de ''DISPENSA DE LICITAÇÃO'', ''INEXIGIBILIDADE DE LICITAÇÃO''. * **Decreto***: Tipo - Texto. ([[#Principais Regras de Negócio| RN03]]) * **Artigo***: Tipo - TEXTO. Apenas para as modalidades de ''DISPENSA DE LICITAÇÃO'' e ''INEXIGIBILIDADE DE LICITAÇÃO'', mostrado após escolhida a lei. * **Inciso**: Tipo - TEXTO. Apenas para as modalidades de ''DISPENSA DE LICITAÇÃO'' e ''INEXIGIBILIDADE DE LICITAÇÃO'', mostrado após escolhido o artigo e este apresente incisos. Obrigatório para a modalidade ''DISPENSA DE LICITAÇÃO''. * **Caput**: Tipo - NUMÉRICO. Apenas para a modalidade de ''INEXIGIBILIDADE DE LICITAÇÃO'', mostrado após escolhido o artigo e este apresente incisos. * **Data de Abertura***: Tipo - DATA, Formato: DD/MM/AAAA. * **__Projeto de Pesquisa associado__**: Exibe uma lista com os projetos que poderão ser selecionados: * **Projeto Funpec***: Tipo - TEXTO, Formato - NOME DO PROJETO (CÓDIGO). * Após adicionar o projeto, o mesmo é inserido numa listagem onde são exibido as seguintes informações: * **__Título__**: Tipo - TEXTO. * **__Data de Início__**: Tipo - DATA, Formato - DD/MM/AAAA. * **__Data de Término__**: Tipo - DATA, Formato - DD/MM/AAAA. * Para cada projeto associados temos a opção: * **//Remover Projeto de Pesquisa//** ===Passo 2=== Nesse passo poderão ser informados os empenhos associados ao contrato * **__Tipo de Contrato__**: Tipo - TEXTO. * **__Licitação__**: * **__Processo de Compra__**: Formato - 99999.999999/AAAA-99, Tipo NUMÉRICO. * **__Licitação__**: Formato - TIPO DA LICITAÇÃO - 9/AAAA, Tipo - TEXTO e NUMÉRICO. * **__Contratado__**: * **__Fornecedor__**: Tipo - TEXTO e NUMÉRICO, Formato - NOME - CNPJ. * **__Empenhos do Contrato__**: [[#principais_regras_de_negocio|RN04]]. * **Empenho(Número/Ano)**: Formato 999/AAAA. Tipo NUMÉRICO. * **Data do Empenho**: Tipo DATA. * **Valor do Empenho**: Tipo NUMÉRICO. * **Projeto Funpec:**: Tipo - TEXTO, Formato - DENOMINAÇÃO (CÓDIGO). * Ao selecionar o projeto temos a opção //**Associar Projeto de Pesquisa**//, que associa o projeto escolhido ao empenho informado. * Para a associação do empenho ao contrato, existe a opção //**Inserir**//. * Abaixo são mostrados os empenhos já associados ao contrato: * **__Empenhos Inseridos ao Contrato__**: * **__Número__**: Tipo - NUMÉRICO, Formato - 999999. * **__Ano__**: Tipo - NUMÉRICO, Formato - AAAA. * **__Data__**: Tipo - DATA, Formato - DD/MM/AAAA. * **__Valor__**: Tipo - NUMÉRICO, Formato - R$ 9.9999,99. * **__Projeto Funpec__:***: Tipo - TEXTO, Formato - DENOMINAÇÃO (CÓDIGO). * Para cada empenho temos a opção: * //**Remover Empenho**// ===Passo 3=== * **__Número do Contrato__**: Formato - 999999/AAAA, Tipo NUMÉRICO. * **__Status__**: Tipo TEXTO. * **__Tipo do Contrato__**: Tipo TEXTO. * **__Subtipo do Contrato__**: Tipo TEXTO. * **__Data da Assinatura__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Início__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Término__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data da Publicação__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Duração__**: Tipo TEXTO.**** * **__Denominação__**: Tipo TEXTO. * **__Objeto do Contrato__**: Tipo TEXTO. * **__Continuado__**: Tipo LÓGICO. * **__Permite Acréscimo__**: Tipo LÓGICO. * **__Valor Inicial do Contrato__**: Tipo NUMÉRICO. * **__Valor Atual do Contrato__**: Tipo NUMÉRICO. * **__Saldo Atual__**: Tipo NUMÉRICO. * **__Permite inserção de notas fiscais pela gestora__**: Tipo - LÓGICO. * **__Dados da Licitação__**: * **__Licitação__**: Formato - NOME DA MODALIDADE - 999999/AAAA [INCISO do] ARTIGO da LEI, Tipo - TEXTO e Tipo NUMÉRICO. * **__Dados do Contratado__**: * **__Contratado__**: Formato - NOME DO CONTRATADO - 999.999.999-99, Tipo TEXTO. * **__Endereço__**: Tipo - TEXTO, Formato - LOGRADOURO. * **__Número CEI__**: Tipo - TEXTO. * **__Cidade/UF__**. Tipo - TEXTO, Formato - CIDADE/SIGLA UF. * **__Telefones__**: Tipo - NUMÉRICO, Formato - 99999999 [FAX: 99999999]. * **__E-mail__**: Tipo - TEXTO. * **__Exercício__**: para cada empenho associado ao contrato: * **__Empenho__**: Tipo - NUMÉRICO, Formato - 999999/AAAA. * **__Modalidade__**: Tipo - TEXTO. * **__Data__**: Tipo - DATA, Formato - DD/MM/AAAA. * **__P.TRes./F.R./N.D./Es.__**: Tipo - NUMÉRICO, Formato - 99999/9999999999/9999999/9. * **__Projeto de Pesquisa__**: Tipo - TEXTO, Formato - DENOMINAÇÃO DO PROJETO (CÓDIGO). * **__Valor__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * Abaixo são mostrados o resumo dos valores dos empenhos acima listados, para cada ano: * **__Ano__**: Tipo - NUMÉRICO, Formato - AAAA. * **__Valor Exerc.__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Empenhado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Reforçado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Anulado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Cancelado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo dos Empenhos__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo Atual__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. O sistema deve disponibilizar a opção para inserir as **//Unidades Beneficiadas//**. Seguindo para página de inserção das unidades conforme o descrito abaixo: * **__Dados do Contrato__**: * **__Valor Total__**: Formato R$ 9,99. Tipo NUMÉRICO. Corresponde ao Valor Total do Contrato. * **__Valor Atual do Contrato__**: Formato R$ 9,99. Tipo NUMÉRICO. Corresponde ao Valor atualizado do contrato. * **__Valor Restante__**: Formato R$ 9,99. Tipo NUMÉRICO. Valor que resta para ser utilizado. * **__Dados da Unidade Beneficiada__**: * **Unidade***: Tipo - TEXTO, - CÓDIGO | DENOMINAÇÃO UNIDADE. * **Valor Total (R$)**: Tipo - NUMÉRICO, Formato - 9.999,99. * **Valor Restante**: Tipo - LÓGICO. Após a inserção das Unidades Beneficiadas o sistema deve apresentar uma lista com os seguintes dados cadastrados: * **__Unidades Executoras__**: * **__Unidade__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). * **__Valor Total__**: Tipo - NUMÉRICO, Formato - 9.999,99. * **__Valor Total Contratual das Unidades Executoras__**: Tipo - NUMÉRICO, Formato - 9.999,99. * **__Valor Restante do Total do Contrato__**: Tipo - NUMÉRICO, Formato - 9.999,99. * Para cada unidade informada o usuário possui as opções: * **//Alterar//** * **//Remover//** ===Passo 4=== Continuando, o usuário chega na página de confirmação dos dados do contrato a ser cadastrado. Mostrando os dados gerais do cadastro: * **__Número do Contrato__**: Formato - 999999/AAAA, Tipo NUMÉRICO. * **__Status__**: Tipo TEXTO. * **__Tipo do Contrato__**: Tipo TEXTO. * **__Subtipo do Contrato__**: Tipo TEXTO. * **__Data da Assinatura__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Início__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Término__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data da Publicação__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Duração__**: Tipo TEXTO.**** * **__Denominação__**: Tipo TEXTO. * **__Objeto do Contrato__**: Tipo TEXTO. * **__Continuado__**: Tipo LÓGICO. * **__Permite Acréscimo__**: Tipo LÓGICO. * **__Valor Inicial do Contrato__**: Tipo NUMÉRICO. * **__Valor Atual do Contrato__**: Tipo NUMÉRICO. * **__Saldo Atual__**: Tipo NUMÉRICO. * **__Permite inserção de notas fiscais pela gestora__**: Tipo - LÓGICO. * **__Dados da Licitação__**: * **__Licitação__**: Formato - NOME DA MODALIDADE - 999999/AAAA [INCISO do] ARTIGO da LEI * **__Dados do Contratado__**: * **__Contratado__**: Formato - NOME DO CONTRATADO - 999.999.999-99, Tipo TEXTO. * **__Endereço__**: Tipo - TEXTO, Formato - LOGRADOURO. * **__Número CEI__**: Tipo - TEXTO. * **__Cidade/UF__**. Tipo - TEXTO, Formato - CIDADE/SIGLA UF. * **__Telefones__**: Tipo - NUMÉRICO, Formato - 99999999 [FAX: 99999999]. * **__E-mail__**: Tipo - TEXTO. * **__Exercício__**: para cada empenho associado ao contrato: * **__Empenho__**: Tipo - NUMÉRICO, Formato - 999999/AAAA. * **__Modalidade__**: Tipo - TEXTO. * **__Data__**: Tipo - DATA, Formato - DD/MM/AAAA. * **__P.TRes./F.R./N.D./Es.__**: Tipo - NUMÉRICO, Formato - 99999/9999999999/9999999/9. * **__Projeto de Pesquisa__**: Tipo - TEXTO, Formato - DENOMINAÇÃO DO PROJETO (CÓDIGO). * **__Valor__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * Abaixo são mostrados o resumo dos valores dos empenhos acima listados, para cada ano: * **__Ano__**: Tipo - NUMÉRICO, Formato - AAAA. * **__Valor Exerc.__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Empenhado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Reforçado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Anulado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Valor Cancelado__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo dos Empenhos__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Saldo Atual__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. Abaixo os dados da unidade beneficiadas informadas: * **__Unidades Executoras__**: * **__Unidade__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE). * **__Valor Total__**: Tipo - NUMÉRICO, Formato - 9.999,99. * **__Valor Total Contratual das Unidades Executoras__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. Ao final temos: **//CONFIRMA DADOS DO CADASTRO DO CONTRATO?//** === Passo 5 === Confirmando, é mostrado ao usuário o comprovante do cadastro com os dados gerais do contrato: * **__Dados Gerais do Contrato__**: * **__Número do Contrato__**: Formato - 999999/AAAA, Tipo NUMÉRICO. * **__Status__**: Tipo TEXTO. * **__Tipo do Contrato__**: Tipo TEXTO. * **__Subtipo do Contrato__**: Tipo TEXTO. * **__Data da Assinatura__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Início__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data de Término__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Data da Publicação__**: Formato - DD/MM/AAAA, Tipo DATA. * **__Duração__**: Tipo TEXTO. * **__Denominação__**: Tipo TEXTO. * **__Objeto do Contrato__**: Tipo TEXTO. * **__Continuado__**: Tipo LÓGICO. * **__Permite Acréscimo__**: Tipo LÓGICO. * **__Valor Inicial do Contrato__**: Tipo NUMÉRICO. * **__Valor Atual do Contrato__**: Tipo NUMÉRICO. * **__Saldo Atual__**: Tipo NUMÉRICO. * **__Cadastrado Por__**: Tipo - TEXTO. * **__Dados do Contratado__**: ***__Contratado__**: Formato - NOME DO CONTRATADO - 999.999.999-99, Tipo TEXTO. ***__Endereço__**: Tipo - TEXTO, Formato - LOGRADOURO. ***__Número CEI__**: Tipo - TEXTO. ***__Cidade/UF__**. Tipo - TEXTO, Formato - CIDADE/SIGLA UF. ***__Telefones__**: Tipo - NUMÉRICO, Formato - 99999999 [FAX: 99999999]. ***__E-mail__**: Tipo - TEXTO. * **__Dados da Licitação__**: * **__Processo de Compra__**: Formato - 99999.999999/AAAA-99) Tipo NUMÉRICO. * **__Licitação__**: Formato - SIGLA DA MODALIDADE - 999999/AAAA NOME DA MODALIDADE - [INCISO do] ARTIGO da LEI , Tipo - TEXTO e NUMÉRICO. * **__Empenhos do Contrato__**: para cada empenho associado ao contrato: * **__Numero__**: Tipo - NUMÉRICO, Formato - 999999. * **__Ano__**: Tipo - NUMÉRICO, Formato - AAAA. * **__Unidade Gestora__**: Tipo - TEXTO, Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE) * **__Data__**: Tipo - DATA, Formato - DD/MM/AAAA. * **__Valor__**: Tipo - NUMÉRICO, Formato - R$ 9.999,99. * **__Projeto de Pesquisa__**: Tipo - TEXTO, Formato - DENOMINAÇÃO DO PROJETO (CÓDIGO). O caso de uso é finalizado. ===== Principais Regras de Negócio ===== ***RN01** - Caso se deseje inserir um empenho ao contrato que está sendo cadastrado, é necessário que este empenho já exista na base de dados. ***RN02** - É possível adicionar mais de um projeto de pesquisa ao contrato que está sendo cadastrado. ***RN03** - Quando a modalidade de licitação for contratação direta o sistema deve solicitar que seja informado o decreto nº 8.241/2014. ***RN04** - Caso o empenho inserido não existe na base de dados, persistir a informação no orçamento do SIPAC. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho | administrativo.sco.empenho | | br.ufrn.sipac.patrimonio.comuns.ProjetoPesquisa | adiministrativo.patrimonio.projeto | | br.ufrn.sipac.cadastro.dominio.Unidade | adiministrativo.comum.unidade | | br.ufrn.sipac.contratos.dominio.Contrato | adiministrativo.contratos.contrato | ===== Plano de Teste ===== Sistema: SIPAC Módulo: Portal da Fundação Link(s): Sipac -> Portal da Fundação -> Contratos -> Operações -> Cadastrar Contrato Usuário: lucianaaranha Papel que usuário deve ter: * SipacPapeis.GESTOR_CONTRATOS_FUNDACAO ===== Cenários de Teste ===== Após acessar o caso de uso pelo caminho: Sipac -> Portal da Fundação -> Contratos -> Operações -> Cadastrar Contrato Efetuar o cadastro de contrato Acadêmico, entrando com os mais diversos dados nos campos discriminados acima para realização de testes de validação dos mesmos. Para verificar se o cadastro foi realizado com sucesso, basta acessar o seguinte caso de uso: Sipac -> Portal da Fundação -> Contratos -> Consultas -> Listar Contratos Verificar se na lista de contratos que será mostrada, está presente o contrato recém cadastrado. ===== Dados para o Teste ===== Para ter acesso as informações de número e ano de um empenho existente, basta realizar o seguinte select no banco adiministrativo. administrativo_update_geral: SELECT cod_empenho, ano FROM sco.empenho;