Saltar a contenido

Preparar la compañía

Qué vas a lograr

Dejar los datos maestros de la compañía en condiciones de liquidar, antes de crear a la primera persona.

Para qué sirve

Una nómina no se arregla al final cambiando el archivo de salida. Debe nacer con la compañía, el contrato, los períodos y los responsables correctos.

Qué no hace

No habilita a la compañía ante DIAN, MiPlanilla ni un banco. Cada una de esas integraciones exige su propio proceso, con sus responsables y su custodia de credenciales.

Antes de empezar

Necesita Por qué
Rol Administrador de Nómina y Ajustes / Administrador El primero gobierna parámetros BPS; el segundo abre la ficha de la compañía. Ninguno sustituye al otro.
RUT, última PILA pagada y certificado ARL Permiten confirmar ubicación, clasificación del aportante y tarifa por clase.
Datos legales vigentes de la compañía Aparecen en documentos y salidas locales.
Decisión sobre moneda y calendario Determinan reportes y períodos.

Ruta exacta

Ajustes › Usuarios y compañías › Compañías › pestaña «Nómina BPS Colombia». Los catálogos se consultan aparte en Nómina BPS › Configuración › Catálogos.

Sección Para qué sirve
Configuración Parámetros de la compañía y alertas
Catálogos Administradoras, tipos, vigencias y parámetros anuales
Actualización normativa Importar, revisar y aprobar paquetes normativos

Preparación guiada

Quién: Administrador de Nómina. Cuándo: una vez por compañía y antes de registrar al primer trabajador. Tiempo: depende de tener confirmados los datos legales, afiliaciones y decisiones de calendario.

  1. Abra la compañía correcta desde Ajustes › Usuarios y compañías › Compañías y confirme su nombre. No cambie de compañía mientras completa la ficha.
  2. En Nómina BPS Colombia, active Usa nómina BPS y complete Motivo del cambio de «Usa nómina BPS» para esta compañía. Después complete Aplica exoneración art. 114-1 ET únicamente con la decisión tributaria confirmada para esa compañía. No marque la exoneración para corregir diferencias de aportes.
  3. Seleccione Caja de compensación por defecto y ARL de la compañía desde los catálogos vigentes. Verifique después la administradora y el riesgo propios de cada trabajador: los valores predeterminados no sustituyen la revisión individual.
  4. Revise Periodicidades BPS con vigencia. La compañía nueva trae una fila mensual desde 01/01/1900: edite esa fila. Para un cambio futuro, cierre la vigencia anterior y abra la siguiente al día posterior; no deje rangos superpuestos ni dos filas abiertas. La frecuencia semanal necesita Ancla de semanas. La liquidación consolidada requiere mes calendario completo.
  5. Complete el domicilio general, incluido Municipio, seleccionando país y departamento antes del municipio. Para nómina electrónica, configure por separado Lugar de generación del XML (DIAN) y Domicilio del empleador (DIAN) con ubicaciones propias aptas. No son necesariamente el mismo lugar.
  6. Si la compañía necesita un periodo DIAN por defecto, seleccione Periodo de nómina DIAN por defecto vigente. Un periodo definido en la versión contractual del trabajador prevalece.
  7. Revise Pago de incapacidad general, días 1–2. La opción inicial aplica el porcentaje legal vigente. Al crear una compañía, escriba un Motivo del cambio de política de incapacidad que explique la configuración inicial, incluso si conserva ese valor: el formulario no se guarda sin motivo. Revise también Base IGE para salud y pensión; el valor inicial es Valor de la incapacidad (normativo). Un cambio de base requiere su propio motivo.
  8. En Tarifas de la ARL certificadas por compañía, pulse Confirmar tarifa con soporte ARL. Registre la ARL, la clase, la tarifa, la vigencia, la fecha del soporte, la referencia verificable del certificado o comunicación de la ARL y el motivo. Hágalo para cada clase que se utilizará. Compare la tarifa con el rango legal mostrado; una tarifa fuera de rango se rechaza. Si falta una combinación de ARL, clase y fecha, el cálculo se detiene y pide confirmar el soporte correspondiente.
  9. En Datos del aportante para PILA local, pulse Agregar una línea y registre clasificación, representante legal, correspondencia y beneficios conforme a la planilla y los soportes de la compañía. Fuente y Motivo son obligatorios. No presente la información local como aceptada por el operador.
  10. Guarde y vuelva a abrir la compañía. Compruebe que los valores se conservaron y que puede seleccionar las administradoras y ubicaciones esperadas. Antes de crear trabajadores, complete también los catálogos y parámetros anuales compartidos.

Antes de pasar a empleados: tener el país Colombia no activa Nómina BPS. Confirme que Usa nómina BPS sigue marcada después de guardar. Si el cálculo indica que la compañía no está activa, vuelva a la ficha con una cuenta que ya tenga los permisos de Ajustes y Administrador de Nómina y registre el motivo del cambio. Revise también los tipos de ausencia: una ausencia nueva con un tipo sin homologar no se puede aprobar como si ya tuviera tratamiento.

La siguiente pantalla muestra la compañía ficticia recién creada, antes de activar Nómina BPS y completar administradoras. Úsala para ubicar la pestaña; no la tomes como ejemplo de configuración terminada. La captura actual de tarifas certificadas y datos del aportante sigue pendiente.

Confirmar y revisar la tarifa ARL

Quién: Administrador de Nómina con acceso a la compañía. Antes de abrir el formulario, seleccione ARL de la compañía; si falta, la pantalla no permite continuar. La tarifa inicial que muestra el producto es una referencia normativa, no la tarifa de la empresa ni un certificado. Para una compañía ficticia con trabajadores de riesgo I y de otra clase, confirme por separado cada clase usando la comunicación real de su ARL; no copie una tarifa de otra compañía.

  1. Pulse Confirmar tarifa con soporte ARL. Compruebe Compañía y ARL del soporte. Elija Clase, indique Tarifa certificada (%), Vigente desde y, si el soporte tiene fecha final, Vigente hasta.
  2. Complete Fecha del soporte ARL, Certificado o comunicación de la ARL y Motivo. El campo de certificado/comunicación es una referencia textual; esta pantalla no muestra un campo para adjuntar el archivo. Conserve el documento original según el procedimiento documental de la empresa, sin afirmar que quedó cargado en la nómina.
  3. Compare la cifra con Mínima legal (%), Inicial de referencia (%) y Máxima legal (%). La tarifa informada debe estar dentro del rango; la inicial de referencia no se aplica automáticamente. Revise las fechas y confirme la ficha. Confirmar cierra el formulario ya guardado; Cancelar abandona la ventana sin confirmar el trabajo pendiente. Reabra la compañía y compruebe la fila creada.
  4. Para revisar lo vigente, pulse Revisar o cerrar vigencias ARL. Esa lista corresponde solo a la compañía activa. Si el soporte fue reemplazado, cierre la vigencia anterior con Vigente hasta y un Motivo nuevo; después registre el nuevo certificado con inicio posterior. La tarifa y el soporte históricos no se reescriben ni se eliminan.

Si se bloquea: ARL de la compañía vacía → selecciónela primero; fecha del soporte futura, tarifa fuera del rango o vigencias superpuestas → contraste el documento y corrija el dato antes de guardar; falta referencia o motivo → complételos; no puede confirmar → pida al Administrador autorizado que actúe en la compañía correcta. No use la tarifa inicial para eludir la falta de soporte. Una lista vacía o una ficha sin guardar no demuestra que la tarifa esté certificada.

Pestaña Nómina BPS Colombia de una compañía ficticia en escritorio, antes de completar la configuración

La misma pestaña de la compañía ficticia a 480 píxeles

La compañía ficticia con Usa nómina BPS activado y un motivo registrado

Activación de Nómina BPS y motivo en vista angosta

Estas dos últimas capturas muestran el resultado de guardar y reabrir la pestaña. No acreditan que la compañía ya tenga ARL, caja o aportante PILA configurados.

Si algo no permite guardar

Situación Recuperación
Municipio no coincide con país o departamento Corrija primero país y departamento y vuelva a seleccionar el municipio correspondiente.
Ubicación DIAN no aparece o no es aceptada Complete/revise la ubicación propia para el uso requerido (generación o domicilio); no elija una ubicación de otra compañía.
Periodicidades se superponen o el mes no está completo Corrija los rangos con el administrador antes de calcular. No cambie el calendario para saltarse el cierre mensual.
No hay EPS, AFP, CCF o ARL disponibles El administrador debe completar el catálogo compartido y confirmar su vigencia antes de continuar.
No hay tarifa ARL certificada para la clase y fecha del trabajador Confirme con soporte una tarifa de la ARL de la compañía para esa clase y vigencia.
Datos del aportante incompletos Revise la última planilla y complete clasificación, representante, correspondencia, beneficios, Fuente y Motivo.
«Configurar la política de incapacidad requiere motivo» En la misma pestaña, complete Motivo del cambio de política de incapacidad con la decisión adoptada y vuelva a guardar. No cambie el porcentaje solo para superar el aviso.
«Cambiar la tolerancia requiere motivo» Complete Motivo del cambio de tolerancia para la configuración inicial. No altere el valor de tolerancia solo para hacer desaparecer el mensaje.

La descripción campo por campo y las políticas avanzadas se consultan en Configuración de la compañía: campos y decisiones. Para el alta, siga Registrar la ficha y crear la versión contractual.

Pestaña «Nómina BPS Colombia» de la compañía

Con Administrador de Nómina, abra la ficha de la compañía que va a configurar y elija la pestaña Nómina BPS Colombia. Confirme el nombre de la compañía antes de cambiar cualquier opción: estos valores son propios de esa empresa; los parámetros anuales y los catálogos de administradoras son compartidos.

El campo Municipio está en los datos generales del domicilio, no en esta pestaña. Seleccione primero el país y departamento y luego el municipio correspondiente. No lo confunda con Domicilio del empleador (DIAN): ese campo apunta a una ubicación DIAN gobernada y apta.

Campo visible Qué registra o decide Valor inicial / regla y cuándo usarlo
Usa nómina BPS y Motivo del cambio de «Usa nómina BPS» Activa esta compañía para la operación BPS y deja la razón del cambio. La casilla aparece desmarcada en la compañía ficticia recién creada. Actívela únicamente en la compañía que administrará y explique el alta en el motivo.
Aplica exoneración art. 114-1 ET Marca si la compañía se declara sujeta a esa política. Desmarcado por defecto. Márquelo solo cuando la compañía haya confirmado que aplica. No significa que todos los trabajadores queden exonerados: el cálculo evalúa además las condiciones que correspondan a cada trabajador.
Caja de compensación por defecto CCF que se propone para los trabajadores de la compañía. Seleccione una Caja de compensación familiar vigente del catálogo Administradoras.
ARL de la compañía ARL que se propone al preparar un trabajador y que se usa como referencia del aportante. Seleccione una ARL vigente del catálogo. Revise además la clase de riesgo de cada trabajador; esta opción no la reemplaza.
Política de elegibilidad de nómina Qué hace un lote cuando encuentra trabajadores no aptos. Por defecto, Excluir y avisar (los aptos se liquidan). La otra opción, Bloquear el lote completo, detiene a todos hasta resolver los faltantes. El cálculo individual de un trabajador no apto sigue bloqueado.
Exigir alta completa del contrato Si se exigen los datos mínimos del contrato al guardar una versión laboral. Desactivado por defecto. Actívelo cuando el proceso de alta vaya a completar tipo de contrato, inicio, salario, jornada y lugar de trabajo. No lo active para sortear datos históricos incompletos.
Anticipación de aviso de vencimiento (término fijo) Días calendario antes del vencimiento para mostrar un aviso en la ficha del contrato. Por defecto, 30; debe ser un entero positivo. Es un aviso interno y no envía ni reemplaza el preaviso legal.
Periodicidades BPS con vigencia Frecuencia de nómina de la compañía en cada rango de fechas. Al crear la compañía se agrega una fila mensual de inicio 01/01/1900. Edite esa fila; no agregue otra vigencia abierta ni superpuesta. Para un cambio futuro, cierre la anterior y comience la siguiente al día posterior. La opción semanal requiere Ancla de semanas.
Lugar de generación del XML (DIAN) Ubicación propia desde donde se informa la generación electrónica. Solo permite elegir una ubicación de esta compañía apta para generación, con sus códigos geográficos e idioma completos. Consulte Ubicaciones DIAN.
Domicilio del empleador (DIAN) Dirección física de la compañía que viaja al documento electrónico. Solo permite elegir una ubicación propia apta como domicilio. Puede ser la misma del lugar de generación si reúne ambos grupos de requisitos.
Periodo de nómina DIAN por defecto Código de periodicidad que se propone en los documentos. Opcional. Elija una opción vigente del catálogo DIAN; cuando una versión contractual tenga su propio período, ese dato tiene prioridad. Consulte Códigos del anexo DIAN.

Precaución con la periodicidad: el sistema conserva opciones quincenal y semanal para registrar calendarios con vigencia, pero el cierre de nómina se consolida mensualmente. Las opciones quincenal/semanal pueden quedar bloqueadas para preliquidación mientras no esté completo el cierre mensual. No cambie la frecuencia para resolver un período incompleto.

Preparar o revisar diario Nómina

En la ficha de la compañía, busca Preparar un diario de Nómina. La acción requiere Administrador de Nómina y el permiso de administración de Contabilidad, además de permiso para editar la compañía. Confirma que la compañía esté autorizada y activa en tu sesión.

Pulsa Preparar o revisar diario Nómina. Si la compañía no tiene un diario preparado y el nombre y código están libres, el sistema crea Nómina, de tipo Varios, con código NBPS; luego abre su ficha. Si ya se preparó uno válido, abre ese mismo. No cambia asientos existentes ni asigna el diario a los mapeos: Contabilidad debe seleccionarlo explícitamente en Mapeo contable.

Si el nombre o el código están ocupados, revisa el diario existente en Contabilidad › Configuración › Diarios; la acción no lo reutiliza automáticamente ni crea un duplicado. Si el diario preparado está archivado o no corresponde a la compañía o al tipo esperado, pide a Contabilidad revisar su configuración antes de continuar.

Datos mínimos

Grupo Información Resultado esperado
Identidad Razón social, NIT, dirección y datos legales vigentes La compañía se identifica de forma consistente en documentos locales, incluido el comprobante de pago.
Moneda COP para una compañía colombiana, salvo decisión documentada Reportes y salidas no presentan otra moneda por defecto.
Calendario Periodicidad y período de trabajo autorizados Las novedades y recibos caen en el período correcto.
Administradoras EPS, ARL, AFP, cesantías y cajas de compensación Sin ellas no puedes completar un empleado, y sin empleado completo no hay cálculo.
Parámetros anuales y vigencias Valores normativos con su fecha desde/hasta El cálculo usa el valor correcto para cada período.
Responsables Roles BPS asignados a personas reales Cada requisito tiene una persona responsable.

El orden importa

Los catálogos de administradoras son el prerrequisito silencioso más frecuente: se descubren cuando ya se está creando al primer empleado y no hay EPS que seleccionar. Créalos antes.

Maestros y clasificaciones de la compañía

Antes de operar, confirma que las ubicaciones de la compañía y del lugar de trabajo correspondan a la actividad real. Selecciona departamentos y municipios del catálogo disponible; no inventes códigos ni dupliques registros para superar una validación.

Para nómina electrónica, revisa con el responsable que las clasificaciones del trabajador y de la compañía coincidan con la información oficial vigente. Si falta una equivalencia o un dato, déjalo pendiente y solicita la confirmación correspondiente.

La preliquidación es mensual

Antes de fijar el calendario, ten presente una restricción del producto: la preliquidación técnica exige un mes calendario completo. La preliquidación por quincena todavía no existe.

Puedes usar períodos quincenales para registrar tiempo, pero el cálculo consolidado es mensual.

Las decisiones de compañía que cambian el resultado

Esto es lo que más sorprende a quien llega nuevo: la misma nómina, con los mismos datos, se comporta distinto según cómo esté configurada la compañía. Las diez políticas siguientes pueden cambiar el resultado o bloquear una tarea; no son la lista exhaustiva de los parámetros disponibles en módulos especializados. Para esos campos sigue los enlaces de las guías de cada proceso. No son preferencias estéticas: cámbielas con una decisión documentada.

Ajuste Opciones Qué decide
Política de elegibilidad de nómina Excluir y avisar (los aptos se liquidan) · Bloquear el lote completo Qué pasa cuando un lote trae empleados no aptos: se liquida al resto avisando, o no se liquida a nadie.
Política de auxilio de transporte si el empleador lo suministra Excluir el auxilio · Bloquear la liquidación · Liquidar advirtiendo Cómo se resuelve el caso del empleador que ya presta el transporte. La opción intermedia exige decisión humana.
Política de coherencia parafiscal Alerta restrictiva · Bloqueo Si una incoherencia parafiscal se puede justificar y seguir, o impide confirmar.
Tolerancia de coherencia parafiscal Valor numérico A partir de qué diferencia se considera incoherente.
Política de conciliación para cierre Bloqueo · Alerta restrictiva Si el cierre admite diferencias materiales justificadas o no cierra con ellas.
Soporte obligatorio al justificar Sí / No Si justificar una diferencia exige adjuntar soporte.
Bloquear por habitualidad crítica Sí / No Si la habitualidad detectada detiene el proceso.
Aplica exoneración art. 114-1 ET Sí / No Si la compañía se acoge a esa exoneración de aportes.
Caja de compensación por defecto CCF Valor que se propone al completar empleados.
Sábado hábil para vacaciones Activo por defecto; sin pantalla para cambiarlo Afecta el conteo de vacaciones. Si la compañía opera de lunes a viernes, solicite el ajuste a soporte antes de liquidar; no busque una casilla que aún no existe.

Qué significa en la práctica la política de elegibilidad

Cincuenta empleados, dos sin clase de riesgo ARL. Con excluir y avisar, se liquidan 48 y los 2 aparecen bloqueados con su motivo. Con bloquear el lote completo, no se liquida ninguno hasta corregir esos dos. En ambos casos el sistema lo informa: nunca falla en silencio.

Dos compañías bien configuradas pueden dar resultados distintos

Antes de comparar una nómina con la de otro cliente, o con la del mes pasado, compruebe que estas políticas no cambiaron. Una diferencia inexplicable suele estar aquí y no en el cálculo.

«Aplica exoneración art. 114-1» y la tolerancia parafiscal tienen efecto económico

No los mueva para «destrabar» un proceso. Si un aporte no cuadra, la respuesta es corregir el dato o registrar el pendiente con su fuente, no ampliar la tolerancia.

Actualización normativa: dos personas

Los permisos Actualización normativa: importar y Actualización normativa: aprobar están deliberadamente separados y no los incluye ningún rol funcional. Asígnalos a personas distintas: quien carga un paquete normativo no debería ser quien lo aprueba.

Resultado esperado

La compañía tiene identidad, moneda, calendario, catálogos y responsables. Puedes crear un empleado y completarlo hasta dejarlo apto para nómina sin encontrarte con un catálogo vacío.

Cómo comprobarlo

Crea un empleado ficticio de prueba y completa el grupo Nómina BPS Colombia. Si puedes seleccionar EPS, AFP, cesantías y CCF —las cuatro que cuentan para la aptitud— y el campo Apto para nómina queda activo, la compañía tiene los datos básicos. También deben estar completos el lugar de trabajo, cuenta bancaria, contrato vigente y clase de riesgo ARL: ver registrar la ficha y crear la versión contractual.

Errores y recuperación

Lo que ves Causa probable Qué revisar Cómo recuperarte Escalar a
Datos de otra compañía Compañía activa equivocada Selector de compañía Cambia de compañía; no reutilices soportes ajenos Administrador de Nómina
Período equivocado Calendario mal configurado Períodos de la compañía Detén el cálculo y corrige el período o la fecha del evento Operador de nómina
No hay EPS/ARL/AFP para elegir Catálogo de administradoras vacío Configuración → Catálogos Da de alta las administradoras antes de crear empleados Administrador de Nómina
Falta un valor normativo Parámetro anual sin vigencia Parámetros anuales y sus vigencias Registra el pendiente con su fuente. No inventes una tasa, un código ni una casilla Administrador de Nómina
Importes en otra moneda Moneda de la compañía Ficha de la compañía Ajusta a COP salvo decisión documentada Administrador de Nómina

Dependencias externas

La habilitación DIAN, el perfil MiPlanilla y el banco se configuran por cliente y por entorno. Prepara metadatos y soportes, pero no ingreses secretos en campos de texto libre. Lee DSNE, PILA y Banco antes de iniciar cada integración.

Guías relacionadas

Referencia de Preparar la compañía. Para completar una tarea, siga la guía del proceso; confirme los datos, permisos y resultado antes de continuar.

Controles, asistentes, pantallas y configuración

Opción / pantalla Área Quién la usa Para qué sirve
Política de elegibilidad de nómina Preparar la compañía Administrador de Nómina Opciones: Excluir y avisar (los aptos se liquidan); Bloquear el lote completo. Valor inicial: Excluir y avisar (los aptos se liquidan). Qué hacer con los empleados no aptos en un lote de preliquidación: excluir y avisar (los aptos se liquidan) o bloquear el lote completo
Exigir alta completa del contrato Preparar la compañía Administrador de Nómina Cuando está activo, no se puede guardar una versión de contrato laboral de esta compañía sin tipo de contrato, fecha de inicio, salario, jornada y lugar de trabajo. Se entrega desactivado para que una base ya instalada no quede con versiones históricas incompletas imposibles de editar; actívelo cuando los datos de la compañía estén completos
Municipio Preparar la compañía Administrador de Nómina Municipio del contacto oficial de esta compañía. Seleccione primero país y departamento. No reemplaza los maestros de ubicación DIAN
Periodicidades BPS con vigencia Preparar la compañía Administrador de Nómina Historial de periodicidad que gobierna la nómina BPS de esta compañía
Aplica exoneración art. 114-1 ET Preparar la compañía Administrador de Nómina Indica si la empresa está exonerada de aportes parafiscales (SENA, ICBF) y del aporte patronal de salud por los trabajadores que cumplan las condiciones del art. 114-1 del Estatuto Tributario. Es una marca de política por empresa: el motor de seguridad social aplica la exoneración según la normativa vigente; aquí no se fija ningún tope ni porcentaje
Caja de compensación por defecto Preparar la compañía Administrador de Nómina Caja de compensación familiar por defecto de la empresa. El catálogo de administradoras es nacional/global; cada empresa elige la suya
ARL de la compañía Preparar la compañía Administrador de Nómina ARL de la empresa. Se propone en la ficha de cada trabajador y el cálculo de ARL la congela en el período: la causación lleva el pasivo de ARL a su tercero
Anticipación de aviso de vencimiento (término fijo) Preparar la compañía Rol de Odoo con permiso asociado, Administrador de Nómina Días calendario antes del vencimiento para mostrar un aviso preventivo en el contrato. Por defecto son 30 días, para alertar dentro de la ventana prevista por el artículo 46 del CST modificado por la Ley 2466 de 2025. Puede configurarlos según la anticipación operativa de esta compañía. Este plazo solo controla el aviso en la ficha; no reemplaza el preaviso legal ni registra su comunicación. valida la fecha y el soporte de no renovación
Lugar de generación del XML (DIAN) Preparar la compañía Administrador de Nómina Punto desde el que se genera el documento electrónico: aporta país, departamento, municipio e idioma. Solo se pueden elegir ubicaciones de esta compañía que estén completas para ese uso
Domicilio del empleador (DIAN) Preparar la compañía Administrador de Nómina Domicilio físico del empleador: aporta país, departamento, municipio y dirección. Puede ser la misma ubicación que la de generación si además tiene dirección e idioma
Periodo de nómina DIAN por defecto Preparar la compañía Administrador de Nómina Periodicidad por defecto de la compañía (tabla 5.5.1 del anexo). Cada versión contractual puede declarar la suya y prevalece. No se deduce del texto de ningún campo: se elige explícitamente