Detalhar Despesas em Lote
Esta operação é utilizada pelos gestores do orçamento das unidades. Detalhar despesas é a mesma coisa que zerar os saldos dos sub-empenhos. Este caso de uso tem como finalidade controlar os saldos dos empenhos e sub empenhos. Para maiores informações sobre empenhos, vide o Documento de Negócio do Sistema de Controle Orçamentário.
Descrição do Caso de Uso
Este caso de uso inicia quando o usuário acessa a opção: SIPAC → Orçamento → Aba Movimentações → Empenho → Detalhar Despesas → Detalhar Despesas em Lote.
Passo 1
O usuário informa o número do documento do empenho a ser detalhado.
Passo 2
O sistema exibe então os seguintes dados do empenho:
- Empenho: Formato - 9…/AAAA. Tipo - TEXTO.
- Gestora: Formato - <SIGLA> (<CÓDIGO>) Tipo - TEXTO.
- Data: Tipo - DATA.
- Processo: Formato - 99999.999999/AAAA-99. Tipo - TEXTO. (RN01)
- Programa de Trabalho Resumido: Tipo - TEXTO.
- Natureza de Despesa: Tipo - TEXTO.
- Fonte de Recurso: Tipo - TEXTO.
- Esfera: Tipo - TEXTO.
- Plano Interno: Tipo - TEXTO.
- Modalidade: Tipo - TEXTO.
- Credor: Tipo - TEXTO.
- Observações:
- Total do Empenho: Tipo - NUMÉRICO.
- Saldo do Empenho: Tipo - NUMÉRICO.
- Valor Anulado: Tipo - NUMÉRICO.
- Valor Reforçado: Tipo - NUMÉRICO.
- Valor Cancelado: Tipo - NUMÉRICO.
- Registrado por: Formato - <NOME DO USUÁRIO> (<LOGIN>) Tipo - TEXTO.
Exibe os seguintes dados dos Centros de Custos
- Centro de Custo: Formato - <NOME DA UNIDADE> (<CÓDIGO>) Tipo - TEXTO.
- Valor: Tipo - NUMÉRICO.
- Saldo: Tipo - NUMÉRICO.
Existe a opção de Visualizar todos os detalhamento de despesas já realizados para este empenho e então solicitará os dados do detalhamento de despesas.
- Opções de Detalhamento de Despesas: Tipo - TEXTO. Opções: 'Vinculado a Requisição' ou 'Outros'.
Caso seja escolhida a opção 'Vinculado a Requisição' o usuário tem a opção de 'Associar Requisição ao Empenho'. Para associar uma requisição ao empenho, o usuário informa os seguintes dados: (RN 21)
- Número: Tipo - NUMÉRICO.
- Ano: Tipo - NUMÉRICO, Formato: AAAA.
- Tipo: Tipo - TEXTO.
- Centro de Custo: Tipo - TEXTO.
E então o sistema exibe os seguintes dados:
- Requisição: Tipo - TEXTO, Formato - 9…/AAAA. Tipo - TEXTO.
- Valor da Requisição: Tipo NUMÉRICO.
- Valor Contigenciado: Tipo NUMÉRICO.
O usuário tem a opção de remover a requisição associada.
O sistema solicita os dados do detalhamento:
- Modalidade: Tipo - TEXTO. Opção: 'PROCESSO' ou 'DEVOLUÇÃO'. (RN02)
- Processo de Outra Instituição?: Tipo - LÓGICO. Pode ser 'SIM' ou 'NÃO'. (RN11, RN14, RN15 e RN17)
- Processo: TIPO - NUMÉRICO, FORMATO - 99999.999999/AAAA-99, Entrada de Dados: (radical.número/ano-dv) (RN12, RN13, RN16)
- Favorecido: Tipo AUTOCOMPLETE, formato: <NOME DO FORNECEDOR> <CNPJ ou CPF>, Entrada de dados: NOME, CPNJ ou CPF.
- Categoria de Despesa: Tipo - TEXTO. (RN05)
- Data: Tipo - DATA.
- Valor (R$): Tipo NUMÉRICO. (RN03)
- Número da Ordem Bancária: Tipo - NUMÉRICO.
- Data da Ordem Bancária: Tipo - DATA.
- Observações: Tipo - TEXTO.
O usuário tem a possibilidade de adicionar 'Ordens Bancárias'. Para isso, o sistema requisita os seguintes dados:
- Número da Ordem Bancária:* Tipo - NUMÉRICO. Formato: 9…/AAAA.
- Data da Ordem Bancária:* Tipo - DATA. Formato: dd/mm/AAAA.
- Valor (R$):* Tipo - NUMÉRICO.
- Observações: Tipo - TEXTO.
O usuário confirma e o sistema exibe a listagem com as ordens bancárias anexadas:
Ordens Bancárias Vinculadas ao Detalhamento | ||||
---|---|---|---|---|
Número | Data | Obsevações | Status | Valor |
9999 | dd/mm/aaaa | <TEXTO> | <STATUS> | |
… | … | … | … | … |
Para cada linha da tabela existe a possibilidade de alterar ou remover ordem.
O sistema lista as Ordens Bancárias Vinculadas ao Processo Informado
, mostrando os mesmos dados da tabela anterior. O usuário tem a opção de anexar essas ordens ao detalhamento.
O usuário tem a opção de adicionar Tributos. Para isso, o sistema requisita os seguintes dados:
- Tipo do Tributo:* Tipo - TEXTO, Opções:
DAR
,DARF
ouGPS
. - Número do Tributo:* Tipo - NUMÉRICO.
- Data do Tributo:* Tipo - DATA.
- Valor Total do Tributo(R$) Tipo - NUMÉRICO.
- Observações Tipo - TEXTO.
O sistema exibe os tributos adicionados.
Tributos Vinculados ao Detalhamento | ||||
---|---|---|---|---|
Número/Ano | Tipo do Tributo | Data do Tributo | Valor do Tributo | |
9999/AAAA | <TIPO> | dd/mm/aaaa | R$ 9.999,99 | |
… | … | … | … |
Para cada linha da listagem o usuário tem a opção de alterar e/ou remover tributo.
O sistema lista as Tributos Vinculados ao Detalhamento
, mostrando os mesmos dados da tabela anterior. O usuário tem a opção de anexar esses tributos ao detalhamento.
O usuário anexa o detalhamento de despesas e o sistema exibe a listagem com todos o detalhamentos anexados:
Detalhamentos de Despesas Anexados | ||||
---|---|---|---|---|
Unidade do Empenho | Data | Tipo | Processo | Valor |
<DESCRIÇÃO DA UNIDADE> | dd/mm/aaaa | <TIPO> | 99999.999999/AAAA-99. | R$ 9.999,99 |
Requisições Associadas | ||||
Descrição | Centro de Custo | Valor | Valor a Liquidar(R$) | |
<Descrição da Requisição> | <TEXTO> | 9.999,99 | 9.999,99 | |
… | … | … | … | |
Ordens Bancárias Vinculadas ao Detalhamento | ||||
Número | Data | Observações | Status | Valor (R$) |
99999 | dd/mm/aaaa | <TEXTO> | <STATUS> | 9.999,99 |
… | … | … | … | … |
Tributos Vinculados ao Detalhamento | ||||
Número/Ano | Tipo do Tributo | Data do Tributo | Valor (R$) | |
999/AAAA | <TIPO> | dd/mm/aaaa | 9.999,99 | |
… | … | … | … |
O usuário clica em Detalhar Despesas
e o sistema realiza a consolidação dos detalhamentos de despesas anexados.
O sistema exibe as seguintes informações no formato de comprovante:
- Número do Empenho: Formato - 9…/AAAA. Tipo - TEXTO.
- PTRES: Tipo - TEXTO.
- Natureza de Despesa: Tipo - TEXTO.
- Fonte de Recurso: Tipo - TEXTO.
- Esfera: Tipo - TEXTO.
- Plano Interno: Tipo - TEXTO.
- Usuário Cadastrador: Tipo - TEXTO.
Detalhamentos de Depesas Anexados | ||||
---|---|---|---|---|
Unidade do Empenho | Data | Tipo | Processo | Valor |
<DESCRIÇÃO DA UNIDADE> | dd/mm/aaaa | <TIPO> | 99999.999999/AAAA-99. | R$ 9.999,99 |
Requisições Associadas | ||||
Descrição | Centro de Custo | Valor | Valor a Detalhar(R$) | |
<Descrição da Requisição> | <TEXTO> | 9.999,99 | 9.999,99 | |
… | … | … | … | |
Ordens Bancárias Vinculadas ao Detalhamento | ||||
Número | Data | Observações | Status | Valor (R$) |
99999 | dd/mm/aaaa | <TEXTO> | <STATUS> | 9.999,99 |
… | … | … | … | … |
Tributos Vinculados ao Detalhamento | ||||
Número/Ano | Tipo do Tributo | Data do Tributo | Valor (R$) | |
999/AAAA | <TIPO> | dd/mm/aaaa | 9.999,99 | |
… | … | … | … |
Existe a possibilidade de imprimir este comprovante, clicando em Imprimir Comprovante
O caso de uso é encerrado.
Principais Regras de Negócio
- RN01 - Caso a opção Processo de Outra Instituição seja selecionada, o processo não será validado, ou seja, não irá verificar se está cadastrado na base do Protocolo e as serão buscadas apenas as ordens bancárias que tenham processos de outras instituições;
- RN02 - Caso a modalidade de Detalhamento de empenho escolhida seja de processo, o saldo do empenho será dimuido assim como o saldo do sub empenho da unidade interessada. Caso seja escolhida a modalidade de detalhamento de devolução os saldos serão somados.
- RN03 - O valor do detalhamento obrigatoriamente deve ser maior que zero.
- RN04 - O empenho não pode ter sido anulado.
- RN05 - VALOR DO DETALHAMENTO:
- O valor do detalhamento não pode ultrapassar o valor do saldo do empenho.
- O valor da detalhamento não pode ultrapassar o valor do saldo do sub empenho da unidade interessada.
- RN06 - Caso seja escolhida a opção de realizar o detalhamento de empenho associado a uma requisição, esta operação só poderá ser realizada sobre empenhos estimativos/globais.
- RN07 - O empenho deve possuir saldo maior que zero.
- RN08 - Os sub empenhos do empenho selecionado devem possuir a mesma natureza de despesa da requisição.
- RN09 - Para realizar um detalhamento para uma unidade debitada é necessário que exista no empenho um sub empenho para a unidade central de empenho.
- RN10 - Caso um empenho seja ordinário, só poderá ser detalhado totalmente. Não é possível fazer um detalhamento de despesas parcial sobre o mesmo.
- RN11 - Caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja false, o campo Processo de Outra Instituição? não será exibido.
- RN12 - Caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja true, ao informar o Processo, o sistema irá verificar a base dos processos.
- RN13 - Caso o parâmetro UTILIZA_PROTOCOLO_SIPAC esteja false, ao informar o Processo, o sistema não irá considerar a base dos processos.
- RN14 - Caso o campo Processo de Outra Instituição? seja 'NÃO' e o processo contenha ordens bancárias associadas ao processo, estas serão exibidas após o campo observação.
- RN15 - Caso o campo Processo de Outra Instituição? seja 'NÃO' e o processo não contenha ordens bancárias associadas ao processo, será solicitado após o campo observação as informações de Número da Ordem Bancária e a Data da Ordem Bancária
- RN16 - Quando o parâmetro UTILIZA_PROTOCOLO_SIPAC estiver configurado como false o campo Processo é solicitado de forma única utilizando uma máscara no formato 99999.999999/9999-99, ao contrário da situação que o parâmetro esteja configurado como true, onde o campo Processo é solicitado ao usuário de forma separada, sendo necessário ser informado para cada campo os dados radical, número, ano e digito verificador do processo.
- RN17 - Caso o campo Processo de Outra Instituição? seja 'SIM' o campo Processo será solicitado em apenas um campo, onde exigirá a formatação completa do número do processo. FORMATO: 99999.999999/999-99 (radical.número/ano-dv).
- RN18 - A requisição informada não pode está associada a outros detalhamentos de despesas. (Adicionado em 13/07/2011 referente a tarefa 66587)
- RN19 - A soma dos Tributos mais a Ordem Bancária não pode ser superior ao valor do detalhamento;
- RN20 - Caso seja uma requisição de solicitação de materia em um registro de preço, e o processo associado a esta requisição possua pelo menos 1 item com o status cancelado ou pendente, não será possível realizar a liquidação.
- RN21 - Caso a opção escolhida seja
Vinculado a Requisição
e o tipo do empenho seja ordinário, o sistema permite anexar uma ou mais requisições. Caso o tipo do empenho seja diferente de ordinário o sistema só permite anexar uma requisição.
Classes Persistentes e Tabelas Envolvidas
Classe | Tabela |
---|---|
br.ufrn.sipac.orcamento.movimentacoes.dominio.Lancamento | administrativo.sco.lancamento |
br.ufrn.sipac.orcamento.movimentacoes.dominio.OrdemBancaria | administrativo.sco.ordem_bancaria |
br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho | administrativo.sco.empenho |
br.ufrn.sipac.orcamento.movimentacoes.dominio.OrdemBancariaLancamento | administrativo.sco.ordem_bancaria_lancamento |
br.ufrn.sipac.orcamento.movimentacoes.dominio.SubEmpenho | administrativo.sco.sub_empenho |
br.ufrn.sipac.orcamento.movimentacoes.dominio.Tributo | administrativo.sco.tributo |
br.ufrn.sipac.orcamento.movimentacoes.dominio.TributoLancamento | administrativo.sco.tributo_lancamento |
Plano de Teste
Sistema: SIPAC
Módulo: Orçamento
Link(s): Aba Movimentações → Empenho → Detalhar Despesas → Detalhar Despesas em Lote
Usuário:
- larrubia2: Executor do Orçamento Global
- seocchla01: Executor do Orçamento
- raiula: Executor Convênio
Papel que usuário deve ter: ScoPapeis.EXECUTOR_ORCAMENTO, ScoPapeis.EXECUTOR_ORCAMENTO_GLOBAL,ScoPapeis.EXECUTOR_CONVENIO
Cenários de Teste
- Realizar a liquidação para unidade pagadora e que o sub empenho da unidade central de empenho possua um ou mais reforços, verificando a consistência dos saldos das células orçamentárias. Para Verificar os dados das células orçamentárias utilizar o relatório Menu SCO → Relatórios → Saldos → Saldo Orçamentário por Unidade.
Dados para o Teste
- Para obtermos os dados necessários para a realização do teste desse caso de uso devemos buscar esse dados em SCO → Consultas → Empenho → Empenho. Devem ser utilizados apenas empenhos que não estejam finalizados.
- Para obter os dados para requisições consulte SCO > Relatórios > Requisições/Documentos de Resumo para Empenhos > Requisições Empenhadas
- Consulta que exibe os os empenhos estimativos e globais não anulados que possuem requisições associados e que não foram detalhados totalmente:
SELECT DISTINCT cod_empenho, subreq.id_requisicao, subreq.tipo_requisicao FROM sco.empenho e JOIN sco.sub_empenho sub USING (id_empenho) JOIN sco.sub_empenho_requisicao subreq ON (subreq.id_sub_empenho = sub.id_sub_empenho) JOIN sco.lancamento l ON (sub.id_sub_empenho = l.id_sub_empenho) WHERE e.ano = :ano AND e.id_unidade_gestora = :gestora AND e.anulado = FALSE AND e.saldo > 0
- Para obter os dados da requisição para dar inicio ao fluxo quando escolhida a opção Vinculado a requisições, o testador deve ir ao caso de uso:
- SIPAC > Orçamento > Requisições > requisições > Consultar Requisição, onde o status da requisição seja enviada.
- Consulta que exibe os empenhos ordinários não anulados que possuem requisições associados e que não foram detalhados totalmente:
SELECT DISTINCT cod_empenho FROM sco.empenho e JOIN sco.sub_empenho sub USING (id_empenho) JOIN sco.sub_empenho_requisicao subreq ON (subreq.id_sub_empenho = sub.id_sub_empenho) JOIN sco.lancamento l ON (e.id_empenho = l.id_empenho) WHERE e.ano = :ano AND e.id_unidade_gestora = :gestora AND e.anulado = FALSE AND e.saldo > 0
Onde ano é o :ano do empenho e :gestora é a unidade gestora do empenho.
Consulta que traz as unidades gestoras
SELECT * FROM unidade WHERE categoria = 1 AND tipo = 2