Eventi lavorativi

Registra presenze, assenze, ferie, malattia, straordinari e altri eventi lavorativi per ciascun contratto domestico. Gli eventi lavorativi sono la base per il calcolo del cedolino.

GET/v1/work-events

Restituisce l'elenco paginato degli eventi lavorativi per un contratto domestico.

Parametri query

Parametro	Tipo	Obbligatorio	Descrizione
`domesticContractId`	`string`	Sì	ID del contratto domestico.
`page`	`integer`	No	Numero di pagina (default 1).
`limit`	`integer`	No	Numero massimo di risultati (default 20, max 100).
`sortField`	`string`	No	Campo per l'ordinamento (es. date).
`sortDirection`	`string`	No	Direzione ordinamento: asc o desc.

Risposta

{
  "data": [
    {
      "id": "we_01H9Y4M",
      "domesticContractId": "dc_01H9Y4N",
      "date": "2026-03-10",
      "hours": "5",
      "type": "work",
      "subType": "regular_work",
      "multiplier": "1",
      "addsToThirteen": true,
      "addsToSeverance": true,
      "isFromGlobalWage": false,
      "affectsContributions": true,
      "createdAt": "2026-03-10T08:00:00Z",
      "updatedAt": "2026-03-10T08:00:00Z"
    }
  ]
}

GET/v1/work-events/{id}

Restituisce i dettagli di un singolo evento lavorativo.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID dell'evento lavorativo.

POST/v1/work-events

Crea un nuovo evento lavorativo.

Parametri body

Parametro	Tipo	Obbligatorio	Descrizione
`domesticContractId`	`string`	Sì	ID del contratto domestico.
`date`	`string`	Sì	Data dell'evento (formato YYYY-MM-DD).
`hours`	`string`	Sì	Numero di ore (tra 0 e 24).
`type`	`string`	Sì	Tipo di evento (vedi tabella tipi sotto).
`subType`	`string`	Sì	Sottotipo di evento (vedi tabella sottotipi sotto).
`multiplier`	`string`	Sì	Moltiplicatore retributivo (da 0.01 a 10). Valore 1 per retribuzione ordinaria.
`customName`	`string`	No	Nome personalizzato per l'evento.
`notes`	`string`	No	Note aggiuntive.
`addsToThirteen`	`boolean`	No	Contribuisce al calcolo della tredicesima.
`addsToSeverance`	`boolean`	No	Contribuisce al calcolo del TFR.
`isFromGlobalWage`	`boolean`	No	Calcolato sulla base della retribuzione globale.
`affectsContributions`	`boolean`	No	Incide sul calcolo dei contributi.

Esempio

curl -X POST https://api.workledger.it/v1/work-events \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "domesticContractId": "dc_01H9Y4N",
    "date": "2026-03-10",
    "hours": "5",
    "type": "work",
    "subType": "regular_work",
    "multiplier": "1"
  }'

POST/v1/work-events/batch

Crea più eventi lavorativi in un'unica richiesta per uno stesso contratto.

Parametri query

Parametro	Tipo	Obbligatorio	Descrizione
`domesticContractId`	`string`	Sì	ID del contratto domestico.

Il body è un array di oggetti evento con la stessa struttura della creazione singola (senza domesticContractId, che è specificato nel parametro query).

Esempio

curl -X POST "https://api.workledger.it/v1/work-events/batch?domesticContractId=dc_01H9Y4N" \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "date": "2026-03-10",
      "hours": "5",
      "type": "work",
      "subType": "regular_work",
      "multiplier": "1"
    },
    {
      "date": "2026-03-11",
      "hours": "5",
      "type": "work",
      "subType": "regular_work",
      "multiplier": "1"
    }
  ]'

POST/v1/work-events/auto-fill

Genera automaticamente gli eventi lavorativi per un intervallo di date, basandosi sull'orario settimanale configurato nel contratto.

Parametri body

Parametro	Tipo	Obbligatorio	Descrizione
`domesticContractId`	`string`	Sì	ID del contratto domestico.
`startDate`	`string`	Sì	Data di inizio (formato YYYY-MM-DD).
`endDate`	`string`	Sì	Data di fine (formato YYYY-MM-DD).

Esempio

curl -X POST https://api.workledger.it/v1/work-events/auto-fill \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "domesticContractId": "dc_01H9Y4N",
    "startDate": "2026-03-01",
    "endDate": "2026-03-31"
  }'

L'auto-fill crea un evento lavorativo di tipo work / regular_work per ogni giorno lavorativo previsto dall'orario settimanale del contratto, con le ore corrispondenti. I giorni festivi vengono riconosciuti automaticamente.

PATCH/v1/work-events/{id}

Aggiorna un evento lavorativo esistente.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID dell'evento lavorativo.

Il body accetta gli stessi campi della creazione; vengono aggiornati solo i campi inclusi.

Esempio

curl -X PATCH https://api.workledger.it/v1/work-events/we_01H9Y4M \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "hours": "3",
    "type": "sick_leave",
    "subType": "sick_full"
  }'

DELETE/v1/work-events/{id}

Elimina un evento lavorativo.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID dell'evento lavorativo.

L'eliminazione di eventi lavorativi già inclusi in un cedolino elaborato non modifica il cedolino esistente. Per ricalcolare, eliminare prima il cedolino e poi rielaborarlo.

Tipi di evento

Valore	Descrizione
`work`	Lavoro
`leave`	Permesso
`public_holiday`	Festività
`vacation`	Ferie
`sick_leave`	Malattia
`work_injury`	Infortunio sul lavoro
`leave_of_absence`	Congedo

Sottotipi di evento

Valore	Tipo padre	Descrizione
`regular_work`	work	Lavoro ordinario
`holiday_work`	work	Lavoro festivo
`sunday_work`	work	Lavoro domenicale
`night_work`	work	Lavoro notturno
`other_work`	work	Altro lavoro
`overtime`	work	Straordinario
`daily_overtime`	work	Straordinario giornaliero
`night_overtime`	work	Straordinario notturno
`unpaid_absence`	leave	Assenza non retribuita
`unpaid_absence_suspended`	leave	Assenza non retribuita (sospesa)
`paid_permit`	leave	Permesso retribuito
`unpaid_permit`	leave	Permesso non retribuito
`sick_full`	sick_leave	Malattia retribuita al 100%
`sick_half`	sick_leave	Malattia retribuita al 50%
`sick_none`	sick_leave	Malattia non retribuita
`sick_custom`	sick_leave	Malattia con retribuzione personalizzata
`work_injury_full`	work_injury	Infortunio retribuito
`work_injury_none`	work_injury	Infortunio non retribuito
`regular_vacation`	vacation	Ferie ordinarie
`regular_public_holiday`	public_holiday	Festività ordinaria
`maternity_leave`	leave_of_absence	Congedo di maternità
`paternity_leave`	leave_of_absence	Congedo di paternità
`matrimonial_leave`	leave_of_absence	Congedo matrimoniale