Pular para conteúdo

Manual do RH — Telvora (time de teste)

Tela do Telvora ERP — Manual do RH — Telvora (time de teste)

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
Ambiente sugerido: https://telvora.core3.com.br/
Público: Operador RH | Gestor | QA / Teste
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

1. O que este módulo faz

Cadastro de colaboradores e catálogos (cargo, departamento, jornada, benefícios, treinamentos), adiantamento por filial, cálculo/fechamento de folha, contracheque e integração com Contas a Pagar (CPA). A contabilidade da folha entra pelo CPA (não por lançamento paralelo).

2. Quem pode usar

Permissões típicas: hr.employee.*, hr.payroll.*, hr.advance.*, hr.job_position.*, hr.training.*, catálogos hr.*.

3. Pré-requisitos

  • Empresa e filial no contexto do workspace.
  • Centros de custo e plano de contas (Contabilidade) se for classificar despesa do colaborador.
  • Tabelas oficiais INSS/IRRF/FGTS seedadas (competência vigente).
  • Parâmetros RH (Configurações → Parâmetros, grupo RH), se o cenário exigir CPA no fechamento.

4. Ordem sugerida de cadastros

  1. Departamentos — código automático (somente leitura).
  2. Jornadas — horas semanais.
  3. Tipos de contrato — regime, flags de folha/férias/13º e aba Eventos de Folha (vínculos após salvar).
  4. Treinamentos (catálogo) — curso + validade em meses.
  5. Cargos — CBO, salário referência; aba Treinamentos obrigatórios (após salvar o cargo).
  6. Benefícios e Eventos da folha — proventos/descontos extras.
  7. Funcionários.

Códigos (CARGO-0001, DEPT-0001, MAT-0001…) são pré-visualizados. Ao cancelar o formulário sem salvar, o código temporário é liberado.

5. Funcionário — passo a passo

  1. RH → Funcionários → Novo funcionário.
  2. Matrícula automática e não editável.
  3. Abas:
  4. Dados pessoais — CPF, endereço completo
  5. Dados profissionais — filial, cargo, departamento, tipo de contrato, jornada; CC e conta de despesa
  6. Remuneração — salário e dados bancários/PIX
  7. Férias / 13º — início da contagem, saldo, dias gozados, adiantamento de 13º
  8. Benefícios — vincular e remover
  9. Treinamentos — conformidade do cargo + histórico + registrar conclusão
  10. Documentos — observações e anexos
  11. Histórico — alterações salariais (leitura)
  12. Salve antes de vincular benefícios/treinamentos/anexos.

5.1 Treinamentos (ponto crítico de teste)

  1. Cadastre o treinamento no catálogo (RH → Treinamentos).
  2. No Cargo, vincule como obrigatório (se aplicável).
  3. No Funcionário → Treinamentos:
  4. Grade superior = conformidade do cargo (obrigatórios).
  5. Grade Histórico registrado = conclusões gravadas no colaborador.
  6. Registrar conclusão: selecione o treinamento na lista (autocomplete), informe data de conclusão; validade excepcional exige justificativa.
  7. Remover: no histórico, botão Remover — confirma e apaga o registro (atualiza conformidade).
Checklist QA Esperado
Registrar com data Aparece no histórico
Remover do histórico Some do histórico; conformidade pode voltar a PENDING
Só digitar sem selecionar na lista Não grava (deve exigir seleção)

6. Adiantamento salarial (somente por filial)

  1. RH → Adiantamentos → Gerar por filial.
  2. Informe filial, %, dias de geração/pagamento e competência.
  3. Sistema cria lote com adiantamentos PENDING dos ACTIVE da filial (e CPA, se configurado).
  4. Grade mostra o lote (não linha a linha). Badges: Pendente / Pago / Aplicado / Cancelado. Detalhes = relatório do lote.
  5. Cancelar exige motivo e cancela PENDING do lote (+ CPA vinculados).
  6. Após liquidar o CPA do adiantamento no Financeiro, o status individual passa a Pago (e o lote pode refletir PAID).

Não use esta tela para adiantamento de um único colaborador — use Lançamentos da folha.

7. Folha de pagamento

  1. RH → Folhas → criar competência (filial opcional) e tipo (Mensal, Férias ou 13º).
  2. Calcular — na mensal: salário + lançamentos + eventos do tipo de contrato + adiantamentos; INSS/IRRF/FGTS só se vinculados no tipo de contrato.
  3. Conferir itens (PJ sem tributo CLT; CLT só com os eventos marcados).
  4. Conferir → Fechar.
  5. Simulação Férias: usa saldo da aba Férias/13º × (salário/30). 13º: proporcional aos meses desde a admissão; desconta adiantamento de 13º cadastrado.
  6. Conferir → Fechar (pode gerar CPA por colaborador).
  7. Reabrir — cancela CPA abertos e permite recalcular.
  8. Contracheque — logo da filial (Cadastros → Filiais).

Tributos (origem)

Tributo Origem
INSS / IRRF / FGTS Só se o evento estiver em Tipo de Contrato → Eventos de Folha; cálculo pelas tabelas oficiais

Tabelas seed (SeedHrTaxTables) resolvidas pela competência da folha.

Contabilidade

Ao gerar/fechar CPA da folha, a Contabilidade lê os eventos AP_* do Financeiro. Não deve existir um segundo diário “só de folha”.

8. Lançamentos da folha

  1. RH → Lançamentos (ou equivalente no menu).
  2. Informe competência, funcionário, evento, valor.
  3. Use para proventos/descontos pontuais e adiantamento individual.
  4. Confira na grade filtrando a competência.

9. Dashboard RH

  • Totais de funcionários por status.
  • Folhas por status.
  • Treinamentos a vencer em 60 dias.

10. Roteiro de teste sugerido (ordem)

  1. Seed/cadastros: departamento → jornada → tipo contrato → treinamento → cargo (+ obrigatório) → benefício/evento.
  2. Criar funcionário ACTIVE com salário, filial, cargo, CC/conta.
  3. Vincular benefício e depois remover.
  4. Registrar treinamento → conferir histórico → Remover → conferir conformidade.
  5. Gerar adiantamento por filial → Detalhes → Cancelar com motivo (cenário separado se for testar folha com adiantamento).
  6. Criar folha mensal → Calcular (confira evento do tipo de contrato e tributos) → Conferir → Fechar → abrir CPA no Financeiro → ver Diário na Contabilidade.
  7. (Opcional) Folha tipo Férias / 13º com dados na aba Férias/13º → Calcular → conferir linhas.
  8. Imprimir contracheque (logo da filial).
  9. Reabrir folha (se permitido) e recalcular.

11. Erros / avisos comuns

Situação O que fazer
Motivo obrigatório ao cancelar adiantamento Informe o motivo no prompt
Treinamento “não grava” Selecione na lista + data; veja o histórico
Não conseguia remover treinamento Use Remover no histórico (disponível nesta versão)
Lote sem funcionários ACTIVE na filial + salário > 0
Contracheque sem logo Cadastros → Filiais → logo
Sem permissão hr.* Liberar no IAM / grupos
CPA não gerou Parâmetro de integração folha→CPA e status CLOSED

12. Artigos relacionados

Arquivo para envio ao time: este Markdown em
CORE3-ERP-DOCUMENTACAO-CURSOR/23-WIKI/rh/04-manual-rh-passo-a-passo.md

Referências