Módulo de folha de pagamento Odoo 19: guia completo de configuração e gerenciamento

O processamento da folha de pagamento está entre as operações mais sensíveis a erros em qualquer organização. Uma retenção de imposto mal calculada gera penalidades de conformidade. Uma dedução incorreta de benefícios desencadeia queixas dos funcionários. Um atraso na folha de pagamento prejudica a confiança de toda a força de trabalho. O módulo Odoo 19 Payroll fornece uma estrutura estruturada para definir regras salariais, calcular recibos de pagamento, lidar com a conformidade fiscal em vários países e integrar perfeitamente a folha de pagamento com seus sistemas de contabilidade e RH.

Este guia cobre todo o ciclo de vida do gerenciamento da folha de pagamento do Odoo 19 – desde a configuração inicial do módulo até o processamento mensal, relatórios de final de ano e considerações de conformidade específicas do país.

Principais conclusões

• Odoo 19 Payroll usa uma estrutura hierárquica: os tipos de estrutura contêm estruturas, que contêm regras salariais que calculam linhas de recibo de pagamento individuais
• Os contratos dos funcionários devem ser totalmente configurados com detalhes salariais, benefícios e horários de trabalho antes do início do processamento da folha de pagamento
• As regras salariais suportam três métodos de cálculo: valores fixos, porcentagens de outras regras e código Python personalizado para cálculos complexos
• A integração da folha de pagamento com a contabilidade gera automaticamente lançamentos contábeis manuais, eliminando a escrituração manual de despesas salariais
• A folha de pagamento em vários países é possível em uma única instância do Odoo, com pacotes de localização específicos do país que lidam com faixas de impostos, seguridade social e deduções legais
• Odoo 19 apresenta painéis de folha de pagamento aprimorados, desempenho de processamento em lote e localização expandida para 15 países adicionais

Pré-requisitos antes da configuração da folha de pagamento

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

• Funcionários – Registros completos de funcionários com informações pessoais, atribuições de departamento, cargos e locais de trabalho
• Contratos -- Contratos de trabalho ativos com detalhes salariais, datas de início e horários de trabalho
• Contabilidade - Plano de contas com contas específicas da folha de pagamento (despesas salariais, folha de pagamento a pagar, obrigações fiscais, contas de benefícios)
• Folga (opcional) -- Se a licença sem vencimento deve reduzir automaticamente os cálculos da folha de pagamento
• Presença (opcional) -- Se a folha de pagamento depender de horas reais trabalhadas em vez de salários mensais fixos
• Quadros de horas (opcional) -- Para faturamento baseado em projeto que se integra à folha de pagamento do contratante

Compreendendo a arquitetura da folha de pagamento

Visão geral da hierarquia

Odoo Payroll organiza a lógica de remuneração em uma hierarquia clara:

| Nível | O que define | Exemplo | |-------|----------------|--------| | Tipo de Estrutura | Ampla categoria de funcionários e frequência de pagamento | Funcionário Mensal, Trabalhador Horista, Empreiteiro | | Estrutura Salarial | Pacote de remuneração específico dentro de um tipo | Funcionário Mensal nos EUA, Funcionário Mensal no Reino Unido | | Regra Salarial | Linha de cálculo individual no contracheque | Salário Básico, Imposto de Renda, Plano de Saúde | | Categoria de regra | Agrupamento por regras salariais no contracheque | Bruto, Deduções, Salário Líquido, Custo do Empregador |

Essa hierarquia permite que uma única instância do Odoo lide com vários tipos de funcionários, frequências de pagamento e regulamentações específicas do país em um sistema de folha de pagamento.

Categorias de regras

As categorias de regras padrão organizam as linhas do contracheque:

• Básico -- Salário base do contrato de trabalho
• Auxílio -- Moradia, transporte, alimentação e outras complementações
• Bruto -- Total do salário base mais todos os subsídios
• Dedução - Deduções do lado do funcionário (impostos, previdência social, seguros, amortizações de empréstimos)
• Líquido -- Valor pago ao funcionário (bruto menos deduções)
• Contribuição do empregador -- Custos da empresa (previdência social do empregador, equiparação de pensões, seguro)
• Custo Total -- Custo total para o empregador (líquido + deduções + contribuições do empregador)

Etapa 1: Configurar tipos de estrutura

Navegue até Folha de pagamento > Configuração > Tipos de estrutura e crie entradas para cada categoria de funcionário:

| Tipo de Estrutura | Rubrica salarial | Frequência de pagamento | Caso de uso | |---------------|-----------|---------------|----------| | Funcionário Mensal | Mensal Fixo | Mensalmente | Trabalhadores assalariados a tempo inteiro | | Funcionário quinzenal | Mensal Fixo | A cada duas semanas | Funcionários assalariados pagos quinzenalmente | | Trabalhador Horista | Por hora | Semanal ou Quinzenal | Trabalhadores remunerados | | Empreiteiro | Mensal Fixo | Mensalmente | Contratantes independentes | | Funcionário de meio período | Mensal Fixo | Mensalmente | Pessoal assalariado a tempo parcial |

Para cada tipo de estrutura, configure:

• Estrutura salarial regular -- A estrutura padrão atribuída a funcionários deste tipo
• Horário de trabalho padrão -- Horas padrão por semana (por exemplo, 40 horas)
• Tipo de entrada de trabalho padrão -- Como os registros de presença são mapeados para a folha de pagamento (por exemplo, horário normal de trabalho)

Etapa 2: Definir Estruturas Salariais

Navegue até Folha de pagamento > Configuração > Estruturas e crie estruturas dentro de cada tipo.

Uma estrutura salarial mensal típica inclui estes grupos de regras:

Regras de ganhos

• Salário Básico -- Retirado do campo salário do contrato de funcionário
• Auxílio Habitação -- Valor fixo ou percentual do básico (varia de acordo com o país)
• Vale Transporte -- Valor fixo mensal para deslocamento
• Horas extras - Calculadas a partir de registros de frequência a uma taxa horária de 1,5x ou 2x
• Bônus/Comissão -- Remuneração variável informada por holerite ou calculada a partir de metas
• Subsídio de Refeição -- Subsídio de alimentação diário ou mensal

Regras de Dedução

• Imposto de Renda -- Calculado com base em tabelas de faixas de impostos da jurisdição relevante
• Segurança Social (Empregado) -- Percentual do salário bruto até o teto
• Seguro de Saúde (Funcionário) - Participação do funcionário no prêmio de cobertura de saúde
• Aposentadoria/Pensão (Empregado) -- Contribuição previdenciária obrigatória ou voluntária
• Reembolso de Empréstimo - Dedução recorrente para adiantamentos de salário ou empréstimos da empresa
• Taxas Sindicais -- Taxas de filiação sindical fixas ou baseadas em porcentagem

Regras de contribuição do empregador

• Segurança Social (Empregador) -- Contribuição patronal equiparada ou adicional
• Seguro de saúde (empregador) - Participação da empresa na cobertura de saúde
• Correspondência de Pensão (Empregador) -- Contribuição para o fundo de aposentadoria do empregador
• Compensação de Trabalhadores -- Prêmio de seguro com base no volume da folha de pagamento

Etapa 3: Configurar regras salariais

Cada regra salarial requer configuração específica:

Propriedades da regra

• Nome -- Etiqueta descritiva mostrada no contracheque (por exemplo, Imposto de Renda Federal)
• Categoria -- Atribui a regra ao grupo Bruto, Dedução, Líquido ou Empregador
• Código -- Identificador exclusivo usado em fórmulas (por exemplo, BRUT, FIT, SSEE)
• Sequência -- Ordem de processamento (os números mais baixos são calculados primeiro)
• Condição -- Critérios opcionais para quando a regra se aplica (por exemplo, somente se o funcionário estiver em um departamento específico)

Métodos de computação

Odoo 19 suporta três abordagens de computação:

Valor Fixo: Melhor para subsídios fixos e deduções fixas. Exemplo: Subsídio de transporte de 200 USD por mês.

Porcentagem: Calcula como uma porcentagem do resultado de outra regra. Exemplo: Segurança Social a 6,2% do salário bruto. Configure o código da regra base e o valor percentual.

Código Python: Para cálculos complexos que exigem lógica condicional, colchetes de impostos ou fórmulas multivariáveis. O ambiente Python fornece acesso a estas variáveis:

• payslip -- Registro do contracheque atual com datas do período e referência do funcionário
• employee -- Registro do funcionário com dados pessoais, departamento e cargo
• contract -- Contrato ativo com salário, vantagens e cronograma
• categories -- Dicionário de totais de categorias computadas (por exemplo, categorias.GROSS)
• rules -- Dicionário de resultados de regras individuais (por exemplo, regras.BASIC)
• worked_days -- Dados de atendimento com horas e dias trabalhados por tipo
• inputs -- Entradas adicionais de contracheque (bônus, reembolsos, reajustes)

Uma regra Python para cálculo progressivo de impostos implementaria uma lógica baseada em colchetes, onde o lucro tributável (salário bruto menos deduções antes de impostos) é processado por meio de colchetes progressivos. Por exemplo, 10% sobre os primeiros 11.600 USD anuais, 12% entre 11.601 e 47.150 USD, 22% entre 47.151 e 100.525 USD e assim por diante, através de colchetes mais altos. O valor mensal é o imposto anual dividido por 12.

Etapa 4: Configuração de funcionário e contrato

Campos da folha de pagamento do funcionário

Para cada funcionário, verifique estes campos relevantes para a folha de pagamento:

• Bank account -- IBAN or account number for salary payment
• Identificação fiscal -- Número de segurança social, identificação fiscal ou identificador nacional
• Dependentes -- Quantidade de dependentes para cálculo de retenção na fonte
• Status de declaração fiscal -- Solteiro, casado, chefe de família (varia de acordo com o país)
• Inscrição em benefícios -- Nível de seguro saúde, eleições de plano de aposentadoria
• Local de trabalho -- Determina a jurisdição fiscal aplicável para vários estados ou vários países

Configuração do Contrato

Cada contrato ativo deve especificar:

| Campo | Finalidade | Exemplo | |-------|---------|-----| | Estrutura Salarial | Quais regras de folha de pagamento se aplicam | Funcionário Mensal dos EUA | | Salário | Taxa base mensal ou horária | 5.000 USD/mês | | Horário de Trabalho | Horas padrão por período | 40 horas/semana | | Vantagens | Benefícios e subsídios | Nível de seguro saúde, subsídio de carro | | Data de início | Data de entrada em vigor do contrato | 15/01/2026 | | Data final | Expiração do contrato (se aplicável) | Deixe em branco por tempo indeterminado |

Etapa 5: Geração e processamento de recibo de pagamento

Recibo de Pagamento Individual

Para recibos de vencimento únicos ou correções:

1. Navegue até Folha de pagamento > Recibos de pagamento > Todos os recibos de pagamento
2. Clique em Criar e selecione o funcionário
3. Defina o período (datas de início e término)
4. Clique em Planilha de cálculo para calcular todas as regras salariais
5. Revise a precisão de cada item de linha
6. Clique em Confirmar para finalizar o contracheque

Processamento em lote

Para execuções mensais da folha de pagamento:

1. Navegue até Folha de pagamento > Recibos de pagamento > Lotes
2. Clique em Criar e defina o período da folha de pagamento
3. Click Generate Payslips to create payslips for all employees with active contracts
4. Revise o resumo do lote em busca de anomalias (quantidades excepcionalmente altas ou baixas)
5. Abra holerites individuais para verificar cálculos de novos funcionários ou com alterações
6. Clique em Confirmar para finalizar todos os contracheques do lote
7. Criar lançamento preliminar para gerar o lançamento contábil

Lista de verificação de recibo de pagamento

Antes de confirmar um lote, verifique:

• [] A contagem de funcionários corresponde ao número de funcionários esperado
• [ ] Novas contratações têm cálculos rateados para meses parciais
• [ ] Funcionários demitidos são excluídos ou têm salário final calculado
• [] Horas extras correspondem aos registros de comparecimento
• [] Os valores de bônus e comissões correspondem aos valores aprovados
• [ ] As taxas de retenção na fonte refletem as tabelas de colchetes atuais
• [] As deduções de benefícios correspondem às eleições de inscrição
• [] Os valores de pagamento líquido passam nas verificações de razoabilidade

Cálculos e Conformidade Fiscal

Apoio fiscal multipaíses

Odoo 19 inclui pacotes de localização de folha de pagamento para mais de 50 países. Cada pacote fornece:

• Escalões fiscais -- Tabelas de imposto de renda atualizadas para o ano fiscal atual
• Regras de seguridade social -- Taxas de contribuição, limites máximos e correspondência do empregador
• Deduções legais -- Deduções obrigatórias específicas do país
• Modelos de relatórios -- Relatórios e arquivamentos de folha de pagamento exigidos pelo governo

Destaques específicos do país

| País | Principais recursos | |--------|-------------| | Estados Unidos | Suportes de impostos federais e estaduais, suporte W-4, deduções 401(k), FICA | | Reino Unido | Códigos fiscais PAYE, Seguro Nacional, reembolso de empréstimos estudantis, inscrição automática de pensões | | Alemanha | Aulas Lohnsteuer, Solidaritaetszuschlag, Kirchensteuer, Sozialversicherung | | Índia | PF, ESI, Imposto Profissional, TDS com deduções da Seção 80, geração do Formulário 16 | | Emirados Árabes Unidos | Conformidade com WPS, cálculos de gratificações, sem imposto de renda | | Arábia Saudita | Contribuições GOSI, benefícios de fim de serviço, conformidade com saudização |

Processamento de fim de ano

Atividades de folha de pagamento de final de ano:

1. Conciliar totais anuais – Verifique se os números acumulados no ano correspondem aos dados cumulativos do recibo de pagamento
2. Gerar documentos fiscais -- W-2 (EUA), P60 (Reino Unido), Lohnsteuerbescheinigung (Alemanha)
3. Enviar declarações anuais - Arquivar os resumos da folha de pagamento exigidos junto às autoridades fiscais
4. Atualizar tabelas fiscais – Carregar novas faixas de ano fiscal e limites de contribuição
5. Rolar saldos - Redefinir acúmulos de férias anuais, atualizar inscrição em benefícios

Horas extras, benefícios e cálculos especiais

Configuração de horas extras

Configure regras de horas extras com base na sua jurisdição e na política da empresa:

• Horas extras padrão -- Horas além de 40/semana a 1,5x a taxa normal
• Horas extras de fim de semana -- Trabalho sábado/domingo com taxa de 1,5x ou 2x
• Horas extras em feriados -- Trabalho em feriados com taxa de 2x ou 2,5x
• Diferencial de turno noturno -- Percentual adicional para horas noturnas

Os cálculos de horas extras são extraídos do módulo Presença, quando ativado, ou de linhas de entrada manual em recibos de pagamento individuais.

Administração de Benefícios

Tipos de benefícios comuns gerenciados por meio da folha de pagamento:

• Seguro de saúde -- Planos escalonados (somente funcionário, funcionário + cônjuge, família) com diferentes divisões de prêmios
• Odonto e oftalmológico -- Cobertura complementar com linhas de dedução separadas
• Seguro de vida -- Cobertura básica paga pelo empregador com suplemento opcional pago pelo funcionário
• Planos de aposentadoria -- 401(k), pensão ou fundo de previdência com fórmulas de correspondência do empregador
• Contas de despesas flexíveis - Deduções antes de impostos para despesas de saúde ou cuidados com dependentes
• Opções de ações -- Cronogramas de aquisição de direitos que afetam a remuneração tributável

Gerenciamento de empréstimos e adiantamentos

Processar adiantamentos de salário e reembolsos de empréstimos:

1. Registre o valor do empréstimo e as condições de reembolso no registro do funcionário
2. Crie uma regra salarial para desconto do empréstimo com o valor mensal acordado
3. A regra vale automaticamente para cada contracheque até o saldo chegar a zero
4. Acompanhe o saldo restante por meio das linhas de entrada do contracheque

Relatórios e análises

Relatórios padrão de folha de pagamento

Odoo 19 inclui estes relatórios de folha de pagamento integrados:

| Relatório | Conteúdo | Frequência | |--------|---------|-----------| | Resumo do recibo de pagamento | Todos os itens de linha do recibo de pagamento por funcionário | Por período de pagamento | | Custo do Departamento | Custo total da folha de pagamento por departamento | Mensalmente | | Cadastro Salarial | Discriminação detalhada de todas as componentes da remuneração | Mensalmente | | Responsabilidade Fiscal | Impostos retidos e contribuições patronais | Mensal / Trimestral | | Acumulado no ano | Rendimentos acumulados e descontos por trabalhador | Sob demanda | | Número de funcionários e custos | Número de funcionários com remuneração média e total | Mensalmente |

Relatórios personalizados com planilhas

A integração da planilha Odoo 19 permite:

• Dados de folha de pagamento ao vivo em planilhas colaborativas
• Análise de tendências dos custos da folha de pagamento ao longo do tempo
• Comparações de custos de departamento e localização
• Análise de orçamento vs. remuneração real
• Previsão de headcount com projeções de custos

Integração com Contabilidade

A integração da folha de pagamento com a contabilidade automaticamente:

• Cria lançamentos contábeis manuais a partir de recibos de pagamento confirmados
• Mapeia regras salariais para as contas contábeis corretas
• Separa as deduções dos funcionários em contas de passivo
• Publica contribuições do empregador em contas de despesas
• Reconcilia os pagamentos bancários da folha de pagamento com os valores líquidos do holerite

Configure o mapeamento de contas em Folha de pagamento > Configuração > Regras salariais atribuindo contas de débito e crédito a cada regra.

Integração com outros módulos de RH

Integração de folga

Quando o módulo Time Off está ativo:

• Os dias de licença sem vencimento reduzem automaticamente o salário bruto proporcionalmente
• A licença remunerada não afeta os cálculos da folha de pagamento
• Licença médica com remuneração parcial calculada no percentual configurado
• O saldo das férias aparece no contracheque para referência do funcionário

Integração de Atendimento

Quando o rastreamento de presença está ativado:

• As horas reais trabalhadas são incluídas nos cálculos de salários por hora
• As horas extras são calculadas automaticamente com base nas regras de horário de trabalho
• Chegadas tardias e partidas antecipadas podem gerar deduções, se configuradas
• Sinalização de anomalias de comparecimento para revisão antes do processamento da folha de pagamento

Integração de despesas

As despesas dos funcionários interagem com a folha de pagamento quando:

• Os reembolsos de despesas são processados através da folha de pagamento e não de contas a pagar
• As ajudas de custo diárias são configuradas como entradas de contracheque
• Os adiantamentos de viagem são deduzidos dos reembolsos de despesas no contracheque

Perguntas frequentes

O Odoo pode lidar com a folha de pagamento de vários países em uma única instância?

Sim. Crie tipos e estruturas salariais separadas para cada país. Os funcionários são alocados na estrutura apropriada por meio de contrato. As regras fiscais, os cálculos da segurança social e as deduções legais são específicos de cada país dentro de cada estrutura. Isto permite que uma empresa multinacional administre a folha de pagamento global a partir de um único banco de dados Odoo.

Como o Odoo lida com contratações e rescisões no meio do mês?

Odoo distribui automaticamente o salário por meses parciais com base na data de início ou término do contrato em relação ao período do contracheque. O rateio utiliza o horário de trabalho para calcular a quantidade exata de dias úteis do período parcial versus o período integral. Os recibos de pagamento finais para funcionários demitidos podem incluir pagamentos de férias acumuladas e cálculos de indenizações.

Os funcionários podem visualizar seus próprios contracheques?

Sim. O portal de autoatendimento para funcionários fornece acesso a recibos de vencimento atuais e históricos em formato PDF. Os funcionários podem visualizar, mas não editar, os dados do seu contracheque. O acesso é controlado por meio do sistema de permissão padrão Odoo, e a visibilidade do contracheque é limitada ao registro individual de cada funcionário.

Como lidar com ajustes salariais retroativos?

Crie um novo contracheque para o período de ajuste com linhas de entrada refletindo a diferença. Como alternativa, adicione linhas de entrada de ajuste ao contracheque atual que contabilizam a alteração retroativa. Para ajustes recorrentes (por exemplo, um aumento em vigor há três meses), calcule a diferença cumulativa e processe-a como uma entrada única.

O Odoo Payroll está em conformidade com o GDPR e os regulamentos de proteção de dados?

Odoo inclui controles de acesso que restringem os dados da folha de pagamento a usuários autorizados. Campos confidenciais (contas bancárias, IDs fiscais) podem ser criptografados no nível do banco de dados. As políticas de retenção de dados permitem o arquivamento automático de registros de folha de pagamento após períodos configuráveis. No entanto, a conformidade depende, em última análise, da configuração da implementação e dos procedimentos organizacionais de tratamento de dados.

Implementação de folha de pagamento profissional

A configuração da folha de pagamento afeta todas as áreas de RH e contabilidade, e os erros criam exposição financeira e jurídica. ECOSIRE fornece serviços de implementação Odoo e consultoria Odoo que incluem configuração de módulo de folha de pagamento, configuração de regras fiscais, design de estrutura de benefícios e integração com seu sistema de contabilidade.

Para organizações que precisam de suporte contínuo ao gerenciamento de folha de pagamento, nossos serviços de treinamento Odoo fornecem instruções práticas para suas equipes de RH e de folha de pagamento.

Entre em contato com nossa equipe para discutir seus requisitos de folha de pagamento Odoo e obter um plano de configuração personalizado para sua organização.