~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Adicionar Nota Fiscal ====== Para informações mais detalhadas acerca do processo de adição da nota fiscal, verifique a seguinte especificação: [[desenvolvimento:especificacoes:sipac:almoxarifado:casos_de_uso:estoque:estoque:nota_fiscal:cadastrar|Cadastrar Nota Fiscal do Módulo Almoxarifado]]. Esse caso de uso apenas implementa essa funcionalidade de forma diferente, tal qual descrita abaixo. ===== Descrição do Caso de Uso ===== O caso de uso inicia quando o usuário acessa SIPAC -> Módulo Contratos -> Aba Pagamento -> Nota Fiscal -> Adicionar Nota Fiscal. ** PASSO 1:** O Usuário informa um ou mais filtros especificados na consulta do caso de uso [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:listar_contratos| Listar Contratos ]] ([[#Principais_regras_de_negócio|RN14, RN25, RN30, RN31]]) ( [[#Principais_regras_de_negócio|RN22]] ) O Usuário seleciona o contrato para a inserção da nota fiscal **PASSO 2:** O sistema exibe as informações gerais especificadas no caso de uso [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:contrato_detalhado|Contrato Detalhado]] exibindo: * **__Dados do Contrato__**; * **__Arquivos de Detalhamento de Contrato__**; * **__Unidades Beneficiadas__**; ( [[#Principais_regras_de_negócio|RN10, RN11, RN13]] ) O Sistema solicita os dados da NF: * **Tipo da Nota***: Tipo LÓGICO. Opções: Tradicional ou Eletrônica. * **Medição**: Tipo - TEXTO( [[#Principais_regras_de_negócio|RN15]] ). * **Série***: Tipo - TEXTO ( [[#Principais_regras_de_negócio|RN01]] ). * **Número da Nota***: Tipo NUMÉRICO. ([[#Principais_regras_de_negócio|RN01]]), ([[#Principais_regras_de_negócio|RN34]]) * **Valor da Nota (R$)***: Tipo NUMÉRICO * **Data de Emissão***: Tipo - DATA. Formato DD/MM/AAAA. ( [[#Principais_regras_de_negócio|RN06]] ) * **Data de Atesto**: Tipo - DATA. Formato DD/MM/AAAA. * **Código de Autenticação:** Tipo TEXTO. ( [[#Principais_regras_de_negócio|RN02]] ) * **Arquivo:** Tipo TEXTO. * opção para visualizar arquivo. ( [[#Principais_regras_de_negócio|RN03]] ) * **Está associada com requisição?** Tipo LÓGICO. Opções: SIM ou NÃO. ( [[#Principais_regras_de_negócio|RN16]] ) ( [[#Principais_regras_de_negócio|RN35]] ) O sistema exibe a prorrogação e seus valores restantes para o contrato ( [[#Principais_regras_de_negócio|RN32]] ), ( [[#Principais_regras_de_negócio|RN33]] ): * **Valores contingenciados por prorrogação:** Tipo - Numérico. O sistema exibe a prorrogação (período), valor a descontar e opção para selecionar a prorrogação desejada. Associar requisições à nota fiscal. ( [[#Principais_regras_de_negócio|RN16 e RN24]] ) * **Número:** Tipo NUMÉRICO. * **Valor:** Tipo NUMÉRICO. * **Ano:** Tipo NUMÉRICO. * **Tipo da Requisição:** Tipo NUMÉRICO. * Opção para adicionar a requisição. ( [[#Principais_regras_de_negócio|RN09 e RN12]] ) Associação das requisições são exibidas as requisições já associadas a nota fiscal: ( [[#Principais_regras_de_negócio|RN04]] ) * **__Número__**: Tipo - NUMÉRICO. * **__Ano__**: Tipo - NUMÉRICO. * **__Tipo da Requisição__**: Tipo NUMÉRICO. * O sistema exibe opção para remover da lista as requisições associadas. O Sistema solicita os dados das unidades beneficiadas pela nota fiscal: ([[#Principais_regras_de_negócio|RN07 e RN08]]) * **Unidade Beneficiada**: Tipo - TEXTO. Formato: UNIDADE (CÓDIGO DA UNIDADE). * **Nova Unidade Beneficiada** (somente para contratos de autoincremento): Tipo - TEXTO. Formato: UNIDADE (CÓDIGO DA UNIDADE). ([[#Principais_regras_de_negócio|RN05]]) * **Valor para a Unidade (R$)***: Tipo - NUMÉRICO. O usuário confirma a inserção das Unidades Beneficiadas e o sistema exibe a lista: * **__Unidade Beneficiada__** * **__Série__** * **__Número__** * **__Valor para a Unidade (R$)__** * OPção de visualizar: O sistema exibe informações da referencia: **__Mês__**, **__Ano__** e **__Valor__**. * Opção de remover. O Usuário associa as referências da NF e Unidades Beneficiadas: * **Mês**: Tipo TEXTO. * **Ano**: Tipo NUMÉRICO. * **Valor**: Tipo NUMÉRICO. * Opção para adicionar referência. ([[#Principais_regras_de_negócio|RN17]]) * Para contratos com categorias de gastos cadastradas o sistema solicita ao usuário que informe os valores de cada categoia. Abaixo do formulário de associação das referências são exibidas as referências já associadas à unidade beneficiada: * **__Mês__**: Tipo - NUMÉRICO. * **__Ano__**: Tipo - NUMÉRICO. * **__Valor__**: Tipo - MOEDA. * O sitema exibe opção pare remover categoria. Para os contratos que possuam categoria de gastos de despesa, será possível detalhar a destinação do valor da referência da nota fiscal por categoria: * **__Total __**: Tipo - NUMÉRICO. ([[#Principais_regras_de_negócio|RN23]]) Ao inserir a NF, o sistema lista todas as notas fiscais: * **__Série__***: Tipo - TEXTO. * **__Número__***: Tipo NUMÉRICO. * **__Valor__***: Tipo MOEDA. * O sistema exibe opção de alterar e remover Nota Fiscal. O usuário insere as notas fiscais ([[#Principais_regras_de_negócio|RN20]]), ([[#Principais_regras_de_negócio|RN27]]), ([[#Principais_regras_de_negócio|RN28]]), ([[#Principais_regras_de_negócio|RN29]]) **PASSO 3:** São exibidos os dados gerais conforme a especificação [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:contrato_detalhado|Contrato Detalhado]], porém, de maneira mais resumida, exibindo apenas as seguintes seções: * **__Dados do Contrato__**; * **__Arquivos de Detalhamento de Contrato__**; * **__Unidades Beneficiadas__**; Sequência de notas fiscais cadastradas: * **__Série__**: Tipo - TEXTO. * **__Número__**: Tipo NUMÉRICO. * **__Data Emissão__**: Tipo DATA. * **__Data Atesto__**: Tipo DATA. ([[#Principais_regras_de_negócio|RN18]]) * **__Valor__**: Tipo MOEDA. O Sistema lista todas as unidades beneficiadas pela NF: * **__Unidade Beneficiada__**: Tipo - TEXTO. * **__Referências__**: Tipo - TEXTO. * **__Valor Referência__**: Tipo - MOEDA. * **__Valor__**: Tipo - MOEDA. O Usuário confirma a operação de adição de notas fiscais ao contratos e o caso de uso se encerra direcionando o usuário para a consulta. ([[#Principais_regras_de_negócio|RN19]]) ===== Principais Regras de Negócio ===== * **RN01** - Será consultado no banco a nota fiscal após serem informados os dados da //Série// e //Número da Nota//, caso exista uma nota já cadastrada no sistema, os dados serão prepopulados e serão desabilitados para edição. Os dados que serão preenchidos automaticamente são: //Série, Número da Nota, Valor da Nota (R$), Data de Emissão, Data do Atesto//. * **RN02** - O campo //Código de Autenticação// deve aparecer apenas para notas fiscais eletrônicas. * **RN03** - Caso a nota fiscal informada já exista na base de dados, e possua arquivo associado a ela, será exibido o ícone para visualização do arquivo. * **RN04** - Caso a nota fiscal informada já exista na base de dados, e possua requisições associadas a ela, será exibida a listagem das requisições associadas e com possibilidade de exclusão. * **RN05** - O campo //Nova Unidade// só será exibido para contratos do tipo Auto-incremento. * **RN06** - A data de emissão da nota fiscal deve estar no período de vigência do contrato ou após. * **RN07** - A unidade beneficiada só pode ser associada uma vez a nota fiscal. * **RN08** - A soma das referências da unidade beneficiada deve ser igual ao valor da unidade. * **RN09** - A mesma requisição não pode ser adicionada duas vezes para a mesma nota fiscal. * **RN10** - Se o contrato for diferente do tipo auto-incremento o saldo da unidade beneficiada não pode ficar negativo. * **RN11** - Se o contrato for do tipo auto-incremento o saldo do contrato não pode ficar negativo. * **RN12** - O número e ano da requisição devem corresponder a uma requisição já existente na base de dados. * **RN13** - Não é possível cadastrar uma nota fiscal para um contrato sem unidades beneficiadas. * **RN14** - Caso a consulta retorne apenas um contrato, o usuário não precisará selecionar o mesmo através da listagem, o sistema irá direciona-lo automaticamente para a página de associação das notas fiscais. * **RN15** - Campo exibido somente para contratos com o subtipo OBRAS E SERVIÇOS DE ENGENHARIA. * **RN16** - Por padrão a opção vem selecionada como //Não//, caso o usuário a defina como //Sim//, será exibidos os campos para associação das requisições e que deve ser obrigatórios. * **RN17** - Cada unidade beneficiada deve possuir pelo menos uma referência associada a ela. * **RN18** - Somente exibido caso o usuário tenha fornecido a informação da data de atesto da nota fiscal no momento do cadastro. * **RN19** - Para cadastrar a nota fiscal relacionada à medição, é necessário que os dados da medição sejam lançados no cronograma físico pela Superintendência de Infraestrutura, regra somente para contratos do tipo OBRAS E SERVIÇOS DE ENGENHARIA. * **RN20** - A medição, não poderá ser associada a mais de uma nota fiscal regra somente para contratos do tipo OBRAS E SERVIÇOS DE ENGENHARIA. * **RN21** - Deve ser inserida no mínimo uma nota fiscal ao contrato para prosseguir com a operação. * **RN22** - Caso só exista um contrato com as informações atribuídas no formulário, o usuário será direcionado para a tela de associação das notas fiscais, pulando a etapa de escohada pelo contrato, quando há mais de um contrato com as informações passadas. * **RN23** - É necessário informar no mínimo um detalhamento do valor da referência em uma das categorias, a soma dos valores devem ser igual ao valor da referência. * **RN24** - As requisições de item contratados associadas ao contrato que tiverem sua data de cadastro anterior data definida no parâmetro PERIODO_BLOQUEIO_NOTA_FISCAL_REQUISICAO terão seu status atualizado para AUTORIZADO, com isso a requisição será removida da listagem de requisições que comprometem o saldo do contrato. * **RN25** - Se o usuário possuir o papel GESTOR CONTRATO será possível inserir notas fiscais em contratos de outras unidades gestora do tipo auto-incremento. (Tarefa 133108) * **RN26** - Se for inserido requisições, só será permitido uma unidade beneficiada associada na nota fiscal. Pois, dessa forma, será possível saber qual a unidade, a requisição está vinculada e quanto pertence os valores das requisições para as unidades beneficiadas associadas a nota fiscal (Tarefa 140478) * **RN27** - Não é permitido inserir uma requisição na nota fiscal com o valor maior do que o original da requisição. (Tarefa 139236 ) * **RN28** - Não é permitido inserir uma requisição na nota fiscal que o seu valor somado as demais associações dessa requisição com outras notas ultrapassem o valor original da requisição. (Tarefa 139236 ) * **RN29** - As RNs 27 e 28 não se aplicam para as requisições de tipo Hospedagem, Viagem e Passagem. (Tarefa 142370 ) * **RN30** - Caso o ator tenha apenas permissão de GESTOR CONTRATOS GESTORA, para contratos de auto-incremento, é preciso que o contrato seja da unidade gestora do usuário para adicionar Nota Fiscal, pois não tem unidades beneficiadas (Contratos de Auto-incremento) * **RN31** - Caso o ator tenha apenas permissão de GESTOR CONTRATOS GESTORA só visualizará contratos que forem cadastrados por atores da sua UNIDADE GESTORA ou que possua unidades beneficiadas que possuam sua unidade gestora em sua hierarquia (Contratos de Despesa) * **RN32** - Caso o contrato tenha valor restante de prorrogação contratual conforme regra RN27, do caso de uso aba pagamentos -> aditivar, o sistema exibe os valores da prorrogação referente para que o usuário tenha a possibilidade fazer pagamentos utilizando esses valores restantes. Caso não escolha valor do contingenciamento (restante) da prorrogação contratual, não descontar do saldo restante referente a prorrogação contratual. (Tarefa * **RN33** - Caso o usuário informe que deseja usar valores restantes para pagamento e o valor informado para a NF seja maior que o saldo restante disponível da prorrogação contratual escolhida e o usuário tentar continuar com o cadastro da nota fiscal, o sistema exibe mensagem de validação informando que "o valor da nota fiscal informado é maior que o valor disponível do saldo anterior resultante de prorrogação contratual. * **RN34** - O sistema deve possibilitar ao usuário recuperar a nota fiscal cadastrada nos casos de usos Módulo Patrimônio -> Bens -> Nota Fiscal Cadastrar, Módulo Almoxarifado -> Estoque -> Estoque -> Nota Fiscal -> Cadastrar ou Módulo Liquidação de despesa _> aba Liquidação de despesas -> Nota Fiscal -> Cadastrar, caso a nota exista, o sistema deve preencher automaticamente o valor da nota, série, número da nota e data de atesto. Na confirmação da nota fiscal o sistema debitará do saldo do contrato. Caso não exista a nota fiscal, o sistema exibe mensagem informando que não existe. * **RN35** - Apenas permitir associação de requisições de PASSAGEM com status ENVIADA, PENDENTE EMPENHO, REMARCADA, REEMBOLSADA, LIQUIDADA. (Tarefa 167524, alterada em 10/11/2015) ==== Resoluções/Legislações Associadas ==== "Não se Aplica". ===== Entidades Persistentes Envolvidas ===== ^ Classe ^ Tabela | | br.ufrn.sipac.cadastro.dominio.Unidade | administrativo.comum.unidade | | br.ufrn.sipac.contratos.dominio.Contrato | administrativo.contratos.contrato | | br.ufrn.sipac.contratos.dominio.NotaUndBeneficiada | administrativo.contratos.notafiscal_unidade | | br.ufrn.sipac.contratos.dominio.NotaUndBeneficiadaReferencia | administrativo.contratos.nota_und_benef_referencia | | br.ufrn.sipac.contratos.dominio.OcorrenciaContrato | administrativo.contratos.ocorrencia_contrato | | br.ufrn.sipac.contratos.dominio.ReferenciaNotaFiscal | administrativo.contratos.referencia_notafiscal | | br.ufrn.sipac.contratos.dominio.UnidadeBeneficiada | administrativo.contratos.unidade_beneficiada | ====== Plano de Teste ====== Sistema: SIPAC Módulo: CONTRATO Link(s): Contratos -> Pagamento -> Nota Fiscal -> Adicionar Nota Fiscal Usuário: rcsl Papel que usuário deve ter: SipacPapeis.GESTOR_CONTRATOS, SipacPapeis.GESTOR_CONTRATOS_GLOBAL ===== Cenários de Teste ===== * Confrontar a regras de negócio descritas acima. ===== Dados para o Teste ===== É necessário obter um contrato que permita a inserção de notas fiscais e que seja do tipo diferente de **Receita**, esse contrato pode ser obtido no caso de uso: * Contratos -> Aba Consultas/relatórios -> Geral -> Listar Contratos