Quiero registrar tiempo o una novedad¶
Ficha de verificación
BPSNOMINA 1.0 · Verificada el 2026-08-17 · Código 4073760e (dev-fase3 de xdiegob/PayrollBPS) · Entorno: instancia limpia local sobre ese commit, sin datos de demostración · Rol: Operador de nómina + Officer de RR. HH. · Datos sintéticos · Capturadas las tres pantallas de entrada; no se ejecutó un ciclo de aprobación completo · Estado externo: no aplica.
Qué vas a lograr¶
Dejar registrados, con soporte y trazabilidad, los hechos del período que afectan la nómina: horas, ausencias, incapacidades y licencias.
Para qué sirve¶
El valor de una novedad no es aparecer en una lista: es quedar vinculada a un empleado, un período, un soporte y un estado revisable. La preliquidación consume esas trazas; lo que no esté registrado y confirmado, no se calcula.
Qué no hace¶
No emite ni valida la determinación médica, legal o administrativa que respalda una incapacidad o licencia. Esa fuente sigue siendo externa y competente.
Captura V1.0, canon anterior. La disposición varía con el rol. Los elementos del menú listados abajo corresponden al commit verificado.
Antes de empezar¶
| Necesita | Formato o criterio | Por qué |
|---|---|---|
| Rol Operador de nómina | Para registrar. Aprobar horas exige Supervisor operativo | Son capacidades deliberadamente separadas. |
| Empleado apto | Ver Crear un empleado y contrato | Una novedad sobre alguien no apto no llega al cálculo. |
| Fechas coherentes | Desde ≤ Hasta | El sistema calcula los días. |
| Tipo de novedad | Del catálogo con vigencia | La clasificación no se inventa en texto libre. |
| Soporte | Adjunto según política interna | Permite entender la causa en una revisión posterior. |
Ruta exacta¶
Nómina BPS → Tiempos y novedades
| Opción | Sirve para |
|---|---|
| Tiempos BPS | Contenedor de jornada y horas |
| Registro de horas | Registrar horas por empleado con flujo de aprobación |
| Valorización de horas | Ver cómo se valoriza cada hora |
| Periodos quincenales | Períodos de tiempo quincenales |
| Reglas de jornada · Categorías especiales · Autorizaciones de jornada | Gobierno de jornada |
| Cumplimiento mensual · Generar cumplimiento | Contraste mensual de jornada |
| Novedades BPS | Contenedor de novedades |
| Novedades | Registrar la novedad operativa por empleado |
| Tipos de novedad | Catálogo con vigencia |
| Incapacidades | Cálculo de incapacidades |
| Banderas de riesgo · Reglas de bandera | Alertas por novedades de salud |
Las tres puertas de entrada¶
Instancia limpia local, commit 4073760e, 1280 px, rol Operador de nómina, datos sintéticos. Registro de horas es por donde entran horas extra y recargos. La lista está vacía porque en esta instancia no se registraron horas: la imagen documenta la pantalla y sus columnas, no un período trabajado.
Misma instancia, commit y rol. Novedades recoge ausencias, licencias e incapacidades con su período y su soporte.
Misma instancia, commit y rol. Incapacidades no es una pantalla donde se escriba a mano: recoge los cálculos que derivan de una novedad de incapacidad ya registrada. Registre primero la novedad.
Registrar una novedad¶
Datos a ingresar¶
| Campo | Obligatoriedad | Formato / ejemplo | Efecto |
|---|---|---|---|
| Empleado | Requerido | Persona apta de la compañía | Define a quién afecta |
| Código de novedad | Requerido | Del catálogo vigente | Clasifica el hecho |
| Desde / Hasta | Requeridos | Fechas coherentes | De ellas se calcula el campo Días |
| Origen | Requerido, por defecto Manual | Manual o Time Off (ausencia) |
Indica si nació aquí o de una ausencia de Odoo |
| Es prórroga | Opcional | Casilla | Enlaza con la novedad de origen |
| Soportes | Según política | Adjuntos | Evidencia de la causa |
Días es un campo calculado: no se teclea.
Estados¶
| Estado | Significado |
|---|---|
| Borrador | Registrada, todavía editable |
| Confirmada | Vigente para el cálculo |
| Anulada | Sin efecto, conservada como traza |
Una novedad en borrador no es una novedad aplicada: confírmala.
Registrar horas¶
El registro de horas tiene su propio flujo, con más estados porque interviene una aprobación:
| Estado | Significado |
|---|---|
| Borrador | Registrado |
| Validado | Revisado |
| Aprobado | Aprobado por el supervisor |
| Rechazado | Devuelto, con motivo de rechazo |
| Liquidado | Ya consumido por la nómina |
| Bloqueado | Congelado |
El origen puede ser Manual, Asistencia o Planning. En los estados finales el registro queda congelado: sus datos ya no se editan.
Quien registra no aprueba
Aprobar y rechazar horas —incluso revertir una aprobación— es capacidad del rol Supervisor operativo de nómina, separada a propósito del Operador y del Administrador.
Resultado esperado¶
- Novedades del período en estado Confirmada, con soporte adjunto.
- Horas en estado Aprobado, listas para ser consumidas.
Cómo comprobarlo independientemente¶
Antes de preliquidar, revisa que no queden novedades en Borrador ni horas en Borrador/Validado para el período. Lo que no esté confirmado o aprobado no entra al cálculo, y después la preliquidación es inmutable.
Errores y recuperación¶
| Lo que ves | Causa probable | Qué revisar | Cómo recuperarte | Escalar a |
|---|---|---|---|---|
| Días distintos a los esperados | Fechas o tipo de novedad | Desde/Hasta y el código | Corrige el dato fuente; Días se recalcula solo | Operador de nómina |
| La novedad no llega al cálculo | Sigue en Borrador, o el período no coincide | Estado y fechas | Confírmala dentro del período correcto | Operador de nómina |
| No puedes editar unas horas | Están en estado congelado | El estado del registro | Si es incorrecto, el supervisor puede rechazar con motivo | Supervisor operativo |
| No puedes aprobar horas | Te falta el rol | Tu usuario | Solicita Supervisor operativo de nómina | Administrador de Nómina |
| El tipo de novedad no aparece | Sin vigencia para la fecha | Tipos de novedad | Pide la vigencia; no uses un código aproximado | Administrador de Nómina |
| Aparece una bandera de riesgo | Novedades de salud recurrentes | Banderas de riesgo | Es una alerta gobernada: la revisa Jurídico, que ve el efecto, nunca el diagnóstico | Jurídico laboral BPS |
Datos personales¶
Las banderas de riesgo exponen eventos y días, nunca diagnóstico ni datos clínicos. No escribas información médica en campos de texto libre ni en el chatter: adjunta el soporte donde corresponde y con el permiso adecuado.
Cobertura funcional y límites¶
La guía cubre el registro interno y su trazabilidad. La validez médica o legal del hecho que respalda una incapacidad o licencia es responsabilidad de la fuente competente.
Jornada semanal: capacidad no operable todavía
El commit verificado incorpora un modelo de agregación semanal de jornada, pero ningún rol tiene permiso de lectura sobre él, así que no es accesible desde la interfaz. Esta wiki no lo documenta como pantalla de usuario hasta que el carril de producto aclare si es intencional (uso interno) o una configuración pendiente.
Importaciones y cadena tiempo–IBC del corte vigente¶
Contenido contrastado en S (067ec7a21cf049451cd349ae473e872883f98e77), sin importación nueva ejecutada. El adaptador distingue archivo/API en horas y importación en novedades. Exige compañía, identidad externa del lote y de cada línea, período y empleado. Reenviar idéntica identidad/contenido devuelve el mismo lote; cambiar el contenido con la misma identidad produce REENVIO_INCOHERENTE. No es una corrección automática.
Responsabilidades: el administrador autorizado controla el origen y los lotes; el operador registra/revisa los hechos; el supervisor aprueba lo que corresponde. La existencia del servicio de importación no demuestra un asistente de carga: no se encontró una vista nueva del adaptador en el delta; no se instruye ejecutar Python ni una API como reemplazo del recorrido humano.
Antes de preliquidar, revisar que incapacidad y horas de trabajo no se solapen. La cadena exige contrato mínimo, tiempo valorizado y su declaración dentro del IBC del mismo período. Si aparece IBC_NO_DECLARA_TIEMPO_VALORIZADO, cotejar la declaración y las trazas consumidas, no sumar una cantidad manual para cuadrar. SOLAPE_INCAPACIDAD_REGISTRO_TIEMPO exige corregir el origen con responsable y motivo; un reenvío no anula las horas anteriores.
Para correcciones importadas, conservar identidad, hash y referencias; las originales deben anularse por su flujo autorizado antes de reemplazarlas cuando corresponda. El adaptador no las anula. No inventar una nueva identidad para duplicar trabajo que sigue vigente. Un lote recibido no prueba valorización, preliquidación ni pago.
La prueba histórica de jornada flexible no creó otro motor: el producto consume el calendario nativo. Los límites diarios pendientes de fuente siguen cerrados; una contraprueba de horas no convierte la categoría en disponible. Las afirmaciones de agosto sobre acceso al agregado semanal no se extrapolan sin verificación a S.
Capturas faltantes: registros con canal/origen, validación/aprobación, traza valorizada, IBC/declaración y error/recuperación del mismo caso. Fuentes: adaptador, cadena tiempo–IBC.
Guías relacionadas¶
- Antes: Crear un empleado y contrato
- Siguiente: Calcular y revisar una nómina