Configuração da folha de pagamento Odoo HR por país: guia de configuração completo

Guia passo a passo para configurar o Odoo HR Payroll para diferentes países, incluindo regras fiscais, previdência social, deduções e relatórios legais.

E
ECOSIRE Research and Development Team
|16 de março de 202611 min de leitura2.3k Palavras|

Parte da nossa série Compliance & Regulation

Leia o guia completo

Configuração da folha de pagamento Odoo HR por país: guia completo de configuração

A folha de pagamento é o módulo mais específico do país em qualquer sistema ERP. Os escalões fiscais, as contribuições para a segurança social, os regimes de pensões e os requisitos legais de apresentação de relatórios variam dramaticamente entre jurisdições. O módulo de folha de pagamento do Odoo aborda isso por meio de uma estrutura de localização que fornece regras salariais, tabelas de impostos e modelos de relatórios específicos do país. Este guia explica o processo de configuração para as principais regiões e as opções de personalização para países sem localizações oficiais.

Principais conclusões

  • Odoo 19 é fornecido com localizações de folha de pagamento para mais de 40 países, abrangendo regras salariais, tabelas fiscais e relatórios legais
  • O mecanismo de regras salariais usa expressões Python para cálculos complexos, mantendo uma trilha de auditoria completa
  • Organizações multinacionais podem executar folha de pagamento para diferentes jurisdições a partir de uma única instância do Odoo
  • Localizações personalizadas podem ser criadas usando a estrutura salarial para países não suportados oficialmente
  • A integração com a contabilidade garante que os lançamentos contábeis manuais da folha de pagamento sejam lançados automaticamente com o mapeamento correto da conta

Visão geral da arquitetura da folha de pagamento

A folha de pagamento Odoo processa cálculos salariais por meio de um mecanismo baseado em regras. A arquitetura consiste em:

Estruturas Salariais: Modelos que definem quais regras salariais se aplicam a uma categoria de funcionários. Uma empresa pode ter estruturas para funcionários assalariados mensais, trabalhadores horistas e terceirizados.

Regras Salariais: Etapas de cálculo individuais dentro de uma estrutura. Cada regra possui uma expressão Python que calcula seu valor com base em entradas como salário base, dias trabalhados e resultados de regras anteriores. As regras são executadas em sequência com base no seu número de prioridade.

Categorias de regras salariais: agrupamentos que organizam regras para relatórios. As categorias incluem salário bruto, deduções, contribuições patronais e salário líquido.

Recibo de pagamento: o documento de saída de um único funcionário para um único período, contendo todos os valores de regras computados.

Navegue até Folha de pagamento > Configuração > Estruturas salariais para visualizar e modificar as estruturas salariais disponíveis em sua instância do Odoo.

Configuração dos Estados Unidos

Configuração de Imposto Federal

A folha de pagamento dos EUA exige a configuração da retenção de imposto de renda federal com base no formulário W-4 do funcionário:

  1. Navegue até Folha de Pagamento > Configuração > Regras Salariais e localize a regra do Imposto de Renda Federal
  2. A regra faz referência às faixas de impostos atuais do IRS, que Odoo atualiza anualmente
  3. O contrato de cada funcionário armazena seu status de arquivamento (solteiro, casado, arquivado em conjunto, chefe de família) e subsídios
  4. O cálculo contabiliza as deduções antes dos impostos (401k, seguro saúde, FSA) antes de calcular o lucro tributável

Configuração de Imposto Estadual

O imposto de renda estadual exige regras adicionais para cada estado onde os funcionários trabalham:

Categoria EstadualExemplosAbordagem de configuração
Nenhum imposto de renda estadualTX, FL, WA, NV, NH, TN, WY, SD, AKNão são necessárias regras adicionais
Taxa fixaIL (4,95%), PA (3,07%), IN (3,05%)Regra única com percentagem fixa
Colchetes progressivosCA, NY, NJ, OURegra multi-colchetes semelhante à federal
Impostos locaisNova York, Filadélfia, DetroitRegras adicionais por localidade

FICA e Medicare

A Segurança Social (6,2% até à base salarial) e o Medicare (1,45% com 0,9% adicional acima de 200.000 USD) configuram-se como regras de contribuição do empregador e do empregado. O limite salarial base é atualizado anualmente --- para 2026, configure a base salarial da Previdência Social em Folha de pagamento > Configuração > Parâmetros.

Benefícios e Deduções

Deduções comuns nos EUA configuradas como regras salariais:

  • 401(k): Dedução antes de impostos com correspondência do empregador (porcentagem e limite configuráveis)
  • Seguro de saúde: Participação no prêmio do funcionário (antes de impostos de acordo com a Seção 125)
  • HSA/FSA: contribuições antes de impostos para poupanças de saúde ou contas de despesas flexíveis
  • Roth 401(k): Dedução pós-impostos (reduz o salário líquido, mas não o lucro tributável)
  • penhoras: deduções judiciais com regras de prioridade

Países da União Europeia

Alemanha

A folha de pagamento alemã está entre as mais complexas devido ao imposto religioso, à sobretaxa de solidariedade e à interação entre as contribuições para a seguridade social:

Classes fiscais (Steuerklasse I a VI) determinam a retenção do imposto de renda. Configure a classe fiscal de cada funcionário em seu contrato em Folha de pagamento > Funcionários > Contratos.

As contribuições para a segurança social na Alemanha são divididas igualmente entre empregador e empregado:

ContribuiçãoTaxa de funcionárioTaxa do empregadorTeto (2026)
Seguro saúde7,3% + suplemento7,3% + suplemento62.100 euros/ano
Seguro de pensões9,3%9,3%90.600 EUR/ano (Oeste)
Seguro desemprego1,3%1,3%90.600 euros/ano
Cuidados de longa duração1,7% (+0,6% sem filhos)1,7%62.100 euros/ano

Imposto religioso: 8% ou 9% do imposto de renda dependendo do estado federal (Bundesland).

França

A folha de pagamento francesa usa o DSN (Declaration Sociale Nominative) para relatórios eletrônicos às agências de seguridade social. Principais áreas de configuração:

  • Cotisations sociales: Mais de 30 linhas individuais de contribuição social que abrangem saúde, aposentadoria, desemprego e previdência complementar
  • CSG/CRDS: Contribuição Social calculada sobre 98,25% do salário bruto
  • Mutuelle: Seguro de saúde complementar obrigatório (o empregador paga no mínimo 50%)
  • Previdência: Contribuições para seguro de morte e invalidez
  • Redução Fillon: Redução previdenciária patronal para salários próximos ao salário mínimo

Reino Unido

A folha de pagamento do Reino Unido segue o sistema PAYE (Pay As You Earn):

  • Códigos fiscais: códigos atribuídos pelo HMRC que determinam a isenção de impostos (por exemplo, 1257L para a franquia pessoal padrão)
  • Seguro Nacional: contribuições de NI do funcionário a 8% (acima do limite primário) e NI do empregador a 13,8% (acima do limite secundário)
  • Deduções de empréstimos estudantis: Plano 1, Plano 2, Plano 4 ou taxas de pós-graduação
  • Inscrição automática de pensões: Pensão no local de trabalho no mínimo 5% do empregado + 3% do empregador
  • Relatórios RTI: envios de informações em tempo real ao HMRC após cada execução de pagamento

Oriente Médio e África

Emirados Árabes Unidos

A folha de pagamento dos Emirados Árabes Unidos é mais simples devido à ausência de imposto de renda, mas requer atenção a:

  • Cálculo de gratificação: Gratificação de fim de serviço com base nos anos de serviço (21 dias/ano nos primeiros 5 anos, 30 dias/ano a partir de então)
  • Conformidade com WPS: Transferências eletrônicas de salários do Sistema de Proteção de Salários por meio de bancos aprovados
  • DEWS: Plano Difc Employee Workplace Savings para empresas sediadas em DIFC
  • Auxílio moradia: Normalmente 30-40% do salário base, configurado como regra salarial

Arábia Saudita

  • GOSI: Organização Geral para Contribuições para a Segurança Social (empregador 12%, empregado 10% para cidadãos sauditas; empregador 2% para expatriados)
  • Sem imposto de renda: Para pessoas físicas (o imposto corporativo se aplica a entidades estrangeiras)
  • Saudização: Acompanhamento de porcentagens de nacionalidade para conformidade com o programa Nitaqat

África do Sul

  • PAYE: faixas fiscais progressivas administradas pela SARS
  • UIF: Fundo de Seguro Desemprego (1% empregado + 1% empregador, limitado)
  • SDL: Taxa de Desenvolvimento de Competências (1% da folha de pagamento total)
  • Créditos fiscais médicos: Créditos mensais fixos por dependente

Ásia-Pacífico

Índia

A folha de pagamento indiana envolve vários componentes:

ComponenteDescriçãoPorcentagem típica
BásicoComponente do salário base40-50% do CTC
RHSubsídio de aluguel de casa40-50% do Básico
DASubsídio de CaridadeVaria por setor
Subsídio EspecialComponente flexívelSaldo do CTC
FPCaixa de Previdência (trabalhador)12% do Básico
FPCaixa de Previdência (empregador)12% do Básico (3,67% EPF + 8,33% EPS)
IESSeguro Estadual de Funcionário0,75% empregado + 3,25% empregador
Imposto ProfissionalImposto estadualVaria de acordo com o estado (máx. 2.500 INR/ano)

TDS (Imposto Retido na Fonte): O empregador calcula e deduz mensalmente o imposto de renda com base nos investimentos declarados e no regime tributário aplicável (antigo x novo).

Austrália

  • Retenção PAYG: imposto de renda pré-pago usando tabelas de impostos ATO
  • Superannuation: Contribuição para aposentadoria exigida pelo empregador (11,5% para 2026)
  • HECS-HELP: reembolsos de empréstimos para educação superior acima do limite de renda
  • Imposto Medicare: 2% do rendimento tributável (com sobretaxa para pessoas com rendimentos mais elevados sem seguro de saúde privado)
  • Relatórios STP: folha de pagamento de toque único para ATO com cada evento de pagamento

Criando localizações personalizadas

Para países sem localizações oficiais do Odoo, você pode criar estruturas salariais personalizadas:

Etapa 1: Definir estrutura salarial

Crie uma nova estrutura salarial em Folha de pagamento > Configuração > Estruturas salariais com regras que abrangem:

  • Cálculo do salário bruto
  • Regras de retenção de impostos (consulte as faixas de impostos do país)
  • Contribuições previdenciárias (parcelas trabalhistas e patronais)
  • Deduções legais (pensões, seguros, etc.)
  • Cálculo do salário líquido

Etapa 2: Criar regras salariais

Cada regra salarial exige:

  • Nome e código: Nome descritivo e código de referência exclusivo
  • Categoria: Bruto, dedução, contribuição patronal ou líquida
  • Sequência: Ordem de execução (números menores são executados primeiro)
  • Expressão Python: A lógica de cálculo

Exemplo de regra para cálculo progressivo de imposto:

A condição Python verifica se o total da categoria para salário bruto é maior que zero. A expressão de cálculo faz referência aos limites e taxas da faixa de imposto para o país específico, aplicando taxas marginais a cada faixa. O objeto payslip fornece acesso a todos os resultados de regras anteriores e dados de contrato de funcionário.

Etapa 3: Configurar relatórios estatutários

Crie modelos de relatórios usando o mecanismo de relatórios QWeb do Odoo para relatórios específicos de cada país, como certificados fiscais, declarações de segurança social e resumos de final de ano.

Operações de folha de pagamento em vários países

Organizações que operam em vários países podem executar toda a folha de pagamento a partir de uma única instância do Odoo:

  1. Crie estruturas salariais para cada país
  2. Atribuir estruturas aos contratos dos funcionários com base no local de trabalho
  3. Configurar a contabilidade com lançamentos contábeis manuais separados por país para lançamento contábil adequado
  4. Definir períodos de pagamento por país (mensalmente é padrão na maioria dos países; quinzenalmente nos EUA)
  5. Gere relatórios específicos de cada país usando modelos de relatórios localizados

O recurso multiempresa do Odoo oferece suporte a entidades legais separadas por país, ao mesmo tempo que mantém relatórios consolidados no nível do grupo.

Integração da folha de pagamento com contabilidade

Cada lote de recibos de pagamento gera lançamentos contábeis manuais que são contabilizados no razão geral. O mapeamento de contas é configurado por regra salarial:

  • Contas de despesas salariais: lançamentos de débito para salário bruto, contribuições patronais
  • Contas do passivo: Lançamentos de crédito para retenção de impostos, segurança social a pagar
  • Conta bancária: Lançamento de crédito para pagamento de salário líquido

Navegue até Folha de pagamento > Configuração > Regras salariais e edite cada regra para definir as contas de débito e crédito. O lançamento contábil manual é criado quando o lote do recibo de pagamento é validado e pode ser revisado antes do lançamento.

Serviços de folha de pagamento ECOSIRE

Configurar corretamente a folha de pagamento requer profundo conhecimento da arquitetura técnica do Odoo e da legislação trabalhista local. Os serviços de implementação Odoo da ECOSIRE incluem especialistas em folha de pagamento que configuram localizações específicas de cada país, criam regras salariais personalizadas e validam cálculos em registros manuais de folha de pagamento. Nossos serviços de suporte incluem atualizações anuais para alterações nas faixas de impostos e modificações regulatórias.

Leitura Relacionada

Com que frequência as localizações da folha de pagamento Odoo são atualizadas para alterações fiscais?

As localizações oficiais do Odoo são atualizadas pelo menos anualmente para refletir novas faixas de impostos, tetos de seguridade social e mudanças regulatórias. Para clientes empresariais, essas atualizações estão incluídas na assinatura de manutenção e normalmente chegam antes do início do novo ano fiscal. As localizações personalizadas devem ser atualizadas manualmente.

O Odoo pode lidar com a folha de pagamento de funcionários assalariados e horistas?

Sim. Crie estruturas salariais separadas para funcionários assalariados e horistas. As estruturas horárias fazem referência ao módulo de frequência ou às entradas da planilha de horas para calcular as horas trabalhadas e, em seguida, aplicam taxas horárias com multiplicadores de horas extras com base nos requisitos da legislação trabalhista local.

A folha de pagamento Odoo é certificada para conformidade regulatória em todos os países suportados?

A certificação varia de acordo com o país. Algumas localizações (França, Bélgica, África do Sul) foram certificadas ou validadas pelas autoridades locais. Outros baseiam-se nas regras e taxas fiscais publicadas, mas podem não possuir certificação formal. Sempre verifique os cálculos da folha de pagamento em relação a fontes independentes durante a configuração inicial.

E

Escrito por

ECOSIRE Research and Development Team

Construindo produtos digitais de nível empresarial na ECOSIRE. Compartilhando insights sobre integrações Odoo, automação de e-commerce e soluções de negócios com IA.

Mais de Compliance & Regulation

Lista de verificação de preparação para auditoria: como seu ERP torna as auditorias 60% mais rápidas

Lista de verificação completa de preparação de auditoria usando sistemas ERP. Reduza o tempo de auditoria em 60% com documentação, controles e coleta automatizada de evidências adequados.

Guia de implementação de consentimento de cookies: gerenciamento de consentimento em conformidade legal

Implemente o consentimento de cookies que esteja em conformidade com GDPR, ePrivacy, CCPA e regulamentações globais. Abrange banners de consentimento, categorização de cookies e integração CMP.

Regulamentações de transferência de dados transfronteiriças: navegando em fluxos de dados internacionais

Navegue pelas regulamentações de transferência de dados transfronteiriças com SCCs, decisões de adequação, BCRs e avaliações de impacto de transferência para conformidade com GDPR, Reino Unido e APAC.

Requisitos regulatórios de segurança cibernética por região: um mapa de conformidade para empresas globais

Navegue pelas regulamentações de segurança cibernética nos EUA, UE, Reino Unido, APAC e Oriente Médio. Abrange regras NIS2, DORA, SEC, requisitos de infraestrutura crítica e cronogramas de conformidade.

Governança e conformidade de dados: o guia completo para empresas de tecnologia

Guia completo de governança de dados que abrange estruturas de conformidade, classificação de dados, políticas de retenção, regulamentos de privacidade e roteiros de implementação para empresas de tecnologia.

Políticas de retenção de dados e automação: mantenha o que você precisa, exclua o que você precisa

Crie políticas de retenção de dados com requisitos legais, cronogramas de retenção, aplicação automatizada e verificação de conformidade para GDPR, SOX e HIPAA.

Converse no WhatsApp