Configuración de nómina de recursos humanos de Odoo por país: guía de configuración completa

La nómina es el módulo más específico de cada país en cualquier sistema ERP. Los tramos impositivos, las contribuciones a la seguridad social, los planes de pensiones y los requisitos legales de presentación de informes varían drásticamente entre jurisdicciones. El módulo de nómina de Odoo aborda esto a través de un marco de localización que proporciona reglas salariales, tablas de impuestos y plantillas de informes específicas de cada país. Esta guía explica el proceso de configuración para las principales regiones y las opciones de personalización para países sin localizaciones oficiales.

Conclusiones clave

• Odoo 19 se envía con localizaciones de nómina para más de 40 países que cubren reglas salariales, tablas de impuestos e informes legales.
• El motor de reglas salariales utiliza expresiones de Python para cálculos complejos y al mismo tiempo mantiene un seguimiento de auditoría completo.
• Las organizaciones de varios países pueden ejecutar nóminas para diferentes jurisdicciones desde una única instancia de Odoo.
• Se pueden crear localizaciones personalizadas utilizando el marco de estructura salarial para países que no son compatibles oficialmente.
• La integración con la contabilidad garantiza que los asientos del diario de nómina se publiquen automáticamente con la asignación de cuentas correcta

Descripción general de la arquitectura de nómina

La nómina de Odoo procesa los cálculos salariales a través de un motor basado en reglas. La arquitectura consta de:

Estructuras salariales: Plantillas que definen qué reglas salariales se aplican a una categoría de empleados. Una empresa puede tener estructuras para empleados asalariados mensuales, trabajadores por horas y contratistas.

Reglas salariales: Pasos de cálculo individuales dentro de una estructura. Cada regla tiene una expresión de Python que calcula su valor en función de entradas como el salario base, los días trabajados y los resultados de la regla anterior. Las reglas se ejecutan en secuencia según su número de prioridad.

Categorías de reglas salariales: agrupaciones que organizan reglas para la presentación de informes. Las categorías incluyen salario bruto, deducciones, contribuciones del empleador y salario neto.

Recibo de nómina: el documento de salida para un solo empleado durante un solo período, que contiene todos los valores de las reglas calculadas.

Navegue a Nómina > Configuración > Estructuras salariales para ver y modificar las estructuras salariales disponibles en su instancia de Odoo.

Configuración de Estados Unidos

Configuración de impuestos federales

La nómina de EE. UU. requiere configurar la retención del impuesto federal sobre la renta según el formulario W-4 del empleado:

1. Navegue a Nómina > Configuración > Reglas de Salario y localice la regla del Impuesto Federal sobre la Renta.
2. La regla hace referencia a los tramos impositivos actuales del IRS, que Odoo actualiza anualmente.
3. El contrato de cada empleado almacena su estado civil (soltero, casado que presenta una declaración conjunta, cabeza de familia) y sus asignaciones.
4. El cálculo tiene en cuenta las deducciones antes de impuestos (401k, seguro médico, FSA) antes de calcular la renta imponible.

Configuración de impuestos estatales

Los impuestos estatales sobre la renta requieren reglas adicionales para cada estado donde trabajan los empleados:

FICA y Medicare

La Seguridad Social (6,2% hasta la base salarial) y Medicare (1,45% con un 0,9% adicional por encima de los 200.000 USD) se configuran como reglas de contribución de empleadores y empleados. El límite de la base salarial se actualiza anualmente. Para 2026, configure la base salarial del Seguro Social en Nómina > Configuración > Parámetros.

Beneficios y Deducciones

Deducciones comunes en EE. UU. configuradas como reglas salariales:

• 401(k): Deducción antes de impuestos con igualación del empleador (porcentaje y límite configurables)
• Seguro médico: parte de la prima del empleado (antes de impuestos según la Sección 125)
• HSA/FSA: contribuciones antes de impuestos a ahorros para la salud o cuentas de gastos flexibles
• Roth 401(k): Deducción después de impuestos (reduce el salario neto pero no la renta imponible)
• Embargos: Deducciones ordenadas por el tribunal con reglas de prioridad

Países de la Unión Europea

Alemania

La nómina alemana se encuentra entre las más complejas debido al impuesto eclesiástico, el recargo de solidaridad y la interacción entre las cotizaciones a la seguridad social:

Las clases de impuestos (Steuerklasse I a VI) determinan la retención del impuesto sobre la renta. Configure la clase de impuestos de cada empleado en su contrato en Nómina > Empleados > Contratos.

Las contribuciones a la seguridad social en Alemania se dividen equitativamente entre el empleador y el empleado:

Impuesto eclesiástico: 8 % o 9 % del impuesto sobre la renta según el estado federal (Bundesland).

Francia

La nómina francesa utiliza la DSN (Declaración Social Nominativa) para la presentación de informes electrónicos a las agencias de seguridad social. Áreas de configuración clave:

• Cotisations sociales: más de 30 líneas individuales de cotización social que cubren salud, jubilación, desempleo y pensión complementaria.
• CSG/CRDS: Impuestos de contribución social calculados sobre el 98,25% del salario bruto
• Mutuelle: Seguro médico complementario obligatorio (el empleador paga mínimo el 50%)
• Previancia: Cotizaciones al seguro de fallecimiento e invalidez
• Reduction Fillon: Reducción de la seguridad social del empleador para salarios cercanos al salario mínimo

Reino Unido

La nómina del Reino Unido sigue el sistema PAYE (Pay As You Earn):

• Códigos impositivos: códigos asignados por HMRC que determinan la asignación libre de impuestos (por ejemplo, 1257L para la asignación personal estándar)
• Seguro Nacional: Contribuciones de NI de los empleados al 8% (por encima del umbral primario) y NI del empleador al 13,8% (por encima del umbral secundario)
• Deducciones por préstamos estudiantiles: Plan 1, Plan 2, Plan 4 o tarifas de posgrado
• Inscripción automática de pensión: Pensión en el lugar de trabajo como mínimo 5% empleado + 3% empleador
• Informes RTI: envíos de información en tiempo real a HMRC después de cada ejecución de pago

Medio Oriente y África

Emiratos Árabes Unidos

La nómina de los EAU es más sencilla debido a que no hay impuesto sobre la renta, pero requiere atención a:

• Cálculo de gratificación: gratificación por fin de servicio basada en los años de servicio (21 días/año durante los primeros 5 años, 30 días/año a partir de entonces)
• Cumplimiento de WPS: Transferencias electrónicas de salario del Sistema de Protección Salarial a través de bancos aprobados
• DEWS: Plan de ahorro en el lugar de trabajo para empleados de Difc para empresas con sede en DIFC
• Asignación de vivienda: normalmente entre el 30% y el 40% del salario básico, configurado como regla salarial

Arabia Saudita

• GOSI: Organización General de Contribuciones a la Seguridad Social (empleador 12%, empleado 10% para ciudadanos saudíes; empleador 2% para expatriados)
• Sin impuesto sobre la renta: Para personas físicas (el impuesto corporativo se aplica a entidades extranjeras)
• Saudización: Seguimiento de porcentajes de nacionalidad para el cumplimiento del programa Nitaqat

Sudáfrica

• PAYE: tramos impositivos progresivos administrados por el SARS
• UIF: Fondo del Seguro de Desempleo (1% empleado + 1% empleador, tope)
• SDL: Tasa de desarrollo de habilidades (1% de la nómina total)
• Créditos fiscales médicos: Créditos mensuales fijos por dependiente

Asia-Pacífico

India

La nómina india involucra múltiples componentes:

TDS (Impuesto deducido en la fuente): el empleador calcula y deduce el impuesto sobre la renta mensualmente en función de las inversiones declaradas y el régimen fiscal aplicable (antiguo o nuevo).

Australia

• Retención de PAYG: impuesto sobre la renta de pago por uso utilizando las tablas de impuestos ATO
• Superannuation: contribución de jubilación obligatoria del empleador (11,5% para 2026)
• HECS-HELP: reembolsos de préstamos de educación superior por encima del umbral de ingresos
• Medicare Levy: 2% de la renta imponible (con recargo para personas con mayores ingresos sin seguro médico privado)
• Informes STP: Nómina de un solo toque a ATO con cada evento de pago

Creación de localizaciones personalizadas

Para países sin localizaciones oficiales de Odoo, puede crear estructuras salariales personalizadas:

Paso 1: Definir la estructura salarial

Cree una nueva estructura salarial en Nómina > Configuración > Estructuras salariales con reglas que cubran:

• Cálculo del salario bruto
• Reglas de retención de impuestos (consulte los tramos impositivos del país)
• Contribuciones a la seguridad social (partes del empleado y del empleador)
• Deducciones legales (pensión, seguros, etc.)
• Cálculo del salario neto

Paso 2: Crear reglas salariales

Cada regla salarial requiere:

• Nombre y código: Nombre descriptivo y código de referencia único
• Categoría: Bruto, deducción, contribución del empleador o neto
• Secuencia: Orden de ejecución (los números más bajos se ejecutan primero)
• Expresión de Python: La lógica de cálculo

Regla de ejemplo para un cálculo de impuesto progresivo:

La condición de Python verifica que el total de la categoría para el salario bruto sea mayor que cero. La expresión de cálculo hace referencia a los umbrales y tasas de los tramos impositivos para el país específico, aplicando tipos marginales a cada tramo. El objeto payslip proporciona acceso a todos los resultados de reglas anteriores y a los datos del contrato de los empleados.

Paso 3: Configurar informes reglamentarios

Cree plantillas de informes utilizando el motor de informes QWeb de Odoo para informes específicos de cada país, como certificados de impuestos, declaraciones de seguridad social y resúmenes de fin de año.

Operaciones de nómina en varios países

Las organizaciones que operan en varios países pueden ejecutar toda la nómina desde una única instancia de Odoo:

1. Crear estructuras salariales para cada país
2. Asignar estructuras a los contratos de los empleados según su lugar de trabajo.
3. Configurar la contabilidad con asientos de diario separados por país para una publicación adecuada del libro mayor.
4. Establezca períodos de pago por país (mensual es estándar en la mayoría de los países; quincenal en EE. UU.)
5. Genere informes específicos de cada país utilizando plantillas de informes localizadas

La función multiempresa en Odoo admite entidades legales separadas por país mientras mantiene informes consolidados a nivel de grupo.

Integración de nómina con contabilidad

Cada lote de recibos de nómina genera asientos de diario que se contabilizan en el libro mayor. La asignación de cuentas se configura por regla salarial:

• Cuentas de gastos salariales: Entradas de débito por salario bruto, contribuciones patronales
• Cuentas de pasivo: Entradas de crédito por retención de impuestos, seguridad social por pagar
• Cuenta bancaria: Entrada de crédito por pago de salario neto

Navegue a Nómina > Configuración > Reglas salariales y edite cada regla para configurar las cuentas de débito y crédito. El asiento de diario se crea cuando se valida el lote de recibos de nómina y se puede revisar antes de publicarlo.

Servicios de nómina ECOSIRE

Configurar correctamente la nómina requiere un conocimiento profundo tanto de la arquitectura técnica de Odoo como de la legislación laboral local. Los servicios de implementación de Odoo de ECOSIRE incluyen especialistas en nómina que configuran localizaciones específicas de cada país, crean reglas salariales personalizadas y validan cálculos con registros de nómina manuales. Nuestros servicios de soporte incluyen actualizaciones anuales para cambios en los tramos impositivos y modificaciones regulatorias.

Lectura relacionada

• Guía del módulo de nómina de Odoo
• Planificación de Compensación y Beneficios en Odoo
• Gestión de permisos y tiempo libre de Odoo
• Guía del módulo de contratación de Odoo
• Guía de configuración de Odoo para varias empresas

¿Con qué frecuencia se actualizan las localizaciones de nómina de Odoo para cambios impositivos?

Las localizaciones oficiales de Odoo se actualizan al menos una vez al año para reflejar nuevos tramos impositivos, límites máximos de seguridad social y cambios regulatorios. Para los clientes empresariales, estas actualizaciones están incluidas en la suscripción de mantenimiento y normalmente llegan antes de que comience el nuevo año fiscal. Las localizaciones personalizadas deben actualizarse manualmente.

¿Puede Odoo manejar la nómina de empleados asalariados y por horas?

Sí. Cree estructuras salariales separadas para empleados asalariados y por horas. Las estructuras horarias hacen referencia al módulo de asistencia o a las entradas de la hoja de horas trabajadas para calcular las horas trabajadas y luego aplican tarifas por hora con multiplicadores de horas extra según los requisitos de la legislación laboral local.

¿Está la nómina de Odoo certificada para el cumplimiento normativo en todos los países admitidos?

La certificación varía según el país. Algunas localizaciones (Francia, Bélgica, Sudáfrica) han sido certificadas o validadas por las autoridades locales. Otros se basan en las normas y tasas impositivas publicadas, pero es posible que no cuenten con una certificación formal. Siempre verifique los cálculos de nómina con fuentes independientes durante la configuración inicial.