Configuração de RH e Folha de Pagamento do Odoo

Visão Geral

Esta habilidade orienta gerentes de RH e contadores de folha de pagamento na configuração correta do RH e Folha de Pagamento do Odoo. Ela abrange a criação de estruturas salariais com regras computadas em Python, políticas de afastamento, tipos de contrato de funcionário e o fluxo de lançamento da folha de pagamento para contabilidade.

Quando Usar Esta Habilidade

• Criar uma estrutura salarial com salário bruto, deduções e salário líquido.
• Configurar políticas de férias anuais, licença médica e feriados.
• Solucionar problemas de valores incorretos em recibos de pagamento ou contribuições de regras ausentes.
• Configurar o diário de folha de pagamento para lançar corretamente na contabilidade.

Como Funciona

1. Ativar: Mencione @odoo-hr-payroll-setup e descreva seu cenário de folha de pagamento.
2. Configurar: Receba configuração passo a passo para regras salariais e alocação de licenças.
3. Depurar: Cole uma regra salarial ou um problema de recibo de pagamento e receba uma análise da causa raiz.

Exemplos

Exemplo 1: Estrutura Salarial com Deduções

Menu: Payroll → Configuration → Salary Structures → New

Name: US Employee Monthly
Payslip Code: MONTHLY

Rules (executed top-to-bottom — order matters):
  Code  | Name                   | Formula                        | Category
  ----- | ---------------------- | ------------------------------ | ---------
  BASIC | Basic Wage             | contract.wage                  | Basic
  GROSS | Gross                  | BASIC                          | Gross
  SS    | Social Security (6.2%) | -GROSS * 0.062                 | Deduction
  MED   | Medicare (1.45%)       | -GROSS * 0.0145                | Deduction
  FIT   | Federal Income Tax     | -GROSS * inputs.FIT_RATE.amount| Deduction
  NET   | Net Salary             | GROSS + SS + MED + FIT         | Net

Imposto de Renda Federal: A localização padrão dos EUA do Odoo não expõe um único campo l10n_us_w4_rate. Use uma entrada (tipo de entrada salarial) para passar a taxa de retenção por funcionário, ou instale um módulo de folha de pagamento dos EUA da comunidade (OCA l10n_us_hr_payroll) que lida com o status de declaração W4 corretamente.

Exemplo 2: Configurar um Tipo de Afastamento

Menu: Time Off → Configuration → Time Off Types → New

Name: Annual Leave / PTO
Approval: Time Off Officer
Leave Validation: Time Off Officer  (single approver)
  or: "Both" for HR + Manager double approval

Allocation:
  ☑ Employees can allocate time off themselves
  Requires approval: No

Negative Balance: Not allowed (employees cannot go negative)

Then create initial allocations:
Menu: Time Off → Managers → Allocations → New
  Employee: [Each employee]
  Time Off Type: Annual Leave / PTO
  Allocation: 15 days
  Validity: Jan 1 – Dec 31 [current year]

Exemplo 3: Resultado da Entrada do Diário de Folha de Pagamento

After validating a payroll batch, Odoo generates:

Debit   Salary Expense Account     $5,000.00
  Credit  Social Security Payable     $310.00
  Credit  Medicare Payable             $72.50
  Credit  Federal Tax Payable         (varies)
  Credit  Salary Payable           $4,617.50+

When net salary is paid:
Debit   Salary Payable            $4,617.50
  Credit  Bank Account              $4,617.50

Employer taxes (e.g., FUTA, SUTA) post as separate journal entries.

Melhores Práticas

• ✅ Fazer: Instale a localização de folha de pagamento do seu país (l10n_us_hr_payroll, l10n_mx_hr_payroll, etc.) antes de construir regras personalizadas — ela fornece estruturas fiscais pré-configuradas.
• ✅ Fazer: Use entradas de regras salariais (inputs.ALLOWANCE.amount) para passar valores variáveis (bônus, ajudas de custo, taxas de retenção) em vez de codificá-los diretamente na fórmula da regra.
• ✅ Fazer: Arquive estruturas salariais antigas em vez de excluí-las — recibos de pagamento ativos referenciam sua estrutura e falharão se a estrutura for excluída.
• ✅ Fazer: Sempre defina um Contrato de Funcionário ativo com datas e salário corretos antes de gerar recibos de pagamento.
• ❌ Não fazer: Edite manualmente recibos de pagamento lançados — cancele e gere novamente o lote de recibos de pagamento se forem necessárias correções.
• ❌ Não fazer: Use contract.wage em regras de dedução sem verificar se a estrutura é mensal ou anual — sempre verifique o período salarial do contrato.

Limitações

• A Folha de Pagamento do Odoo é apenas para Enterprise — a Edição Community não inclui o módulo de Folha de Pagamento (hr_payroll).
• Conformidade específica dos EUA (W2, 941, declaração estadual SUI/SDI) requer módulos adicionais além da localização base; o Odoo não gera declarações fiscais diretamente.

…