Pular para conteúdo

RH Fatia 3 — parâmetros, tabelas e CPA

Tela do Telvora ERP — RH Fatia 3 — parâmetros, tabelas e CPA

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

Módulo: RH
Menu: Operações → RH · Configurações → Parâmetros (grupo RH)
Público: Operador | Gestor | Administrador
Status: Publicado
Atualizado: 2026-09-09
Refs técnicas: ADR-022 · 01-ARQUITETURA/67-rh-folha.md

O que faz

Completa o módulo de folha com campos obrigatórios do funcionário, matrícula/códigos automáticos, CBO, tabelas oficiais INSS/IRRF/FGTS, adiantamento por filial e geração de Contas a Pagar.

Quem pode usar

  • Cadastros: hr.employee.*, hr.job_position.*, etc.
  • Folha / tabelas: hr.payroll.read|update|process|close|reopen
  • Adiantamentos: hr.advance.*
  • Parâmetros: settings.parameter.*

Pré-requisitos

  • Empresa e filial no contexto
  • Cargo, departamento, tipo de contrato e jornada cadastrados
  • Para CPA: fornecedor gerado no funcionário + centro de custo e conta de despesa (ou parâmetro de conta)

Passo a passo

  1. Em Parâmetros, grupo RH, confira folha retroativa e geração de CPA.
  2. Cadastre Tipo de contrato (marque se participa da folha), Eventos e Benefícios.
  3. Em Cargos, busque o CBO na lupa.
  4. Admita o Funcionário com endereço, filial, cargo, depto, contrato e jornada (matrícula pode ficar em branco).
  5. Na aba Benefícios, ao escolher o benefício o valor vem do cadastro (default_amount) e aparece na grade.
  6. Em Adiantamentos, use Gerar por filial para lote percentual.
  7. Processe a Folha normalmente; no fechamento o sistema tenta criar CPA por funcionário.

Tabelas oficiais (INSS / IRRF / FGTS)

Fonte do cálculo da folha: tabela hr_tax_tables + faixas hr_tax_table_brackets, seedadas automaticamente (SeedHrTaxTables, competência a partir de 2026-01).

  • API: GET /api/v1/hr/tax-tables, PATCH /api/v1/hr/tax-table-brackets/{id}, POST /api/v1/hr/tax-preview
  • Parâmetros operacionais (CPA, retroativa): Configurações → Parâmetros → grupo RH
  • Tela dedicada de edição visual das faixas ainda não existe; o seed cobre o ambiente de teste

Regras importantes

  • Adiantamento só edita enquanto PENDING e até a data de pagamento.
  • Reabrir folha cancela os títulos CPA e libera a chave de idempotência para um novo fechamento.
  • IRRF V1: base = remuneração − INSS (sem dependentes).

Erros / avisos comuns

Situação O que fazer
Folha retroativa bloqueada Ative hr.allow_retroactive_payroll ou use o mês corrente
CPA não gerado Preencha CC e conta no funcionário (ou parâmetro de conta)
Duplicate idempotency ao refechar Corrigido: cancelamento do CPA libera a chave
Matrícula/código duplicado Informe outro código ou deixe em branco para automático

Relacionados

Referências