Ir al contenido principal

¿Cómo uso el módulo "Gestión de Modificaciones"?

Manual de Usuario

 — Gestión de Modificaciones de Licencias

Sección: Gestión de Licencias > Gestión de ModificacionesModifcaciones
Versión: 1.2.0 — Agosto 2026

1. Introducción

La sección Gestión de Modificaciones permite realizar dos operaciones sobre licencias de empleado:

Operación Descripción
Modificación Cambiar las fechas de una licencia existente (mover días a otro período), o devolver días a cuenta corriente
Dejar sin efecto Cancelar parcialmente (o totalmente) una licencia: algunos días se cancelan y otros se mantienen vigentes (Dejar sin efecto puede ser parcial o total)

¿Qué cambia cuando modifico una licencia?

AmbasEXPLICAR operacionesDE generanMEJOR unFORMA registroY AÑADIR FLUJO VISUAL.

Cuando se modifica una licencia, el sistema:

  1. Revée todos los consumos originales (los días que la licencia original había descontado de la cuenta corriente del empleado se devuelven).
  2. Crea licencias nuevas en Intranet y Mapuche con las fechas indicadas. Estas nuevas licencias vuelven a descontar días de la cuenta corriente, pero con el nuevo rango de fechas.
  3. Elimina la licencia original sincronizada.
  4. Registra la operación en el historial quecon puedeun consultarsedetalle ede imprimirsequé comose PDF.modificó, qué se mantuvo y qué se devolvió.

En resumen: toda modificación es un ciclo de "revertir → recrear → re-sincronizar". El sistema nunca edita una licencia existente: la destruye y crea una nueva con los datos actualizados.

2. Acceso y pantalla principal

Ruta: GestiónDashboard de> Licencias > Gestión de Modificaciones

Al ingresar se muestra el listado de modificaciones registradas, con filtros y paginación.

[Pantalla principal - Menú desplegado]image.pngimage.png

Componentes de la pantalla

Zona Descripción
Botones de acción "Añadir Modificación" (azul) y "Dejar sin efecto" (outline con ícono de prohibir)
Filtros Legajo, Apellido y Nombre, Tipo de Licencia, Devolución (Todas / Con devolución / Sin devolución)
Listado Acordeón con cada modificación registrada
Paginación Control de páginas y cantidad de filas por página (10, 20, 50, 100)

3. Flujo: Modificación de Licencia

3.1. Abrir el formulario

Hacé clic en el botón "Añadir Modificación" (ícono +). Se abre un diálogo modal con el formulario.

image.png

3.2. Ingresar número de solicitud

Completá el campo "N° Solicitud de Licencia" con el número de la licencia a modificar. Al ingresar el número, el sistema carga automáticamenteticamente:

los
  • Los datos del empleado (nombre, legajo)
  • El período y la cantidad de días de la licencia.

    licencia
  • Los días ya usufructuados (consumidos)
  • Los feriados locales del empleado para ese período
  • Todos los días hábiles del período se cargan automáticamente como bloques de modificación con sus fechas originales

image.pngimage.png

Importante: al cargar la licencia, todos los días hábiles aparecen como bloques en estado original (sin cambios). No se modificó nada todavía. Solo necesitás indicar qué días querés mover o devolver.

3.3. Información de la licencia

Una vez cargada, se muestra una tarjeta con los datos del empleado y la licencia:

  • Empleado y Legajo
  • Período (fecha desde — fecha hasta)
  • Días solicitados
  • Tipo de licencia (en color indigo)

Estados especiales

El sistema puede mostrar alertas según el estado de la licencia:

ajustes
Alerta Color Significado ¿Qué hacer?
LicenciaDías bloqueadausufructuados Rojo La licencia yatiene fue usufructuada en su totalidad. No se permiten modificaciones a menosdías que seya hagafueron consumidos por el empleado. Estos días están protegidos por defecto.Hacé clic en "Desbloquear". si necesitás mover o devolver esos días también.
LicenciaDías desbloqueadausufructuados desbloqueados Ámbar Se desbloqueó manualmente. LaLos modificacióndías procederáusufructuados peroahora puedeson generarmodificables. Verificá enlos ladatos cuentaantes corriente.de guardar.
Días vencidos Ámbar La licencia consumió días con período vencido. Informativo. Ninguna acción requerida.
Licencia no sincronizada Rojo La licencia no está sincronizada con Mapuche. DebeNo sincronizarlase puede modificar.Sincronizá la licencia primero antesdesde la sección de modificarla.licencias. El botón "Guardar" queda deshabilitado.

Nota sobre el desbloqueo: el botón "Desbloquear" aparece siempre que haya días usufructuados, no solo cuando la licencia está 100% consumida. Esto permite trabajar con licencias parcialmente usufructuadas.

image.pngimage.png

3.3.4. SeleccionarEl díascalendario eny los bloques

Cómo funciona el calendario

El calendario muestra todos los días del período de la licencia. Todos los días hábiles ya están pre-cargados como bloques con sus fechas originales. Cada día tiene un color según su estado:

unbloque)
Color Significado ¿Se puede seleccionar?
Verde Día modificable (sin usufructuar) Sí
Rosa Día usufructuado (ya consumido) No (a menos que se desbloquee)
Ámbar Sin parte diario Sí
Púrpura Feriado No
Gris Fin de semana No
Azul Ya seleccionadoincluido en un bloque modificado No (ya estáfue enmovido)
CyanDía marcado para devoluciónNo (ya fue marcado)

El color del Cómoborde seleccionarexterior de las celdas indica el modo de selección activo: borde azul si estás en modo Modificación, borde cyan si estás en modo Devolución.

Los bloques: la unidad de trabajo

Un bloque es un rango contiguo de días:

as
    hábiles.
  1. HacéAl cliccargar enla licencia, el día de inicio (verde o ámbar). Aparece un mensaje azul: "Inicio: {fecha} — seleccioná el día de fin".
  2. Hacé clic en el día de fin. Sesistema crea automáticamente un bloque conpor todoscada losgrupo de días hábiles contiguos del rango.
    3. período.

Se pueden crear múltiplesEstos bloques repitiendoaparecen el proceso.

image.png

3.4. Bloques de modificación y resumen

Enen el panel lateral derecho se muestran:derecho.

DíasCada usufructuadosbloque puede estar en uno de tres estados:

(siexisten):bloquesrosa mover.
EstadoColor del bordeIconoSignificado
Sin cambiosGris✅El bloque mantiene sus fechas originales. Al guardar, se re-sincroniza sin cambios.
ModificaciónAzul✏️El bloque tiene nuevas fechas. Al guardar, se crea una licencia nueva con candado,estas indicandofechas.
A devolverCyan🗑️El bloque será cancelado. Al guardar, los días que ya se consumierondevuelven ya nola secuenta puedencorriente.

image.png

Bloques

3.5. Modificar fechas de modificación:un cadabloque

Para mover un bloque seleccionadoa otras fechas:

  1. En el panel lateral, localizá el bloque que querés modificar (aparece con:

    como
      "Sin
    • Rangocambios" decon fechasborde seleccionadogris).
    • CamposEn editables:los campos "Nuevo desde" y "Nuevo hasta", (paraelegí moverlas nuevas fechas.
    • El sistema recalcula automáticamente los días hábiles del bloque.

Auto-completado de fechas: cuando cambias el "Nuevo desde", el sistema calcula automáticamente el "Nuevo hasta" basándose en la cantidad de días hábiles del bloque original. Solo tenés que ajustar si necesitás un rango diferente.

Exclusión de feriados: el cálculo automático de fechas excluye feriados locales del empleado. Si el nuevo rango incluye un feriado, ese día se salta automáticamente.

Al modificar las fechas de un bloque:

  • El bloque cambia de estado "Sin cambios" a otro"Modificación" período)(borde azul).
  • BotónEl Xcalendario muestra el rango nuevo en azul.
  • La columna "A modificar" del resumen se actualiza.

3.6. Devolver días a cuenta corriente

Existen dos formas de marcar un bloque para eliminardevolución:

Desde el bloque existente:

  1. En el panel lateral, localizá el bloque que querés devolver.
  2. Hacé clic en el ícono 🗑️ (papelera) que aparece en la esquina superior derecha del bloque.
  3. El bloque se mueve a la sección "A devolver" (color cyan).

Desde el calendario (modo Devolución):

  1. Activá el modo "Devolución" usando el toggle en la parte superior del panel lateral.
  2. Seleccioná un rango de días en el calendario (clic inicio → clic fin).
  3. El nuevo bloque se crea directamente como "A devolver".

¿Qué pasa al devolver días? Al guardar, el sistema revée el consumo original de esos días (los devuelve a la cuenta corriente del empleado) pero no crea licencia nueva para ellos. Simplemente desaparecen como licencia.

Restaurar: si marcaste un bloque para devolución y te arrepentís, hacé clic en el ícono ↩️ (restaurar) del bloque cyan. Vuelve a la sección "Sin cambios" con sus fechas originales.

3.7. Secciones del panel lateral

El panel lateral se organiza en las siguientes secciones:

SecciónDescripción
Días usufructuadosBloques rosa con candado. Días que ya fueron consumidos y no se pueden modificar (a menos que se desbloquee).
Toggle Modificación / DevoluciónSelector de modo para elegir qué hacer al seleccionar días en el calendario.
ModificadosBloques cuyas fechas cambiaron. Muestra fechas originales y nuevas. Tiene botón 🗑️ para devolver y botón ✕ para eliminar.
A devolverBloques marcados para cancelación. Color cyan. Tiene botón ↩️ para restaurar.
Sin cambiosBloques que mantienen sus fechas originales. Color gris con ✅.
ResumenPanel de 3 columnas: A modificar (azul) · Sin cambios (gris) · A devolver (cyan).

Nota: las secciones "Modificados", "A devolver" y "Sin cambios" solo aparecen si tienen al menos un bloque.

3.8. Resumen de modificación:

El panel conde 3resumen muestra tres columnas:

Columna Color Significado
A MODIFICAR Azul Cantidad de díDías que se están moviendo a nuevas fechas
USUFRUCTUADOSSIN CAMBIOS RosaDías que quedan consumidos (sin cambio)
DEVUELTOSÁmbarGris Días que se mantienen con fechas originales (se re-sincronizan sin cambios)
A DEVOLVERCyanDías que se cancelan y devuelven a la cuenta corriente (se liberan)

image.pngDebajo se muestra el total de días hábiles del período original.

Validación: la suma de las tres columnas debe ser igual al total de días hábiles del período. Si modificás o devolvés algún bloque, verificá que los números se mantengan consistentes.

3.5.9. Observaciones y guardado

  1. (Opcional) Completá el campo "Observaciones".
  2. Revisá el resumen: verificá que las cantidades de días sean correctas.
  3. Hacé clic en "Guardar".

Se muestra un mensajetoast de éxito: "Guardado con éxito". El diálogo se cierra y el listado se actualiza automáticamente.

3.10. ¿Qué ocurre en el sistema?sistema al guardar?

El proceso es el siguiente, en orden:

Paso 1 — Revertir consumos originales

El sistema busca todas las licencias vinculadas a la solicitud original (en la tabla licenciaEmpleado y detalleLicenciasEspecialesOtorgadas). Para cada registro de consumo encontrado:

  • SeElimina creanel nuevasregistro licenciasde endetalle Intranet(el vínculo entre la licencia y Mapuchela concuenta las fechas modificadas.corriente).
  • Se eliminan las licencias originales Sincronizadas.
  • Se devuelvenDevuelve los días que no fueron seleccionadosdescontados a la cuenta corriente del empleado (silicencias_especiales_otorgadas.dias_disponibles se incrementa).

Si la licencia original no estabantenía usufructuados)consumos

  • registrados pero tenía días solicitados (y es tipo feria), se crea un registro provisional de cuenta corriente para que la sincronización posterior pueda descontar de él.

    Vencidos: si un registro de cuenta corriente ya estaba vencido (su disponible_durante era anterior a hoy), se le restaura temporalmente para permitir el consumo, y luego se revierte.

    Paso 2 — Crear licencias nuevas (por cada bloque)

    Tipo de bloque¿Qué se crea?
    Modificado (fechas cambiadas)Se crea un pedido en Intranet con las nuevas fechas, se sincroniza con Mapuche, y se genera la licencia nueva con su descuento en cuenta corriente.
    Sin cambios (fechas originales)Se crea un pedido en Intranet con las fechas originales, se sincroniza con Mapuche. Esencialmente, se recrea la licencia original exactamente igual.
    A devolver (cancelado)No se crea nada. Los días simplemente quedan devueltos a la cuenta corriente.

    ¿Por qué se re-crean los bloques sin cambios? Porque la licencia original se elimina en el paso 3. Para que los días no modificados sigan existiendo como licencia vigente, se deben recrear con sus fechas originales.

    Paso 3 — Eliminar la licencia original

    Se marca como eliminada (baja lógica) la licencia original en Intranet.

    Paso 4 — Registrar devoluciones netas a cuenta corriente

    El sistema calcula la devolución neta (días devueltos menos días consumidos por las nuevas licencias) y la registra laen modificaciónHistoricoDevolucionCuentaCorriente. Solo se registra si hay días netos a devolver.

    Paso 5 — Registrar en el historial

    con

    Se loscrea resultadosun yregistro devoluciones.en HistoricoModificacionLicencia con:

    • Referencia a la licencia original
    • Referencia al interviniente (quien realizó la modificación)
    • Motivo/observaciones

    ObservacionesPara cada licencia nueva creada, se registra un resultado en LicenciaModificacionResultado:

    • Si"MODIFICACIÓN" unapara licencialicencias con fechas nuevas
    • no"Dejada poseesin efecto" para días usufructuadoscancelados y(si aplica)

    Paso 6 — Rollback (si hay error)

    Si ocurre cualquier error durante el calendario muestra todos sus días de color ámbar (suele ser el caso de empleados que no deben fichar) Se deben seleccionar las fechas de color ámbar y asignarle las fechas correspondientes sinoproceso, el sistema interpretaráejecuta estoun comorollback unacompleto:

    devolución
    • Elimina (baja lógica) todos los pedidos de Intranet creados
    • Revierte los registros de Mapuche generados por la sincronización
    • Restaura los días.as descontados en la cuenta corriente
    • Restaura el disponible_durante original de los registros vencidos

    La operación es atómica: o se completa al 100% o se revierte todo. No quedan estados intermedios.

    4. Flujo: Dejar sin Efecto (Parcial)

    4.1. Abrir el formulario

    Hacé clic en el botón "Dejar sin efecto" (ícono de prohibir). Se abre un diálogo modal.

    La descripción del diálogo indica: "Seleccioná en el calendario los días a dejar sin efecto. Los días no seleccionados se mantendrán como licencia vigente."

    4.2. Ingresar número de solicitud

    Igual que en modificación: completá el campo "N° Solicitud de Licencia" y esperá a que se carguen los datos.

    image.pngimage.png

    4.3. Información de la licencia

    Se muestra la misma tarjeta de información que en modificación (empleado, período, días, tipo). Aplican las mismas restricciones:

    • Si la licencia no está sincronizada (migrado = false): se muestra un banner rojo y el botón de confirmar queda deshabilitado. Primero debe sincronizarse la licencia.
    • Si la licencia estátiene totalmentedías usufructuadausufructuados: se bloquea la selección de días.as usufructuados (salvo que se desbloquee).

    📸 [Screenshot: tarjeta de info + banner "Licencia no sincronizada" si aplica]

    4.3.4. Seleccionar días a cancelar

    La mecánica del calendario es igual a la modificación:

    1. Hacé clic en el día de inicio del rango a cancelar.
    2. Hacé clic en el día de fin.

    Los bloques creados aparecen en el panel lateral como "A cancelar" con color rosa y son readonly (no se pueden editar fechas ni eliminar con X).

    Puedes seleccionar múltiples rangos si los días a cancelar no son contiguos.

    📸 [Screenshot: calendario con días seleccionados para cancelar, panel lateral con bloques "A cancelar"]image.png

    4.4.5. Resumen de dejada sin efecto

    El panel muestra el "Resumen de dejada sin efecto" con 2 columnas:

    Columna Color Significado
    A CANCELAR Rosa Días que se van a cancelar (se devuelven a cuenta corriente)
    SE MANTIENEN Verde Días que quedan como licencia vigente

    Debajo se muestra el total de días hábiles del período.

    📸 [Screenshot: resumen de dejada sin efecto con las 2 columnas]

    4.5.6. Confirmar

    Hacé clic en el botón rojo "Confirmar — Dejar sin efecto".

    Se muestra un toast de éxito con el resultado:

    "Licencia dejada sin efecto. X días devueltos, Y días mantenidos."

    El diálogo se cierra y el listado se actualiza.

    📸 [Screenshot: toast de éxito con el resultado de días devueltos y mantenidos]

    ¿Qué ocurre en el sistema?

    Días cancelados (devueltos)

    • Se revierten los consumos de laesos licencia originaldías en la cuenta corriente.
      • corriente
    • Se crean nuevas licencias para (los días quevuelven a estar disponibles).
    • No se mantienen.
    • Se elimina lacrea licencia original.nueva para esos días.
    • Se registra en el historial:resultado
      • Resultadocomo "Dejada sin efecto" paraen el historial.

      Días que se mantienen

      • Se revierten los díasconsumos cancelados.originales de toda la licencia.
      • ResultadoSe "MODIFICACIÓN"crean licencias nuevas paracon las fechas originales de los días que se mantienen (con su nueva licencia asociada)re-sincronización).
    • Se registra lael devoluciónresultado decomo días"MODIFICACIÓN" en el historial con referencia a la cuentanueva corriente.licencia.

    Licencia original

    • Se elimina (baja lógica) la licencia original.

    En resumen: la "dejada sin efecto parcial" es una modificación donde los días cancelados no reciben reemplazo, y los días que se mantienen se re-crean con sus fechas originales.

    5. Historial de Modificaciones

    5.1. Listado (acordeón)

    Cada modificación registrada aparece como un elemento del acordeón con:

    • ID de la modificación (badge)
    • Nombre del empleado y legajo
    • Tipo de licencia
    • Rango de fechas de la licencia original
    • N° de pedido original de Intranet
    • Fecha de modificación (derecha)

    Hacé clic en un registro para expandirlo y ver el detalle.

    📸 [Screenshot: acordeón con varios registros, uno expandido]

    5.2. Detalle expandido

    Al expandir un registro se muestra:

    Panel de información:

    • Interviniente (quien realizó la modificación)
    • Empleado
    • N° Pedido Intranet original
    • Fecha de modificación
    • Motivo (si existe)

    Tabla "Licencias generadas":

    Columna Descripción
    Tipo Badge con el tipo de resultado: MODIFICACIÓN (azul), USUFRUCTUADO (gris), o Dejada sin efecto (rojo)
    Licencia Descripción del tipo de licencia
    Desde / Hasta Rango de fechas de la licencia generada
    Empleado Nombre del empleado
    ID Intranet Número de pedido en Intranet

    Tabla "Devolución de días":

    Columna Descripción
    ID ID del registro de devolución
    Período Período de la licencia especial (ej: "2024 1")
    Tipo Si es de verano o invierno
    Días Devueltos Cantidad de días devueltos (en verde)

    Si no hubo devolución, se muestra: "No hubo devolución de días a cuenta corriente."

    image.png

    Botón "Imprimir Detalle": genera un PDF con todos los datos de la modificación y lo abre en una nueva pestaña.

    📸El [Screenshot:archivo detallese expandidorevoca conautomáticamente tablasdespués de licencias60 generadas y devolución de días]segundos.

    6. Leyenda de colores del calendario

    Color Celda Significado
    Verde (emerald) Día modificable Día hábil disponible para seleccionar
    Rosa (rose) Día usufructuado Día que ya fue consumido por el empleado
    Ámbar (amber) Sin parte diario Día sin registro en el parte diario
    Púrpura (purple) Feriado Día feriado local
    Azul (blue) Seleccionado / Modificado Día incluido en un bloque de modificación
    Cyan (cyan)DevoluciónDía marcado para devolución a cuenta corriente
    Gris (zinc) Fin de semana Sábado o domingo

    7. Estados y restricciones

    Estado Restricción Acción requerida
    No sincronizada (migrado = false) No se puede modificar ni dejar sin efecto Sincronizar la licencia desde la sección de licencias
    BloqueadaCon días usufructuados (totalmente usufructuada) No se pueden seleccionarLos días consumidos están protegidos por defecto Hacer clic en "Desbloquear" para forzar la modificación de esos días
    Días vencidos Informativo, no bloquea Ninguna (el sistema informa pero permite continuar)
    • Volver arriba