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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.




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¶
- Antes: Instalación y acceso · Roles y seguridad
- Siguiente: Registrar la ficha y crear la versión contractual
Menús y opciones de esta área¶
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 |