Quiero preparar un candidato PILA¶
Ruta vigente observada — septiembre, parcial¶
En 067ec7a21cf049451cd349ae473e872883f98e77, Operador UAT ve Nómina BPS → PILA → Consolidar planilla del período directamente bajo PILA. La tabla histórica de abajo conserva un nivel de agrupación anterior; para consolidar use la ruta directa. También se observaron Correcciones locales (Planilla N), Generar paquete MiPlanilla, Candidatos UAT MiPlanilla y catálogos fuenteados. No se ejecutó consolidación ni paquete nuevo.
Separar al administrador que prepara fuentes/perfiles, al operador que trabaja el período y al revisor que contrasta el resultado. Antes de consolidar, verificar insumos de seguridad social y período del mismo caso. PILA debe revisarse independientemente de H-8; no declarar que toda la guía está bloqueada por retención. Faltan sesión funcional reconectada, datos sintéticos preparados y capturas actuales. Imágenes V1.0: historia, sin equivalencia visual acreditada en este corte.
Para qué sirve¶
Revisar aproximaciones y exoneración del corte actual¶
Contraste de código, no planilla ejecutada: BPSPayrollE PR #8, commits 0313c166 y f8a89890, incorporados al corte 067ec7a21cf049451cd349ae473e872883f98e77.
- Antes de consolidar, el administrador prepara las trazas IBC/aportes del mismo trabajador, compañía y período. El revisor conserva sus importes originales.
- Al revisar la planilla local y el detalle tipo 2, distinguir IBC al peso superior de aportes al centenar superior por cotizante. Es comportamiento del transporte PILA: no redondear a mano ni sobrescribir la precisión de las trazas IBC originales. El total pensión/FSP se obtiene de los componentes ya aproximados, no redondeando un agregado distinto.
- Revisar la determinación de exoneración y su vínculo con el IBC. El campo 76 no se presume: solo informa S con determinación final. Si faltaba traza, el productor intenta resolverla desde el mismo IBC; si hay varias, bloquea por ambigüedad.
- Ante
PENDIENTE_DATO_PILA_DETALLE, leer el componente concreto: ausencia, importe inválido, determinación ambigua o IBC distinto. Escalar al administrador con referencia de período/traza; no escoger una determinación arbitraria ni editar el TXT para superar el control.
Evidencia pendiente: entrada y datos del asistente, resultado por cotizante, detalle tipo 2 con exoneración, contraprueba de importes y recuperación sintética. No se ha ejecutado este recorrido ni se afirma aceptación del operador. Fuente de implementación: detalle y aproximaciones.
Preparar, prevalidar y conservar evidencia local de una planilla/candidato PILA antes de cualquier interacción con MiPlanilla u otro operador. Su objetivo es detectar problemas temprano y preservar la respuesta del operador cuando exista.
Listado real de una base Development limpia. Las columnas muestran qué debe quedar identificado antes de crear un candidato; que no existan filas no significa que exista una aceptación de MiPlanilla.
Ruta exacta¶
Aplicación: Nómina BPS → contenedor: PILA
| Lo que necesitas | Opción de menú | Cómo se ejecuta |
|---|---|---|
| Consolidar la planilla del período | Planillas PILA técnicas > Consolidar planilla del período | Asistente |
| Ver las planillas consolidadas | Planillas PILA técnicas | Lista |
| Corregir localmente (Planilla N) | Planillas PILA técnicas > Correcciones locales (Planilla N) | Lista |
| Generar el paquete de prueba del operador | TXT PILA local no enviable > Generar paquete MiPlanilla | Asistente |
| Revisar candidatos de prueba | TXT PILA local no enviable > Candidatos UAT MiPlanilla | Lista |
| Revisar bases y aportes | Cálculos de IBC, Aportes salud y pensión, Aportes de ARL, Parafiscales (CCF, SENA, ICBF) | Listas |
| Gobernar el formato del operador | Perfiles operador PILA (local), Validación operador PILA | Listas |
| Consultar catálogos normativos | Tipos de cotizante, Layout PILA fuenteado, Reglas PILA fuenteadas, Catálogos PILA fuenteados | Listas |
El contenedor TXT PILA local no enviable se llama así a propósito: lo que produce es un archivo local y no un TXT presentable ante el operador.
Antes de empezar¶
| Requisito | Formato/criterio | Por qué |
|---|---|---|
| Periodo y compañía | Corte correcto y compañía dueña de la planilla | Evita mezclar obligaciones. |
| Empleados/recibos | Información revisada de la nómina | Es el origen de la propuesta PILA. |
| Perfil de operador | Perfil local con ficha/formatos confirmados | Gobierna la interpretación de evidencia recibida. |
| Soporte de corrección | Original, motivo y adjunto cuando aplique | Una corrección no debe quedar sin trazabilidad. |
Flujo local recomendado¶
Comprobar cobertura antes de consolidar o exportar¶
En S (067ec7a21cf049451cd349ae473e872883f98e77) el control compara las líneas efectivas con todos los recibos finalizados de la compañía y período, no solo con la lista de preliquidaciones de entrada. Si falta un trabajador, PILA_NO_CUBRE_RECIBO_DEL_PERIODO impide una planilla incompleta; PENDIENTE_RECIBO_PILA_OMITIDO comprueba además el detalle local y su versión antes de devolver incluso un TXT existente.
Operador/revisor: cotejar lista de trabajadores, recibos finalizados, preliquidaciones y detalles tipo 2. Si hay omisión, revisar su origen y corregir por el flujo autorizado antes de consolidar. No borrar un recibo finalizado ni crear una preliquidación ficticia; cualquier corrección del cierre requiere al responsable. La exclusión justificada de esa cobertura no tiene un flujo gobernado demostrado: una observación no levanta el bloqueo.
Contraste de ambos productores y sus llamadas; no planilla ni TXT generados. Capturas pendientes: trabajadores de origen, planilla/detalles, omisión y recuperación del mismo caso. Cobertura de planilla, archivo local.
Secuencia de revisión del candidato¶
- Cree o abra el paquete/candidato del periodo correcto.
- Ejecute la prevalidación local y lea cada línea/campo/posición reportado.
- Corrija datos fuente; no “maquille” el resultado de la validación.
- Para Planilla N o Tipo 51, use el preflight local y conserve planilla original, motivo y soporte.
- Si recibe una respuesta/acuse del operador, adjúntelo mediante el flujo gobernado; el hash, tamaño, formato y detalle se preservan.
- Revise el resumen de cobertura AT2 y los gates pendientes antes de presentar una carga manual real.
Resultado esperado¶
Debe quedar una evidencia local con compañía, periodo, adjunto original inmutable, hash y un detalle acotado/legible de errores o advertencias. Si el detalle es extenso, se conserva el archivo original y el resumen indica cuándo se aplicó el límite técnico de persistencia.
Qué sí y qué no hace cada parte¶
| Opción/estado | Sí hace | No hace |
|---|---|---|
| Prevalidación local | Detecta reglas fuenteadas y pendientes conocidos | Certificar que el operador aceptará el archivo. |
| Candidato UAT MiPlanilla | Ordena los datos y evidencia para una prueba asistida | Enviar automáticamente ni aceptar en nombre del operador. |
| Respuesta de operador | Conserva acuse/archivo y su lectura configurada | Inventar un parser si falta ficha técnica. |
| Planilla N / Tipo 51 preflight | Prepara evidencia y bloqueos locales | Habilitar su operación externa productiva. |
Si algo falla¶
| Síntoma | Causa probable | Recuperación |
|---|---|---|
| Estado de formato pendiente | Falta ficha técnica o formato real del operador | Conserve la evidencia y solicite el formato/ficha; no clasifique por intuición. |
| Error por días/novedad | Dato de nómina o regla de prevalidación | Revise empleado, periodo, soporte y fuente del dato. |
| No deja preparar corrección | Falta referencia original/motivo/soporte | Complete la evidencia obligatoria, sin omitirla. |
| Respuesta muy grande | El detalle visual se acotó | Revise el adjunto original/hash y el marcador de truncamiento. |
Límite externo
Esta aplicación no declara TXT PILA productivo, envío, aceptación de MiPlanilla, pago PILA ni corrección externa productiva. La carga al portal, el resultado real del operador y el pago siguen siendo acciones manuales/autorizadas, con prueba UAT pendiente.
Cobertura normativa y trabajo pendiente¶
La base técnica y controles AT2 locales están documentados. Continúan pendientes la ficha técnica formal del operador, formato real de respuesta, carga UAT con MiPlanilla, Tipo 51/Planilla N externos y pago por el canal que corresponda.
Ficha de verificación¶
| Dato | Valor |
|---|---|
| Versión de la guía | V1.1 — texto reanclado; capturas todavía V1.0 |
| Fecha de verificación | 2026-08-10 |
| Código observado | 4b0f549dd72d6d61dd1eb181d165dbe48459480f |
| Rama | dev-fase3 de xdiegob/PayrollBPS |
| Entorno | Odoo.sh xdiegob-payrollbps, Development, build 36201289, Test: Success |
| Alcance verificado | Rutas de menú, roles que las ven y existencia de asistentes, por consulta de solo lectura |
| No verificado | Recorrido funcional con rol real y datos de nómina sembrados |
| Estado externo | No aplica: esta guía no afirma aceptación de ningún tercero |