PILA: opción por opción¶
Volver a Todos los menús · Guía del proceso
Estado: PARCIAL. Referencia de acciones, vistas y campos del código fusionado 067ec7a21cf049451cd349ae473e872883f98e77. Los ejemplos de esta página son propuestas sintéticas, no ejecuciones ni resultados obtenidos. La sesión actual no permite comprobar todos estos menús. No confundir esta referencia con un tutorial visual ya terminado.
Responsabilidades: Operador prepara artefactos locales; administración gobierna catálogos; respuesta/carga externa fuera de este encargo. La restricción que se muestra por nodo no reemplaza la comprobación de permisos del usuario ni autoriza a concedérselos.
Cómo seguir un ejemplo¶
Ir directamente a una opción:
- Cálculos de IBC
- Coherencia parafiscal
- Aportes salud y pensión
- Fondo de Solidaridad Pensional
- Exoneración art. 114-1
- Aportes de ARL
- Proporcionalidad de IBC
- Parafiscales (CCF, SENA, ICBF)
- Tipos de cotizante
- Excepciones de pensión
- Planillas PILA técnicas
- Layout PILA fuenteado
- Reglas PILA fuenteadas
- Catálogos PILA fuenteados
- Detalle PILA tipo 2 local
- Archivo PILA tipo 1 local
- TXT PILA local no enviable
- Validación operador PILA
- Perfiles operador PILA (local)
- Paquetes de prueba operador PILA
- Generar paquete MiPlanilla
- Candidatos UAT MiPlanilla
- Correcciones locales (Planilla N)
- Consolidar planilla del período
Use exclusivamente Development y la compañía InfoCenter Ejemplo Colombia, con Ana (salario mínimo) y Luis (3.500.000 COP), agosto de 2026, como se prepara en Mi primera nómina. Los casos especiales (retiro, incapacidad, compensación, litigio) son ejemplos separados: no altere el mes ordinario para fabricarlos. Si falta el dato o la sesión, no pulse acciones para rellenar la guía.
En cada ficha, datos obligatorios de lectura significa que los exige el artefacto, no que deban teclearse. La tabla muestra campos declarados en modelos/vistas BPS; no certifica todas las validaciones de negocio ni resuelve la interfaz nativa o heredada completa. Los botones pueden depender del estado, grupos y vista seleccionada: se enumeran para reconocerlos, no como permiso de ejecución.
PILA¶
Ruta: Nómina BPS → PILA.
Es un contenedor de navegación, no genera un registro ni calcula importes. Ábralo y elija la opción según la tarea:
- Consolidar planilla del período
- Cálculos de IBC
- Planillas PILA técnicas
- Layout PILA fuenteado
- Reglas PILA fuenteadas
- Catálogos PILA fuenteados
- Detalle PILA tipo 2 local
- Archivo PILA tipo 1 local
- TXT PILA local no enviable
- Validación operador PILA
- Perfiles operador PILA (local)
- Coherencia parafiscal
- Proporcionalidad de IBC
- Aportes salud y pensión
- Fondo de Solidaridad Pensional
- Exoneración art. 114-1
- Aportes de ARL
- Parafiscales (CCF, SENA, ICBF)
- Tipos de cotizante
Ejemplo: para consultar Consolidar planilla del período, despliegue esta ruta y siga la ficha enlazada. Si no aparece, el PO comprueba sesión y compañía; no se cambia el rol para fotografiar el menú.
Dos imágenes requeridas — pendientes: A, contenedor expandido con sus opciones; B, siguiente nivel o pantalla de destino con la ruta reconocible. No contar dos tamaños de la misma imagen como dos etapas.
Acceso declarado: Operador de nómina / Administrador BPS / Auditor de nómina Fuente: bps_nomina_app_menus.xml.
Aportes de ARL¶
Ruta: Nómina BPS → PILA → Aportes de ARL.
Para qué sirve: Aporte de riesgos laborales (ARL) desde el IBC.
Ejemplo explicado: Consulta la clase y tarifa que realmente consumió la traza de Ana; el aporte de ARL es costo del empleador, no deducción del trabajador.
Entrada y pasos:
- Abra la ruta y verifique Aportes de ARL. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Clase de riesgo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| IBC de ARL | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tarifa ARL (%) | Calculado / lectura | Tarifa por clase de riesgo leída del catálogo vigente. A cargo del empleador. No se quema en código. |
| Aporte ARL (empleador) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_calculo_arl. - Acción:
bps_nomina_ibc.action_bps_calculo_arl; modelobps.calculo.arl. - Fuentes del menú/acción: calculo_arl_views.xml, bps_nomina_app_menus.xml.
- Vistas: calculo_arl_views.xml.
- Datos: calculo_arl.py.
Aportes salud y pensión¶
Ruta: Nómina BPS → PILA → Aportes salud y pensión.
Para qué sirve: Aportes de salud y pensión desde el IBC.
Ejemplo explicado: Para Luis, compara las bases y aportes del trabajador con los del empleador. No descuentes el aporte patronal del neto del trabajador.
Entrada y pasos:
- Abra la ruta y verifique Aportes de salud y pensión. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| EPS | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| AFP | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Exon. 114-1 | Calculado / lectura | La compañía está marcada como sujeto del art. 114-1 ET. La aplicación depende de la determinación final por empleado y período. |
| Exoneración 114-1 aplicada | Calculado / lectura | La porción patronal de salud se liquidó en cero porque la determinación final del art. 114-1 resultó aplicable. |
| Exen. pensión | Calculado / lectura | El trabajador extranjero tiene soporte vigente de no obligación a pensión: el aporte a pensión es cero (salud/ARL/parafiscales se mantienen). |
| Alto riesgo | Calculado / lectura | Actividad de alto riesgo (Decreto 2090/2003): el empleador cotiza los puntos adicionales de pensión. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Determinación 114-1 | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Excepción de extranjero | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Puntos adicionales alto riesgo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Aportes | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_calculo_aportes. - Acción:
bps_nomina_ibc.action_bps_calculo_aportes; modelobps.calculo.aportes. - Fuentes del menú/acción: calculo_aportes_views.xml, bps_nomina_app_menus.xml.
- Vistas: calculo_aportes_views.xml.
- Datos: calculo_aportes.py.
Excepciones de pensión¶
Ruta: Nómina BPS → PILA → Aportes salud y pensión → Excepciones de pensión.
Para qué sirve: Excepcion de cotizacion a pension: extranjero no obligado.
Ejemplo explicado: Revisa una excepción sintética de extranjero no obligado, con soporte y vigencia. Nacionalidad extranjera por sí sola no prueba la excepción.
Entrada y pasos:
- Abra la ruta y verifique Excepciones de pensión (extranjeros). Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- Revise los datos de la ficha. La presencia de un formulario no acredita permiso para crear/modificar: siga el flujo de la guía del proceso y la sesión autorizada.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Empleado | Obligatorio | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Desde | Obligatorio | Fecha coherente con el hecho o vigencia del registro. |
| Hasta | Obligatorio | Al vencer, la excepcion deja de aplicar y el trabajador vuelve a cotizacion plena de pension (retorno automatico). |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Residencia fiscal (registrada) | No marcado obligatorio en esta declaración | Resultado del analisis tributario. Se REGISTRA, no se calcula (D-9). Alimenta el procedimiento de retencion (M07). |
| Categoria PILA | No marcado obligatorio en esta declaración | Tipo de cotizante PILA del extranjero no obligado a pension. El codigo especifico se gobierna como dato (M08/HU-047) si aun no existe en el catalogo. |
| Dias de permanencia en el pais | No marcado obligatorio en esta declaración | Dato registrado para la alerta de coherencia con la categoria fiscal. |
| Compania | Obligatorio | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Alerta de vencimiento | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Alerta de residencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Soporte documental | No marcado obligatorio en esta declaración | Certificado de cotizacion en sistema extranjero o convenio. Obligatorio: sin soporte no se aplica la excepcion (P9). |
| Motivo del alta | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_excepcion_pension. - Acción:
bps_nomina_ibc.action_bps_excepcion_pension; modelobps.excepcion.pension.extranjero. - Fuentes del menú/acción: excepcion_pension_views.xml.
- Vistas: excepcion_pension_views.xml.
- Datos: excepcion_pension.py.
Archivo PILA tipo 1 local¶
Ruta: Nómina BPS → PILA → Archivo PILA tipo 1 local.
Para qué sirve: Archivo PILA tipo 1 local no exportable.
Ejemplo explicado: Revisa el encabezado local y su relación con la planilla; generar el tipo 1 no genera por sí solo un archivo completo aceptado.
Entrada y pasos:
- Abra la ruta y verifique Archivo PILA tipo 1 local. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Planilla PILA | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Version layout | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Longitud | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Linea local archivo tipo 1 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Valores campo a campo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_archivo_tipo1. - Acción:
bps_nomina_pila.action_bps_pila_archivo_tipo1; modelobps.pila.archivo.tipo1. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_archivo_tipo1.py.
Cálculos de IBC¶
Ruta: Nómina BPS → PILA → Cálculos de IBC.
Para qué sirve: Cálculo del IBC de seguridad social (pipeline 5 pasos, HU-027).
Ejemplo explicado: Consulta por separado a Ana y Luis en agosto y revisa base, piso/tope, días y conceptos fuente. No confundas el IBC con el neto ni con el costo patronal.
Entrada y pasos:
- Abra la ruta y verifique Cálculos de IBC. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Salario integral | Calculado / lectura | Casilla de lectura: comprobar la condición calculada por el proceso. |
| Base antes de topes | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Base tras topes | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Días del período | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| IBC final | Calculado / lectura | Base de cotización tras topes y proporcionalidad por días. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo del 40% | Calculado / lectura | Traza del motor del 40% (HU-016) reutilizada; no se recalcula aquí. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Total salarial (TS) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Exceso 40% (E) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Base tras 40% (TS+E) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Factor de base integral | Calculado / lectura | Fracción del salario integral que constituye base (1 − factor prestacional, leído de los parámetros anuales). |
| Base integral | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tope mínimo (1 SMMLV) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tope máximo (25 SMMLV) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Divisor de días | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| IBC por subsistema | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_calculo_ibc. - Acción:
bps_nomina_ibc.action_bps_calculo_ibc; modelobps.calculo.ibc. - Fuentes del menú/acción: calculo_ibc_views.xml, bps_nomina_app_menus.xml.
- Vistas: calculo_ibc_views.xml.
- Datos: calculo_ibc.py, cadena_tiempo_ibc.py.
Catálogos PILA fuenteados¶
Ruta: Nómina BPS → PILA → Catálogos PILA fuenteados.
Para qué sirve: Catalogo PILA fuenteado y gobernado.
Ejemplo explicado: Busca un código usado por los trabajadores y comprueba su categoría/vigencia. Un código DIAN no es necesariamente un código PILA.
Entrada y pasos:
- Abra la ruta y verifique Catálogos PILA fuenteados. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| tipo | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Codigo PILA | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Descripcion | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Version fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Estado fuente | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Pagina/seccion fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| activo | No marcado obligatorio en esta declaración | No marcar la casilla sin cumplir y demostrar su condición. |
| Vigente desde | No marcado obligatorio en esta declaración | Fecha coherente con el hecho o vigencia del registro. |
| Vigente hasta | No marcado obligatorio en esta declaración | Fecha coherente con el hecho o vigencia del registro. |
| Fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| URL fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Notas de alcance | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_catalogo. - Acción:
bps_nomina_pila.action_bps_pila_catalogo; modelobps.pila.catalogo. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_catalogo.py.
Coherencia parafiscal¶
Ruta: Nómina BPS → PILA → Coherencia parafiscal.
Para qué sirve: Coherencia entre IBC de CCF y base parafiscal.
Ejemplo explicado: Compara IBC CCF y base parafiscal del mismo trabajador/período y revisa la explicación de cualquier diferencia, sin igualarlas manualmente.
Entrada y pasos:
- Abra la ruta y verifique Coherencia parafiscal. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| IBC de CCF | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Base parafiscal | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Diferencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tolerancia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Política | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Justificación | Calculado / lectura | Justificación documentada de la divergencia. No debe contener datos personales ni sensibles, solo el motivo normativo/operativo. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_coherencia_parafiscal. - Acción:
bps_nomina_ibc.action_bps_coherencia_parafiscal; modelobps.coherencia.parafiscal. - Fuentes del menú/acción: coherencia_parafiscal_views.xml, bps_nomina_app_menus.xml.
- Vistas: coherencia_parafiscal_views.xml.
- Datos: coherencia_parafiscal.py.
Consolidar planilla del período¶
Ruta: Nómina BPS → PILA → Consolidar planilla del período.
Para qué sirve: Consolidar planilla PILA tecnica del periodo.
Ejemplo explicado: Selecciona compañía y mes del ejemplo y pulsa Consolidar únicamente cuando existan las fuentes requeridas. Revisa cobertura de ambos trabajadores y bloqueos.
Entrada y pasos:
- Abra la ruta anterior y revise el título Consolidar planilla PILA del período de la ventana.
- Compruebe compañía/alcance y complete los datos de entrada que se indican abajo. No sustituya referencias inexistentes por otras de un período distinto.
- Lea los controles declarados y las precondiciones de la guía del proceso antes de confirmar. Si corresponde a secretos, aprobación, pago o acción externa, deténgase.
- Solo después de una ejecución local autorizada, revise el resultado o bloqueo y conserve su identificador. En esta ficha ese resultado sigue sin ejecutar.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Obligatorio | Ultimo dia del mes que se consolida. El servicio rechaza cualquier otra fecha indicando cual corresponde. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Compania | Obligatorio | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Consolidar | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Cancelar | Salir del asistente sin ejecutar su operación. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ventana de entrada con campos y alcance; B, resultado o bloqueo posterior con explicación. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_planilla_consolidar. - Acción:
bps_nomina_pila.action_bps_pila_planilla_consolidar; modelobps.pila.planilla.consolidar.wizard. - Fuentes del menú/acción: pila_consolidar_wizard_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_consolidar_wizard_views.xml.
- Datos: pila_consolidar_wizard.py.
Detalle PILA tipo 2 local¶
Ruta: Nómina BPS → PILA → Detalle PILA tipo 2 local.
Para qué sirve: Detalle PILA tipo 2 local desde recibo finalizado.
Ejemplo explicado: Revisa el detalle de Ana y sus bases/días/aportes desde el recibo finalizado. No completes un renglón a mano cuando falte el recibo.
Entrada y pasos:
- Abra la ruta y verifique Detalle PILA tipo 2 local. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Obligatorio en la traza; lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Recibo finalizado | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Liquidacion definitiva RET | Calculado / lectura | Liquidacion definitiva CERRADA que soporta la novedad RET local. Solo se informa en el TXT local no enviable; no habilita envio ni pago PILA. |
| Tipo planilla | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Tipo cotizante | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Subtipo cotizante | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Longitud | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Preliquidacion origen | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Version layout | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Secuencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Traza IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Traza aportes | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Traza ARL | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Traza parafiscales | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Linea local tipo 2 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Valores campo a campo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_detalle_tipo2. - Acción:
bps_nomina_pila.action_bps_pila_detalle_tipo2; modelobps.pila.detalle.tipo2. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_catalogo.py.
Exoneración art. 114-1¶
Ruta: Nómina BPS → PILA → Exoneración art. 114-1.
Para qué sirve: Determinación de la exoneración del art. 114-1 ET.
Ejemplo explicado: Revisa el resultado por compañía, trabajador y período, con régimen y causa. No actives una exoneración general por el solo salario de Ana.
Entrada y pasos:
- Abra la ruta y verifique Exoneración art. 114-1. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| IBC de salud (referencia proxy) | Calculado / lectura | IBC de salud persistido como contraste técnico. NO decide la exoneración del art. 114-1: puede diferir del salario/devengado. |
| Devengado salarial de referencia | Calculado / lectura | Total salarial de la traza inmutable de regla 40 % consumida por M05. Es la fuente mensual con la que se evalúa el umbral del art. 114-1 ET. |
| Compañía sujeta a 114-1 | Calculado / lectura | La compañía está marcada como sujeto de la exoneración (HU-022A). |
| IBC de salud < 10 SMMLV (proxy) | Calculado / lectura | Contraste técnico: el IBC de salud es menor que 10 SMMLV. No decide la exoneración final porque puede diferir del devengado salarial. |
| Candidato a exoneración (proxy) | Calculado / lectura | Indicador histórico de contraste: compañía sujeta e IBC de salud bajo el umbral. La decisión final usa devengado salarial, no este proxy. |
| Exoneración (final) | Calculado / lectura | Resultado final para el período: la compañía es sujeto y el devengado salarial persistido es menor que 10 SMMLV. |
| Determinación final pendiente | Calculado / lectura | Solo se activa si la traza salarial exigida por la determinación final no puede resolverse. En ese caso el motor bloquea y no liquida aportes. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Umbral 10 SMMLV | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Devengado salarial < 10 SMMLV | Calculado / lectura | Resultado normativo: el devengado salarial persistido es estrictamente menor que el umbral parametrizado de 10 SMMLV. |
| Montos exonerados pendientes | Calculado / lectura | Solo se activa si el cálculo no puede completar los montos desde las tasas gobernadas de aportes y parafiscales. |
| Componentes | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_exoneracion_114. - Acción:
bps_nomina_ibc.action_bps_exoneracion_114; modelobps.exoneracion.114. - Fuentes del menú/acción: exoneracion_114_views.xml, bps_nomina_app_menus.xml.
- Vistas: exoneracion_114_views.xml.
- Datos: exoneracion_114.py.
Fondo de Solidaridad Pensional¶
Ruta: Nómina BPS → PILA → Fondo de Solidaridad Pensional.
Para qué sirve: Fondo de Solidaridad Pensional desde el IBC.
Ejemplo explicado: Consulta la traza y sus umbrales vigentes; en el caso básico no presupongas un descuento positivo. Una traza en cero puede ser un resultado válido.
Entrada y pasos:
- Abra la ruta y verifique Fondo de Solidaridad Pensional. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| IBC de pensión | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Aplica FSP base | Calculado / lectura | El afiliado cotiza la tasa base del FSP solo si su IBC de pensión alcanza las 4 SMMLV. |
| % FSP base | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Aporte FSP total (trabajador) | Calculado / lectura | Total consumible del FSP: suma de las líneas de Solidaridad y Subsistencia. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Umbral 4 SMMLV | Calculado / lectura | Tope de 4 SMMLV (HU-007) a partir del cual el afiliado cotiza al FSP. |
| Aporte FSP base (trabajador) | Calculado / lectura | Tasa base del 1% a cargo del trabajador sobre el IBC de pensión, solo si aplica. NO incluye escalones por rango (subcuenta de Subsistencia). |
| % FSP total | Calculado / lectura | Tasa total realmente aplicada: base más el escalón adicional fuenteado. |
| Componentes FSP | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Escalón de Subsistencia pendiente | Calculado / lectura | True solo para una traza histórica previa a la parametrización de los escalones de Subsistencia. El cálculo vigente usa el catálogo fuenteado con vigencia; la traza histórica se conserva para revisión y no se recalcula. |
| Reparto por subcuentas pendiente | Calculado / lectura | True solo para una traza histórica previa a la parametrización del reparto entre subcuentas. El cálculo vigente usa el catálogo fuenteado con vigencia; la traza histórica se conserva para revisión y no se recalcula. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_calculo_fsp. - Acción:
bps_nomina_ibc.action_bps_calculo_fsp; modelobps.calculo.fsp. - Fuentes del menú/acción: calculo_fsp_views.xml, bps_nomina_app_menus.xml.
- Vistas: calculo_fsp_views.xml.
- Datos: calculo_fsp.py.
Layout PILA fuenteado¶
Ruta: Nómina BPS → PILA → Layout PILA fuenteado.
Para qué sirve: Campo oficial del layout PILA (catalogo M08).
Ejemplo explicado: Consulta posición, longitud y formato de un campo del tipo de registro; no cambies anchos para que un archivo inválido parezca aceptado.
Entrada y pasos:
- Abra la ruta y verifique Layout PILA fuenteado. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Version layout | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Tipo de archivo | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Tipo de registro | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Campo | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Nombre oficial del campo | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Posicion inicial | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Posicion final | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Longitud | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Tipo dato | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Obligatorio | No marcado obligatorio en esta declaración | No marcar la casilla sin cumplir y demostrar su condición. |
| Estado verificacion | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Activo | No marcado obligatorio en esta declaración | No marcar la casilla sin cumplir y demostrar su condición. |
| Fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| URL fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Pagina/seccion fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Notas de alcance | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_layout_campo. - Acción:
bps_nomina_pila.action_bps_pila_layout_campo; modelobps.pila.layout.campo. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_layout.py.
Parafiscales (CCF, SENA, ICBF)¶
Ruta: Nómina BPS → PILA → Parafiscales (CCF, SENA, ICBF).
Para qué sirve: Parafiscales por componente desde la base trazable.
Ejemplo explicado: Revisa cada componente de Luis, su base, tarifa y exoneración aplicable. No uses un total agregado para ocultar un componente faltante.
Entrada y pasos:
- Abra la ruta y verifique Parafiscales (CCF, SENA, ICBF). Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Base parafiscal | Calculado / lectura | Base SALARIAL de la traza de IBC (HU-027): total salarial (TS), o la BASE INTEGRAL (70% del total) si el salario es integral. Excluye el excedente del 40% (art. 30 Ley 1393/2010), que integra el IBC de seguridad social pero NO los parafiscales. |
| % total parafiscales | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Exoneración 114-1 pendiente | Calculado / lectura | Indica que M05 aún no tiene una determinación final del art. 114-1. M08 la resuelve antes de transportar la planilla; si no puede obtener una traza única, bloquea y no persiste una liquidación parcial. |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Cálculo de IBC | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| IBC de CCF (referencia) | Calculado / lectura | IBC de CCF del trace (incluye el excedente del 40% y los topes). Es REFERENCIA para la coherencia; NO es la base parafiscal. |
| Excedente excluido | Calculado / lectura | Diferencia IBC de CCF − base parafiscal (excedente del 40% que NO entra a parafiscales). |
| Coherencia parafiscal | Calculado / lectura | Traza de coherencia (HU-030) registrada cuando la base parafiscal difiere del IBC de CCF (excedente del 40%). |
| Determinación 114-1 | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Candidato a exoneración (proxy) | Calculado / lectura | Contraste histórico tomado de la determinación 114-1. La aplicación de SENA/ICBF se decide exclusivamente por su resultado final. |
| Beneficios Mipyme (Ley 590/1429) pendientes | Calculado / lectura | Las progresividades/beneficios Mipyme (Ley 590/1429) NO se aplican: quedan en backlog (HU-035 v1.1). |
| Componentes | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_calculo_parafiscales. - Acción:
bps_nomina_ibc.action_bps_calculo_parafiscales; modelobps.calculo.parafiscales. - Fuentes del menú/acción: calculo_parafiscales_views.xml, bps_nomina_app_menus.xml.
- Vistas: calculo_parafiscales_views.xml.
- Datos: calculo_parafiscales.py.
Perfiles operador PILA (local)¶
Ruta: Nómina BPS → PILA → Perfiles operador PILA (local).
Para qué sirve: Perfil local de validacion por operador PILA.
Ejemplo explicado: Revisa el perfil MiPlanilla y su versión/fuente antes de interpretar una prevalidación local.
Entrada y pasos:
- Abra la ruta y verifique Perfiles operador PILA (local). Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Codigo interno | Obligatorio | Identificador interno BPS del operador (no es un codigo oficial PILA). |
| Operador | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Estado del perfil | Obligatorio | Mientras no exista ficha tecnica formal del operador, el perfil queda pendiente y NO agrega reglas de negocio propias del operador. |
| Terminador preferido | No marcado obligatorio en esta declaración | Solo si el operador lo declara formalmente. Si esta definido y el TXT local usa otro terminador, la prevalidacion local lo reporta como error. |
| Exigir contenido ASCII | No marcado obligatorio en esta declaración | Solo si el operador lo declara formalmente. Si esta activo y el TXT local contiene caracteres no ASCII, la prevalidacion local lo reporta. |
| Activo | No marcado obligatorio en esta declaración | No marcar la casilla sin cumplir y demostrar su condición. |
| Formato respuesta operador | Obligatorio | Gobierna si una respuesta adjunta del operador se conserva solo como evidencia o se parsea localmente contra una ficha/formato confirmado. No declara aceptacion externa real ni reemplaza la validacion del operador. |
| Delimitador respuesta | No marcado obligatorio en esta declaración | Elegir una opción del catálogo de la pantalla. |
| Encoding respuesta | No marcado obligatorio en esta declaración | Elegir una opción del catálogo de la pantalla. |
| Respuesta con encabezado | No marcado obligatorio en esta declaración | El parser local solo interpreta formatos delimitados con encabezado confirmado. Si el operador entrega otro formato, queda pendiente. |
| Columna estado respuesta | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna linea TXT | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna campo TXT | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna codigo/error | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna mensaje | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna severidad | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Columna hash/planilla | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Fuente formato respuesta | No marcado obligatorio en esta declaración | Ficha tecnica, acta de prueba o fuente interna aprobada que justifica el parser local. Si falta, no se parsea. |
| Fuente de la configuracion | Obligatorio | De donde proviene cada preferencia configurada (ficha tecnica, manual del operador, o declaracion de ausencia de especificacion formal). |
| URL fuente | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Notas de alcance | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_operador_perfil. - Acción:
bps_nomina_pila.action_bps_pila_operador_perfil; modelobps.pila.operador.perfil. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_operador_perfil.py.
Planillas PILA técnicas¶
Ruta: Nómina BPS → PILA → Planillas PILA técnicas.
Para qué sirve: Cabecera tecnica de planilla PILA.
Ejemplo explicado: Abre la planilla del mes, revisa aportantes y detalles de los dos trabajadores y lee las validaciones antes de preparar archivos locales.
Entrada y pasos:
- Abra la ruta y verifique Planillas PILA técnicas. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Tipo de planilla | Calculado / lectura | PENDIENTE_FUENTE: el catalogo oficial de tipos de planilla (E/A/I/N/W...) de la Res. 2388/2016 no esta normalizado en el repo. No se asume codigo. |
| Estado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Total aportes (tecnico) | Calculado / lectura | Suma tecnica de aportes consolidados. NO es un valor a pagar al operador. |
| PILA pendiente de reglas/operador | Calculado / lectura | True mientras falten reglas, datos autoritativos o prueba de operador. Mientras sea True, la exportacion productiva esta bloqueada. |
| Estado fuente layout | Calculado / lectura | La fuente oficial AT2 v29 esta identificada; la exportacion requiere datos/reglas completos y prueba con operador. |
| Estado archivo PILA completo | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Gates archivo PILA completo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Version fuente layout | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| URL fuente layout | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Lineas | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Archivos tipo 1 locales | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| TXT locales no enviables | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Correcciones locales (Planilla N) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Evaluar archivo completo | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Generar tipo 1 local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Ver tipo 1 local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Generar TXT local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Ver TXT local | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Preflight correccion (Planilla N / Tipo 51) | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS / Auditor de nómina. LECTURA: matriz de requisitos y gates pendientes para una correccion. No prepara, no genera Planilla N/Tipo 51 productiva ni envia al operador. |
| Preparar correccion local (Planilla N) | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Deja evidencia local trazable de una correccion (motivo, soporte y campos AT2 afectados). No genera TXT productivo ni envio al operador. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_planilla. - Acción:
bps_nomina_pila.action_bps_pila_planilla; modelobps.pila.planilla. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml, pila_correccion_local_views.xml.
- Datos: cobertura_planilla.py, pila_archivo_local.py, pila_archivo_tipo1.py, pila_correccion_local.py, pila_miplanilla_carga.py, pila_planilla.py.
Correcciones locales (Planilla N)¶
Ruta: Nómina BPS → PILA → Planillas PILA técnicas → Correcciones locales (Planilla N).
Para qué sirve: Correccion local PILA (Planilla N) — evidencia gobernada no productiva.
Ejemplo explicado: Consulta una corrección sintética ligada a su planilla origen y revisa diferencias. Preparar evidencia local no corrige una planilla presentada ante el operador.
Entrada y pasos:
- Abra la ruta y verifique Correcciones locales PILA (Planilla N). Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo original | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Planilla original | Obligatorio en la traza; lectura | Planilla PILA tecnica consolidada que se corrige. Queda INMUTABLE: la correccion la referencia (HU-050), no la edita. |
| Estado | Obligatorio en la traza; lectura | Evidencia LOCAL. No existe estado productivo/enviado/aceptado: el TXT productivo y la aceptacion del operador siguen bloqueados. |
| Preparada el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Preparada por | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| SHA256 de la evidencia | Calculado / lectura | Hash del contenido canonico (planilla, motivo, campos, soporte). Idempotencia: una correccion identica no se duplica. |
| Adjunto de evidencia | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Motivo de la correccion | Obligatorio en la traza; lectura | Motivo obligatorio y auditado de la correccion (HU-050). Sin motivo no se prepara evidencia. |
| Campos AT2 afectados | Calculado / lectura | Campos del layout AT2 v29 (catalogo fuenteado) que la correccion afecta. Solo se referencian campos oficiales existentes; no se inventan campos ni su semantica de correccion. |
| Soporte de la correccion | Calculado / lectura | Adjuntos de soporte OBLIGATORIOS (acto administrativo, calculo previo, comunicacion). Sin soporte la correccion queda BLOQUEADA. |
| Resumen de la correccion | Calculado / lectura | Resumen legible: planilla original, periodo, motivo, campos afectados y soporte. Es evidencia local contrastable, no un archivo productivo. |
| Detalle estructurado (JSON) | Calculado / lectura | Evidencia estructurada de la correccion con las mismas claves del resumen para trazabilidad/auditoria. No es un TXT PILA. |
| Fuente / memoria | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_correccion_local. - Acción:
bps_nomina_pila.action_bps_pila_correccion_local; modelobps.pila.correccion.local. - Fuentes del menú/acción: pila_correccion_local_views.xml.
- Vistas: pila_correccion_local_views.xml.
- Datos: pila_correccion_local.py.
Proporcionalidad de IBC¶
Ruta: Nómina BPS → PILA → Proporcionalidad de IBC.
Para qué sirve: Días cotizados y base proporcional del IBC por subsistema.
Ejemplo explicado: Para un caso separado de ingreso a mitad de mes, compara días por subsistema con el caso de 30 días. No alteres el ejemplo completo de Ana.
Entrada y pasos:
- Abra la ruta y verifique Proporcionalidad de IBC. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Período | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Empleado | Calculado / lectura | Ana o Luis, solo cuando el caso esté creado por RR. HH. en la compañía correcta. |
| Días del período | Calculado / lectura | Días del período según ingreso/retiro (convención de mes de divisor días). Es la base antes de descontar novedades. |
| Días cotizados salud | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Días cotizados pensión | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Días cotizados ARL | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Días cotizados parafiscales | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| IBC mínimo proporcional | Calculado / lectura | SMMLV × días_base / divisor (Dec. 780/2016: puede ser inferior a 1 SMMLV en períodos parciales). |
| Compañía | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Ingreso en el período | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. |
| Retiro en el período | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. |
| Divisor (días base/mes) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SMMLV del período | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Flujo operativo de novedades pendiente | Calculado / lectura | HU-028A trabaja con entradas de novedad CONTROLADAS. El flujo operativo completo (registros de novedad por empleado conectados automáticamente al período) queda en HU-028B (PENDIENTE). |
| IBC por subsistema pendiente | Calculado / lectura | Esta traza determina los días por subsistema, pero el motor de IBC (HU-027) aún recibe un único dias y produce un IBC proporcional común: persistir un IBC DIFERENTE por subsistema queda PENDIENTE. CA-4 e 'IBC por subsistema' NO se declaran completos. |
| Novedades aplicadas | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_proporcionalidad_ibc. - Acción:
bps_nomina_ibc.action_bps_proporcionalidad_ibc; modelobps.proporcionalidad.ibc. - Fuentes del menú/acción: proporcionalidad_ibc_views.xml, bps_nomina_app_menus.xml.
- Vistas: proporcionalidad_ibc_views.xml.
- Datos: proporcionalidad_ibc.py.
Reglas PILA fuenteadas¶
Ruta: Nómina BPS → PILA → Reglas PILA fuenteadas.
Para qué sirve: Regla condicional fuenteada del layout PILA.
Ejemplo explicado: Lee la condición y fuente de una regla que bloquea el candidato; corrige el dato origen en lugar de desactivar la regla.
Entrada y pasos:
- Abra la ruta y verifique Reglas PILA fuenteadas. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Version layout | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Tipo de archivo | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Tipo de registro | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Campo objetivo | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Tipo de regla | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Campo condicion | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Operador | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Valor condicion | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Severidad | Obligatorio | Una advertencia informa al area de nomina en la prevalidacion local sin bloquear el TXT; nunca declara envio, aceptacion ni pago. |
| Estado fuente | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Activo | No marcado obligatorio en esta declaración | No marcar la casilla sin cumplir y demostrar su condición. |
| Valor requerido | No marcado obligatorio en esta declaración | Segun el tipo de regla: valor exacto, lista de valores permitidos, rango 'min,max' o lista de numeros de campo alternativos. |
| Campo de referencia | No marcado obligatorio en esta declaración | Solo para 'no menor que otro campo': numero del campo contra el que se compara el campo objetivo (p. ej. fecha inicio de la novedad). |
| Mensaje funcional | No marcado obligatorio en esta declaración | Mensaje en espanol para el area de nomina; si esta vacio se usa el mensaje generico del tipo de regla. Obligatorio para 'nota_si'. |
| Sugerencia de correccion | No marcado obligatorio en esta declaración | Solo cuando es seguro sugerirla; el reporte de prevalidacion la muestra junto al error para el usuario no tecnico. |
| Fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| URL fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Pagina/seccion fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Descripcion | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_layout_regla. - Acción:
bps_nomina_pila.action_bps_pila_layout_regla; modelobps.pila.layout.regla. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_layout.py.
Tipos de cotizante¶
Ruta: Nómina BPS → PILA → Tipos de cotizante.
Para qué sirve: Tipo de cotizante y unidad por subsistema.
Ejemplo explicado: Consulta el tipo del trabajador dependiente sintético y las reglas por subsistema antes de seleccionarlo en la ficha.
Entrada y pasos:
- Abra la ruta y verifique Tipos de cotizante. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- Revise los datos de la ficha. La presencia de un formulario no acredita permiso para crear/modificar: siga el flujo de la guía del proceso y la sesión autorizada.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Código de cotizante | Obligatorio | Código oficial del tipo de cotizante (p. ej. 01 dependiente, 51 tiempo parcial). NO es el código PILA del aporte. |
| Descripción | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Estado | Obligatorio | 'preparado' = la estructura existe pero el cálculo no está activado. 'activo_local' = el cálculo por unidad está activo y la planilla PILA LOCAL lo refleja, pero el TXT productivo y la validación con el operador siguen bloqueados. 'activo' = además la generación PILA ya no está pendiente. |
| Unidad salud | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Unidad pensión | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Unidad ARL | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Unidad CCF/parafiscales | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Planilla PILA pendiente (M08) | No marcado obligatorio en esta declaración | La GENERACIÓN de la planilla PILA (layout, validación, novedades) NO está construida: depende de M08 (PENDIENTE_M08). El código del tipo de cotizante (campo codigo) sí es oficial (Resolución 5094/2013). |
| TXT PILA productivo pendiente | Calculado / lectura | SIEMPRE pendiente: el archivo PILA productivo, su validación con el operador y el pago no dependen de este módulo. Que el tipo esté activo no habilita la exportación. |
| Aplica el tope mínimo de IBC (1 SMMLV) | No marcado obligatorio en esta declaración | Un dependiente de tiempo completo se ajusta al mínimo de 1 SMMLV. En la cotización por semanas ese ajuste NO se fuerza (Decreto 2616/2013): el trabajador labora menos de 30 días y su base es la del mecanismo de semanas, no un mínimo mensual completo. |
| Clave del IBC semanal | No marcado obligatorio en esta declaración | Clave de catálogo cuyo valor vigente es la FRACCIÓN del SMMLV que constituye el IBC de UNA semana. El valor NO se siembra: se parametriza con su fuente oficial y su vigencia. Sin ella, el régimen falla cerrado. |
| Clave del IBC mensual | No marcado obligatorio en esta declaración | Clave de catálogo cuyo valor vigente es la FRACCIÓN del SMMLV que constituye el IBC de un MES completo para los subsistemas cuya unidad es 'mes' (ARL en el tipo 51). El valor NO se siembra. |
| Fuente | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Auditor de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_ibc.menu_bps_tipo_cotizante. - Acción:
bps_nomina_ibc.action_bps_tipo_cotizante; modelobps.tipo.cotizante. - Fuentes del menú/acción: tipo_cotizante_views.xml, bps_nomina_app_menus.xml.
- Vistas: tipo_cotizante_views.xml.
- Datos: tipo_cotizante.py.
TXT PILA local no enviable¶
Ruta: Nómina BPS → PILA → TXT PILA local no enviable.
Para qué sirve: TXT PILA local no enviable.
Ejemplo explicado: Revisa estado local, hash y prevalidación del TXT. El rótulo NO ENVIABLE debe permanecer explícito; no cargarlo a MiPlanilla desde este encargo.
Entrada y pasos:
- Abra la ruta y verifique TXT PILA local no enviable. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Obligatorio en la traza; lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Planilla PILA | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Version layout | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Numero de lineas | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Longitud total | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Estado paquete operador | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Prevalidacion local | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Archivo tipo 1 | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Total detalles validados | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Total nomina validado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA256 contenido | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha prevalidacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA256 prevalidado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Perfil operador local | Calculado / lectura | Perfil de validacion local contra el que se prevalido el paquete. Un perfil pendiente NO sustituye la validacion real del operador. |
| Detalles tipo 2 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Linea archivo tipo 1 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Linea encabezado archivo tipo 2 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Contenido TXT local | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen paquete operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Advertencias paquete operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Reporte tecnico prevalidacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores prevalidacion | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores prevalidacion (detalle estructurado) | Calculado / lectura | Snapshot JSON con un registro por error: linea, tipo de registro, numero y nombre de campo, posiciones, valor encontrado, regla incumplida, fuente, estado de fuente, sugerencia y severidad. Insumo tecnico para revision y para el operador. |
| Advertencias prevalidacion | Calculado / lectura | Hallazgos que NO bloquean el TXT local pero que el area de nomina debe revisar antes de la carga manual (p. ej. dias en cero cuya exencion depende de obligaciones no verificables localmente). |
| Advertencias prevalidacion (detalle estructurado) | Calculado / lectura | Snapshot JSON de las advertencias con la misma estructura del detalle de errores (linea, campo, posiciones, valor, regla, fuente, sugerencia y severidad). |
| Resultados validacion operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Paquetes de prueba operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Valores encabezado tipo 2 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fuente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Candidatos UAT | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Prevalidar operador | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Prevalidar perfil MiPlanilla | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Generar adjunto NO ENVIABLE | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. |
| Generar paquete de prueba MiPlanilla | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Operador de nómina / Administrador BPS. Empaqueta el TXT validado con su reporte, resumen y checklist para la carga MANUAL en el operador. No envia, no acepta y no paga. |
| Ver resultados operador | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Aprobar candidato UAT MiPlanilla | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. Grupos declarados: Administrador BPS. Exige aprobacion humana con motivo y crea un TXT UAT manual; no habilita exportación productiva. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_archivo_local. - Acción:
bps_nomina_pila.action_bps_pila_archivo_local; modelobps.pila.archivo.local. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml, pila_candidato_uat_views.xml.
- Datos: pila_archivo_local.py, pila_candidato_uat.py, pila_paquete_operador.py.
Candidatos UAT MiPlanilla¶
Ruta: Nómina BPS → PILA → TXT PILA local no enviable → Candidatos UAT MiPlanilla.
Para qué sirve: Candidato UAT MiPlanilla gobernado.
Ejemplo explicado: Consulta el candidato y su evidencia; los controles de carga/respuesta manual pertenecen al PO y requieren evidencia externa real.
Entrada y pasos:
- Abra la ruta y verifique Candidatos UAT MiPlanilla. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Perfil operador | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| SHA256 TXT candidato | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Aprobado el | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha de carga manual | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha resultado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| TXT local fuente | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Paquete local MiPlanilla | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Lineas | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Detalles | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Total nomina campo 20 | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Longitud total | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| Terminador | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Aprobado por | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Motivo de aprobacion humana | Obligatorio en la traza; lectura | Contrastar con la fuente; no sobrescribir. |
| TXT candidato UAT | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Reporte de controles UAT | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Checklist de entrega UAT | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Responsable de carga | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA256 confirmado en la carga | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Evidencia de carga | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Soporte de carga manual | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resultado operador | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Resultado fuente | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Responsable resultado | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Respuesta original operador | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA256 respuesta original | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Estado formato respuesta | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Soporte resultado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores operador por linea/campo | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen parser existente | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle parser existente | Calculado / lectura | El candidato reutiliza el parser y el tope de detalle existentes; no duplica la respuesta original ni su evidencia estructurada. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Registrar carga manual UAT | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Operador de nómina / Administrador BPS. |
| Registrar respuesta del operador | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Operador de nómina / Administrador BPS. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_candidato_uat. - Acción:
bps_nomina_pila.action_bps_pila_candidato_uat; modelobps.pila.candidato.uat. - Fuentes del menú/acción: pila_candidato_uat_views.xml.
- Vistas: pila_candidato_uat_views.xml.
- Datos: pila_candidato_uat.py.
Generar paquete MiPlanilla¶
Ruta: Nómina BPS → PILA → TXT PILA local no enviable → Generar paquete MiPlanilla.
Para qué sirve: Seleccionar TXT validado y generar paquete MiPlanilla.
Ejemplo explicado: Selecciona un TXT previamente validado del caso y genera únicamente el paquete local; no lo cargues al operador ni registres aceptación.
Entrada y pasos:
- Abra la ruta anterior y revise el título Paquete de prueba MiPlanilla de la ventana.
- Compruebe compañía/alcance y complete los datos de entrada que se indican abajo. No sustituya referencias inexistentes por otras de un período distinto.
- Lea los controles declarados y las precondiciones de la guía del proceso antes de confirmar. Si corresponde a secretos, aprobación, pago o acción externa, deténgase.
- Solo después de una ejecución local autorizada, revise el resultado o bloqueo y conserve su identificador. En esta ficha ese resultado sigue sin ejecutar.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| TXT local validado | Obligatorio | Seleccionar la referencia correcta, no escribir un identificador inventado. |
| Compania | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Período | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| Prevalidacion local | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Perfil prevalidado | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA256 | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Generar paquete MiPlanilla | Revisar precondiciones y estado en la guía; no ejecutado por esta ficha. |
| Cancelar | Salir del asistente sin ejecutar su operación. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ventana de entrada con campos y alcance; B, resultado o bloqueo posterior con explicación. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_paquete_miplanilla_wizard. - Acción:
bps_nomina_pila.action_bps_pila_paquete_miplanilla_wizard; modelobps.pila.paquete.miplanilla.wizard. - Fuentes del menú/acción: pila_planilla_views.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_paquete_operador.py.
Paquetes de prueba operador PILA¶
Ruta: Nómina BPS → PILA → TXT PILA local no enviable → Paquetes de prueba operador PILA.
Para qué sirve: Paquete de prueba manual para operador PILA.
Ejemplo explicado: Revisa archivo, manifiesto y evidencia del paquete. No registres una respuesta manual de aceptación que no existe.
Entrada y pasos:
- Abra la ruta y verifique Paquetes de prueba operador PILA. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- La vista declara creación desactivada: no use Nuevo, importación ni edición manual para fabricar una traza. Consulte el productor y sus precondiciones en la guía del proceso.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Periodo | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| TXT local validado | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Perfil operador | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Estado | Obligatorio en la traza; lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Generado el | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Fecha del resultado | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Compañía | Calculado / lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Referencia | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA256 del TXT empaquetado | Calculado / lectura | Hash del TXT local inmutable al momento de generar el paquete. La evidencia del operador debe registrar el hash del archivo probado; una diferencia bloquea el registro (no se prueba un archivo distinto). |
| Adjunto del paquete | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Generado por | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Evidencia del operador | Calculado / lectura | Resultado manual registrado en el flujo gobernado existente. El paquete solo lo refleja; la evidencia vive en la validacion. |
| Resultado registrado | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Responsable del registro | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Archivo respuesta MiPlanilla | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Nombre respuesta MiPlanilla | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| SHA256 respuesta MiPlanilla | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Formato respuesta MiPlanilla | Calculado / lectura | Valor de lectura: comprobar el estado o clasificación que dejó el proceso. |
| Resumen parser respuesta | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Detalle parser respuesta | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Soporte del operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores del operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Errores operador (detalle manual) | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen de entrega | Calculado / lectura | Aportante, periodo, conteos, sumatorias, hash y terminador del TXT empaquetado: lo que el humano contrasta al cargar manualmente. |
| Checklist de carga manual | Calculado / lectura | Pasos INTERNOS del proceso BPS para la entrega manual al operador. No son reglas del operador (sin ficha tecnica formal no se inventan). |
| Fuente / memoria | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
Controles que puede encontrar
Los siguientes textos están declarados en vistas del modelo, incluidas extensiones. Su presencia efectiva depende de la vista, rol y estado; no son una secuencia para pulsarlos todos.
| Control | Restricción / lectura segura |
|---|---|
| Registrar resultado manual del operador | No ejecutar en este encargo; PO o custodio autorizado, con evidencia real. Grupos declarados: Operador de nómina / Administrador BPS. Registra la evidencia manual del operador (soporte obligatorio). Tras el registro el paquete queda inmutable. |
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_paquete_operador. - Acción:
bps_nomina_pila.action_bps_pila_paquete_operador; modelobps.pila.paquete.operador. - Fuentes del menú/acción: pila_planilla_views.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_paquete_operador.py.
Validación operador PILA¶
Ruta: Nómina BPS → PILA → Validación operador PILA.
Para qué sirve: Resultado gobernado de validacion operador PILA.
Ejemplo explicado: Consulta reglas aprobadas/fallidas y su origen local o externo. Prevalidar con un perfil no equivale a recibir una respuesta real del operador.
Entrada y pasos:
- Abra la ruta y verifique Validación operador PILA. Revise filtros iniciales antes de concluir que falta un registro.
- Localice el caso por compañía, trabajador/período o clave/vigencia, según los campos disponibles. Abra el registro relacionado, no uno parecido de otra compañía.
- Revise los datos de la ficha. La presencia de un formulario no acredita permiso para crear/modificar: siga el flujo de la guía del proceso y la sesión autorizada.
- Contraste campos y evidencia de origen con el ejemplo. Use los controles de detalle solo cuando cumpla rol y estado; no interprete su existencia en el código como una ejecución realizada.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Fecha resultado | Obligatorio | Revisar etiqueta, formato y ejemplo antes de guardar. |
| TXT local | Obligatorio | Seleccionar la referencia correcta, no escribir un identificador inventado. |
| Planilla | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Perfil operador | Calculado / lectura | Operador al que corresponde la evidencia: particiona el resultado por TXT/hash/operador (dos operadores sobre el mismo TXT no comparten ni sobreescriben evidencia). Los registros historicos previos a la particion pueden no tenerlo; las evidencias nuevas lo persisten (por defecto, el perfil prevalidado del TXT). |
| Resultado | Obligatorio | Elegir una opción del catálogo de la pantalla. |
| Responsable | Obligatorio en la traza; lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| SHA256 archivo validado | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Formato respuesta MiPlanilla | Calculado / lectura | Estado honesto del formato de respuesta. Sin ficha formal MiPlanilla no se interpreta como aceptacion productiva. |
| Compania | Obligatorio en la traza; lectura | InfoCenter Ejemplo Colombia; no YourCompany ni compañía de otro caso. |
| Periodo | Calculado / lectura | Fecha coherente con el hecho o vigencia del registro. Caso mensual de agosto de 2026; use el último día solo si el asistente lo exige. |
| SHA256 respuesta operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Archivo respuesta MiPlanilla | Calculado / lectura | Referencia de lectura: comprobar su relación con el caso; no cambiarla aquí. |
| Nombre archivo respuesta | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Tamano respuesta operador | Calculado / lectura | Contrastar con la fuente; no sobrescribir. |
| Resumen parser respuesta | Calculado / lectura | Resumen local del parser configurable. Si falta ficha tecnica, deja el gate pendiente sin inventar formato MiPlanilla. |
| Detalle parser respuesta | Calculado / lectura | Snapshot JSON de filas interpretadas o errores de parser: linea de respuesta, linea/campo TXT si existen, codigo, mensaje, severidad y estado. Contrato del snapshot persistido: maximo 1000 filas fuente + 1 marcador estructurado de truncamiento con conteos (hasta 1001 entradas JSON al truncar); la clasificacion usa todas las filas y la respuesta original queda adjunta completa con su SHA256. No es aceptacion productiva ni respuesta oficial DIAN/operador. |
| Soporte operador | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Errores observados/rechazados | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
| Errores operador (detalle manual estructurado) | No marcado obligatorio en esta declaración | Detalle manual estructurado por linea/campo si el soporte del operador lo permite: lista JSON de objetos validada y acotada por el mismo tope tecnico del parser (maximo 1000 filas fuente + 1 marcador de truncamiento). No es parser oficial MiPlanilla: mientras no exista formato formal, conserva el gate PENDIENTE_FORMATO_RESPUESTA_MIPLANILLA. |
| Observaciones | No marcado obligatorio en esta declaración | Revisar etiqueta, formato y ejemplo antes de guardar. |
Acciones: no se encontró un botón propio de ejecución en las vistas BPS de esta consulta. No se inventa un botón de calcular/generar. La creación del artefacto puede depender de otro flujo o de una capacidad aún no operable por interfaz.
Resultado y recuperación: conserve la relación con el registro fuente y su período. Si la lista está vacía, quite solo filtros de búsqueda pertinentes y verifique que el productor realmente se ejecutó; no cree una fila para aparentar un resultado. Ante un bloqueo, lea la guía del proceso y los mensajes de bloqueo. Si falta permiso, el PO autentica al responsable: no ampliar roles. Estado de esta ficha: contenido de referencia; recorrido y resultado sin demostrar.
Dos capturas operativas para cerrar esta opción: A, ruta/listado con filtros y caso identificable; B, detalle del mismo registro con los campos relevantes. Pendientes de esta ruta y sesión. Las imágenes de apoyo o históricas no acreditan el cierre, ni lo hace una captura del InfoCenter.
Acceso declarado en el menú: Operador de nómina / Administrador BPS / Auditor de nómina No omitir restricciones de ancestros, ACL/reglas ni controles de método.
Referencia verificable de esta ficha
- Menú:
bps_nomina_pila.menu_bps_pila_validacion_operador. - Acción:
bps_nomina_pila.action_bps_pila_validacion_operador; modelobps.pila.validacion.operador. - Fuentes del menú/acción: pila_planilla_views.xml, bps_nomina_app_menus.xml.
- Vistas: pila_planilla_views.xml.
- Datos: pila_archivo_local.py.