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 FopListaDependentesBusinessObject é focado na listagem detalhada de dependentes, agrupados por departamento. Ele possui lógicas internas para validar a elegibilidade ao Salário Família com base em múltiplos critérios (idade, vacinação e frequência escolar) e permite a filtragem por incidências fiscais específicas.
- Módulo: Folha de Pagamento
- Time Responsável: Rotinas
- Diferencial: Agrupamento automático por Seção e cálculo dinâmico de elegibilidade ao Salário Família.
02. PARÂMETROS DE ENTRADA
Os filtros deste objeto permitem refinar a lista tanto pelo funcionário quanto pelas características específicas do dependente:
| Parâmetro | Descrição | Comportamento |
|---|
| Seção | Código da Seção | Filtra por código da seção (suporta busca por hierarquia via LIKE). |
| Matrícula | Chapa do Funcionário | Permite filtrar um ou mais funcionários específicos. |
Incidência Sal. Família | Filtro de Elegibilidade | Filtra dependentes que têm ou não incidência de Salário Família. |
Incidência IRRF | Filtro de IRRF | Filtra dependentes que têm ou não incidência de IRRF. |
Situação | Status do Funcionário | Filtra pela situação cadastral (Ativo, Férias, etc). |
Grau de Parentesco | Vínculo Familiar | Filtra por tipos específicos (Filho, Cônjuge, etc). |
Imprime sem dependentes | Opção Sim/Não | Define se funcionários sem dependentes devem constar no agrupamento. |
03. Estrutura de Dados
Cabeçalho e Identificação
- CompanyName / CompanyCnpj: Dados de identificação da Coligada.
- CompanyLogo: Logotipo da empresa recuperado da tabela GIMAGEM.
- FinancialStatementMonth/Year: Mês e Ano de competência formatados.
Dados do Funcionário e Financeiros
- Employeecode / Employeename: Identificação do colaborador.
- Events (Lista): Contém os Proventos (Earnings), Descontos (Discounts) e Bases de Envelope.
- Basescalclist (Lista): Bases de cálculo específicas selecionadas nos parâmetros.
- Totalslist / Formulalist: Totais gerais e resultados das fórmulas de cabeçalho.
- Totalnetreceivable: Valor líquido a receber (Proventos - Descontos).
Agrupadores e Totais de Quebra (CCusto / Filial)
- CostCenterTot / BranchCodeTot: Listas de agrupamento que trazem totais de verbas e contadores de funcionários por unidade.
- SelfEmployed (Lista): Dados de autônomos rateados conforme a quebra selecionada.
04. Regra de Negócio
- Tratamento de Rateio: Se a quebra por Centro de Custo estiver ativa, o objeto utiliza a lógica de rateio para distribuir os eventos do funcionário proporcionalmente entre os centros de custo cadastrados.
- Contadores de Movimentação: O objeto calcula automaticamente totais de:
- Admitidos/Demitidos: Baseado na data de admissão e demissão dentro da competência.
- Afastamentos: Contagem por situação (Militar, Doença, Maternidade, Acidente, etc).
- Rescisão Complementar: Identifica demitidos em períodos anteriores com movimentação na competência atual.
- Ordenação: Suporta ordenação prioritária por Nome ou Chapa, respeitando sempre a hierarquia de Filial > Centro de Custo.
- Envelopes de Retificação: possui parâmetro específico para considerar ou desconsiderar envelopes de funcionários transferidos que sofreram retificação.
- Data de Pagamento: Possui lógica de contingência para buscar a data de pagamento na tabela de funcionários caso o registro específico do envelope esteja nulo.
05. Exemplo de Utilização
Este objeto é fundamental para:
- Fechamento Mensal: Conferência de totais de INSS, FGTS e IRRF por Filial.
- Análise de Custo: Verificação de gastos com pessoal rateados por Centro de Custo.
- Gestão de Autônomos: Consolidação de pagamentos feitos a prestadores de serviço externos integrados à folha.
06. Relatórios que utilizam esse objeto de negócio