Objetivo

O Plano de Auditoria Avançado permite a geração e retenção de auditorias adicionais para clientes que possuem a funcionalidade licenciada.

A habilitação do plano é controlada por meio do campo:

CLIENTES_LICENCAS.PLANO_AUDITORIA

Somente clientes com este campo definido como 'S' terão acesso às auditorias exclusivas do plano.

Controle de Licenciamento

Identificação da Licença Vigente

A validação do plano considera a licença vigente do cliente, utilizando a maior data de vigência menor ou igual à data atual.

Consulta da Licença

SELECT NVL(cl.plano_auditoria, 'N') AS plano_auditoria
  FROM clientes_licencas cl
 WHERE cl.cod_cliente = vcod_cliente
   AND cl.data_vigencia = (
       SELECT MAX(cl_.data_vigencia)
         FROM clientes_licencas cl_
        WHERE cl_.cod_cliente = cl.cod_cliente
          AND cl_.data_vigencia <= TRUNC(SYSDATE)
   );

Retorno Esperado

Integração com Venda Direta

Quando a licença é habilitada no sistema gerencial, a API:

vendadireta-pontosoftexpress-api

é responsável por criar uma nova vigência na tabela CLIENTES_LICENCAS, registrando:

PLANO_AUDITORIA = 'S'

Após o processamento, a licença poderá ser visualizada no Dashboard.

Auditorias Exclusivas do Plano

As auditorias disponibilizadas exclusivamente para clientes licenciados são definidas na tabela:

TIPOS_AUDITORIAS_PONTOS

por meio do campo:

GERA_SOMENTE_LICENCA = 'S'

Quando configurado dessa forma, a auditoria somente será gerada para clientes com o Plano de Auditoria Avançado ativo.

Auditorias Configuradas

Consulta das Auditorias Exclusivas

SELECT cod_auditoria,
       descr_auditoria,
       nome_tabela,
       gera_somente_licenca
  FROM express_app.tipos_auditorias_pontos
 WHERE gera_somente_licenca = 'S'
 ORDER BY cod_auditoria;

Política de Retenção e Limpeza

A limpeza dos registros de auditoria é executada pela rotina:

pack_trigger_auditoria_ponto.politica_retencao_limpeza()

Regra para Clientes com Plano de Auditoria

Quando o cliente possui o Plano de Auditoria Avançado habilitado:

• A retenção passa a ser de 1.830 dias (aproximadamente 5 anos).
• Registros anteriores ao período calculado tornam-se elegíveis para exclusão.
• O valor configurado em TIPOS_AUDITORIAS_PONTOS.QTD_DIAS_RETENCAO é desconsiderado para auditorias marcadas com:

GERA_SOMENTE_LICENCA = 'S'

Comportamento para Clientes sem Licença

Clientes que não possuem o Plano de Auditoria Avançado continuam utilizando a política padrão de retenção definida em:

TIPOS_AUDITORIAS_PONTOS.QTD_DIAS_RETENCAO

Inclusão de Novas Auditorias

Ao adicionar uma nova tabela ao processo de auditoria, é necessário registrar a auditoria e executar:

pack_trigger_auditoria_ponto.validar(cod_auditoria)

O que a rotina realiza

A procedure é responsável por:

• Validar a configuração da auditoria.
• Criar ou atualizar a trigger correspondente na tabela auditada.
• Garantir a gravação automática dos eventos na tabela:

AUDITORIAS_PONTOS

Resumo Técnico