~~ODT~~ ====== Remanejar Internamente ====== O Remanejamento interno tem como objetivo realizar uma operação para um contrato com valor global, que deseja redistribuir os valores das unidades beneficiadas. Esta operação diminui o valor e o saldo de uma unidade incrementando em outra, que já pode ser existente ou ser uma nova unidade beneficiada. Tal operação pode ser realizada pelo gestor de contrato acessando o link: SIPAC -> Módulo Contratos -> Aba Alteração Contratual -> Alterações -> Remanejar Internamente. ===== Descrição do Caso de Uso ===== Para remanejar internamente o contrato, é necessário selecionar o contrato, informando o dados na tela //Buscar Contrato//. Todos os campos deve ser preenchidos: * **Número**: Número identificador do contrato. * **Ano do Contrato**: Ano em que o contrato foi cadastrado. * **Contrato Externo?**: Este campo possui as opções //Sim// para caso o contrato desejado seja um contrato externo (normalmente um contrato da FUNPEC) ou //Não// para caso seja um contrato interno (da própria UFRN). ([[#principais_regras_de_negócio|RN01]]) Efetuada a busca([[#principais_regras_de_negócio|RN02]]), o sistema exibe os contratos (caso exista mais de um contrato, se não o sistema irá redirecionar para tela de remanejamento interno do contrato) encontrados para que o Gestor de Contratos possa escolher o que deseja. Os contratos exibem os seguintes campos: * **__Número__**: Tipo - NUMÉRICO. Apresenta o formato //Número/Ano//. * **__Empresa__**: Tipo - TEXTO. Nome ou Razão Social do contratado. * **__Tipo__**: Tipo - TEXTO. Indica o tipo do contrato. Este pode ser //Acadêmico//, //Despesa/Global//, //Despesa/Ordinário// ou //Receita//. As definições dos tipos de contratos podem ser visualizas no [[desenvolvimento:especificacoes:sipac:contratos:negocio|documento de negócio]]. * **__Cadastro__**: Tipo - TEXTO. Data em que o contrato foi cadastrado. * **__Login Cadastro__**: Tipo - TEXTO. Login do usuário que cadastrou o contrato. Ao selecionar o contrato desejado, o sistema exibe os seguintes dados do contrato (Tela "//Remanejamento Interno do Contrato//"): * **__Número do Contrato__**: Tipo - NUMÉRICO. Apresenta o formato //Número/Ano//. * **__Status__**: Tipo - TEXTO. Situação atual do contrato. Os possíveis status de um contrato são: //ABERTO//, //FINALIZADO// ou //ESTORNADO//. * **__Tipo do Contrato__**: Tipo - TEXTO. Indica o tipo do contrato. * **__Subtipo do Contrato__**: Tipo - TEXTO. Denominação do produto ou serviço requisitado. Pode ser //AQUISIÇÃO DE LIVROS//, //LOCAÇÃO DE MÃO-DE-OBRA//, //MANUTENÇÃO DE VEÍCULOS//, //OBRAS E SERVIÇOS DE ENGENHARIA// ou //SERVIÇOS DE LIMPEZA//. O sistema deve mostrar uma opção para visualizar arquivo do contrato. * **__Data da Assinatura__**: Tipo - DATA. Data da assinatura do contrato. * **__Data de Início__**: Tipo - DATA. Data em que o contrato se inicia. * **__Data de Término__**: Tipo - DATA. Data em que o contrato termina. * **__Data da Publicação__**: Tipo - DATA. Data em que o documento foi publicado. * **__Denominação__**: Tipo - TEXTO. * **__Objeto do Contrato__**: Tipo - TEXTO. Descrição geral do serviço ou produto fornecido pelo contrato. * **__Continuado__**: Tipo - LÓGICO. Indica se a prestação de serviços será executada de forma contínua ou não. * **__Permite Acréscimo__**: Tipo - LÓGICO. * **__Valor Inicial do Contrato__**: Tipo - MOEDA. É o valor acordado na criação do documento contratual. * **__Valor Atual do Contrato__**: Tipo - MOEDA. É o valor vigente para o contrato. Caso não tenha havido necessidade de mudança, este valor é o mesmo do inicial. * **__Saldo Atual__**: Tipo - MOEDA. É o montante disponível para ser usado com itens do contrato até o seu término. * **__Licitação__**: Tipo - TEXTO. Formato - NOME DA MODALIDADE - 99999/AAAA (Processo: 99999.999999/AAAA-99). É o procedimento administrativo para contratação de serviços ou aquisição de produtos pela Administração Federal, Estadual e Municipal. * **__Processo de Compra__**: Tipo - TEXTO.([[#principais_regras_de_negócio|RN05]]) * **__Permite inserção de notas fiscais pela gestora?__**:Tipo - LÓGICO. Pode assumir os valores //Sim// ou //Não//. * **__Permite inserção de notas fiscais pelos fornecedores?__**: Tipo - TEXTO. Pode assumir os valores //Sim// ou //Não//. * **__Cadastrador__**: Tipo - TEXTO. Login do usuário que cadastrou o contrato. * **__Contratado__**: Tipo - TEXTO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Número do CEI__**: Tipo - NUMÉRICO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Endereço__**: Tipo - TEXTO. Telefone do contratado. * **__Cidade/UF__**: Tipo - TEXTO. Telefone do contratado. * **__Telefones__**: Tipo - TEXTO. Telefone do contratado. * **__E-mail__**: Tipo - TEXTO. Endereço eletrônico do contratado. Abaixo da tela de detalhamento do contrato, será exibida uma listagem com as unidades beneficiadas e o valor dos benefícios correspondentes, com os seguintes campos: * **__Unidade__**: Tipo - TEXTO. Nome da unidade beneficiada, no formato: Nome (Código); * **__Valor Total__**: Tipo - MOEDA. Valor total do benefício da unidade (em R$); * **__Saldo Atual__**: Tipo - MOEDA. Saldo (em R$) do benefício disponível para unidade em relação ao utilizado; * **__Valor Atual Contratual das Unidades Beneficiadas__**: Tipo - MOEDA. Somatório de todos os benefícios das unidades associadas a esse contrato. Em seguida estará disponível um formulário para a descrição do Remanejamento de Contrato, com os requisitos: ***Instrumento Normativo***: Tipo - LÓGICO. ***Valor***: O usuário deve informar o valor. Caso não seja informado ou o valor digitado for igual a zero o sistema deve exibir a mensagem: "//Valor inválido. O valor deve ser um número válido e maior que zero.//" ***Unidade Origem***: O usuário deve selecionar a unidade em um lista. ***O usuário poderá escolher uma //unidade destino// ou uma //nova unidade beneficiada//:** ***Unidade de destino*:** Caso seja selecionada, o usuário deverá escolher uma unidade na lista. ***Nova Unidade Beneficiada*:** Caso seja selecionada, o usuário deverá escolher uma unidade na lista ou digitar o código da unidade. O sistema deverá disponibilizar uma opção para busca da unidade em nova janela. Ao selecionar a opção de **Cadastrar**([[#principais_regras_de_negócio|RN03 e RN04]]), o sistema deve exibir a tela de confirmação do remanejamento com título: "//Confirmar Remanejamento Interno do Contrato //", conforme descrita abaixo: * **__Número do Contrato__**: Tipo - NUMÉRICO. Apresenta o formato //Número/Ano//. * **__Status__**: Tipo - TEXTO. Situação atual do contrato. Os possíveis status de um contrato são: //ABERTO//, //FINALIZADO// ou //ESTORNADO//. * **__Tipo do Contrato__**: Tipo - TEXTO. Indica o tipo do contrato. * **__Subtipo do Contrato__**: Tipo - TEXTO. Denominação do produto ou serviço requisitado. Pode ser //AQUISIÇÃO DE LIVROS//, //LOCAÇÃO DE MÃO-DE-OBRA//, //MANUTENÇÃO DE VEÍCULOS//, //OBRAS E SERVIÇOS DE ENGENHARIA// ou //SERVIÇOS DE LIMPEZA//. O sistema deve mostrar uma opção para visualizar arquivo do contrato. * **__Data da Assinatura__**: Tipo - DATA. Data da assinatura do contrato. * **__Data de Início__**: Tipo - DATA. Data em que o contrato se inicia. * **__Data de Término__**: Tipo - DATA. Data em que o contrato termina. * **__Data da Publicação__**: Tipo - DATA. Data em que o documento foi publicado. * **__Denominação__**: Tipo - TEXTO. * **__Objeto do Contrato__**: Tipo - TEXTO. Descrição geral do serviço ou produto fornecido pelo contrato. * **__Continuado__**: Tipo - LÓGICO. Indica se a prestação de serviços será executada de forma contínua ou não. * **__Permite Acréscimo__**: Tipo - LÓGICO. * **__Valor Inicial do Contrato__**: Tipo - MOEDA. É o valor acordado na criação do documento contratual. * **__Valor Atual do Contrato__**: Tipo - MOEDA. É o valor vigente para o contrato. Caso não tenha havido necessidade de mudança, este valor é o mesmo do inicial. * **__Saldo Atual__**: Tipo - MOEDA. É o montante disponível para ser usado com itens do contrato até o seu término. * **__Licitação__**: Tipo - TEXTO. Formato - NOME DA MODALIDADE - 99999/AAAA (Processo: 99999.999999/AAAA-99). É o procedimento administrativo para contratação de serviços ou aquisição de produtos pela Administração Federal, Estadual e Municipal. * **__Processo de Compra__**: Tipo - TEXTO.([[#principais_regras_de_negócio|RN05]]) * **__Permite inserção de notas fiscais pela gestora?__**:Tipo - LÓGICO. Pode assumir os valores //Sim// ou //Não//. * **__Permite inserção de notas fiscais pelos fornecedores?__**: Tipo - TEXTO. Pode assumir os valores //Sim// ou //Não//. * **__Cadastrador__**: Tipo - TEXTO. Login do usuário que cadastrou o contrato. * **__Contratado__**: Tipo - TEXTO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Número do CEI__**: Tipo - NUMÉRICO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Endereço__**: Tipo - TEXTO. Telefone do contratado. * **__Cidade/UF__**: Tipo - TEXTO. Telefone do contratado. * **__Telefones__**: Tipo - TEXTO. Telefone do contratado. * **__E-mail__**: Tipo - TEXTO. Endereço eletrônico do contratado. ***Unidades Beneficiadas com a Operação ** ***__Unidade__**: Tipo - TEXTO. Exemplo de unidade -> HOSPITAL UNIVERSITÁRIO ONOFRE LOPES(21.00) ***__Valor Total__**: Tipo - MOEDA. Deve ser exibido no formato -> R$ 0,00 ***__Saldo Atual__**: Tipo - MOEDA. Deve ser exibido no formato -> R$ 0,00 ***__Valor da Operação__**: Tipo - TEXTO. Deve ser exibido no formato -> R$ 0,00 ***__Valor Atual Contratual das Unidades Beneficiadas__**: Tipo - MOEDA. deve ser exibido no formato -> R$ 0,00 ***Confirmação de Remanejamento** ***__Instrumento Normativo__**: Tipo - TEXTO. ***__Valor__:** Tipo - MOEDA. Valor a ser remanejado. Exibir no formato R$0,00 ***__Unidade Origem__**: Tipo - TEXTO. deve ser exibido no formato -> R$ 0,00 ***__Unidade Destino__**: Tipo - TEXTO. deve ser exibido no formato -> R$ 0,00 Com a confirmação do usuário, o sistema deverá exibir o comprovante seguindo com os dados ("//Comprovante - Contratos//"): * **__Número do Contrato__**: Tipo - NUMÉRICO. Apresenta o formato //Número/Ano//. * **__Status__**: Tipo - TEXTO. Situação atual do contrato. Os possíveis status de um contrato são: //ABERTO//, //FINALIZADO// ou //ESTORNADO//. * **__Tipo do Contrato__**: Tipo - TEXTO. Indica o tipo do contrato. * **__Subtipo do Contrato__**: Tipo - TEXTO. Denominação do produto ou serviço requisitado. Pode ser //AQUISIÇÃO DE LIVROS//, //LOCAÇÃO DE MÃO-DE-OBRA//, //MANUTENÇÃO DE VEÍCULOS//, //OBRAS E SERVIÇOS DE ENGENHARIA// ou //SERVIÇOS DE LIMPEZA//. O sistema deve mostrar uma opção para visualizar arquivo do contrato. * **__Data da Assinatura__**: Tipo - DATA. Data da assinatura do contrato. * **__Data de Início__**: Tipo - DATA. Data em que o contrato se inicia. * **__Data de Término__**: Tipo - DATA. Data em que o contrato termina. * **__Data da Publicação__**: Tipo - DATA. Data em que o documento foi publicado. * **__Denominação__**: Tipo - TEXTO. * **__Objeto do Contrato__**: Tipo - TEXTO. Descrição geral do serviço ou produto fornecido pelo contrato. * **__Continuado__**: Tipo - LÓGICO. Indica se a prestação de serviços será executada de forma contínua ou não. * **__Permite Acréscimo__**: Tipo - LÓGICO. * **__Valor Inicial do Contrato__**: Tipo - MOEDA. É o valor acordado na criação do documento contratual. * **__Valor Atual do Contrato__**: Tipo - MOEDA. É o valor vigente para o contrato. Caso não tenha havido necessidade de mudança, este valor é o mesmo do inicial. * **__Saldo Atual__**: Tipo - MOEDA. É o montante disponível para ser usado com itens do contrato até o seu término. * **__Licitação__**: Tipo - TEXTO. Formato - NOME DA MODALIDADE - 99999/AAAA (Processo: 99999.999999/AAAA-99). É o procedimento administrativo para contratação de serviços ou aquisição de produtos pela Administração Federal, Estadual e Municipal. * **__Processo de Compra__**: Tipo - TEXTO.([[#principais_regras_de_negócio|RN05]]) * **__Permite inserção de notas fiscais pela gestora?__**:Tipo - LÓGICO. Pode assumir os valores //Sim// ou //Não//. * **__Permite inserção de notas fiscais pelos fornecedores?__**: Tipo - TEXTO. Pode assumir os valores //Sim// ou //Não//. * **__Cadastrador__**: Tipo - TEXTO. Login do usuário que cadastrou o contrato. * **__Contratado__**: Tipo - TEXTO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Número do CEI__**: Tipo - NUMÉRICO. Nome da Pessoa Física ou Razão Social da Pessoa Jurídica contratada para fornecer o serviço ou produto. * **__Endereço__**: Tipo - TEXTO. Telefone do contratado. * **__Cidade/UF__**: Tipo - TEXTO. Telefone do contratado. * **__Telefones__**: Tipo - TEXTO. Telefone do contratado. * **__E-mail__**: Tipo - TEXTO. Endereço eletrônico do contratado. * **Unidades Beneficiadas** ***__Unidade__**: Tipo - TEXTO. ***__Valor Total__**: Tipo - MOEDA. Deve ser exibido no formato -> R$ 0,00 ***__Saldo Atual__**: Tipo - MOEDA. Deve ser exibido no formato -> R$ 0,00 O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - Somente exibido se o sistema estiver habilitado para contratos externo. * **RN02** - Não é possível fazer um remanejamento interno em um contrato se o mesmo não possuir pelo menos uma unidade beneficiada associada a ele. * **RN03** - Na tela de "//Remanejamento Interno do Contrato//" se as unidades forem iguais, o sistema deverá exibir a mensagem: "//As unidades beneficiadas selecionadas como origem e destino devem ser diferentes.//" * **RN04** - Caso o valor informado seja maior que o Saldo Atual, o sistema deve criticar com a mensagem: "//O valor a ser remanejado deve ser menor ou igual ao saldo da unidade de origem.//" * **RN05** - A formatação do número único atribuído ao processo, quando da sua autuação, será constituído de quinze dígitos, devendo, ainda, ser acrescido de mais dois dígitos de verificação (DV) e, com o acréscimo dos dígitos verificadores, o número atribuído ao processo será composto por dezessete dígitos, separados em grupos (08008.000156/2010-31), conforme descrito abaixo: * I - o primeiro grupo é constituído de cinco dígitos, referentes ao código numérico atribuído a cada unidade protocolizadora e este código identifica o órgão de origem do processo, mantendo-se inalterado, de acordo com as faixas numéricas determinadas; * II - o segundo grupo é constituído de seis dígitos, separados do primeiro por um ponto e determina o registro seqüencial dos processos autuados, devendo este número ser reiniciado a cada ano; * III - o terceiro grupo, constituído de quatro dígitos, separado do segundo grupo por uma barra, indica o ano de formação do processo; e * IV - o quarto grupo, constituído de dois dígitos, separado do terceiro grupo por hífen, indica os Dígitos Verificadores (DV), utilizados pelos órgãos que façam uso de rotinas automatizadas. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.contratos.dominio.Contrato | administrativo.constratos.contrato | | br.ufrn.sipac.contratos.dominio.RemanejamentoContrato | administrativo.constratos.remanejamento_contrato | | br.ufrn.sipac.contratos.dominio.UnidadeBeneficiada | administrativo.constratos.unidade_beneficiada | | br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.comum.unidade | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Contratos Link(s): Alteração Contratual -> Alterações -> Remanejar Internamente Usuário: rcsl (GETSOR_CONTRATO), nnaa (GESTOR_CONTRATO_GLOBAL) Papel que usuário deve ter: GESTOR_CONTRATO ou GESTOR_CONTRATO_GLOBAL ===== Cenários de Teste ===== * Tentar acessar o uc informando um contrato que não possua unidades beneficiadas relacionadas a ele. O sistema deve bloquear a continuação do uc; * Tentar acessar o uc informando um contrato que possua unidades beneficiadas relacionadas a ele. O sistema deve seguir normalemnte o fluxo do uc; * Realizar um remanejamento entre unidades e verificar se ocorre algum comportamento inesperado ou anarmalidade no fluxo do uc; * Entrar com um valor que seja maior que o Saldo Atual do contrato, o sistema deve criticar a operação; ===== Dados para o Teste ===== * Efetuar um cadastro de um contrato e associar a ele uma ou mais unidades beneficiadas ao contrato. * SIPAC -> Contratos -> Aba Geral -> Contrato -> Cadastrar/Editar Contrato -> Auto-incremento (Por exemplo)