Pular para conteúdo

Folha de pagamento (Fatia 2)

Tela do Telvora ERP — Folha de pagamento (Fatia 2)

Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.

Módulo: RH / Folha
Menu: Operações → RH → Folhas / Lançamentos / Adiantamentos
Público: Operador de RH | Gestor
Status: Publicado
Atualizado: 2026-09-11
Refs técnicas: ADR-022 · 01-ARQUITETURA/67-rh-folha.md · DECISION_REQUIRED-rh-ferias-13-calculo-v1.md

O que faz

Processa a folha mensal (ou simulação de férias/13º) por competência: salário, lançamentos manuais, eventos vinculados ao tipo de contrato, benefícios com desconto em folha e adiantamentos. INSS / IRRF / FGTS só entram se esses eventos estiverem vinculados em Tipos de Contrato → Eventos de Folha (cálculo paramétrico pelas tabelas oficiais). Contrato PJ sem esses vínculos não recebe tributos de CLT.

Quem pode usar

  • hr.payroll.read / create / update / process / close / reopen
  • hr.entry.read / create / update
  • hr.advance.read / create / update

Pré-requisitos

  • Funcionários ativos com salário e tipo de contrato que participa da folha.
  • Eventos padrão são criados automaticamente (SALARIO, ADIANTAMENTO, VALE_TRANSPORTE, INSS, IRRF, FGTS, FERIAS, DECIMO_TERCEIRO, ADIANTAMENTO_13).
  • Em Tipos de Contrato → Eventos de Folha, vincule:
  • proventos/descontos recorrentes (valor/% no cadastro do evento);
  • INSS, IRRF e/ou FGTS quando o regime exigir (ex.: CLT). Sem vínculo = sem esse tributo.
  • Na aba Férias / 13º do funcionário, informe saldo de dias (e adiantamento de 13º) antes de gerar folha tipo Férias / 13º.
  • Tabelas oficiais seedadas. Parâmetro hr.allow_retroactive_payroll controla competência passada.

Passo a passo

1. Lançamentos manuais (opcional)

  1. Abra Operações → RH → Lançamentos.
  2. Informe competência, funcionário, evento e valor.
  3. Salve. Os lançamentos entram no cálculo da folha mensal da mesma competência.

2. Adiantamentos (opcional)

  1. Abra Adiantamentos.
  2. Gere o lote por filial (não há criação pontual nesta tela).
  3. Status do adiantamento: Pendente → após liquidar o CPA vira Pago → na folha mensal vira desconto e passa a Aplicado.
  4. A grade do lote mostra badge com esses rótulos (PAID = Pago).

3. Folha mensal

  1. Abra Folhas → Nova folha (competência, tipo Mensal, filial opcional).
  2. Clique Calcular — gera itens por funcionário ACTIVE da empresa/filial (salário + lançamentos + eventos do tipo de contrato + benefícios + adiantamentos + tributos vinculados).
  3. Férias: se no funcionário a data de competência das férias (vacation_accrual_start) cair no mesmo mês/ano da folha e houver saldo de dias, entra a linha FERIAS.
  4. 13º: na folha de dezembro (YYYY-12) entra o 13º proporcional (e o desconto do adiantamento, se cadastrado).
  5. Revise totais e itens; use Contracheque para imprimir.
  6. Conferir → Fechar. Folha fechada não recalcula; use Reabrir se precisar corrigir.

4. Simulação dedicada de férias / 13º

  1. Na criação da folha, escolha tipo Férias (simulação) ou 13º (simulação) (qualquer competência).
  2. Calcular:
  3. Férias: saldo de dias × (salário ÷ 30) (requer has_vacation no contrato e saldo > 0).
  4. 13º: salário × meses desde a admissão / 12 (máx. 12); se houver adiantamento de 13º no cadastro, desconta até o valor do provento.
  5. É simulação V1 (sem 1/3 constitucional nem regras trabalhistas completas). Detalhes em DECISION_REQUIRED-rh-ferias-13-calculo-v1.md.

5. Contracheque

Na grade “Por funcionário”, botão Contracheque abre janela de impressão com proventos, descontos, informativos e totais.

Regras importantes

  • Tributos: INSS / IRRF / FGTS só são calculados se o evento estiver em Tipos de Contrato → Eventos de Folha. Ex.: CLT com só FGTS vinculado → só FGTS; PJ sem vínculos de tributo → só salário (+ outros eventos cadastrados).
  • Eventos do tipo de contrato (exceto INSS/IRRF/FGTS) entram na mensal pelo kind (provento/desconto/informativo) e default_value (se unit = PERCENT, % do salário). Se já existir lançamento manual do mesmo evento na competência, o vínculo do contrato é ignorado para evitar duplicar.
  • Dinheiro em decimal (sem float); centros de custo e plano de contas continuam os da Contabilidade.
  • Folha CLOSED bloqueia cálculo; REOPENED permite calcular de novo.
  • Tipo ADVANCE (API): créditos dos adiantamentos PENDING (uso legado; a UI de folhas usa Mensal / Férias / 13º).

Erros / avisos comuns

Mensagem / situação O que fazer
Já existe folha para esta competência… Use a folha existente ou altere tipo/filial.
Folha fechada não pode ser recalculada Reabra a folha.
Adiantamento já aplicado… Não cancela após desconto na mensal.
Não há itens… no contracheque Calcule a folha antes.
Simulação de férias sem linhas Confira competência das férias (= mês/ano da folha mensal), saldo de dias e flag férias no tipo de contrato. Folha de janeiro não recebe férias se a competência cadastrada for dezembro.
Folha já fechada Reabrir → Calcular de novo após alterar o cadastro do funcionário.

Relacionados

Referências