CONTEÚDO
- Visão Geral
- Parâmetros de Entrada (filtros)
- Estrutura de Dados
- Regra de Negócio
- Exemplo de Utilização
01. VISÃO GERAL
O objeto de negócio FopHistSalarialBusinessObject fornece o rastreio completo das alterações de remuneração dos colaboradores. Ele extrai dados da tabela de histórico salarial (PFHSTSAL), permitindo visualizar não apenas o salário atual, mas toda a progressão do funcionário ao longo do tempo, incluindo os motivos de cada alteração.
- Módulo: Folha de Pagamento
- Time Responsável: Rotinas
02. PARÂMETROS DE ENTRADA
Este objeto possui parâmetros específicos para controlar a profundidade do histórico e a visibilidade de dados sensíveis:
| Parâmetro | Descrição | Comportamento |
|---|
Coligada | Código da Empresa | Filtra os registros por uma coligada específica. |
Filial | Unidade de Negócio | Filtra os funcionários vinculados a uma filial. |
Departamento | Seção/Estrutura | Permite busca hierárquica por código de seção (via LIKE). |
Centro de Custo | Classificação Contábil | Filtra funcionários alocados em centros de custo específicos. |
Data do Filtro | Data de Corte | Retorna apenas alterações ocorridas a partir da data informada. |
Cargo / Função | Estrutura de Cargos | Filtra a evolução salarial de cargos ou funções específicas. |
Exibe Salário | Flag de Privacidade | Define se o valor numérico do salário deve ser retornado. |
Exibe Histórico | Nível de Detalhe | Define se trará apenas o último registro ou o histórico completo. |
03. Estrutura de Dados
Os dados são retornados com base na entidade FopHistoricoSalarialBusinessObjectEntity.
Identificação do Colaborador
- CompanyCode: Código da coligada.
- BranchCode: Código da filial.
- EmployeeCode: Chapa do funcionário.
- EmployeeName: Nome completo.
- EmployeeSituationCode: Código da situação atual (Ativo, Férias, etc).
Dados da Alteração Salarial
- Salary: Valor nominal do salário na data do registro (sujeito ao filtro de exibição).
- ChangedDate: Data em que a alteração entrou em vigor (PFHSTSAL.DTMUDANCA).
- ReasonCode / ReasonDescription: Código e descrição do motivo da alteração (Ex: Promoção, Acordo Coletivo, Mérito).
- EmployeePaymentType: Tipo de recebimento (Mensalista, Horista, etc).
04. Regra de Negócio
- Tratativa de Banco de Dados: O objeto realiza conversões automáticas para filtros de data dependendo do dialeto do banco:
- SQL Server: Utiliza strings de data padrão ('yyyy-MM-dd').
- Oracle: Injeta a função TO_DATE para garantir a integridade da consulta.
- Segurança e Acesso: O objeto possui um atributo de segurança (RMSBusinessObjectSecurityAttr) vinculado ao código 812000680, garantindo que apenas usuários com permissão na ação de Histórico Salarial visualizem os dados.
- Filtragem por Código Interno: Para parâmetros como Tipo de Pagamento e Situação, a lógica interna busca o CODINTERNO das tabelas globais (PCODRECEB e PCODSITUACAO), garantindo compatibilidade mesmo que as descrições sejam alteradas pelo usuário.
- Imprime Histórico: Quando o parâmetro "Exibe Histórico" é definido como "Não" (Valor 2 no backend), o sistema prioriza o registro mais recente da evolução salarial para o período filtrado.
05. Exemplo de Utilização
Este objeto é o componente base para:
- Relatório de Evolução Salarial: Análise de percentuais de aumento por departamento.
- Auditoria de Dissídio: Verificação se os reajustes sindicais foram aplicados corretamente nas datas retroativas.
- Planejamento Orçamentário: Consulta de bases salariais históricas para projeções futuras.