---
title: "LeaveBalancesByEmployerId__embeddedLeaveBalance (Loket.nl REST)"
description: "itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural"
language: de
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/de/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/de/
---

# LeaveBalancesByEmployerId__embeddedLeaveBalance: Loket.nl REST itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

`read only` `REST`

- Katalog: `LoketNlRest`
- Schema: `LeaveBalance`
- Bezeichnung: itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

Das Urlaubssaldo für alle Beschäftigungsverhältnisse __Aktivitätsname :__ GetLeaveBalancesByEmployerId
  
Gibt die jährlichen Urlaubssalden für alle Beschäftigungsverhältnisse zurück


Es können nur Daten abgerufen werden.

## API-Quelle

- Endpunkt: `/providers/employers/{employerId}/leavebalances`
- Operation: `get /providers/employers/{employerId}/leavebalances`

## Parameter

| Name | Datentyp | Required | Default | Documentation |
|---|---|:---:|---|---|
| `employerId` | `` | [x] |  | Die eindeutige Kennung des Arbeitgebers |
| `referenceDate` | `` | [ ] |  | Legt ein Referenzdatum für die folgende Logik fest 1.Zur Bestimmung der aktiven `function` und `department` des Beschäftigungsverhältnisses 2.Zur Berechnung von `usageAfterToday` und `usageThroughToday` 3.Zur Bestimmung des Jahres, für das das Urlaubssaldo zurückgegeben wird. Falls nicht angegeben, wird "heute" verwendet |

## Tabellenspalten

Die Spalten der Tabelle `LeaveBalancesByEmployerId__embeddedLeaveBalance` sind unten aufgeführt. Jede Spalte hat einen SQL-Datentyp. Beim Einfügen und Aktualisieren muss für jede erforderliche Spalte jederzeit ein neuer Wert angegeben werden der nicht Null ist.

| Name | Datentyp | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `accrual` | `double` | itgen_loketnl_accrual | [ ] |  | Die Anzahl der im Jahr für die Urlaubsart angesammelten Urlaubseinheiten |
| `balance` | `double` | Balance | [ ] |  | Der verbleibende Urlaubssaldo für das Jahr und die Urlaubsart.Das Saldo berücksichtigt die künftige Urlaubsnutzung. |
| `balancePreviousYear` | `double` | Saldo des Vorjahres | [ ] |  | Der verbleibende Urlaubssaldo aus dem Vorjahr für die Urlaubsart |
| `employee_dateOfBirth` | `datetime` | Geburtsdatum des Mitarbeiters | [ ] |  | Das Geburtsdatum |
| `employee_employeeNumber` | `int32` | itgen_loketnl_employee_employeenumber | [ ] |  | Die Mitarbeiternummer zur eindeutigen Identifizierung eines Mitarbeiters innerhalb eines Arbeitgebers. |
| `employee_firstName` | `varchar2(28)` | Vorname des Mitarbeiters | [ ] |  | Der Vorname des Mitarbeiters |
| `employee_formattedName` | `varchar2(82)` | Name des Mitarbeiters (formatiert) | [ ] |  | Formatierter Name des Mitarbeiters auf Basis des Wertes von `howToFormatLastName` |
| `employee_id` | `guid` | Mitarbeiter ID | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `employee_initials` | `varchar2(6)` | Initialen des Mitarbeiters | [ ] |  | Die Initialen des Mitarbeiters |
| `employee_lastName` | `varchar2(25)` | Nachname des Mitarbeiters | [ ] |  | Der Nachname des Mitarbeiters |
| `employee_lastNamePartner` | `varchar2(25)` | itgen_loketnl_employee_lastnamepartner | [ ] |  | Der Nachname des Partners des Mitarbeiters |
| `employee_photo` | `varchar2` | Mitarbeiterfoto | [ ] |  | Ein Foto des Mitarbeiters, das als Avatar/Profilbild verwendet wird.Der letzte Teil des zurückgegebenen Endpunkts ist die Version des Logos, sodass Benutzer das Bild zwischenspeichern können.Eine Änderung des Wertes der Version beeinflusst die Ausgabe nicht. |
| `employee_prefix` | `varchar2(10)` | Mitarbeiter-Präfix | [ ] |  | Das Präfix des Mitarbeiters |
| `employee_prefixPartner` | `varchar2(10)` | Mitarbeiter-Präfix-Partner | [ ] |  | Das Präfix des Partners des Mitarbeiters |
| `endDate` | `datetime` | Enddatum | [ ] |  | Das Datum, an dem das Beschäftigungsverhältnis endet.NL: DatumUitDienst |
| `expires` | `double` | itgen_loketnl_expires | [ ] |  | <ul>   <li>Dieses Feld ist nur für die folgenden Urlaubsarten relevant:</li>   <li><strong>Wettelijk verlof:</strong> Angesammelter gesetzlicher Urlaub aus Vorjahren, der am Juli 1 des gewählten Jahres verfällt.</li>   <li><strong>Bovenwettelijk verlof:</strong> Angesammelter außergesetzlicher Urlaub von vor 5 Jahren und früher, der am Jan 1 des gewählten Jahres + 1 verfällt.</li>   <li><strong>Verlof:</strong> Die Summe der beiden obigen Urlaubsarten.</li> </ul> |
| `historicalStartDate` | `datetime` | Historisches Startdatum | [ ] |  | Das historische Datum, an dem der Mitarbeiter erstmals beschäftigt wurde.Dieses Feld wird verwendet, wenn ein Mitarbeiter im Zeitverlauf mehrere Beschäftigungsverhältnisse hat.In den meisten Fällen sollte dieses Feld als das Datum verwendet werden, an dem der Mitarbeiter im Unternehmen zu arbeiten begann.NL: HistorischeDatumInDienst |
| `id` | `guid` | ID | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `incomeRelationshipNumber` | `int32` | itgen_loketnl_incomerelationshipnumber | [ ] |  | Die Einkommensbeziehungsnummer, die in der Steuererklärung erforderlich ist.Zusammen mit der Bürgerservicenummer (burgerservicenummer, BSN) und der Lohnsteuernummer identifiziert die Einkommensbeziehungsnummer ein Dienstverhältnis eindeutig.NL: NummerInkomstenVerhouding |
| `leaveType_balanceExceedsYear` | `char` | itgen_loketnl_leavetype_balanceexceedsyear | [ ] |  | Gibt an, ob das Saldo am Jahresende für diese Urlaubsart in das nächste Jahr übertragen wird. |
| `leaveType_key` | `int32` | Schlüssel für Urlaubsart | [ ] |  | Der Schlüssel für die Urlaubsart. |
| `leaveType_value` | `varchar2` | Urlaubsart Wert | [ ] |  | Die Beschreibung der Urlaubsart.Beachten Sie, dass Urlaubsarten auf Arbeitgeberebene überschrieben werden können.In diesen Fällen hat die Beschreibung auf Arbeitgeberebene Vorrang vor der Standardbeschreibung der Urlaubsart. |
| `nonPayrollAdministration_description` | `varchar2(50)` | itgen_loketnl_nonpayrolladministration_description | [ ] |  | Beschreibung der Verwaltung |
| `nonPayrollAdministration_id` | `guid` | itgen_loketnl_nonpayrolladministration_id | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `nonPayrollAdministration_name` | `varchar2(70)` | itgen_loketnl_nonpayrolladministration_name | [ ] |  | Name der Nicht-Lohn-Verwaltung |
| `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 | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `organizationalEntity_deviatingFunctionDescription` | `varchar2(50)` | itgen_loketnl_organizationalentity_deviatingfunctiondescription | [ ] |  | Die abweichende Funktionsbeschreibung des Beschäftigungsverhältnisses.Diese Beschreibung weicht vom Wert des Feldes `function` ab. |
| `organizationalEntity_deviatingFunctionGroup` | `varchar2(5)` | itgen_loketnl_organizationalentity_deviatingfunctiongroup | [ ] |  | Die abweichende Funktionsgruppenbeschreibung des Beschäftigungsverhältnisses.Gilt nur, wenn eine abweichende Funktionsbeschreibung definiert ist. |
| `organizationalEntity_endDate` | `datetime` | itgen_loketnl_organizationalentity_enddate | [ ] |  | Das Enddatum der Entität.Das Datum ist einschließlich. |
| `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 | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `organizationalEntity_placeOfEmployment` | `varchar2(24)` | itgen_loketnl_organizationalentity_placeofemployment | [ ] |  | Der Standardarbeitsort (standplaats) für das Beschäftigungsverhältnis. |
| `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 | [ ] |  | Das Startdatum des Objekts.Eine (verknüpfte Kette)[./#section/Data/Date-chains] wird innerhalb dieser Ressource gepflegt. |
| `payrollAdministration_clientNumber` | `int32` | itgen_loketnl_payrolladministration_clientnumber | [ ] |  | Die Kundennummer ist eine eindeutige Nummer für Verwaltungen, die für die Lohnabrechnung verwendet werden.Dieses Feld hat keinen Wert, wenn die Verwaltung nicht für die Lohnabrechnung verwendet wird. |
| `payrollAdministration_description` | `varchar2(50)` | itgen_loketnl_payrolladministration_description | [ ] |  | Beschreibung der Verwaltung |
| `payrollAdministration_id` | `guid` | ID der Lohn- und Gehaltsabrechnung | [ ] |  | Die eindeutige Kennung eines Objekts (GUID/UUID) |
| `payrollAdministration_name` | `varchar2(70)` | Name der Lohn- und Gehaltsabrechnung | [ ] |  | Name der Lohnbuchhaltung |
| `startDate` | `datetime` | Anfangsdatum | [ ] |  | Das Datum, an dem diese Beschäftigung beginnt.NL: DatumInDienst |
| `usageAfterReferenceDate` | `double` | itgen_loketnl_usageafterreferencedate | [ ] |  | Die Anzahl der für die Urlaubsart im Jahr nach `referenceDate` verbrauchten Urlaubseinheiten |
| `usageThroughReferenceDate` | `double` | itgen_loketnl_usagethroughreferencedate | [ ] |  | Die Anzahl der für die Urlaubsart verbrauchten Urlaubseinheiten, beginnend am Jahresanfang bis einschließlich `referenceDate` |
| `usageTotal` | `double` | Gesamtnutzung | [ ] |  | Die Gesamtzahl der im Jahr für die Urlaubsart verbrauchten Urlaubseinheiten. |
| `year` | `int32` | Year | [ ] |  | Das Jahr, für das das Saldo der Urlaubsart gilt. |


## Anmerkungen zu dieser Version

Was hat sich in den Tabellen, Spalten, Attributen und Funktionen des Treibers mit jeder neuen Version geändert:

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