Preparar la compañía¶
Integridad de maestros DANE al actualizar¶
Cambio de instalación/validación, no una nueva pantalla: PayrollBPS PR #40, 695c6260 (MIG-29), presente en 067ec7a21cf049451cd349ae473e872883f98e77. Después de cargar el registro, la migración comprueba el índice físico de código DANE normalizado. No reconstruye el índice ni modifica municipios; falla cerrada si la barrera está degradada. El instalador debe conservar el diagnóstico de actualización y escalar al equipo de producto, no crear municipios duplicados ni editar códigos para sortearlo. La prueba de actualización real sigue pendiente; no se atribuye a la falta de RR. HH. el contraste de esta migración, que sí se hizo por código. Fuente MIG-29.
Revisión de alcance — 2026-09-13
Para el corte BPSPayrollE 067ec7a2, la preparación empieza en Implantación → Checklist F1, incluidos Roles y permisos, administradoras, parámetros anuales y catálogos con vigencia. Colombia y COP deben verificarse explícitamente; la tarifa ARL requiere fuente y vigencia. No se configuró una compañía nueva en esta entrega. El manual de primera nómina identifica lo ejecutado y lo pendiente. Las capturas y detalles siguientes proceden del corte histórico indicado en su ficha y no acreditan la configuración del build actual.
Ficha de verificación
Guía V1.1 · Verificada el 2026-08-11 · Código 4b0f549d (dev-fase3 de xdiegob/PayrollBPS) · Entorno Odoo.sh xdiegob-payrollbps Development, build 36201289 Test: Success · Contenedor Configuración y sus tres secciones confirmados en el árbol de menús vivo; los diez ajustes de compañía leídos de las definiciones de campo del build · Estado externo: no aplica.
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.
Captura V1.0, canon anterior. En el commit verificado el contenedor Configuración agrupa tres secciones: Configuración, Catálogos y Actualización normativa.
Antes de empezar¶
| Necesita | Por qué |
|---|---|
| Rol Administrador de Nómina | Configuración y catálogos son suyos. |
| 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¶
Nómina BPS → Configuración
| 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 |
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 gate tiene un dueño humano. |
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 DANE y clasificación DSNE vigentes¶
Contraste de código en BPSPayrollE 067ec7a21cf049451cd349ae473e872883f98e77; no se guardaron maestros ni se ejecutó una migración en esta entrega.
- Administrador BPS: abre los catálogos DANE desde Configuración y revisa primero país/departamento/municipio. El corte utiliza ciudades nativas y el catálogo municipal de
l10n_co_edi, anotado con fuente; la conclusión antigua “no hay municipios sembrados” ya no describe S. - Revisa código literal, ceros iniciales, relación con el departamento y fuente/fecha. El nombre de una ciudad no permite deducir su código. Si una búsqueda no devuelve el registro, revisa filtros de vigencia/pendientes antes de crear un duplicado.
- Comprueba las ubicaciones de generación y domicilio del empleador; RR. HH. comprueba la de trabajo del empleado. No son un único dato sustituible por la dirección comercial.
- Revisa el catálogo de clasificación DIAN y su correspondencia documentada: versión vigente, código, fuente, sección/página y equivalencia. Las versiones cerradas son historia. La ausencia de equivalencia bloquea; no se infiere a partir del tipo PILA ni del nombre del contrato.
- Guarda solo datos respaldados y vuelve a evaluar el control local que señaló el faltante. Conserva el mensaje y la referencia del maestro, sin datos personales innecesarios.
Recuperación de actualización: el producto normaliza claves y comprueba unicidad antes/después del registro. Ante duplicidad, un índice degradado o una correspondencia no respaldada, el instalador conserva el diagnóstico para producto. No se borran municipios de usuario ni se renumera un código a mano. La consolidación de aliases nativos y retirada del antiguo código 27493 son migraciones concretas del catálogo, no una instrucción para eliminar registros similares de un cliente.
Capturas Odoo requeridas: lista con filtros, ficha con código/fuente, ubicaciones de compañía/trabajador y validación/recuperación. La falta de sesión administrativa solo impide esas comprobaciones de interfaz, no este contraste documental. Fuentes: maestros del módulo base, vistas de maestros.
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. Son diez ajustes propios de BPS, y varios deciden si un proceso se detiene o continúa. No son preferencias estéticas: cámbielos con 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 | Sí / No | Cómo se cuentan los días de vacaciones. |
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 sintético de prueba y llega hasta el final del 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 (gate) queda en verdadero, la compañía está preparada. Recuerda que el gate también exige lugar de trabajo, cuenta bancaria, contrato vigente y clase de riesgo ARL: ver Crear un empleado y contrato.
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: Crear un empleado y contrato