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

# LeaveBalancesByEmployerId__embeddedLeaveBalance: Loket.nl REST itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

`read only` `REST`

- Catalogo: `LoketNlRest`
- Schema: `LeaveBalance`
- Label: itgen_loketnl_leavebalancesbyemployerid__embeddedleavebalance_plural

Il saldo ferie per tutti i rapporti di lavoro __Nome attività:__ GetLeaveBalancesByEmployerId
  
Restituisce i saldi ferie annuali per tutti i rapporti di lavoro


È possibile solo recuperare i dati.

## Codice sorgente dell'API

- Punto finale: `/providers/employers/{employerId}/leavebalances`
- Operazione: `get /providers/employers/{employerId}/leavebalances`

## Parametri

| Name | Tipo di dati | Required | Default | Documentation |
|---|---|:---:|---|---|
| `employerId` | `` | [x] |  | L'identificativo univoco del datore di lavoro |
| `referenceDate` | `` | [ ] |  | Imposta una data di riferimento per la logica seguente   1.Per determinare `function` e `department` attivi del rapporto di lavoro   2.Per calcolare `usageAfterToday` e `usageThroughToday`   3.Per determinare l'anno per cui viene restituito il saldo ferie. Se non specificato, viene usato "oggi" |

## Colonne della tabella

Di seguito sono riportate le colonne della tabella `LeaveBalancesByEmployerId__embeddedLeaveBalance`. Ogni colonna ha un tipo di dati SQL. Un nuovo valore non nullo deve essere fornito per ogni colonna richiesta in ogni momento durante l'inserimento e l'aggiornamento.

| Name | Tipo di dati | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `accrual` | `double` | itgen_loketnl_accrual | [ ] |  | L'importo delle unità di ferie maturate per il tipo di ferie nell'anno |
| `balance` | `double` | Balance | [ ] |  | Il saldo ferie residuo per l'anno e il tipo di ferie.Il saldo tiene conto dell'utilizzo di ferie future. |
| `balancePreviousYear` | `double` | Saldo dell'esercizio precedente | [ ] |  | Il saldo ferie residuo dell'anno precedente per il tipo di ferie |
| `employee_dateOfBirth` | `datetime` | Data di nascita del dipendente | [ ] |  | La data di nascita |
| `employee_employeeNumber` | `int32` | itgen_loketnl_employee_employeenumber | [ ] |  | Il numero del dipendente che identifica in modo univoco un dipendente all'interno di un datore di lavoro. |
| `employee_firstName` | `varchar2(28)` | Nome del dipendente | [ ] |  | Il nome del dipendente |
| `employee_formattedName` | `varchar2(82)` | Nome del dipendente (formattato) | [ ] |  | Nome formattato del dipendente in base al valore di `howToFormatLastName` |
| `employee_id` | `guid` | ID dell'impiegato | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `employee_initials` | `varchar2(6)` | Iniziali dei dipendenti | [ ] |  | Le iniziali del dipendente |
| `employee_lastName` | `varchar2(25)` | Cognome del dipendente | [ ] |  | Il cognome del dipendente |
| `employee_lastNamePartner` | `varchar2(25)` | itgen_loketnl_employee_lastnamepartner | [ ] |  | Il cognome del partner del dipendente |
| `employee_photo` | `varchar2` | Foto del dipendente | [ ] |  | Una foto del dipendente da usare come avatar/immagine del profilo.L'ultima parte dell'endpoint restituito è la versione del logo; questo consente agli utenti di memorizzare nella cache l'immagine.La modifica del valore della versione non influisce sull'output. |
| `employee_prefix` | `varchar2(10)` | Prefisso del dipendente | [ ] |  | Il prefisso del dipendente |
| `employee_prefixPartner` | `varchar2(10)` | Prefisso dipendente Partner | [ ] |  | Il prefisso del partner del dipendente |
| `endDate` | `datetime` | Data di fine | [ ] |  | La data in cui termina il rapporto di lavoro.NL: DatumUitDienst |
| `expires` | `double` | itgen_loketnl_expires | [ ] |  | <ul>   <li>Questo campo è rilevante solo per i seguenti tipi di ferie:</li>   <li><strong>Wettelijk verlof:</strong> Ferie legali maturate in anni precedenti che scadono il 1 luglio dell'anno selezionato.</li>   <li><strong>Bovenwettelijk verlof:</strong> Ferie extra-legali maturate 5 anni fa o prima, che scadono il 1 gennaio dell'anno selezionato + 1.</li>   <li><strong>Verlof:</strong> La somma dei due tipi di ferie sopra.</li> </ul> |
| `historicalStartDate` | `datetime` | Data di inizio storica | [ ] |  | La data storica in cui il dipendente è stato assunto per la prima volta.Questo campo viene utilizzato quando un dipendente ha più rapporti di lavoro nel tempo.Nella maggior parte dei casi questo campo deve essere usato come data in cui il dipendente ha iniziato a lavorare per l'azienda.NL: HistorischeDatumInDienst |
| `id` | `guid` | ID | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `incomeRelationshipNumber` | `int32` | itgen_loketnl_incomerelationshipnumber | [ ] |  | Il numero di relazione di reddito richiesto nella dichiarazione dei redditi.Insieme al numero di servizio cittadino (burgerservicenummer, BSN) e al numero di imposta sul salario, il numero di relazione di reddito identifica in modo univoco un rapporto di lavoro.NL: NummerInkomstenVerhouding |
| `leaveType_balanceExceedsYear` | `char` | itgen_loketnl_leavetype_balanceexceedsyear | [ ] |  | Indica se il saldo a fine anno per questo tipo di ferie viene riportato all'anno successivo. |
| `leaveType_key` | `int32` | Chiave del tipo di permesso | [ ] |  | La chiave per il tipo di ferie. |
| `leaveType_value` | `varchar2` | Tipo di congedo Valore | [ ] |  | La descrizione del tipo di ferie.Si noti che i tipi di ferie possono essere sovrascritti a livello di datore di lavoro.In questi casi la descrizione a livello di datore di lavoro prevale sulla descrizione predefinita del tipo di ferie. |
| `nonPayrollAdministration_description` | `varchar2(50)` | itgen_loketnl_nonpayrolladministration_description | [ ] |  | Descrizione dell'amministrazione |
| `nonPayrollAdministration_id` | `guid` | itgen_loketnl_nonpayrolladministration_id | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `nonPayrollAdministration_name` | `varchar2(70)` | itgen_loketnl_nonpayrolladministration_name | [ ] |  | Nome dell'amministrazione non paghe |
| `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 | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `organizationalEntity_deviatingFunctionDescription` | `varchar2(50)` | itgen_loketnl_organizationalentity_deviatingfunctiondescription | [ ] |  | La descrizione della funzione difforme del rapporto di lavoro.Questa descrizione si discosta dal valore del campo `function`. |
| `organizationalEntity_deviatingFunctionGroup` | `varchar2(5)` | itgen_loketnl_organizationalentity_deviatingfunctiongroup | [ ] |  | La descrizione del gruppo di funzione difforme del rapporto di lavoro.Si applica solo quando è definita una descrizione di funzione difforme. |
| `organizationalEntity_endDate` | `datetime` | itgen_loketnl_organizationalentity_enddate | [ ] |  | La data di fine dell'entità.La data è inclusa. |
| `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 | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `organizationalEntity_placeOfEmployment` | `varchar2(24)` | itgen_loketnl_organizationalentity_placeofemployment | [ ] |  | La sede di lavoro standard (standplaats) per il rapporto di lavoro. |
| `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 data di inizio dell'entità.Una catena collegata[./#section/Data/Date-chains] è mantenuta all'interno di questa risorsa. |
| `payrollAdministration_clientNumber` | `int32` | itgen_loketnl_payrolladministration_clientnumber | [ ] |  | Il numero cliente è un numero univoco per le amministrazioni utilizzate per la gestione paghe.Questo campo non ha valore se l'amministrazione non è utilizzata per la gestione paghe. |
| `payrollAdministration_description` | `varchar2(50)` | itgen_loketnl_payrolladministration_description | [ ] |  | Descrizione dell'amministrazione |
| `payrollAdministration_id` | `guid` | ID gestione stipendi | [ ] |  | L'identificatore univoco di un oggetto (GUID/UUID) |
| `payrollAdministration_name` | `varchar2(70)` | Nome dell'amministratore del libro paga | [ ] |  | Nome dell'amministrazione paghe |
| `startDate` | `datetime` | Data di inizio | [ ] |  | La data in cui inizia questo rapporto di lavoro.NL: DatumInDienst |
| `usageAfterReferenceDate` | `double` | itgen_loketnl_usageafterreferencedate | [ ] |  | L'importo delle unità di ferie utilizzate per il tipo di ferie nell'anno successivo a `referenceDate` |
| `usageThroughReferenceDate` | `double` | itgen_loketnl_usagethroughreferencedate | [ ] |  | L'importo delle unità di ferie utilizzate per il tipo di ferie dall'inizio dell'anno fino a e incluso `referenceDate` |
| `usageTotal` | `double` | Totale di utilizzo | [ ] |  | Il totale delle unità di ferie utilizzate per il tipo di ferie nell'anno. |
| `year` | `int32` | Year | [ ] |  | L'anno a cui si riferisce il saldo del tipo di ferie. |


## Note di rilascio

Cosa è cambiato, versione per versione, nelle tabelle, nelle colonne, negli attributi e nelle funzionalità del driver:

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