---

título: "Módulo Odoo Payroll: Guia completo de instalação e configuração" description: "Guia passo a passo para configurar a folha de pagamento Odoo com estruturas salariais, regras, recibos de pagamento, configuração de impostos e processamento de folha de pagamento." data: "2026-03-05" autor: "Equipe de Pesquisa e Desenvolvimento ECOSIRE" tags: ["odoo", "folha de pagamento", "hr", "salário", "erp"]

Módulo Odoo Payroll: Guia completo de instalação e configuração

O processamento da folha de pagamento é uma das operações mais sensíveis a erros em qualquer empresa. Um único erro de cálculo na retenção de impostos ou nas deduções de benefícios pode resultar em penalidades de conformidade, insatisfação dos funcionários e horas de trabalho corretivo. O módulo Odoo Payroll fornece uma estrutura estruturada para definir regras salariais, calcular recibos de pagamento e integrar folha de pagamento com contabilidade em sua plataforma ERP.

Este guia percorre todo o processo de configuração do Odoo Payroll, desde a configuração inicial até o processamento do primeiro lote de folha de pagamento.

Pré-requisitos

Antes de configurar a folha de pagamento, certifique-se de que estes módulos estejam instalados e configurados:

• Funcionários com registros contendo contratos, departamentos e cargos
• Contabilidade com contas específicas da folha de pagamento (despesas salariais, a pagar, obrigações fiscais)
• Folga (opcional) para licença sem vencimento para reduzir automaticamente a folha de pagamento
• Presença (opcional) se o cálculo depender das horas efetivamente trabalhadas

Compreendendo a arquitetura da folha de pagamento

Odoo Payroll usa uma estrutura hierárquica. Os tipos de estrutura salarial definem categorias amplas como Funcionário, Trabalhador ou Contratado. Cada tipo tem várias estruturas salariais, como funcionário mensal ou funcionário quinzenal. Cada estrutura contém regras salariais que calculam linhas individuais do contracheque.

Etapa 1: Configurar tipos de estrutura salarial

Navegue até Folha de pagamento > Configuração > Tipos de estrutura. Para a maioria das empresas, você precisa de:

Configure a estrutura de pagamento regular, o horário de trabalho padrão, a rubrica salarial e a frequência de pagamento programada para cada tipo.

Etapa 2: Definir Estruturas Salariais

Navegue até Folha de pagamento > Configuração > Estruturas. Uma estrutura mensal típica inclui:

Regras de Remuneração Bruta: Salário Básico do contrato, Auxílio Moradia (fixo ou percentual), Auxílio Transporte, Horas Extras de registros de frequência e Bônus/Comissão como remuneração variável.

Regras de Dedução: Imposto de Renda com base em faixas, contribuição dos empregados da Previdência Social, participação dos empregados do Seguro Saúde, contribuições para Aposentadoria/Pensão e Reembolso de Empréstimos para adiantamentos de salário.

Contribuições do Empregador: Equiparação de Seguro Social do Empregador, parcela do Seguro de Saúde do Empregador e Correspondência de Pensão do Empregador.

Salário Líquido é igual ao salário bruto menos todas as deduções dos funcionários.

Etapa 3: Configurar regras salariais

Cada regra precisa de um nome, categoria (Bruto, Dedução, Líquido, Empregador), código exclusivo para fórmulas e número de sequência para processamento de ordem.

Odoo oferece suporte a três métodos de computação:

Valor Fixo fornece um valor estático por período. Porcentagem é calculada a partir de outra regra. Código Python permite fórmulas personalizadas com acesso a recibo de pagamento, funcionário, contrato, categorias, regras, dias_trabalhados e variáveis ​​de entrada.

Exemplo de cálculo de faixa de imposto:

gross = categories.GROSS
if gross <= 5000:
    result = 0
elif gross <= 15000:
    result = (gross - 5000) * 0.10
elif gross <= 30000:
    result = 1000 + (gross - 15000) * 0.20
else:
    result = 4000 + (gross - 30000) * 0.30
result = -result  # Deductions are negative