Plano de Auditoria Avançado

viniciusdalpiva

Plano de Auditoria Avançado

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

Valor	Descrição
`S`	Cliente possui o Plano de Auditoria Avançado ativo
`N`	Cliente não possui o Plano de Auditoria Avançado

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.

Licença de Auditoria Habilitada

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

Código	Descrição	Tabela Auditada
4	Horários Trabalhos Funcionário	HORARIOS_TRABALHOS_FUNCIONARIO
19	Acordos Coletivos Funcionários	ACORDOS_COLETIVOS_FUNCIONARIOS
26	Setores Pontos Funcionários	SETORES_PONTOS_FUNCIONARIOS
27	Funcionários Parâmetros Folhas	FUNCIONARIOS_PARAMETROS_FOLHAS
28	Resultados Cálculos Pontos	RESULTADOS_CALCULOS_PONTOS
31	REP Cartões Funcionários	REP_CARTOES_FUNCIONARIOS
32	Períodos Controles Pontos	PERIODOS_CONTROLES_PONTOS
33	Períodos Compensações Pontos	PERIODOS_COMPENSACOES_PONTOS
34	Parâmetros Extras Funcionários	PARAMETROS_EXTRAS_FUNCIONARIOS
35	Tipos Salários Pontos	TIPOS_SALARIOS_PONTOS
36	Funcionários Pontos Manuais	FUNCIONARIOS_PONTOS_MANUAIS
42	Setores Acessos Funcionários	SETORES_ACESSOS_FUNCIONARIOS
49	Cargos Pontos Funcionários	CARGOS_PONTOS_FUNCIONARIOS
52	Lançamentos Ocorrências	LANCAMENTOS_OCORRENCIAS
53	Marcações Pontos	MARCACOES_PONTOS
54	Filiais Pontos Funcionários	FILIAIS_PONTOS_FUNCIONARIOS
55	Funcionários PIS Pontos	FUNCIONARIOS_PIS_PONTOS
56	Funcionários REP P	FUNCIONARIOS_REP_P
57	Horas Dias Funcionários	HORAS_DIAS_FUNCIONARIOS
58	Horas Extras Funcionários	HORAS_EXTRAS_FUNCIONARIOS
59	Marcações REP P	MARCACOES_REP_P
60	Ocorrências Pontos	OCORRENCIAS_PONTOS
61	Previsões Ocorrências Pontos	PREVISOES_OCORRENCIAS_PONTOS
62	QR Codes Pontos Funcionários	QR_CODES_PONTOS_FUNCIONARIOS
63	Zonas Virtuais Funcionários	ZONAS_VIRTUAIS_FUNCIONARIOS

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

Item	Comportamento
Controle da licença	`CLIENTES_LICENCAS.PLANO_AUDITORIA`
Auditorias exclusivas	`TIPOS_AUDITORIAS_PONTOS.GERA_SOMENTE_LICENCA = 'S'`
Retenção para clientes licenciados	1.830 dias
Rotina de limpeza	`pack_trigger_auditoria_ponto.politica_retencao_limpeza()`
Rotina de validação	`pack_trigger_auditoria_ponto.validar(cod_auditoria)`
Tabela de armazenamento	`AUDITORIAS_PONTOS`

Leandro Santos

@viniciusdalpiva excelente material informativo!

Para fins de histórico, para quem for consultar este material no futuro, esta funcionalidade do Plano de Auditoria Avançado e os novos relatórios foram aplicadas em produção no Ponto Soft Express a partir da versão 7.3.5, em junho de 2026.