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 FopDependentesBusinessObject tem como objetivo fornecer uma visão consolidada dos dados cadastrais dos funcionários vinculados aos seus respectivos dependentes. Ele é utilizado principalmente para relatórios de conferência de benefícios, auditoria de encargos (IRRF/Salário Família) e dossiês cadastrais que exijam informações de endereço e identificação visual da coligada.
- Módulo: Folha de Pagamento
- Time Responsável: Rotinas
- Categoria: Cadastral
02. PARÂMETROS DE ENTRADA
Ao utilizar este objeto no Smart View, os seguintes filtros podem ser aplicados para refinar os dados:
| Parâmetro | Descrição | Comportamento |
|---|
| Coligada | Código da Empresa | Filtra os dados por uma ou mais coligadas selecionadas. |
| Matrícula | Chapa do Funcionário | Permite a seleção individual ou em lista de funcionários específicos. |
| Seção | Código da Seção | Filtra funcionários alocados em departamentos/seções específicas. |
| Situação | Status do Funcionário | Filtra por Ativos, Rescindidos, Afastados, etc. |
| Data de admissão/demissão. | Período de Início/Fim | Retorna funcionários admitidos dentro do intervalo selecionado. |
| Imprime sem dependente | Opção Sim/Não | Defina se funcionários que não possuem dependentes cadastrados devem aparecer na lista. |
03. Estrutura de Dados
Dados da Empresa (GCOLIGADA)
- CompanyCode: Código da coligada.
- CompanyName: Nome fantasia da empresa.
- CNPJ: Cadastro Nacional da Pessoa Jurídica.
- CompanyLogo: Logotipo da empresa (formato de imagem/byte).
- Endereço da Empresa: Logradouro, Número, Bairro, Cidade e CEP.
Dados do Funcionário (PFUNC / PPESSOA)
- EmployeeCode: Chapa do colaborador.
- EmployeeName: Nome completo do funcionário.
- Department: Descrição da seção/departamento.
- EmployeeCpf / EmployeeRg: Documentos de identificação.
- EmployeeCtps / Serie: Dados da Carteira de Trabalho.
- Endereço do Funcionário: Logradouro, Número, Bairro, Cidade e CEP.
Dados dos Dependentes (PFDEPEND)
- DependentNumber: Número sequencial do dependente.
- DependentName: Nome completo do dependente.
- Relationship: Grau de parentesco (conforme cadastro em PCODPARENT).
- DateOfBirth: Data de nascimento do dependente.
- Cpf: Cadastro de Pessoa Física do dependente.
04. Regra de Negócio
Para garantir a integridade dos dados, este objeto aplica as seguintes regras automáticas:
- Incidência de IRRF: Por padrão, o objeto filtra dependentes que possuem a flag de incidência de IRRF ativa (INCIRRF = 1), garantindo que apenas dependentes legais para fins fiscais sejam listados em contextos de conferência.
- Compatibilidade de Banco de Dados: A consulta é otimizada para ambientes SQL Server (utilizando leituras não bloqueantes - NoLock) e Oracle (respeitando as regras rigorosas de agrupamento de dados).
- Tratamento de Endereços: Os campos de Número e Bairro são tratados de forma individualizada, permitindo uma formatação de etiquetas e correspondências mais precisa.
- Logotipo Dinâmico: O campo CompanyLogo busca automaticamente a imagem vinculada ao cadastro da coligada (GIMAGEM), permitindo a personalização visual imediata do relatório.
05. Exemplo de Utilização
Este objeto é a fonte primária para o relatório de Relação de Dependentes por Funcionário, sendo ideal para:
- Conferência de documentação pendente.
- Geração de listas para concessão de benefícios.
- Auditoria de informações para o eSocial.