Mi primera nómina¶
Esta guía sigue un mes completo, desde la preparación de la compañía hasta los controles de cierre. Propone Compañía Demo BPS y dos trabajadores ficticios: Ana Demo BPS (administrativa) y Luis Demo BPS (operativo). Hasta ahora solo el alta parcial de Ana fue observada; Luis aún no se ha creado en esta práctica. Los salarios son entradas de ejemplo, no una liquidación verificada ni valores legales vigentes. Antes de usar la guía en una empresa real, contrasta cada concepto con sus soportes y con la planilla pagada.
Ejemplo de aprendizaje
Los datos de Ana y Luis son ilustrativos. Antes de operar con una empresa, completa su configuración y compara cada concepto del recibo y de la planilla con los soportes propios. Una preliquidación, un archivo local o un asiento en borrador no prueban pago ni aceptación externa.

El tablero muestra qué falta antes del primer ciclo: ARL, clase y tarifa, caja y tipo de aportante. Pulsa Completar configuración para volver a la compañía. Así se ve en una pantalla angosta. Los valores visibles son de la base de demostración, no un cálculo de Ana o Luis.
Antes de comenzar¶
Reúne el RUT, la última planilla PILA pagada con su detalle, el certificado de tarifas de la ARL de la compañía, la matrícula mercantil, los datos y soportes de cada trabajador y las decisiones del contador sobre exoneración y cuentas. Define personas distintas para parametrizar, operar, revisar y publicar asientos. No cargues información real en una base de demostración.
| Responsabilidad | Permisos que hay que comprobar |
|---|---|
| Parametrizar compañía y catálogos | Administrador de Nómina BPS; para abrir la compañía, también Administrador de Ajustes. |
| Preparar trabajador y contrato | Empleados / Administrador, permiso para crear contactos bancarios y Nómina de Odoo / Encargado de contratos. |
| Calcular IBC y preliquidar | Administrador de Nómina BPS, Empleados / Administrador y Nómina de Odoo / Encargado de contratos. |
| Revisar | Auditor de Nómina BPS consulta evidencias; Supervisor aprueba solo los registros operativos que su pantalla le permite. |
| Publicar asientos | Contabilidad / Administrador. El rol BPS no concede ese permiso. |
Consulta la matriz de roles y capacidades. Quien parametriza no debe aprobar su propio período; no amplíes permisos solo para evitar cambiar de usuario.
1. Asignar los roles¶
En Ajustes › Usuarios, el administrador de usuarios asigna el rol BPS y los permisos estándar de Odoo que corresponden a cada responsabilidad de la tabla. Guarda y pide a cada persona que compruebe sus menús con su propia sesión. Si falta una opción, revisa primero la compañía activa y los permisos; no uses la cuenta de otra persona.
2. Preparar la compañía¶
En Ajustes › Usuarios y compañías › Compañías, abre Compañía Demo BPS y la pestaña Nómina BPS Colombia. Activa Usa nómina BPS y registra el motivo del cambio. Completa país Colombia, COP, caja de compensación, ARL por defecto, periodicidad, municipio del RUT, lugar de generación y domicilio para el XML. Marca Exoneración art. 114-1 solo si el contador confirma que aplica y existe su soporte vigente.

La imagen muestra el punto de partida: la casilla «Usa nómina BPS» aún está desmarcada y faltan administradoras. No es una compañía lista para liquidar. Vista angosta de la misma pantalla.

Después de guardar, la casilla queda marcada y el motivo aparece en la ficha. Todavía faltan caja, ARL y otros datos; comprueba también la vista angosta.
En Tarifas de la ARL certificadas por compañía, el Administrador de Nómina usa Confirmar tarifa con soporte ARL. Selecciona la ARL y la clase de riesgo. Completa Tarifa certificada (%), Vigente desde, Fecha del soporte ARL, Certificado o comunicación de la ARL y Motivo. En Certificado o comunicación de la ARL escribe la referencia del documento: este formulario no adjunta el archivo. Si el soporte tiene fecha final, completa Vigente hasta. Pulsa Confirmar y revisa que aparezca una fila vigente para cada clase que vas a liquidar.
Si el cálculo de IBC y aportes se detiene por una tarifa ARL, revisa que la fila corresponda a la compañía, ARL y clase del trabajador y que su vigencia cubra la fecha indicada por el mensaje. La tarifa también debe estar dentro del rango vigente para el período. Corrige la configuración con el soporte correspondiente y vuelve a calcular; no uses la tarifa inicial de referencia para salir del paso.
En Datos del aportante para PILA local, usa Agregar una línea y completa clasificación, representante, correspondencia, beneficios, Fuente y Motivo. Consulta los campos, permisos y pasos de recuperación de la compañía.
3. Revisar catálogos y parámetros del año¶
En Nómina BPS › Configuración › Catálogos › Parámetros anuales, revisa SMMLV, auxilio y UVT del año del ejemplo. En Administradoras, comprueba tercero, NIT y código PILA. Revisa Catálogos con vigencia para la fecha que liquidarás. No copies porcentajes de esta guía: utiliza los valores vigentes que muestra el producto y confirma la fuente normativa.
4. Completar contactos de entidades¶
En Contactos › Nuevo, el responsable autorizado registra las entidades que se usan como terceros contables y no tienen ficha de administradora, como ICBF y SENA. Verifica el NIT oficial y su soporte. Después enlázalas en el mapeo correspondiente; un contacto sin NIT correcto puede dejar el asiento con el tercero equivocado.
5. Crear los trabajadores y contratos¶
Selecciona la compañía correcta. En Empleados › Nuevo, crea a Ana y Luis con documentos ficticios. En Personal › Nómina BPS Colombia, completa identificación, nombres para nómina electrónica, EPS, AFP, ARL, cesantías, caja, tipo de cotizante y autorización de datos. Agrega cuenta bancaria y, en Contabilidad de nómina, centro de costo y clase de gasto. En Trabajo, define ubicación. En Nómina, completa fecha real de inicio, salario y horario; usa Tipo y duración del contrato y Contrato Colombia BPS para tipo de salario, clase ARL con tarifa certificada, régimen de cesantías y procedimiento de retención. No sustituyas Tipo de contrato (CO) por el tipo nativo de Odoo.
Para practicar, puedes usar salario básico ilustrativo de $1.750.905 para Ana y $3.500.000 para Luis. No sumes el auxilio al salario básico ni infieras el neto a partir de estas entradas. Guarda y lee el aviso apto / no apto de la ficha. La ruta Nómina BPS › Empleados y contratos › Empleados no aptos debe quedar sin ellos. Cada faltante se corrige en su campo de origen. Alta guiada · resolver no aptos.

Primera comprobación del caso ficticio: Ana se guardó con faltantes. En pantalla angosta el aviso conserva los motivos. Corrige cada uno antes de intentar calcular; el segundo trabajador del ejercicio todavía no se ha creado en el recorrido observado.

La lista vincula cada faltante con la trabajadora y la compañía; vista angosta con panel lateral contraído. No continúes a liquidar mientras permanezcan motivos.

Después de vincular una cuenta bancaria ficticia, la ficha ya muestra Apto para nómina. Vista angosta. La aptitud de la persona no reemplaza la configuración obligatoria de la compañía ni autoriza un pago.
6. Preparar la contabilidad con el contador¶
El contador crea las cuentas necesarias en Contabilidad › Configuración › Plan contable. Si aplica exoneración, registra la condición y el soporte en Nómina BPS › PILA › Condición de exoneración 114-1, además de la casilla de la compañía. En Nómina BPS › Contabilidad › Contable BPS › Mapeo contable, crea mapeos vigentes para salario y causación patronal de ARL, salud, SENA e ICBF, además de los conceptos que la compañía use. Define concepto o clave, clase de gasto, cuentas de débito y crédito, diario, tercero, Vigente desde y fuente. Para cambiar una cuenta, cierra la vigencia anterior y crea otra línea: no reescribas la historia.
El campo Cuenta débito es la cuenta donde cae el valor, incluso cuando la línea representa un pasivo. Puede usarse un diario general existente; Preparar diario Nómina es opcional. Revisa el resultado en Nómina BPS › Contabilidad › Contable BPS › Preflight contable. Un mapeo faltante bloquea la contabilización completa, no solo la línea afectada. Guía de banco y contabilidad.
7. Verificar que la compañía esté lista¶
Comprueba de nuevo Empleados no aptos. La Preparación de PILA por compañía se abre desde Nómina BPS › Implantación › Checklist F1, criterio Mapeo y perfil local PILA; no tiene entrada propia de menú. Comprueba Desde y Hasta —propone el mes actual— y revisa sus ocho tarjetas. Configuración del operador requiere revisión humana y Tipo de cotizante del periodo se contrasta con la planilla del mes; ninguna tarjeta constituye aceptación del operador.
El Checklist F1 es opcional para practicar, recomendado antes de operar en real. Si se activa mediante Nómina BPS › Implantación › Iniciar implantación, bloquea la finalización de recibos hasta cerrar sus criterios. No lo actives como simple prueba de navegación. Cómo prepararlo y recuperarse.


El asistente se abrió para mostrar los campos y luego se canceló. No se pulsó Activar checklist; la lista y el asistente también se revisaron a 480 px.
8. Registrar las novedades del mes¶
En Nómina BPS › Tiempos y novedades › Novedades, registra vacaciones, licencias o novedades del período que correspondan. Para incapacidad, revisa también Incapacidades. Para horas, usa Registro de horas y Valorización de horas, con aprobación del supervisor cuando aplique. Si la empresa utiliza Asistencias, Nómina BPS › Importar horas aprobadas desde Asistencias requiere el permiso de esa app. Contrasta las ausencias registradas en Vacaciones de Odoo y revisa que cada novedad quede en el período correcto. Paso a paso de novedades.


Las imágenes ubican Empleado, Tipo de novedad, Desde, Hasta y Soportes; en móvil los campos quedan uno debajo del otro. Es un formulario vacío: no se confirmó una novedad ni se demostró que afecte un recibo.
9. Calcular y revisar la nómina¶
Elige una de estas dos rutas para calcular el mismo mes:
- Lote: en Nómina BPS › Liquidación y recibos › Ejecutar nómina del período, confirma compañía y Último día del período. Deja Sólo estos trabajadores vacío para los aptos de esa compañía o selecciona los del ejercicio. El lote procesa novedades, IBC, aportes, deducciones, preliquidación, retención y recibos. Revisa Hechos, Ya existían, Omitidos y Bloqueados, así como el resultado por trabajador; no vuelvas a ejecutar todos los asistentes individuales solo porque forman parte de esta guía. Repetir nómina del mes anterior propone otro punto de partida que debes revisar antes de aceptar. Operar un lote.
- Persona por persona: usa Calcular IBC y aportes del período, verifica la fecha —el asistente puede proponer otro mes— y revisa Nómina BPS › PILA › Cálculos de IBC y Aportes salud y pensión. Después usa Nómina BPS › Liquidación y recibos › Preliquidar período y compara los conceptos. Si corresponde Proc. 1, entra a Nómina BPS › Retención › Retención BPS › Calcular depuración (Proc. 1) y luego a Generar aplicación mensual para el mismo período. Repite la secuencia para la otra persona. Cómo calcular IBC · Preliquidar y revisar.

Esta imagen conserva un intento anterior, cuando Ana todavía figuraba No apta, con Calculados 0 y No aptos, omitidos o bloqueados 1. Usa Dónde corregirlo; vista angosta. Después de completar sus datos, Ana ya aparece apta, pero un nuevo intento de Calcular IBC y aportes del período para octubre se detuvo porque aún falta confirmar la tarifa de la ARL de la compañía con su certificado. Regresa al paso 2 y registra la tarifa, clase y vigencia que constan en ese soporte; no inventes una cifra. No se generó IBC, preliquidación ni recibo de este ejemplo.*
En ambas rutas, abre Recibos productivos, comprueba devengos y deducciones de cada persona y descarga el comprobante. Solo después decide el cierre: Finalizar puede cerrar el recibo sin otro aviso o abrir Confirmar cierre de provisiones si ese recibo completa la selección necesaria para cerrar el mes. Finalizar recibos del lote, en cambio, abre la confirmación desde el resultado del lote.
En esa ventana, Calcular y publicar las provisiones de toda la compañía viene marcado. Mantenerlo exige que el mes esté completo y que la cuenta autorizada tenga permiso estándar de administración contable. Si se desmarca por una decisión autorizada, finaliza solo los recibos seleccionados y no calcula ni publica provisiones. Revisa población, pendientes y consecuencias antes de Confirmar; si necesitas revisar algo, pulsa Cancelar. Finalizar es irreversible desde esa acción; una corrección posterior usa Correcciones de nómina y deja trazabilidad, no edita el recibo original. Operar y cerrar un lote · Cómo leer el comprobante.
No confundas los resultados
Un cálculo de IBC, una preliquidación y un subtotal técnico no son el neto pagado. Un recibo productivo tampoco demuestra pago. Compara concepto por concepto, no solo el total.
10. Consolidar PILA al final¶
Cuando estén incluidos todos los trabajadores y corregidos los faltantes, entra a Nómina BPS › PILA › Planillas › Generar › Consolidar planilla del período. La planilla se consolida una sola vez por compañía y mes. Revisa Consultar planillas y Detalle de aportes; después PILA › Planillas › Validar › Revisión del operador. El archivo de Presentar › Archivo de prueba: no se envía al operador › Preparar archivo de prueba es para prueba local: su nombre indica que no equivale a presentación ni pago. Guía PILA.


Antes de pulsar Consolidar, verifica Periodo y Compania: la fecha propuesta en las capturas es octubre, aunque el tablero del fondo muestra noviembre. La ventana se canceló; las imágenes no acreditan planilla generada, presentada ni pagada.
Control externo: PILA
El sistema prepara y valida información local. La aceptación y el pago corresponden al operador PILA. Conserva su constancia externa por separado.
11. Preparar el pago bancario¶
En Nómina BPS › Contabilidad › Pago y banco BPS, ejecuta Preflight de pago (local), crea el lote en Crear lote bancario local y revisa Lotes y archivos bancarios. Verifica destinatarios, cuentas e importes antes de entregar el archivo al canal autorizado.
Control externo: banco
Crear un archivo o una orden local no ejecuta el pago. La aceptación y la dispersión ocurren en el banco, fuera de Nómina BPS.
12. Contabilizar y publicar¶
En Nómina BPS › Contabilidad › Contable BPS › Preflight contable, revisa faltantes y usa Contabilizar recibos solo cuando todos los mapeos estén vigentes. La acción deja asientos en borrador. El contador los revisa y los publica en Contabilidad de Odoo con su permiso contable. No confundas Finalizar el recibo con Contabilizar ni con Publicar el asiento. Publicado, el asiento no se edita; la reversión sigue el procedimiento contable y conserva el original.
13. Cerrar el mes¶
Abre Nómina BPS › Contabilidad › Contable BPS › Generar checklist de cierre y revisa Cierre técnico. Si existe un faltante, vuelve al paso de origen y deja evidencia de la corrección. Reapertura técnica requiere una capacidad separada y no revierte por sí misma un asiento ya publicado.
14. Preparar nómina electrónica, cuando corresponda¶
Revisa Nómina BPS › Configuración › Habilitación DIAN y la sección DSNE. Confirma maestros, certificado y consistencia local del XML antes de cualquier gestión externa. Guía DSNE.
Control externo: DIAN
Generar o validar un XML no significa aceptación de la DIAN. Esta guía no autoriza transmitir documentos ni usar credenciales de firma.
Si algo se bloquea¶
| Ves esto | Qué revisar | Regresa a | |---|---| | Falta la tarifa ARL de la compañía | Certificado, clase, tarifa y vigencia ARL de la compañía. | Paso 2 | | Trabajador en Empleados no aptos | Aviso de faltantes en su ficha y contrato. | Paso 5 | | Falta la naturaleza del salario | Tipo de salario en Contrato Colombia BPS. | Paso 5 | | Falta el soporte de la exoneración | Condición vigente y soporte para la casilla de exoneración. | Paso 6 | | No puedes finalizar porque hay criterios abiertos en el Checklist F1 | Revisa el checklist de la compañía y completa cada criterio con su soporte. | Paso 7 | | «Conceptos activos sin mapeo contable vigente…» | Mapeos de los conceptos usados en el período. | Paso 6 |
Más mensajes y recuperación: Problemas y bloqueos.