Quiero gestionar prestaciones¶
Ampliación del corte 067ec7a… — parcial¶
Vistas contrastadas el 2026-09-13 en BPSPayrollE/dev-fase3, SHA 067ec7a21cf049451cd349ae473e872883f98e77. Además de las consultas históricas descritas abajo, Prestaciones → Prestaciones BPS incluye Planes de antigüedad y Extracciones de antigüedad. La vista del plan ofrece Generar extracción si está activo; la extracción ofrece Exportar CSV. No se ejecutaron estas acciones ni se verificó una exportación del caso.
Para revisar, comprobar compañía, trabajador, corte y plan fuenteado antes de generar; comparar la extracción con sus insumos, no editar el CSV para cuadrar. Operador, administrador y auditor ven el contenedor según grupos; la capacidad concreta de generar debe verificarse con la sesión autorizada, no se deduce del menú. Falta recorrido positivo y capturas actuales. Las imágenes y la ficha de agosto se conservan como historia, no como equivalencia visual demostrada.
Fuente: vistas de prestaciones del SHA. H-8 no impide revisar por separado estos planes y consultas.
Operar un plan de antigüedad sin inventar elegibilidad¶
Administrador: en Planes de antigüedad, revisar compañía, población cubierta, años completos mínimos positivos, vigencia y fuente de la política interna. Operador/administrador pueden generar la extracción según ACL; auditor consulta. Generar extracción usa el corte resuelto por el servicio y abre el resultado; verificar la fecha obtenida antes de usarlo, no presumir que el botón pregunta por un corte histórico.
Si la población está vacía, contiene archivados/ajenos o la población visible es menor que la declarada, el servicio bloquea en lugar de entregar una muestra parcial como población completa. Solicitar al dueño del plan la corrección justificada, no quitar trabajadores para conseguir un resultado verde. Un ingreso del 29 de febrero requiere política de aniversario en año no bisiesto; no se aproxima. Un corte duplicado no genera otra extracción.
Revisar total de empleados, elegibles, años completos y fuente; Exportar CSV entrega esos hechos para medición externa. No incluye fecha de ingreso protegida ni calcula la obligación actuarial NIC19. Las extracciones son inmutables. No se ejecutó el recorrido; faltan formulario, salida, archivo y recuperación con datos sintéticos. Modelo vigente.
Para qué sirve¶
Preparar y revisar prestaciones hacia recibo y NIE¶
Cambios contrastados: BPSPayrollE PR #14 (94ca2aaa, 7aae59dd, bc3d0f35) y PR #15 (6be61589, 6a468ddc). Son código fusionado en 067ec7a21cf049451cd349ae473e872883f98e77, no recorridos por interfaz ejecutados.
- Preparación RR. HH.: revisar la versión contractual vigente en el período de la prestación. Una modificación posterior del salario integral o régimen no debe sustituir la historia del corte. Provisión ahora consulta la fecha del acumulador, no solo la versión actual.
- Preparación administrativa: revisar vigencia, fuente no vacía, tipo numérico y valor positivo de los parámetros consumidos. Cálculo, provisión y vacaciones bloquean ante catálogo inválido; no asumir un valor por defecto.
- Revisión del origen: el productor desde preliquidaciones exige tramo completo, sin huecos/solapes y con conceptos y días trazables. Bases variables, fuentes parciales o novedades pueden requerir soporte adicional; no convertir una entrada técnica en evidencia productiva.
- Intereses: comprobar principal consignado, fecha y soporte, correspondencia de la prestación y ausencia de consumo duplicado. Prima proporcional: comprobar que retiro y período correspondan. La presencia de estos servicios no demuestra un botón operativo: falta verificar su entrada por interfaz con administrador.
- Recibo/NIE: cotejar por separado base, días, importe, tasa y referencias de prestación. No cambiar trazas inmutables ni usar el neto como única contraprueba. Ver revisión de FondoSP y prestaciones en NIE.
Errores concretos: PENDIENTE_BASE_PRESTACIONAL, PENDIENTE_DIAS_PRESTACIONES y PENDIENTE_HU055 requieren revisar fuentes; PENDIENTE_INTERESES_PREVIOS exige revisar consumo previo; PENDIENTE_RETENCION_PRESTACIONES y PENDIENTE_RETENCION_PRIMA_SEPARADA requieren depuración coherente, no presumir retención cero. Escalar al administrador/revisor con período y referencia, sin ejecutar una corrección sobre producto.
Faltan ruta productora demostrada, entrada/datos/acción/resultado y recuperación con capturas Odoo. Fuentes: puente del recibo, provisión por período.
Mantener acumuladores y cálculos técnicos de prestaciones sociales como parte del ciclo de nómina. La intención es ofrecer una base revisable, no reemplazar la validación de política laboral o la aprobación del responsable.
Ruta exacta¶
Vacaciones: saldo, programación y disfrute no son lo mismo¶
Contraste del modelo final en S, sin programación ni disfrute ejecutados. En Vacaciones (saldos) se consulta el origen; el nuevo servicio mantiene obligaciones Pendiente de programar → Programada → Cumplida. No se encontró en la vista revisada un botón que permita operar todo ese ciclo: no se indica al usuario ejecutar métodos técnicos.
- La causación genera la obligación continua cuando alcanza el mínimo fuenteado. Programarla exige rango válido, días hábiles suficientes y plazo, usando el catálogo de festivos. La solicitud nativa de Ausencias puede servir de vínculo; pertenecer a otro empleado bloquea.
- Para cumplir una obligación continua hacen falta agenda previa y movimiento real de disfrute suficiente, dentro del rango y plazo. Un movimiento sin agenda no cierra la obligación aunque sume los días; una solicitud aprobada tampoco demuestra por sí sola el disfrute registrado.
- Tras compensación no definitiva, el saldo restante por disfrutar genera su propia obligación. Mientras siga abierta, otra compensación bloquea; dividirla en varias operaciones no evita el control. Las condiciones se consumen del catálogo vigente, no de valores copiados de esta guía.
- RR. HH. prepara ausencia y soporte; operador/revisor cotejan saldo y movimiento; si la interfaz no expone la programación, se registra capacidad de interfaz pendiente, no un problema de autenticación ni un cierre ficticio.
Recuperación: revisar trabajador/saldo, agenda, días hábiles, fechas y fuente. Conservar una obligación vencida como pendiente; no editarla directamente ni borrar movimientos. Modelo vigente y predicado común de cumplimiento.
Comprobante de consignación e intereses¶
El origen de intereses exige evidencia de consignación revisada. El servicio valida cesantías positivas en COP, fecha, fondo vigente del trabajador, referencia y PDF íntegro; un texto renombrado no sirve. Preserva huella, fondo, fuente y responsable. El formato válido no certifica autenticidad ni transferencia.
La revisión la hace otro usuario Administrador BPS, distinto de quien registró el comprobante, con motivo que contraste trabajador/fondo/fecha/valor/referencia. Si el fondo cambió o la huella no coincide, se detiene la revisión. Solo el comprobante íntegro y revisado, asociado a esa cesantía y dentro del período, es consumible. No se revisó ni confirmó una consignación en esta entrega y no se inventará evidencia bancaria para desbloquear intereses. La ruta completa de registro/revisión por interfaz sigue sin demostrar; el modelo por servicio no equivale a un asistente disponible. Fuente.
Para ambos subrecorridos faltan capturas de entrada real, datos, acción, resultado y recuperación. Son dependencias propias, no efectos de H-8.
Menús de consulta¶
Aplicación: Nómina BPS → contenedor: Prestaciones → todo cuelga de Prestaciones BPS
| Lo que necesitas | Opción de menú |
|---|---|
| Ver el acumulador del empleado | Acumuladores |
| Revisar cesantías y sus intereses | Cesantías, Intereses de cesantías |
| Revisar la prima de servicios | Prima de servicios |
| Revisar el saldo de vacaciones | Vacaciones (saldos) |
| Entender un promedio variable | Promedios variables |
| Consultar provisiones | Provisiones |
Revise primero que el empleado, el contrato y los períodos estén correctos: una prestación toma sus insumos del historial laboral y de nómina, así que un dato mal cargado aguas arriba se ve aquí como un saldo raro.
Datos, formato y dependencias¶
| Dato | Formato/criterio | Dependencia |
|---|---|---|
| Empleado y contrato | Registro vigente de la compañía correcta | Empleados y contratos. |
| Periodo | Fechas de corte coherentes | Calendario de nómina. |
| Base/acumulado | Valor calculado desde conceptos/recibos trazables | Liquidación y novedades. |
| Soporte de excepción | Referencia o adjunto autorizado | Política laboral y revisión responsable. |
Información que debe estar lista¶
| Insumo | Por qué importa |
|---|---|
| Fechas contractuales | Determinan el periodo acumulable. |
| Conceptos y bases | Afectan el cálculo técnico y su explicación. |
| Novedades soportadas | Pueden modificar días, bases o elegibilidad. |
| Historial de recibos | Permite revisar cómo se construyó el acumulado. |
Resultado esperado¶
Un acumulado y una explicación técnica que se puedan vincular al empleado, periodo y bases utilizadas. Si hay un dato pendiente o una divergencia, debe aparecer como tal y no como valor “cerrado”.
Problemas frecuentes¶
| Síntoma | Causa probable | Recuperación |
|---|---|---|
| Acumulado inesperado | Fechas/contrato/novedades previas | Revise la cadena de insumos antes de corregir un importe. |
| Falta un concepto | Catálogo o condición no configurada | Solicite revisión de configuración y fuente autorizada. |
| No coincide con un cálculo externo | Corte, datos o regla distinta | Documente la diferencia y compárela con la fuente, no fuerce el valor. |
Límite importante¶
El cálculo técnico no reemplaza un criterio legal especial, una sentencia, una negociación colectiva o una excepción no configurada y fuenteada. Esos casos deben dejar evidencia y ser revisados por la función responsable.
Trabajo manual y cobertura¶
No hay envío a un tercero desde este frente. La persona responsable debe revisar los resultados extraordinarios, conservar la fuente de una excepción y decidir si requiere escalamiento laboral, contable o jurídico.
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 |