Referencia ampliada: empleados y contratos¶
Para seguir el recorrido detallado: abre Preparar un trabajador, paso a paso. Incluye los campos del caso Ana/Luis, comprobaciones y quién debe intervenir. Esa página todavía no contiene capturas de pantalla; esta conserva la referencia funcional y sus límites.
Para las tareas concretas, consulte registrar la ficha del trabajador, crear su versión contractual y resolver un resultado de Empleados no aptos. Esta referencia ampliada conserva la explicación de campos y reglas; no reemplaza esas tareas ni las capturas operativas pendientes.
La preparación inicial corresponde a Recursos Humanos y al administrador autorizado, según los permisos reales de cada cuenta. El operador mensual no debe recibir permisos adicionales para evitar cambiar de sesión. Ver también Mi primera nómina.
Preparación vigente por responsabilidades¶
Use únicamente la sesión de RR. HH. autorizada para crear y mantener los datos laborales. No amplíe el rol del operador si una opción no está disponible.
| Responsable | Trabajo que debe completar | Comprobación antes de entregar al operador |
|---|---|---|
| Administrador de Nómina autorizado | Compañía, catálogos vigentes y decisión sobre Exigir alta completa del contrato | Fuente, vigencia y compañía; no activar un régimen para sortear un faltante |
| RR. HH. autorizado | Identidad, administradoras, lugar de trabajo y versión contractual: fecha, tipo, salario, calendario, riesgo y régimen del período | Datos del trabajador y contrato completos; acceso protegido según los grupos reales de Odoo |
| RR. HH. autorizado — transición pensional 2027 | Semanas cotizadas a la fecha de corte legal indicada en el catálogo y certificado del fondo de pensiones | Soporte adjunto obligatorio, acceso restringido y trazabilidad; no consulta automática al fondo |
| Responsable con acceso a Contactos | Cuenta bancaria y titularidad, cuando su permiso lo permita | Cuenta del trabajador y compañía correctas; no usar una cuenta ajena para obtener aptitud |
| Operador de nómina | Recibir la preparación, revisar aptitud y operar el mes | Versión vigente del período, no solo la actual; faltantes resueltos en el origen |
| Revisor autorizado | Contrastar datos y trazas sin cambiar el historial | No asumir que Auditor BPS dispone de todos los datos privados de RR. HH. |
Completar y revisar la versión contractual¶
- RR. HH. busca primero el trabajador para evitar duplicados. Entra por Nómina BPS → Empleados o por el formulario estándar de Empleados, según su acceso; conserva la denegación si falta la capacidad, sin ampliar permisos.
- Comprueba compañía, identidad y datos de aptitud. En la versión del período registra tipo laboral, inicio, salario, calendario con horas positivas y lugar de trabajo. Guarda con soporte; una nueva versión posterior no debe reemplazar silenciosamente la del mes que se documenta.
- Si la compañía exige alta completa, el producto valida esos mínimos al declarar el contrato laboral, también al cambiar después el tipo de empleado. No desactives el ajuste para guardar un contrato incompleto.
- Revisa modalidad salarial y régimen. El mínimo proporcional usa SMMLV y jornada establecidos para el período. Salario integral y aprendizaje tienen condiciones propias: no se recupera un bloqueo cambiando la modalidad. Si faltan parámetros para un período actual o futuro, solicita al administrador los valores vigentes y su soporte; que un período histórico quede fuera del horizonte de validación no significa aprobación del salario.
- Para DSNE, comprueba las clasificaciones DIAN y su correspondencia documentada. Tipo/subtipo PILA, tipo de trabajador DIAN y tipo contractual colombiano no son intercambiables. Un código sin equivalencia permanece pendiente; no escoger uno “parecido”.
- Si corresponde, RR. HH. revisa el Centro de costo de la versión. El mapeo contable explícito por concepto tiene precedencia en el asiento. Consulta el límite de retiro posterior del centro en Banco y contabilidad.
- El operador vuelve a comprobar la aptitud para el período. Si aparece un faltante contractual o privado, devuelve la preparación a RR. HH.; no lo corrige usando la sesión de otra persona.
Semanas cotizadas para transición pensional¶
Desde el 01-04-2027, no se debe liquidar pensión/FSP de un trabajador sin conocer sus semanas cotizadas acreditadas. La Ley 2381 mantiene bajo Ley 100 a quienes alcanzan el umbral de transición del art. 75 —750 semanas para mujeres y 900 para hombres—; sin ese dato, el sistema no puede saber qué régimen aplicar.
Qué debe hacer RR. HH. para registrar las semanas:
- Solicitar el certificado de semanas del fondo de pensiones.
- Registrar manualmente las semanas certificadas a la fecha de corte legal indicada en el catálogo. La fecha 2025-06-30 aparece como provisional.
- Adjuntar el certificado como soporte obligatorio.
- Revisar el contenido del certificado antes de cargarlo; el sistema solo verifica que exista soporte y conserva traza.
Qué verifica el sistema:
- Que el dato tenga soporte adjunto; sin soporte, la carga no se acepta.
- Quién lo cargó, cuándo lo hizo y qué soporte quedó asociado.
- Que el certificado tenga acceso restringido, por tratarse de información personal.
- Que el corte y la cifra queden registrados junto con el soporte y la traza de carga. El producto no acumula semanas reportadas en PILA para modificar este certificado.
Qué no verifica:
- No consulta automáticamente al fondo.
- No certifica que el contenido del documento sea correcto; esa revisión es responsabilidad de RR. HH.
- La organización debe definir cómo recopilar y cargar inicialmente los certificados del personal que ya está contratado.
Certificado laboral y clasificación contable¶
El certificado laboral local toma empleador, fechas, cargo, modalidad y salario de la fuente protegida. Un dato ausente o salario no positivo bloquea; conserva la lista de faltantes y pide su corrección a RR. HH. No se verificó la acción de impresión ni se generó un certificado en esta entrega. No confundirlo con el comprobante de pago ni con F220.
La ficha también permite consultar categoría, fuente y estado NIC19 de cesantías. La configuración se revisa en Conceptos → Categorías NIC19 / Cesantías — clasificación NIC19: régimen, categoría, vigencias y fuente. Administrador configura; operador/auditor consultan según acceso. Es clasificación contable, no medición actuarial ni una decisión automática sobre prestaciones.
Evidencia operativa todavía necesaria: pantalla de entrada, datos totalmente ficticios, guardado, revisión de aptitud, faltante y recuperación; además, impresión del certificado si el procedimiento la requiere. Las capturas deben corresponder a la versión autorizada y a la sesión de RR. HH.
Referencia visual histórica del formulario¶
Qué vas a lograr¶
Dar de alta a una persona con los datos colombianos que la nómina BPS exige, y saber de antemano si quedará apta para liquidar.
Para qué sirve¶
Un empleado sin los datos colombianos completos aparece en las listas pero no liquida. Esta guía evita descubrirlo al final del mes.
Qué no hace¶
Crear el registro no certifica la validez jurídica del contrato, no reemplaza la custodia documental ni la autorización de RR. HH.
Antes de empezar¶
| Necesita | Formato o criterio | Por qué |
|---|---|---|
| Acceso autorizado de RR. HH. a Empleados | Ver Roles y seguridad | La responsabilidad de preparación no concede permisos automáticamente; solicita el acceso correcto sin usar la sesión del operador. |
| Compañía colombiana activa | La del empleador real | Evita cruces de datos entre clientes. |
| Administradoras dadas de alta | EPS, ARL, AFP, cesantías y caja de compensación | Son campos del empleado; si no existen, no puedes completarlo. |
| Autorización de tratamiento de datos | Confirmación y origen requeridos; el soporte adjunto es opcional en el producto | Registra que la organización cuenta con la autorización. Aplica la política de privacidad de la empresa. |
| Certificado de semanas cotizadas | Soporte del fondo de pensiones, acceso restringido | Desde 01-04-2027 permite clasificar por trabajador el régimen aplicable. RR. HH. revisa el contenido del certificado. |
| Tipo de documento | Catálogo colombiano | El código asociado se muestra en solo lectura; revisa el documento de la persona antes de guardar. |
Ruta exacta¶
Ruta histórica; entrada actual distinta
El alta se hace en la aplicación estándar de Empleados:
Lanzador → Empleados → Empleados → Nuevo
Nómina BPS amplía esa ficha. Los datos de identificación, administradoras y autorización de tratamiento están en Personal; el resumen pensional y los soportes de semanas aparecen en grupos separados. Los atributos del contrato están en la sección de información contractual y requieren acceso de RR. HH. con permisos de gestión de empleados.
Dónde están realmente los campos colombianos¶
Dónde están los datos colombianos
En la ficha estándar de Empleados, la identificación colombiana aparece junto a los datos de ciudadanía. El grupo Nómina BPS Colombia reúne nombres estructurados, administradoras, autorización de tratamiento y resultados de aptitud. Los datos de semanas pensionales se muestran en un grupo separado y restringido a RR. HH.; el resumen del régimen tiene acceso de consulta más amplio según el rol.
Un atajo que existe, pero que no es la ruta
Como la lista Empleados no aptos se apoya en el modelo de empleado, pulsar Nuevo allí también abre una ficha en blanco. Funciona, pero el registro recién creado no pertenece a esa lista, así que desaparece de la vista al guardar. Es menos confuso entrar por Empleados.
Datos a ingresar¶
Los campos que Nómina BPS añade al formulario estándar del empleado.
Grupo «Nómina BPS Colombia»¶
| Campo | Obligatoriedad | Ejemplo sintético | Efecto |
|---|---|---|---|
| Tipo de documento | Requerido para aptitud | Cédula de ciudadanía |
Determina el código DIAN, que se muestra en solo lectura. |
| Primer nombre / Segundo nombre | Primer nombre requerido | Ana / María |
Alimentan el nombre estructurado. |
| Primer apellido / Segundo apellido | Primer apellido requerido | Rojas / Peña |
Alimentan el nombre estructurado. |
| Nombre DSNE | Calculado, solo lectura | — | Nombre normalizado para nómina electrónica. |
| EPS | Requerida para aptitud, y activa | Administradora de salud | Base de aportes de salud. |
| AFP | Requerida para aptitud, y activa | Fondo de pensiones | Base de aportes de pensión. |
| Cesantías | Requerido para aptitud, y activo | Fondo de cesantías | Destino de la prestación. |
| Caja de compensación | Requerida para aptitud, y activa | CCF | Base de parafiscales. |
| ARL | No cuenta para la aptitud del empleado | Administradora de riesgos | La Clase de riesgo ARL se registra en la versión de contrato, no aquí. |
| Autorización de tratamiento | Requerida | Marcada | Habilita el tratamiento de datos personales. |
| Origen de la autorización | Requerido si la anterior está marcada | Documento firmado | Trazabilidad del consentimiento. |
| Soporte de la autorización | Opcional en el producto | Archivo según la política de la empresa | Si se adjunta, debe ser pertinente y conservarse con acceso restringido. El campo no reemplaza la autorización ni su origen. |
| Declarante y fecha | Calculados, solo lectura | — | Quedan registrados automáticamente. |
Campos de resultado (solo lectura)¶
Son dos aptitudes distintas, y confundirlas hace perder tiempo.
| Campo en pantalla | Qué te dice |
|---|---|
| Apto para nómina BPS | Indica si los datos del trabajador y su versión contractual actual completan la configuración básica. No sustituye la evaluación para el período que vas a liquidar. |
| Faltantes nómina BPS | Muestra los datos de configuración pendientes para la ficha y versión actuales. Úsalo para corregir el origen. |
| Apto para nómina | Resultado consolidado de elegibilidad. Para liquidar, el sistema revisa la versión contractual vigente en el período; un trabajador no apto no se liquida. |
| Motivos de no aptitud | Explica los faltantes del resultado consolidado que deben corregirse. El contenido puede variar según la fecha y la compañía evaluadas. |
Condiciones de aptitud¶
La comprobación revisa los faltantes necesarios para el período seleccionado y los presenta juntos para que RR. HH. pueda corregirlos.
De la ficha del empleado (11): tipo de documento Colombia · número de documento · primer nombre · primer apellido · lugar de trabajo · EPS activa · AFP activa · fondo de cesantías activo · CCF activa · cuenta bancaria de pago · autorización de tratamiento de datos. El soporte de esa autorización es opcional para el producto; el origen sí se exige cuando se marca la autorización.
De la versión contractual del período: contrato o versión vigente con fecha de inicio · naturaleza del salario definida como fijo, variable o integral por pacto · clase de riesgo ARL. Si la compañía exige dimensiones contables tomadas del trabajador, también deben estar completos Centro de costo y Clase de gasto; si la compañía obtiene esas dimensiones del mapeo contable, no se exigen en la ficha.
Tres faltantes que sorprenden
Lugar de trabajo y cuenta bancaria de pago no están en el grupo colombiano, sino en la ficha estándar del empleado, y aun así bloquean. Y una administradora inactiva cuenta como faltante: el motivo aparecerá como «EPS activa», no como «EPS».
La aptitud se evalúa para el período que se procesa
Al liquidar, el sistema toma la versión de contrato vigente en ese período, no solo la versión actual. Por eso un empleado puede estar apto hoy y no estarlo para un período anterior.
Tipo y subtipo de cotizante: informativo, no bloquea
Puede aparecer un pendiente sobre el tipo o subtipo de cotizante para PILA. Si no bloquea la liquidación, revisa ese dato antes de preparar la planilla y consulta con la persona administradora si no tienes claro qué opción corresponde.
Grupos de la versión contractual¶
Estos campos están en la sección de información contractual de la ficha y corresponden a la versión vigente en cada período. La gestión requiere acceso autorizado de RR. HH.; no concedas esos permisos al operador por conveniencia.
| Grupo | Campos principales |
|---|---|
| Contrato Colombia BPS | Naturaleza del salario (Fijo, Variable o Integral por pacto), soporte cuando corresponde, alto riesgo de pensión, clase de riesgo ARL, régimen de cesantías y procedimiento de retención. El sistema calcula el mínimo de salario integral y muestra una alerta si el régimen de cesantías requiere tratamiento especial. |
| Tipo y duración del contrato | Tipo de contrato, tipo efectivo (calculado), modalidad salarial, régimen del empleador, referencia de obra, labor distinta al giro, soportes escritos y aviso. Para aprendices: modalidad, fase, año dual cuando aplique, fecha de fase, apoyo mínimo calculado, jornada/funciones y alerta con decisión motivada. |
| Modalidad de trabajo | Modalidad, subtipo de teletrabajo, lugares de prestación, soportes. |
| Instrumentos colectivos | Instrumentos aplicables, alerta, exclusión y su motivo. |
Cómo completar Naturaleza del salario: si el contrato pacta salario integral, activa Salario integral; la naturaleza pasa a Integral y el sistema verifica el mínimo legal del año configurado. Si no es integral, elige Fijo o Variable según el contrato. No dejes el campo vacío: el sistema no presume que el salario sea fijo. Para variable, registra el soporte que pida la pantalla. Si el valor integral o sus parámetros no están disponibles, detente y solicita revisión al administrador; no escribas un valor para superar el bloqueo.
Pasos¶
- Abre Empleados → Empleados y busca primero: evita duplicar a una persona.
- Pulsa Nuevo y completa los datos laborales estándar (nombre, cargo, departamento, compañía).
- Comprueba que la ficha estándar tenga lugar de trabajo y cuenta bancaria de pago: bloquean, y es fácil pasarlos por alto.
- Baja al grupo Nómina BPS Colombia y completa documento, número de documento, nombres y las cuatro administradoras que cuentan para la aptitud (EPS, AFP, cesantías y CCF).
- Registra la autorización de tratamiento y selecciona su Origen de autorización. El soporte adjunto es opcional para el sistema; sigue la política documental de la empresa y restringe su acceso.
- Completa los grupos de contrato que apliquen, incluida la clase de riesgo ARL.
- Guarda y revisa «Apto para nómina»; si no está apto, lee «Motivos de no aptitud».
Resultado esperado¶
El empleado queda guardado con Apto para nómina = verdadero y Motivos de no aptitud vacío. Si no es así, el propio formulario te dice qué falta.
Cómo comprobarlo independientemente¶
Abre Nómina BPS → Empleados y contratos → Empleados no aptos. Es una lista filtrada por Apto para nómina = falso, con la columna Motivos de no aptitud. Tu empleado no debe aparecer ahí.
También puedes usar los filtros Aptos para nómina BPS / No aptos para nómina BPS en la búsqueda de la lista de empleados.
Evidencia que debe conservarse¶
Al marcar la autorización, el sistema registra quién la declaró y cuándo. El soporte de autorización es opcional para el sistema; si la empresa lo exige y se adjunta, debe quedar en el campo dispuesto para ello, no en un chat ni en texto libre. Los soportes escritos del contrato quedan en sus campos de adjuntos.
Errores y recuperación¶
| Lo que ves | Causa probable | Qué revisar | Cómo recuperarte | Escalar a |
|---|---|---|---|---|
| El grupo «Nómina BPS Colombia» no aparece | Falta acceso autorizado a Empleados | Tu cuenta y compañía activa | Solicita el permiso de RR. HH. correspondiente; no uses la sesión del operador | Administrador autorizado |
| No aparecen los grupos de contrato | Falta gestión autorizada de la ficha laboral | Acceso a Empleados y responsabilidades asignadas | Solicita acceso de RR. HH. con gestión de empleados; no amplíes el rol mensual | Administrador autorizado |
| «Apto para nómina» sigue en falso | Falta un dato obligatorio para esa persona o período | Faltantes nómina BPS y Motivos de no aptitud | Completa exactamente lo que enumeran en la ficha de origen; no adivines ni marques aptitud a mano | RR. HH. / administrador autorizado |
| No encuentras la EPS/ARL/AFP | La administradora no está creada | Nómina BPS → Configuración → Catálogos | Pide el alta de la administradora | Administrador de Nómina |
| El empleado no aparece en la lista | Compañía activa distinta | Selector de compañía | Cambia a la compañía del empleado | Administrador de Nómina |
| Aparece una alerta de desnaturalización (aprendiz) | Jornada o funciones propias de un trabajador | Los campos de aprendiz | Registra una decisión motivada; es una decisión humana, no automática | Jurídico laboral BPS |
Cobertura funcional y límites¶
La aplicación organiza el dato laboral y verifica su completitud para nómina. No certifica la validez legal del contrato ni emite un dictamen jurídico. Las alertas de aprendiz e instrumentos colectivos exigen decisión humana trazable.
Guías relacionadas¶
- Antes: Roles y seguridad · Preparar la compañía
- Siguiente: Registrar tiempos y novedades