~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Listar/Alterar ====== Esse caso de uso destina-se à consulta, alteração e remoção de nota fiscal cadastrada no sistema. Para mais detalhes sobre notas fiscais, verifique [[cadastrar|Cadastrar Nota Fiscal]]. ===== Descrição do Caso de Uso ===== O caso de uso inicia quando o usuário acessa //SIPAC -> Módulo Almoxarifado -> Aba Estoque -> Estoque -> Nota Fiscal -> Listar/Alterar//. A fim de realizar essas operações, o usuário deve primeiramente selecionar uma nota fiscal com a qual deseja trabalhar. Para tal feito, deve-se realizar uma busca através de pelo menos uma das seguintes informações: * **Empenho**: Tipo NUMÉRICO. * **Ano**: Tipo NUMÉRICO, formato: AAAA. * **Número**: Tipo NUMÉRICO. * **Série**: Tipo CARACTER. * **Fornecedor**: Tipo AUTOCOMPLETE, Formato: NOME FORNECEDOR - DOCUMENTO FORNECEDOR, entrada de dados: NOME ou DOCUMENTO. * **Material**: Tipo AUTOCOMPLETE, Formato: (CÓDIGO MATERIAL) NOME DO MATERIAL, entrada de dados: NOME ou CÓDIGO MATERIAL. * **Grupo de Material**: Tipo TEXTO, Formato: NOME GRUPO MATERIAL. ([[#principais_regras_de_negocio|RN05]]) * Pode ser preenchido pelo código do grupo de material. * **Notas Fiscais com Itens sem Tombamento**: Tipo LÓGICO. * **Apenas notas fiscais cadastradas pelo seu setor**: Tipo LÓGICO. Após essa consulta às notas fiscais, é exibida uma listagem contendo todas as notas relacionadas, com as seguintes informações:([[#principais_regras_de_negócio|RN01]]) * **__Nº.__**: Tipo TEXTO, formato: NÚMERO DA NOTA FISCAL - SÉRIE DA NOTA FISCAL. * **__Fornecedor__**: Tipo TEXTO. * **__Status__**: Tipo TEXTO. * **__Emissão__**: Tipo DATA, formato: DD/MM/AAAA. * **__Atesto__**: Tipo TEXTO. * **__Valor__**: Tipo NUMÉRICO. * //Percebe-se três funcionalidades integradas à listagem: Visualizar Nota Fiscal, Alterar Nota Fiscal e Remover Nota Fiscal //([[#principais_regras_de_negócio|RN02, RN03, RN11]]). === Visualizar Nota Fiscal === Exibe detalhes de uma nota fiscal. == Dados da Nota Fiscal == * **__Nota Fiscal__**: Tipo NUMÉRICO. * **__Série__**: Tipo TEXTO. * **__Data de Emissão__**: Tipo DATA, formato: DD/MM/AAAA. * **__Data de Atesto__**: Tipo DATA, formato: DD/MM/AAAA HH:MM:SS. * **__Consumo Imediato__**: Tipo TEXTO. ([[#principais_regras_de_negocio|RN09]]) * **__Data de Cadastro__**: Tipo DATA, formato: DD/MM/AAAA HH:MM:SS. * **__Usuário de Cadastro__**: Tipo TEXTO, formato: NOME DO USUÁRIO (LOGIN DO USUÁRIO). * **__Almoxarifado__**: Tipo TEXTO, formato: NOME ALMOXARIFADO. * **__Tipo__**: Tipo TEXTO. * **__Status__**: Tipo TEXTO. == Dados do Fornecedor == * **__Fornecedor__**: Formato - NOME DO FORNECEDOR, Tipo - Tipo TEXTO. * **__CPF/CNPJ__**: Formato - 999.999.999-99 ou 99.999.999/9999-99., Tipo - NUMÉRICO. * **__Endereço__**: Formato - LOGRADOURO | BAIRRO | CIDADE/UF, Tipo - TEXTO. == Empenhos == * **__Número/Ano__**: Tipo NUMÉRICO, formato: 9.../AAAA. * **__Observações__**: Tipo NUMÉRICO. * **__Valor__**: Tipo NUMÉRICO. * **__Saldo__**: Tipo NUMÉRICO. == Histórico de Mudança de Status == * **__Data__**: Tipo DATA e HORA, formato: DD/MM/AAAA HH:MM. * **__Usuário__**: Tipo TEXTO. * **__Status__**: Tipo TEXTO. == Itens da Nota Fiscal == * **__Código__**: Tipo NUMÉRICO. * **__Denominação__**: Tipo TEXTO. * **__Medida__**: Tipo TEXTO. * **__Validade__**: Tipo DATA, formato: DD/MM/AAAA * **__Garantia__**: Tipo DATA, formato: DD/MM/AAAA * **__Qtde.__**: Tipo NUMÉRICO. * **__Total__**: Tipo NUMÉRICO. == Entrada no Almoxarifado == * **__Data__**: Tipo - DATA. * **__Código__**: Formato - 999999999999, Tipo - NUMÉRICO. * **__Denominação__**: Tipo - TEXTO. * **__Medida__**: Tipo - TEXTO. * **__Qtde.__**: Tipo NUMÉRICO. * **__Total__**: Tipo NUMÉRICO. == Saída no Almoxarifado == * **__Data__**: Tipo - DATA. * **__Código__**: Formato - 999999999999, Tipo - NUMÉRICO. * **__Denominação__**: Tipo - TEXTO. * **__Medida__**: Tipo - TEXTO. * **__Qtde.__**: Tipo NUMÉRICO. * **__Total__**: Tipo NUMÉRICO. == Movimentações da Nota Fiscal == * **__Data Origem__**: Formato - DD/MM/AAAA, Tipo - DATA. * **__Destino__**: Formato - NOME DA UNIDADE (CÓDIGO DA UNIDADE), Tipo - TEXTO. * **__Enviado Por__**: Formato - LOGIN DO USUÁRIO, Tipo - TEXTO. * **__Recebido Em__**: Formato - DD/MM/AAAA, Tipo - DATA. * **__Recebido Por__**: Formato - LOGIN DO USUÁRIO, Tipo - TEXTO. Caso o usuário deseje que seja criado um formulário de classificação de material, então o sistema exibe-o conforme o modelo abaixo: **FORMULÁRIO PARA CLASSIFICAÇÃO DE MATERIAL** **Almoxarifado:** NOME ALMOXARIFADO **Empenhos:** 9.../AAAA ^ Código ^ Grupo de Material ([[#principais_regras_de_negocio|RN05]]) ^ Valor ^ | CÓDIGO GRUPO MATERIAL ([[#principais_regras_de_negocio|RN05]]) | NOME GRUPO MATERIAL ([[#principais_regras_de_negocio|RN05]]) | R$ 99,99 | | **Valor Total do(s) Empenho(s):**|| R$ 99,99 | === Alterar Nota Fiscal === Essa funcionalidade tem por função apenas a alteração dos dados cadastrados na seguinte especificação: [[cadastrar|Cadastrar Notas Fiscais]] com a seguinte opção adicional: ([[#principais_regras_de_negócio|RN08]]) * **Alterar outra Nota Fiscal**, utilizada para a alteração dos dados de uma determinada nota fiscal. === Remover Nota Fiscal === Ao escolher essa opção são exibidas as informações gerais da nota fiscal, com os seguintes campos: ([[#principais regras de negócio|RN04, RN08 e RN10]]) * **__Série__**: Tipo - TEXTO. * **__Número__**: Tipo - NUMÉRICO. * **__Data de Emissão__**: Formato - DD/MM/AAAA, Tipo - DATA, * **__Tipo de Entrada__**: Tipo - TEXTO. * **__Valor__**: Tipo - NUMÉRICO. * **__Fornecedor__**: Tipo TEXTO. São exibidas as opções **//Remover//** (utilizado para a confirmação) e **//Cancelar//** para voltar à listagem. ===== Principais Regras de Negócio ===== * **RN01** - Caso o usuário logado seja associado a algum almoxarifado, só serão mostradas notas fiscais pertencentes a este almoxarifado. * **RN02** - Só é permitido alterar e remover notas fiscais cadastradas pelo setor do usuário logado. * **RN03** - Não é possível realizar estorno ou alteração em nota fiscal que teve registrada alguma entrada para o material constate nela. O seu estorno ou alteração provocará inconsistências relacionadas ao preço médio de atendimento do material. * **RN04** - Não é possível estornar ou remoção de uma nota fiscal que possua um processo de pagamento associado ela no sistema. * **RN05** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]]. * **RN06** - Quando a nota fiscal está associada a um documento de protocolo usado para a tramitação da mesmas, são mostrados o número de protocolo do documento e suas movimentações realizadas.(Regra removida em 15/12/2015 referente a tarefa 169702) * **RN07** - Quando a nota fiscal está associada a um contrato ela só poderá ser alterada ou estornada no módulo de contratos. * **RN08** - Usuários que possuem somente o papel Auditor do Almoxarifado não possuem permissão para alterar ou remover notas fiscais. * **RN09** - Apenas para notas de consumo imediato o campo irá aparecer. * **RN10** - Para remover notas de consumo imediato é necessário que as saídas avulsas geradas sejam removidas anteriormente. (Adicionada em 17/05/2013, referente a tarefa 113366). * **RN11** - Caso a nota fiscal tenha sido cadastrada em um mês anterior, a sua remoção só será permitida caso haja calendário contábil aberto para o mês que a nota foi cadastrada. ==== Resoluções/Legislações Associadas ==== Não se aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela ^ | br.ufrn.sipac.almoxarifado.entradas.dominio.NotaFiscal | administrativo.liquidacao.nota_fiscal | | br.ufrn.sipac.almoxarifado.comuns.dominio.Almoxarifado | administrativo.almoxarifado.almoxarifado | | br.ufrn.comum.dominio.PessoaGeral | administrativo.comum.pessoa | | br.ufrn.comum.dominio.UsuarioGeral | administrativo.comum.usuario | | br.ufrn.sipac.supinfra.acompanhamento.dominio.PagamentoObra | administrativo.infra.obra_pagamento | | br.ufrn.sipac.liquidacao.pagamento.dominio.ProcessoPagamento | administrativo.liquidacao.processo_pagamento | | br.ufrn.sipac.almoxarifado.entradas.dominio.ItemNotaFiscal | administrativo.liquidacao.item_nota_fiscal | | br.ufrn.sipac.contratos.dominio.NotaUndBeneficiada | administrativo.contratos.notafiscal_unidade | | br.ufrn.sipac.contratos.dominio.UnidadeBeneficiada | administrativo.contratos.unidade_beneficiada | | br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | administrativo.comum.grupo_material | | br.ufrn.sipac.contratos.dominio.ReferenciaNotaFiscal | administrativo.contratos.referencia_notafiscal | | br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho | administrativo.sco.empenho | | br.ufrn.sipac.requisicoes.livrocontrato.dominio.RequisicaoLivroContrato | administrativo.requisicoes.requisicao_livro_contrato | | br.ufrn.sipac.requisicoes.material.dominio.RequisicaoMaterial | administrativo.requisicoes.requisicao_material | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Almoxarifado Link(s): Almoxarifado -> Estoque -> Estoque -> Nota Fiscal -> Listar/Alterar Usuário: genibaldo (almoxarifado) Papel que usuário deve ter: * SipacPapeis.GESTOR_ALMOXARIFADO ou SipacPapeis.AUDITOR_DO_ALMOXARIFADO. ===== Cenários de Teste ===== Através do caso de uso [[cadastrar|Cadastrar Notas Fiscais]] pode-se cadastrar notas, o que altera o resultado da busca. Pode-se confirmar as alterações realizadas através do próprio caso de uso. ===== Dados para o Teste ===== Os dados para o teste podem ser encontrados em SIPAC -> Almoxarifado -> Relatórios -> Movimentação -> Entradas por Nota Fiscal.