> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/CKoldo/Vacaciones-front/llms.txt
> Use this file to discover all available pages before exploring further.

# Vacation Overview

> View a full summary of vacation usage for any employee, broken down by period, with export options to Excel and PDF.

The Vacation Overview module gives you a read-only summary of how an employee's vacation days have been allocated and used. Use it to check remaining balances, review scheduled ranges, and export reports for record-keeping or approval workflows.

Navigate to this module at `/visualizacion-vacaciones`.

## Selecting an employee

Use the **Seleccionar Personal** dropdown to choose an employee. The page loads all vacation schedules associated with that employee and displays each period as a separate card below.

<Note>
  If an employee has no schedules yet, an empty state is shown. Go to [Vacation Scheduling](/modules/vacation-scheduling) to create a schedule first.
</Note>

## Schedule status

Each vacation period card displays a status badge in the top-right corner:

| Status        | Meaning                                            |
| ------------- | -------------------------------------------------- |
| **Pendiente** | The schedule has been created but not yet reviewed |
| **Aprobado**  | The schedule has been approved                     |
| **Rechazado** | The schedule has been rejected                     |

## Day counters per period

Each period card shows five summary tiles at the top:

| Tile                 | What it shows                                     |
| -------------------- | ------------------------------------------------- |
| **Días Flexibles**   | Flexible days remaining / total available (max 7) |
| **Días en Bloque**   | Block days remaining / total available (max 23)   |
| **Total Disponible** | All remaining days not yet scheduled              |
| **Días Adelanto**    | Days borrowed via the advance vacation feature    |
| **Programado %**     | Percentage of the 30-day period already scheduled |

<Info>
  If an employee still has days available (Total Disponible > 0), a yellow alert banner appears below the counters reminding you that those days have not yet been programmed.
</Info>

## Scheduled ranges table

Below the summary tiles, a table lists all active vacation ranges for that period. Each row shows:

* **ID** — the internal range identifier
* **Periodo** — the formatted date range (e.g. `15/06/2025 - 22/06/2025`)
* **Días** — number of days in the range
* **Tipo** — `Flexible` or `Bloque`
* **Incluye Fin de Semana** — whether the range spans a weekend due to the Friday rule
* **Adelanto** — whether the range was created as an advance vacation
* **Vinculado Desde (IDs)** — IDs of the original ranges this range was rescheduled from (if applicable)

## Rescheduling history

If any ranges in the period have been rescheduled, a second table — **Historial de Reprogramaciones** — appears below the active ranges. These rows are shown at reduced opacity to indicate they are archived. They display the original date range, days, type, and the ID of the range that replaced them.

## Exporting reports

You can export vacation data in two formats: Excel (XLSX) and PDF.

<Tabs>
  <Tab title="Export for one employee">
    When an employee is selected, two buttons appear in the employee selector card header:

    * **Excel** — downloads a `.xlsx` file with full details for that employee across all periods, including scheduled ranges and rescheduling history.
    * **PDF** — downloads a `.pdf` report with the same information formatted for printing or sharing.

    The file name format is: `Vacaciones_<Nombre>_<Apellido>_<date>`.
  </Tab>

  <Tab title="Export all employees">
    In the page header, two global export buttons are always visible:

    * **Excel Todo** — exports all employees in a flat table format: one row per vacation range, with columns for employee ID, email, range ID, status, dates, days, type, advance flag, and rescheduling link.
    * **PDF Todo** — generates a multi-page PDF with one section per employee.

    The file name format is: `Vacaciones_Todo_Personal_<date>`.
  </Tab>
</Tabs>

<Tip>
  Use the per-employee Excel export when preparing individual reports for approval. Use the all-employees export when generating payroll summaries or compliance audits.
</Tip>

## Declaration template (Plantilla Declaración)

The app includes a PDF declaration template editor accessible at `/plantilla-declaracion`. It lets you customize the layout of a *Declaración Jurada* — the official sworn declaration document attached to vacation records.

Configurable elements include:

* **Title** text, font size, and vertical position
* **Employee info** section: toggle name, position, and email on or off, and adjust each field's vertical position
* **Content** font size and vertical position
* **Date and signature** block: toggle display and adjust positions
* **Signature text** label

Click **Guardar Plantilla** to save the template to browser storage, **Vista Previa** to open a live PDF preview, or **Restaurar Valores por Defecto** to reset to the default layout.

<Note>
  The template configuration is saved in browser localStorage under the key `dj_template`. It persists across sessions in the same browser.
</Note>

## Related modules

<CardGroup>
  <Card title="Vacation Scheduling" icon="calendar-plus" href="/modules/vacation-scheduling">
    Add or remove vacation ranges for an employee.
  </Card>

  <Card title="Rescheduling" icon="refresh-ccw" href="/modules/rescheduling">
    Move existing ranges to new dates.
  </Card>

  <Card title="Administration" icon="settings" href="/modules/administration">
    Assign ESINAD document IDs to vacation records.
  </Card>
</CardGroup>