Tiempo y asistencia
Tiempo de trabajo, permisos, horarios y días festivos — registra y lee asistencia programáticamente.
Esta referencia se genera a partir del esquema de la API. Las descripciones de los campos y cualquier texto aún sin traducir se muestran en inglés.
Tiempo de Trabajo
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /employee-working-hours | Recupera la colección de recursos WorkTime. |
| POST | /employee-working-hours | Crea un recurso WorkTime. |
| GET | /employee-working-hours/{id} | Recupera un recurso WorkTime. |
| PATCH | /employee-working-hours/{id} | Actualiza el recurso WorkTime. |
| DELETE | /employee-working-hours/{id} | Elimina el recurso WorkTime. |
| GET | /work-times | Recupera la colección de recursos WorkTime. |
| POST | /work-times | Crea un recurso WorkTime. |
| GET | /work-times/{id} | Recupera un recurso WorkTime. |
| PATCH | /work-times/{id} | Actualiza el recurso WorkTime. |
| DELETE | /work-times/{id} | Elimina el recurso WorkTime. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | |
| employee* | string (iri-reference) | |
| project* | string (iri-reference) | |
| date* | string (date-time) | |
| seconds* | integer | |
| description | stringnull | |
| projectTask | string,null (iri-reference) | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| deletedAt | string,null (date-time) | |
| deleted | boolean | Check if the entity has been soft deleted. |
Día Festivo
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /holidays | Recupera la colección de recursos Holiday. |
| POST | /holidays | Crea un recurso Holiday. |
| GET | /holidays/{id} | Recupera un recurso Holiday. |
| PATCH | /holidays/{id} | Actualiza el recurso Holiday. |
| DELETE | /holidays/{id} | Elimina el recurso Holiday. |
| GET | /holidays/active | Recupera la colección de recursos Holiday. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | |
| type* | string | |
| employee* | string (iri-reference) | |
| manager | string (iri-reference) | |
| description | stringnull | #4548, and it is reachable two ways: written directly through `holiday:create`, and copied from the accepted request by `HolidayRequestDecider:47`. Both columns are VARCHAR(255), so bounding the request at 255 keeps that copy safe — this bounds the direct path. |
| dateFrom* | string (date-time) | |
| dateTo* | string (date-time) | |
| seconds | integernull | |
| requestedSeconds | integernull | |
| notify | boolean | Should this absence tell the employee it was created? |
| payrollEligible | boolean | May payroll act on this absence? |
| holidayRequests | array | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| deletedAt | string,null (date-time) | |
| employeeFullname | string | |
| employeeReversedFullname | string | |
| relatedEmployee | string,null (iri-reference) | |
| deleted | boolean | Check if the entity has been soft deleted. |
Horario
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /schedules | Recupera la colección de recursos Schedule. |
| POST | /schedules | Crea un recurso Schedule. |
| GET | /schedules/{id} | Recupera un recurso Schedule. |
| PATCH | /schedules/{id} | Actualiza el recurso Schedule. |
| GET | /schedules/plan/{date} | Recupera la colección de recursos Schedule. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| name | string | |
| description | stringnull | |
| numberOfDays | integer | |
| regular | boolean | |
| overwriteBankHolidays | boolean | |
| scheduleRanges | array | |
| scheduleEmployees | array |
Festivo Nacional
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /bank-holidays | Recupera la colección de recursos BankHoliday. |
| POST | /bank-holidays | Crea un recurso BankHoliday. |
| GET | /bank-holidays/{id} | Recupera un recurso BankHoliday. |
| PATCH | /bank-holidays/{id} | Actualiza el recurso BankHoliday. |
| DELETE | /bank-holidays/{id} | Elimina el recurso BankHoliday. |
| GET | /holiday-days-frees | Recupera la colección de recursos BankHoliday. |
| POST | /holiday-days-frees | Crea un recurso BankHoliday. |
| GET | /holiday-days-frees/{id} | Recupera un recurso BankHoliday. |
| PATCH | /holiday-days-frees/{id} | Actualiza el recurso BankHoliday. |
| DELETE | /holiday-days-frees/{id} | Elimina el recurso BankHoliday. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| date* | string | |
| publicNotes | stringnull | |
| yearFrom | integernull | |
| yearTo | integernull |
Solicitud de Vacaciones
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /holiday-requests | Recupera la colección de recursos HolidayRequest. |
| POST | /holiday-requests | Crea un recurso HolidayRequest. |
| GET | /holiday-requests/{id} | Recupera un recurso HolidayRequest. |
| PATCH | /holiday-requests/{id} | Actualiza el recurso HolidayRequest. |
| DELETE | /holiday-requests/{id} | Elimina el recurso HolidayRequest. |
| POST | /holiday-requests/{id}/approve | Crea un recurso HolidayRequest. |
| POST | /holiday-requests/{id}/reject | Crea un recurso HolidayRequest. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | |
| status | string | |
| employee | string (iri-reference) | |
| holiday | string,null (iri-reference) | |
| type* | string | |
| description | stringnull | |
| dateFrom* | string (date-time) | |
| dateTo* | string (date-time) | |
| seconds | integernull | |
| requestedSeconds | integernull | |
| holidayRequestLogs | array | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| requestedAt | datetime |
Tipo de Vacaciones
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /holiday-types | Recupera la colección de recursos HolidayType. |
| POST | /holiday-types | Crea un recurso HolidayType. |
| GET | /holiday-types/{id} | Recupera un recurso HolidayType. |
| PATCH | /holiday-types/{id} | Actualiza el recurso HolidayType. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| status | string | |
| name* | string | |
| color | string | |
| descriptionRequired | boolean | |
| icon | stringnull | |
| reducesWorkingTime | boolean | Does an absence of this type reduce the month's expected working hours? |
| requiresApproval | boolean | Does an absence of this type have to be approved by somebody? |
Límite de Días de Vacaciones
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /holiday-days-limits | Recupera la colección de recursos HolidayDaysLimit. |
| POST | /holiday-days-limits | Crea un recurso HolidayDaysLimit. |
| GET | /holiday-days-limits/{id} | Recupera un recurso HolidayDaysLimit. |
| PATCH | /holiday-days-limits/{id} | Actualiza el recurso HolidayDaysLimit. |
| DELETE | /holiday-days-limits/{id} | Elimina el recurso HolidayDaysLimit. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | |
| employee* | string (iri-reference) | |
| seconds* | integer | Leave allowance in SECONDS, not whole days. |
| holidayType | string,null (iri-reference) | |
| variant* | string | |
| allowRequestWhenUsed | boolean | |
| dateFrom | string (date-time) | |
| notes | stringnull | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| notApplicableReason | stringnull | Why this entitlement will not take effect yet, or NULL if it will. |
| vacationLimit | boolean | Is this row the ANNUAL LEAVE entitlement, as opposed to a granted balance of some other type? |
| relatedEmployee | string,null (iri-reference) |
Límite de Días de Vacaciones por Defecto
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /holiday-days-limit-defaults | Recupera la colección de recursos HolidayDaysLimitDefault. |
| POST | /holiday-days-limit-defaults | Crea un recurso HolidayDaysLimitDefault. |
| GET | /holiday-days-limit-defaults/{id} | Recupera un recurso HolidayDaysLimitDefault. |
| PATCH | /holiday-days-limit-defaults/{id} | Actualiza el recurso HolidayDaysLimitDefault. |
| DELETE | /holiday-days-limit-defaults/{id} | Elimina el recurso HolidayDaysLimitDefault. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | |
| holidayType | string (iri-reference) | |
| seconds* | integer | Default leave allowance in SECONDS, not whole days. This entity moves with `HolidayDaysLimit` rather than after it: both are returned through the same line in `HolidaysHelper::getHolidayDaysLimit()`, so leaving one in days would put two units on one code path. |
| variant* | string | |
| allowRequestWhenUsed | boolean | |
| dateFrom | string (date-time) | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) |
Empleado del Horario
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /schedule-employees | Recupera la colección de recursos ScheduleEmployee. |
| POST | /schedule-employees | Crea un recurso ScheduleEmployee. |
| GET | /schedule-employees/{id} | Recupera un recurso ScheduleEmployee. |
| PATCH | /schedule-employees/{id} | Actualiza el recurso ScheduleEmployee. |
| DELETE | /schedule-employees/{id} | Elimina el recurso ScheduleEmployee. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| employee | string (iri-reference) | |
| schedule | string (iri-reference) | |
| dateFrom | string (date-time) | |
| dateTo | string,null (date-time) | |
| type | string | |
| notifiedAt | string,null (date-time) |
Rango del Horario
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /schedule-ranges | Recupera la colección de recursos ScheduleRange. |
| POST | /schedule-ranges | Crea un recurso ScheduleRange. |
| GET | /schedule-ranges/{id} | Recupera un recurso ScheduleRange. |
| PATCH | /schedule-ranges/{id} | Actualiza el recurso ScheduleRange. |
| DELETE | /schedule-ranges/{id} | Elimina el recurso ScheduleRange. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | string | |
| schedule | object | |
| day | integer | |
| timeFrom | integer | |
| timeTo | integer | |
| name | stringnull |
Viaje de trabajo
Endpoints
| Método | Ruta | Descripción |
|---|---|---|
| GET | /delegations | Recupera la colección de recursos Delegation. |
| POST | /delegations | Crea un recurso Delegation. |
| GET | /delegations/{id} | Recupera un recurso Delegation. |
| PATCH | /delegations/{id} | Actualiza el recurso Delegation. |
| DELETE | /delegations/{id} | Elimina el recurso Delegation. |
Campos de schema
| Campo | Tipo | Descripción |
|---|---|---|
| id | integer | |
| employee* | string (iri-reference) | |
| project | string,null (iri-reference) | Nullable: a historical trip may name no project, and it must still be recorded. |
| projectTask | string,null (iri-reference) | |
| dateFrom* | string (date-time) | |
| dateTo* | string (date-time) | |
| seconds | integernull | Optional: the source history carries days, not hours. |
| description | stringnull | |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) | |
| deletedAt | string,null (date-time) | |
| days | integer | Calendar days covered, INCLUSIVE — a trip that starts and ends on the same day is one day, not zero. This is the unit the travel analytics report, because the source history counts days rather than hours. |
| deleted | boolean | Check if the entity has been soft deleted. |