---
title: "LeaveBalancesByEmployerId__embeddedLeaveBalance (Loket.nl REST)"
description: "itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural"
language: es
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/es/datamodels/loketnl/LoketNlRest.LeaveBalance.LeaveBalancesByEmployerId__embeddedLeaveBalance
original: https://documentation.invantive.eu/en/datamodels/loketnl/LoketNlRest.LeaveBalance.LeaveBalancesByEmployerId__embeddedLeaveBalance
updated: 2026-11-19T00:05:38Z
license: https://documentation.invantive.eu/es/
---

# LeaveBalancesByEmployerId__embeddedLeaveBalance: Loket.nl REST itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

`read only` `REST`

- Catálogo: `LoketNlRest`
- Esquema: `LeaveBalance`
- Etiqueta: itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

El saldo de vacaciones de todas las relaciones laborales __Nombre de actividad:__ GetLeaveBalancesByEmployerId
  
Devuelve los saldos anuales de vacaciones de todas las relaciones laborales


Solo puede recuperar datos.

## Fuente de la API

- Punto final: `/providers/employers/{employerId}/leavebalances`
- Operación: `get /providers/employers/{employerId}/leavebalances`

## Parámetros

| Name | Tipo de Datos | Required | Default | Documentation |
|---|---|:---:|---|---|
| `employerId` | `` | [x] |  | El identificador único del empleador |
| `referenceDate` | `` | [ ] |  | Establece una fecha de referencia para la siguiente lógica   1.Para determinar el `function` y `department` activos de la relación laboral   2.Para calcular `usageAfterToday` y `usageThroughToday`   3.Para determinar el año para el que se devuelve el saldo de vacaciones. Si no se indica, se usa "hoy". |

## Columnas de la Tabla

A continuación se muestran las columnas de la tabla `LeaveBalancesByEmployerId__embeddedLeaveBalance`. Cada columna tiene un tipo de datos SQL. Se debe proporcionar un nuevo valor no nulo para cada columna requerida en todo momento durante la inserción y la actualización.

| Name | Tipo de Datos | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `accrual` | `double` | itgen_loketnl_accrual | [ ] |  | La cantidad de unidades de vacaciones acumuladas para el tipo de vacaciones en el año |
| `balance` | `double` | Balance | [ ] |  | El saldo de vacaciones restante para el año y el tipo de vacaciones.El saldo tiene en cuenta el uso de vacaciones en el futuro. |
| `balancePreviousYear` | `double` | Saldo del ejercicio anterior | [ ] |  | El saldo de vacaciones restante del año anterior para el tipo de vacaciones |
| `employee_dateOfBirth` | `datetime` | Fecha de nacimiento del empleado | [ ] |  | La fecha de nacimiento |
| `employee_employeeNumber` | `int32` | itgen_loketnl_employee_employeenumber | [ ] |  | El número de empleado que identifica de forma única a un empleado dentro de un empleador. |
| `employee_firstName` | `varchar2(28)` | Nombre de pila del empleado | [ ] |  | El nombre del empleado |
| `employee_formattedName` | `varchar2(82)` | Nombre del empleado con formato | [ ] |  | Nombre formateado del empleado según el valor de `howToFormatLastName` |
| `employee_id` | `guid` | Identificación del Empleado | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `employee_initials` | `varchar2(6)` | Iniciales del empleado | [ ] |  | Las iniciales del empleado |
| `employee_lastName` | `varchar2(25)` | Apellido del empleado | [ ] |  | El apellido del empleado |
| `employee_lastNamePartner` | `varchar2(25)` | itgen_loketnl_employee_lastnamepartner | [ ] |  | El apellido de la pareja del empleado |
| `employee_photo` | `varchar2` | Foto del empleado | [ ] |  | Una foto del empleado para usar como avatar/imagen de perfil.La última parte del endpoint devuelto es la versión del logotipo; esto permite a los usuarios almacenar la imagen en caché.Cambiar el valor de la versión no influirá en la salida. |
| `employee_prefix` | `varchar2(10)` | Prefijo de empleado | [ ] |  | El prefijo del empleado |
| `employee_prefixPartner` | `varchar2(10)` | Prefijo de empleado: Socio | [ ] |  | El prefijo de la pareja del empleado |
| `endDate` | `datetime` | Fecha Final | [ ] |  | La fecha en la que finaliza la relación laboral.NL: DatumUitDienst |
| `expires` | `double` | itgen_loketnl_expires | [ ] |  | <ul>   <li>Este campo solo es relevante para los siguientes tipos de vacaciones:</li>   <li><strong>Wettelijk verlof:</strong> Vacaciones legales acumuladas de años anteriores que caducan el 1 de julio del año seleccionado.</li>   <li><strong>Bovenwettelijk verlof:</strong> Vacaciones extralegales acumuladas hace 5 años o más, que caducan el 1 de enero del año seleccionado + 1.</li>   <li><strong>Verlof:</strong> La suma de los dos tipos de vacaciones anteriores.</li> </ul> |
| `historicalStartDate` | `datetime` | Fecha de inicio histórica | [ ] |  | La fecha histórica en la que el empleado fue contratado por primera vez.Este campo se utiliza cuando un empleado tiene varias relaciones laborales en el tiempo.En la mayoría de los casos, este campo debe utilizarse como la fecha en la que el empleado comenzó a trabajar en la empresa.NL: HistorischeDatumInDienst |
| `id` | `guid` | ID | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `incomeRelationshipNumber` | `int32` | itgen_loketnl_incomerelationshipnumber | [ ] |  | El número de relación de ingresos que se requiere en la declaración de impuestos.Junto con el número de servicio ciudadano (burgerservicenummer, BSN) y el número de impuesto sobre salarios, el número de relación de ingresos identifica de forma única un empleo.NL: NummerInkomstenVerhouding |
| `leaveType_balanceExceedsYear` | `char` | itgen_loketnl_leavetype_balanceexceedsyear | [ ] |  | Indica si el saldo a final de año de este tipo de ausencia se traslada al año siguiente. |
| `leaveType_key` | `int32` | Clave de tipo de baja | [ ] |  | La clave del tipo de ausencia. |
| `leaveType_value` | `varchar2` | Tipo de permiso Valor | [ ] |  | La descripción del tipo de ausencia.Tenga en cuenta que los tipos de ausencia pueden sobrescribirse a nivel de empleador.En estos casos, la descripción a nivel de empleador tiene prioridad sobre la descripción predeterminada del tipo de ausencia. |
| `nonPayrollAdministration_description` | `varchar2(50)` | itgen_loketnl_nonpayrolladministration_description | [ ] |  | Descripción de la administración |
| `nonPayrollAdministration_id` | `guid` | itgen_loketnl_nonpayrolladministration_id | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `nonPayrollAdministration_name` | `varchar2(70)` | itgen_loketnl_nonpayrolladministration_name | [ ] |  | Nombre de la administración no nómina |
| `organizationalEntity_department_code` | `int32` | itgen_loketnl_organizationalentity_department_code | [ ] |  |  |
| `organizationalEntity_department_description` | `varchar2` | itgen_loketnl_organizationalentity_department_description | [ ] |  |  |
| `organizationalEntity_department_key` | `guid` | itgen_loketnl_organizationalentity_department_key | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `organizationalEntity_deviatingFunctionDescription` | `varchar2(50)` | itgen_loketnl_organizationalentity_deviatingfunctiondescription | [ ] |  | La descripción de función diferente del empleo.Esta descripción difiere del valor del campo `function`. |
| `organizationalEntity_deviatingFunctionGroup` | `varchar2(5)` | itgen_loketnl_organizationalentity_deviatingfunctiongroup | [ ] |  | La descripción diferente del grupo de funciones del empleo.Solo se aplica cuando se define una descripción de función diferente. |
| `organizationalEntity_endDate` | `datetime` | itgen_loketnl_organizationalentity_enddate | [ ] |  | La fecha de fin de la entidad.La fecha es hasta e incluyendo. |
| `organizationalEntity_function_description` | `varchar2(50)` | itgen_loketnl_organizationalentity_function_description | [ ] |  |  |
| `organizationalEntity_function_group` | `varchar2(5)` | itgen_loketnl_organizationalentity_function_group | [ ] |  |  |
| `organizationalEntity_function_key` | `guid` | itgen_loketnl_organizationalentity_function_key | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `organizationalEntity_placeOfEmployment` | `varchar2(24)` | itgen_loketnl_organizationalentity_placeofemployment | [ ] |  | La ubicación de trabajo estándar (standplaats) del empleo. |
| `organizationalEntity_standardFunction_category` | `int32` | itgen_loketnl_organizationalentity_standardfunction_category | [ ] |  |  |
| `organizationalEntity_standardFunction_code` | `varchar2(6)` | itgen_loketnl_organizationalentity_standardfunction_code | [ ] |  |  |
| `organizationalEntity_standardFunction_key` | `int32` | itgen_loketnl_organizationalentity_standardfunction_key | [ ] |  |  |
| `organizationalEntity_standardFunction_value` | `varchar2` | itgen_loketnl_organizationalentity_standardfunction_value | [ ] |  |  |
| `organizationalEntity_startDate` | `datetime` | itgen_loketnl_organizationalentity_startdate | [ ] |  | La fecha de inicio de la entidad.Se mantiene una cadena (vinculada)[./#section/Data/Date-chains] dentro de este recurso. |
| `payrollAdministration_clientNumber` | `int32` | itgen_loketnl_payrolladministration_clientnumber | [ ] |  | El número de cliente es un número único para las administraciones que se utilizan para la nómina.Este campo no tiene valor si la administración no se utiliza para la nómina. |
| `payrollAdministration_description` | `varchar2(50)` | itgen_loketnl_payrolladministration_description | [ ] |  | Descripción de la administración |
| `payrollAdministration_id` | `guid` | N.º de identificación de la administración de nóminas | [ ] |  | El identificador único de un objeto (GUID/UUID) |
| `payrollAdministration_name` | `varchar2(70)` | Nombre de la administración de nóminas | [ ] |  | Nombre de la administración de nóminas |
| `startDate` | `datetime` | Fecha Inicial | [ ] |  | La fecha en que comienza este empleo.NL: DatumInDienst |
| `usageAfterReferenceDate` | `double` | itgen_loketnl_usageafterreferencedate | [ ] |  | La cantidad de unidades de vacaciones utilizadas para el tipo de vacaciones en el año posterior a `referenceDate` |
| `usageThroughReferenceDate` | `double` | itgen_loketnl_usagethroughreferencedate | [ ] |  | La cantidad de unidades de vacaciones utilizadas para el tipo de vacaciones desde el inicio del año hasta e incluyendo `referenceDate` |
| `usageTotal` | `double` | Uso total | [ ] |  | La cantidad total de unidades de vacaciones utilizadas para el tipo de vacaciones en el año. |
| `year` | `int32` | Year | [ ] |  | El año al que se aplica el saldo del tipo de vacaciones. |


## Notas de la Versión

Cambios introducidos en cada versión en las tablas, columnas, atributos y capacidades del controlador:

- [Loket.nl REST](/es/release-notes/drivers?driver=loket-nl-rest)
