Advance vacations (Adelanto)

Learn how employees can borrow days from a future vacation period when their current allocation is exhausted, and how this affects their balance.

Advance vacations (adelanto de vacaciones) allow an employee to borrow days from the period they have not yet earned. This is useful when an employee has used all 30 days in their current period but still needs time off before a new period opens.

How advance days are earned

The number of advance days an employee can request is not fixed — it grows over the course of the active period. The system accrues 2.5 days per completed calendar month elapsed since fechaInicioAnio.

advance days available = completed months since period start × 2.5
maximum = 30 days

This calculation is performed by calcularDiasAdelantoDisponiblesEnPeriodo in vacationUtils.ts. The sidebar in the Vacation Scheduling module shows the current accrued balance, how many advance days have already been used, and how many remain.

An employee 4 months into a period has accrued 10 advance days (4 × 2.5). An employee 12 months in has the maximum of 30.

How to request an advance

The Adelanto de Vacaciones card appears in the right-hand sidebar of the scheduling module whenever an employee is selected. It is rendered by the AdelantoVacaciones component.

1. Open the scheduling module

   Navigate to Vacation Scheduling and select the employee from the dropdown.

2. Review the advance balance

   The Adelanto de Vacaciones card shows three numbers: days available (accrued this period), days already used, and days remaining to borrow.

3. Enter the number of days

   Type the number of days you want to advance in the input field. The maximum is the employee’s remaining advance balance for the current month.

4. Click Solicitar Adelanto

   The system adds the requested days directly to the employee’s block day balance. No separate vacation range is created at this step — the days simply become available in the block pool to be scheduled normally.

What changes on the schedule

When an advance is requested, three fields on the CronogramaVacaciones record are updated immediately:

Field	Change
diasAdelanto	Increases by the number of days advanced
diasTotales	Increases beyond the standard 30 (e.g., 30 + 5 = 35)
diasBloqueDisponibles	Increases by the same amount, making the days available to schedule as block ranges

The HR administrator can then schedule the advance days as normal block ranges in the Vacation Scheduling module. Ranges created after an advance may carry esAdelanto: true to distinguish them from standard ranges.

Removing an advance range

If you delete a range that was created using advance days (esAdelanto: true), the system reverses the advance:

• diasAdelanto decreases by the number of days in that range (minimum 0).
• diasTotales decreases back toward 30. If diasAdelanto reaches 0, diasTotales is reset to exactly 30.
• The block day balance adjusts accordingly.

This rollback logic runs inside handleEliminarRango in RegistroVacaciones.tsx.

Advance days are borrowed from the next period. When the employee’s new vacation period opens, the advanced days will already be considered used. Plan advances carefully — an employee who borrows 10 days in year one will start year two with only 20 available days until those are replenished by the accrual formula.

Use case

An employee’s "2025-2026" period runs from 1 June 2025 to 31 May 2026. By November 2025 they have used all 30 days. They need 5 additional days off in December.

By November, the employee has been in the period for 5 months, accruing 12.5 advance days (5 × 2.5). They request a 5-day advance. The system:

1. Sets diasAdelanto to 5.
2. Sets diasTotales to 35.
3. Increases diasBloqueDisponibles by 5.

The HR administrator can then schedule a 5-day block range in December marked with esAdelanto: true. When the "2026-2027" period opens, those 5 days will be reflected in the new period’s starting balance.