Gestionar la nómina y planilla en Panamá suele ser uno de los dolores operativos y contables más críticos para las pequeñas y medianas empresas (PYMES). Errores en la retención del Seguro Social (CSS), cálculos incorrectos del Seguro Educativo o descuadres en la partida doble del gasto laboral terminan costando multas ante el MITRADEL y dolores de cabeza en el cierre fiscal.
En este artículo técnico y práctico, te mostraremos cómo implementar un flujo completo de Planilla en Odoo Panamá utilizando Odoo 18 Community y los módulos libres de la OCA (Odoo Community Association), logrando una automatización 100% nativa con Odoo Contabilidad sin incurrir en licencias costosas de Odoo Enterprise.
Sustento Legal: Código de Trabajo de Panamá (MITRADEL)
Toda empresa que opera en la República de Panamá debe regirse por la legislación laboral vigente:
- Artículo 148: El plazo de pago del salario pactado entre empleador y trabajador no puede exceder de una quincena.
- Artículo 152: Exige consignar por separado en los registros de salarios o planillas lo correspondiente al trabajo ordinario, extraordinario, comisiones y deducciones, entregando un comprobante o talonario formal al colaborador.
- Artículo 161: Regula taxativamente los descuentos de ley permitidos: Seguro Social Obrero (9.75%), Seguro Educativo (1.25%) e Impuesto sobre la Renta (DGI), fijando un tope de retención máxima que nunca puede sobrepasar el 50% del salario en dinero.
Fase 1: Módulos Requeridos y Localización Contable
Para habilitar el motor de planilla en Odoo Panamá bajo la suite de OCA Odoo Apps, se requieren dos módulos base instalados desde el menú de Aplicaciones:
payroll(Nómina): Gestiona empleados, contratos, reglas de cálculo y lotes quincenales. Instala por dependenciahr(Odoo Empleados) yhr_contract(Odoo Contratos de Empleados).payroll_account(Nómina Contable): Módulo OCA que enlaza cada regla salarial con las cuentas del plan contable panameño para generar los asientos contables automáticos en partida doble.
Plan de Cuentas Panameño y Diario de Nómina
No requieres inventar cuentas contables complejas. Odoo incluye de fábrica en su localización las familias 51 (Gastos) y 24 (Pasivos Corrientes). Se crea un diario contable tipo Misceláneo llamado Nómina con código NOM y cuenta por defecto 2410000 Salarios por Pagar:
Fase 2: Reglas Salariales con Lógica Quincenal
El núcleo del cálculo en Odoo radica en las Reglas Salariales (Nómina > Configuración > Reglas salariales). En Panamá, donde el contrato establece el salario mensual pactado pero la nómina se liquida por quincena, las fórmulas se parametrizan de la siguiente manera:
BASIC) - Secuencia 10Cálculo: result = contract.wage / 2
Cuenta Deudora (Gasto Débito): 5140000 Gastos en Salarios
Cuenta Acreedora: Vacío
SS) - Secuencia 100Cálculo: result = (contract.wage / 2) * 0.0975
Cuenta Deudora: Vacío
Cuenta Acreedora (Pasivo Crédito): 2420000 Salarios por Pagar / Cargas Sociales
SE) - Secuencia 105Cálculo: result = (contract.wage / 2) * 0.0125
Cuenta Deudora: Vacío
Cuenta Acreedora (Pasivo Crédito): 2420000 Salarios por Pagar / Cargas Sociales
NET) - Secuencia 200Cálculo: result = categories.BASIC - categories.DEC
Cuenta Deudora: Vacío
Cuenta Acreedora (Pasivo Crédito): 2410000 Salarios por Pagar / Sueldos a Pagar
Regla de Oro Contable en Odoo OCA (payroll_account)
En las reglas de deducción (SS y SE), el importe debe calcularse con signo positivo. El motor de payroll_account reconoce por su cuenta acreedora que se trata de un Pasivo en el Crédito. Si se colocase un signo negativo, el motor invertiría la naturaleza contable enviando el valor al Débito y provocando una línea forzada de "Asiento de ajuste" para cuadrar el asiento.
Fase 3: Liquidación Quincenal en Vivo (Caso de Estudio)
Para validar el funcionamiento en un escenario real de una PYME en Panamá, tomamos el caso del colaborador Carlos Gómez con un salario mensual de $1,000.00 B/.:
Al procesar la 1ra Quincena de Enero de 2026 en un lote de nómina quincenal, el sistema ejecuta el cálculo exacto de forma instantánea:
- Salario Básico Quincenal (50% de $1,000.00): $500.00 B/.
- Retención Seguro Social (CSS 9.75%): -$48.75 B/.
- Retención Seguro Educativo (SE 1.25%): -$6.25 B/.
- Salario Neto a Recibir: $445.00 B/.
Fase 4: Reportería Legal MITRADEL y Asiento Contable Automático
Al hacer clic en Confirmar, Odoo dispara en paralelo dos procesos fundamentales:
1. Emisión del Talonario de Pago Oficial (Artículo 152)
Genera en PDF el recibo formal de pago con el desglose de devengos, deducciones y espacio para la firma autorizada del colaborador y de la empresa:
2. Asiento Contable Automático en Partida Doble
En el diario Nómina de Odoo Contabilidad, se asienta de manera transparente la partida doble sin diferencias ni centavos de ajuste:
| Cuenta Contable | Descripción | Etiqueta | Débito (B/.) | Crédito (B/.) | Impacto en Estados Financieros |
|---|---|---|---|---|---|
| 5140000 | Gastos en Salarios | Salario Básico | 500.00 | 0.00 | Gasto Costo laboral de la empresa |
| 2420000 | Cargas Sociales a Pagar | Seguro Social (CSS 9.75%) | 0.00 | 48.75 | Pasivo Retención a pagar a la CSS |
| 2420000 | Cargas Sociales a Pagar | Seguro Educativo (SE 1.25%) | 0.00 | 6.25 | Pasivo Retención Seguro Educativo |
| 2410000 | Sueldos a Pagar | Salario Neto | 0.00 | 445.00 | Pasivo Transferencia bancaria a Carlos |
| TOTALES | 500.00 B/. | 500.00 B/. | Cuadratura Perfecta | ||
¿Listo para modernizar la planilla de tu empresa en Panamá?
En MBA Consultings somos especialistas en implementación de Odoo en Panamá y consultoría Odoo para PYMES. Te ayudamos a integrar tu nómina quincenal, facturación electrónica DGI y contabilidad bajo un mismo sistema ERP escalable.
Agenda una Asesoría con MBA Consultings