Certificato di Stipendio - Dati Estratti¶

Elenco completo delle voci che si possono estrarre automaticamente dai certificati di stipendio.

Informazioni Generali¶

Il certificato di stipendio è un documento ufficiale che attesta la situazione lavorativa e retributiva di un dipendente. Include dati anagrafici, contrattuali, retributivi e informazioni su eventuali debiti e TFR.

Esempio Response Completa¶

{
   "event":"document.processed",
   "created_at":"2025-09-01T15:37:36.467736+00:00",
   "document_id":"0cd0ca0f-7a02-4deb-b2a8-445f694af865",
   "application_id":"c3a058c3-2243-4f83-92ce-d6e4fd3e89ae",
   "applicant_reference": "USER-001",
   "status":"DONE",
   "document_type":"certificato_stipendio",
   "extracted_data":{
        "status": "ok",
        "message": "Elaborazione effettuata",
        "azienda": "TECH INNOVATIONS S.R.L.",
        "legale_rappresentate": "Andrea Bianchi",
        "sede_citta": "MILANO",
        "sede_cap": "20121",
        "sede_via": "Via Montenapoleone n. 15",
        "p_iva": "01234567890",
        "capitale_sociale": 500000.00,
        "dipendente_nome": "VERDI GIULIA FRANCESCA",
        "codice_fiscale_dipendente": "VRDGLI88H47F205K",
        "dipendente_nato_luogo": "FIRENZE",
        "dipendente_nato_data": "07/06/1988",
        "dipendente_residenza": "SCANDICCI",
        "dipendente_residenza_via": "VIA DELLA REPUBBLICA, 42",
        "dipendente_qualifica": "IMPIEGATO TECNICO",
        "data_assunzione": "15/09/2019",
        "tempo_indeterminato": true,
        "superamento_prova": true,
        "anni_servizio_totali": "5 anni e 4 mesi",
        "retribuzione_lorda_annua": 35000.00,
        "retribuzione_lorda_mensile": 2916.67,
        "retribuzione_netta_mensile": 2150.50,
        "numero_mensilita": "13",
        "firma": true,
        "data": "10/07/2025",
        "debiti_lista": [
          {
            "tipo_prestito": "cessione",
            "ente_prestito": "COMPASS BANCA S.P.A.",
            "importo_rata": 280.50,
            "data_scadenza": "12/2027",
            "rate_restanti": 36,
            "importo_totale_debito": 10098.00
          }
        ],
        "tfr_lista": [
          {
            "tipo_tfr": "tfr_azienda",
            "ente_tfr": "TECH INNOVATIONS S.R.L.",
            "importo_totale_tfr": 8750.25
          },
          {
            "tipo_tfr": "tfr_fondo",
            "ente_tfr": "COMETA FONDO PENSIONE",
            "importo_totale_tfr": 12500.80
          }
        ]
  }
}

Struttura Response¶

La response dell'API per i certificati di stipendio è organizzata in sezioni principali:

{
  "status": "ok",
  "message": "Elaborazione effettuata",
  // Dati azienda
  // Dati dipendente  
  // Dati retributivi
  // Firma e data
  // Debiti (array)
  // TFR (array)
}

Dati Azienda/Datore di Lavoro¶

{
  "azienda": "TECH INNOVATIONS S.R.L.",
  "legale_rappresentate": "Andrea Bianchi",
  "sede_citta": "MILANO",
  "sede_cap": "20121",
  "sede_via": "Via Montenapoleone n. 15",
  "p_iva": "01234567890",
  "capitale_sociale": 500000.00
}

Campi Azienda¶

Campo	Tipo	Descrizione	Esempio
`azienda`	string	Nome dell'azienda/amministrazione	"TECH INNOVATIONS S.R.L."
`legale_rappresentate`	string	null	Nome del rappresentante legale
`sede_citta`	string	Città sede aziendale	"MILANO"
`sede_cap`	string	null	Codice di Avviamento Postale
`sede_via`	string	null	Indirizzo sede
`p_iva`	string	Partita IVA o Codice Fiscale	"01234567890"
`capitale_sociale`	float	null	Capitale sociale dell'azienda

Informazioni Dipendente¶

{
  "dipendente_nome": "VERDI GIULIA FRANCESCA",
  "codice_fiscale_dipendente": "VRDGLI88H47F205K",
  "dipendente_nato_luogo": "FIRENZE",
  "dipendente_nato_data": "07/06/1988",
  "dipendente_residenza": "SCANDICCI",
  "dipendente_residenza_via": "VIA DELLA REPUBBLICA, 42",
  "dipendente_qualifica": "IMPIEGATO TECNICO",
  "data_assunzione": "15/09/2019",
  "tempo_indeterminato": true,
  "superamento_prova": true,
  "anni_servizio_totali": "5 anni e 4 mesi"
}

Campi Dipendente¶

Campo	Tipo	Descrizione	Esempio
`dipendente_nome`	string	Nome completo del dipendente	"VERDI GIULIA FRANCESCA"
`codice_fiscale_dipendente`	string	Codice fiscale (16 caratteri)	"VRDGLI88H47F205K"
`dipendente_nato_luogo`	string	null	Luogo di nascita
`dipendente_nato_data`	string	null	Data di nascita (DD/MM/YYYY)
`dipendente_residenza`	string	null	Città di residenza
`dipendente_residenza_via`	string	null	Indirizzo di residenza
`dipendente_qualifica`	string	null	Qualifica o ruolo
`data_assunzione`	string	null	Data assunzione (DD/MM/YYYY)
`tempo_indeterminato`	boolean	null	Contratto a tempo indeterminato
`superamento_prova`	boolean	null	Periodo di prova superato
`anni_servizio_totali`	string	null	Anzianità di servizio

Informazioni Retributive¶

{
  "retribuzione_lorda_annua": 35000.00,
  "retribuzione_lorda_mensile": 2916.67,
  "retribuzione_netta_mensile": 2150.50,
  "numero_mensilita": "13"
}

Campi Retributivi¶

Campo	Tipo	Descrizione	Esempio
`retribuzione_lorda_annua`	float	null	Stipendio lordo annuale
`retribuzione_lorda_mensile`	float	null	Stipendio lordo mensile
`retribuzione_netta_mensile`	float	null	Stipendio netto mensile
`numero_mensilita`	string	null	Numero mensilità annue

Firma e Data¶

{
  "firma": true,
  "data": "10/07/2025"
}

Campi Firma¶

Campo	Tipo	Descrizione	Esempio
`firma`	boolean	null	Documento firmato
`data`	string	null	Data compilazione (DD/MM/YYYY)

Debiti e Obbligazioni (debiti_lista)¶

Array contenente tutti i debiti, cessioni e pignoramenti del dipendente:

{
  "debiti_lista": [
    {
      "tipo_prestito": "cessione",
      "ente_prestito": "COMPASS BANCA S.P.A.",
      "importo_rata": 280.50,
      "data_scadenza": "12/2027",
      "rate_restanti": 36,
      "importo_totale_debito": 10098.00
    },
    {
      "tipo_prestito": "pignoramento",
      "ente_prestito": "TRIBUNALE DI MILANO",
      "importo_rata": 150.00,
      "data_scadenza": null,
      "rate_restanti": null,
      "importo_totale_debito": 4500.00
    },
    {
      "tipo_prestito": "prestito_aziendale",
      "ente_prestito": "TECH INNOVATIONS S.R.L.",
      "importo_rata": 100.00,
      "data_scadenza": "06/2025",
      "rate_restanti": 12,
      "importo_totale_debito": 1200.00
    }
  ]
}

Tipi di Debito¶

Tipo	Descrizione	Esempi
`cessione`	Cessione del quinto dello stipendio	Prestiti personali, finanziamenti
`pignoramento`	Pignoramento stipendio	Decreti ingiuntivi, debiti tributari
`prestito_aziendale`	Prestiti concessi dall'azienda	Anticipi, prestiti dipendenti
`assegno_di_mantenimento`	Assegni di mantenimento	Alimenti, mantenimento figli
`altro`	Altri tipi di obbligazioni	Varie tipologie

Campi Debito¶

Campo	Tipo	Descrizione	Esempio
`tipo_prestito`	string	Tipologia del debito	"cessione"
`ente_prestito`	string	null	Ente creditore
`importo_rata`	float	null	Importo rata mensile
`data_scadenza`	string	null	Data scadenza
`rate_restanti`	int	null	Rate rimanenti
`importo_totale_debito`	float	null	Debito residuo totale

TFR - Trattamento di Fine Rapporto (tfr_lista)¶

Array contenente le informazioni sui fondi TFR del dipendente:

{
  "tfr_lista": [
    {
      "tipo_tfr": "tfr_azienda",
      "ente_tfr": "TECH INNOVATIONS S.R.L.",
      "importo_totale_tfr": 8750.25
    },
    {
      "tipo_tfr": "tfr_fondo",
      "ente_tfr": "COMETA FONDO PENSIONE",
      "importo_totale_tfr": 12500.80
    },
    {
      "tipo_tfr": "anticipi",
      "ente_tfr": "anticipi erogati",
      "importo_totale_tfr": 3000.00
    }
  ]
}

Tipi di TFR¶

Tipo	Descrizione	Dettagli
`tfr_azienda`	TFR mantenuto in azienda	Fondi presso il datore di lavoro
`tfr_fondo`	TFR destinato a fondo pensione	Fondi pensione complementare
`anticipi`	Anticipi TFR già erogati	Importi già ricevuti dal dipendente

Campi TFR¶

Campo	Tipo	Descrizione	Esempio
`tipo_tfr`	string	Tipologia destinazione TFR	"tfr_azienda"
`ente_tfr`	string	null	Nome del fondo o ente
`importo_totale_tfr`	float	null	Importo totale accumulato

Note Implementative¶

Gestione Campi Null¶

Molti campi possono essere null se non presenti nel documento
Verificare sempre la presenza prima dell'utilizzo
I campi obbligatori sono: azienda, p_iva, dipendente_nome, codice_fiscale_dipendente

Array Vuoti¶

debiti e tfr_lista possono essere array vuoti []

Formati Data¶

Tutte le date sono in formato DD/MM/YYYY

Validazione Codice Fiscale¶

Il codice fiscale è sempre di 16 caratteri, rispetta quindi il formato ufficiale poichè viene effettuato un controllo in fase di estrazione

Importi Monetari¶

Tutti gli importi sono in Euro (€)

Status Elaborazione¶

status: "ok" indica elaborazione riuscita
message: contiene dettagli sull'elaborazione
Verificare sempre il status prima di processare i dati

Certificato di Stipendio - Dati Estratti Informazioni Generali Esempio Response Completa Struttura Response Dati Azienda/Datore di Lavoro Campi Azienda Informazioni Dipendente Campi Dipendente Informazioni Retributive Campi Retributivi Firma e Data Campi Firma Debiti e Obbligazioni ( )Tipi di Debito Campi Debito TFR - Trattamento di Fine Rapporto ( )Tipi di TFR Campi TFR Note Implementative Gestione Campi Null Array Vuoti Formati Data Validazione Codice Fiscale Importi Monetari Status Elaborazione