Datori di lavoro

Gestisci l'anagrafica dei datori di lavoro associati alla tua organizzazione. Ogni datore di lavoro può essere di tipo domestic (persona fisica) o business (persona giuridica).

GET/v1/employers

Restituisce l'elenco dei datori di lavoro. Supporta paginazione, ricerca e filtri per stato.

Parametri query

Parametro	Tipo	Obbligatorio	Descrizione
`organizationId`	`string`	Sì	ID dell'organizzazione.
`page`	`integer`	No	Numero di pagina (default 1).
`limit`	`integer`	No	Numero massimo di risultati (default 20, max 100).
`search`	`string`	No	Termine di ricerca testuale.
`status`	`string`	No	Filtra per stato: active, archived.
`sortField`	`string`	No	Campo per l'ordinamento.
`sortDirection`	`string`	No	Direzione ordinamento: asc o desc.

Risposta

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "type": "domestic",
      "displayTaxId": "RSSMRA80A01H501U",
      "personalInfo": {
        "firstName": "Mario",
        "lastName": "Rossi",
        "fiscalCode": "RSSMRA80A01H501U",
        "birthDate": "1980-01-01",
        "address": "Via Roma 123",
        "locality": "Milano",
        "province": "MI",
        "zipCode": "20100",
        "phone": "+39 02 1234567",
        "email": "[email protected]"
      },
      "organizationId": "org_01H8X3K",
      "archived": false,
      "archivedAt": null,
      "createdAt": "2024-01-10T09:00:00Z",
      "updatedAt": "2024-01-10T09:00:00Z"
    }
  ]
}

GET/v1/employers/{id}

Restituisce i dettagli di un singolo datore di lavoro.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID del datore di lavoro.

POST/v1/employers

Crea un nuovo datore di lavoro.

Parametri body

Parametro	Tipo	Obbligatorio	Descrizione
`type`	`string`	Sì	Tipo di datore di lavoro: domestic o business.
`organizationId`	`string`	Sì	ID dell'organizzazione.
`personalInfo`	`object`	No	Dati anagrafici per datori di tipo domestic (vedi tabella sotto).
`businessDetails`	`object`	No	Dati aziendali per datori di tipo business (vedi tabella sotto).

personalInfo (per tipo `domestic`)

Parametro	Tipo	Obbligatorio	Descrizione
`firstName`	`string`	Sì	Nome.
`lastName`	`string`	Sì	Cognome.
`fiscalCode`	`string`	No	Codice fiscale.
`birthDate`	`string`	No	Data di nascita (formato YYYY-MM-DD).
`birthLocality`	`string`	No	Comune di nascita.
`birthProvince`	`string`	No	Provincia di nascita (sigla, es. RM).
`birthCountry`	`string`	No	Paese di nascita.
`address`	`string`	No	Indirizzo di residenza.
`locality`	`string`	No	Comune di residenza.
`province`	`string`	No	Provincia di residenza (sigla).
`zipCode`	`string`	No	CAP.
`phone`	`string`	No	Numero di telefono.
`email`	`string`	No	Indirizzo email.
`pec`	`string`	No	Indirizzo PEC.

businessDetails (per tipo `business`)

Parametro	Tipo	Obbligatorio	Descrizione
`name`	`string`	Sì	Ragione sociale.
`corporationType`	`string`	No	Tipo societario: ss, snc, sas, srl, srls, spa, sapa, srl_u, coop, consorzio, ditta_individuale, prof, associazione, fondazione, ente_pubblico, other.
`businessServiceType`	`string`	No	Tipo di attività: studio, caf, private, patronato, agenzia_lavoro, other.
`vatNumber`	`string`	No	Partita IVA.
`fiscalCode`	`string`	No	Codice fiscale.
`address`	`string`	No	Sede legale.
`zipCode`	`string`	No	CAP.
`locality`	`string`	No	Comune.
`province`	`string`	No	Provincia (sigla).
`pec`	`string`	No	Indirizzo PEC.
`phone`	`string`	No	Numero di telefono.
`email`	`string`	No	Indirizzo email.

Esempio

curl -X POST https://api.workledger.it/v1/employers \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "domestic",
    "organizationId": "org_01H8X3K",
    "personalInfo": {
      "firstName": "Mario",
      "lastName": "Rossi",
      "fiscalCode": "RSSMRA80A01H501U",
      "birthDate": "1980-01-01",
      "address": "Via Roma 123",
      "locality": "Milano",
      "province": "MI",
      "zipCode": "20100"
    }
  }'

PATCH/v1/employers/{id}

Aggiorna i dati di un datore di lavoro esistente. Accetta gli stessi campi della creazione; vengono aggiornati solo i campi inclusi nel body.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID del datore di lavoro.

Esempio

curl -X PATCH https://api.workledger.it/v1/employers/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer wl_test_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "personalInfo": {
      "address": "Via Verdi 45",
      "locality": "Roma",
      "province": "RM",
      "zipCode": "00100"
    }
  }'

DELETE/v1/employers/{id}

Elimina un datore di lavoro.

Parametri path

Parametro	Tipo	Obbligatorio	Descrizione
`id`	`string`	Sì	ID del datore di lavoro.

L'eliminazione rimuove il datore di lavoro e tutti i dati associati. Verificare che non esistano contratti attivi prima di procedere.

Datori di lavoro

Parametri query

Risposta

Parametri path

Parametri body

personalInfo (per tipo domestic)

businessDetails (per tipo business)

Esempio

Parametri path

Esempio

Parametri path

personalInfo (per tipo `domestic`)

businessDetails (per tipo `business`)