Cedolini Pensione - Dati Estratti¶

Elenco completo delle voci che è possibile estrarre automaticamente dai cedolini di pensione di diversi enti previdenziali.

Macrocategorie Supportate¶

I vari documenti si classificano in macrocateogire, attualmente è lo stesso valore delle sottocategorie :

cedolino_inps - Cedolino INPS standard
cu_inps - Certificazione Unica INPS
obis_m_inps - Modello OBIS/M INPS
cedolino_inpdap - Cedolino INPDAP/NOIPA
cedolino_enasarco - Cedolino Enasarco

Categorie Supportate¶

L'API riconosce e processa le seguenti sottocategorie :

cedolino_inps - Cedolino INPS standard
cu_inps - Certificazione Unica INPS
obis_m_inps - Modello OBIS/M INPS
cedolino_inpdap - Cedolino INPDAP/NOIPA
cedolino_enasarco - Cedolino Enasarco
sconosciuto - Documento non identificato

Cedolino INPS (cedolino_inps)¶

Esempio Response completa¶

{
  "event": "document.processed",
  "created_at": "2025-09-08T17:45:00+00:00",
  "document_id": "abc12345-6789-def0-1234-56789abcdef0",
  "application_id": "def98765-4321-fedc-ba09-0123456789ab",
  "applicant_reference": "USER-001",
  "status": "DONE",
  "document_type": "cedolino_inps",
    "extracted_data": {
      "categoria" : "cedolino_inps",
      "nome": "CONTI GIOVANNI MARCO",
      "codice_fiscale": "CNTGNN55A15H501B",
      "periodo": "06/2025",
      "pensione_lorda": 1850.75,
      "pensione_netta": 1420.30,
      "codice_prestazione": "001880110131205",
      "trattenuta": 285.50,
      "recupero_obbligatorio": 144.95,
      "decorrenza_inizio": "01/01/2020",
      "recupero_indebiti_rateale": 85.00,
      "codice_pensione_descrizione": "Pensione di vecchiaia",
      "codice_sede_descrizione": "Sede INPS Milano",
      "numero_pensione": "110131205",
      "invalidita": false
    }
}

Campi Cedolino INPS¶

Campo	Tipo	Obbligatorio	Descrizione	Esempio
`nome`	string	Sì	Nome e cognome del pensionato	"CONTI GIOVANNI MARCO"
`codice_fiscale`	string	null	No	Codice fiscale (16 caratteri)
`periodo`	string	Sì	Periodo di paga (MM/AAAA)	"06/2025"
`pensione_lorda`	float	null	No	Importo lordo pensione
`pensione_netta`	float	null	No	Importo netto pensione
`codice_prestazione`	string	Sì	Codice prestazione pensione	"001880110131205"
`trattenuta`	float	null	No	Trattenuta obbligatoria
`recupero_obbligatorio`	float	null	No	Recupero obbligatorio
`decorrenza_inizio`	string	null	No	Data decorrenza (GG/MM/AAAA)
`recupero_indebiti_rateale`	float	null	No	Recupero indebiti rateale

Campi Derivati¶

Campo	Tipo	Descrizione
`codice_pensione_descrizione`	string	null
`codice_sede_descrizione`	string	null
`numero_pensione`	string	null
`invalidita`	bool	null

Certificazione Unica INPS (cu_inps)¶

Esempio Response¶

{
  "event": "document.processed",
  "created_at": "2025-09-08T17:45:00+00:00",
  "document_id": "abc12345-6789-def0-1234-56789abcdef0",
  "application_id": "def98765-4321-fedc-ba09-0123456789ab",
  "applicant_reference": "USER-001",
  "status": "DONE",
  "document_type": "cedolino_pensione",
  "extracted_data": {
      "categoria" : "cu_inps",
      "decorrenza_inizio": "15/03/1995",
      "data_nascita": "12/08/1940",
      "codice_fiscale": "RSSANA40M52F205W",
      "nome": "RUSSO ANNA MARIA",
      "comune_nascita": "FIRENZE",
      "provincia_nascita": "FI",
      "pensione_lorda": 18500.00,
      "ritenute_irpef": 2800.50,
      "codice_prestazione": "001880110131205",
      "codice_pensione_descrizione": "Pensione di vecchiaia",
      "codice_sede_descrizione": "Sede INPS Firenze",
      "numero_pensione": "110131205",
      "invalidita": false
  }
}

Campi CU INPS¶

Campo	Tipo	Descrizione	Esempio
`decorrenza_inizio`	string	null	Anno decorrenza pensione
`data_nascita`	string	null	Data di nascita
`codice_fiscale`	string	null	Codice fiscale contribuente
`nome`	string	null	Nome e cognome
`comune_nascita`	string	null	Comune di nascita
`provincia_nascita`	string	null	Provincia di nascita
`pensione_lorda`	float	null	Reddito totale lordo
`ritenute_irpef`	float	null	Totale ritenute IRPEF
`codice_prestazione`	string	Codice prestazione	"001880110131205"

Modello OBIS/M INPS (obis_m_inps)¶

Esempio Response completa¶

{
  "event": "document.processed",
  "created_at": "2025-09-08T17:45:00+00:00",
  "document_id": "abc12345-6789-def0-1234-56789abcdef0",
  "application_id": "def98765-4321-fedc-ba09-0123456789ab",
  "applicant_reference": "USER-001",
  "status": "DONE",
  "document_type": "cedolino_pensione",
  "extracted_data": {
      "categoria" : "obis_m_inps",
      "decorrenza_inizio": "gennaio 2018",
      "nome": "VERDI GIUSEPPE ANTONIO",
      "codice_fiscale": "VRDGPP60T20L736M",
      "codice_prestazione": "001880110131205",
      "pensione_lorda": 1950.25,
      "codice_pensione_descrizione": "Pensione di vecchiaia",
      "codice_sede_descrizione": "Sede INPS Torino",
      "numero_pensione": "110131205",
      "invalidita": false
  }
}

Campi OBIS/M INPS¶

Campo	Tipo	Descrizione	Esempio
`decorrenza_inizio`	string	null	Mese e anno decorrenza
`nome`	string	null	Nome e cognome pensionato
`codice_fiscale`	string	null	Codice fiscale
`codice_prestazione`	string	Codice prestazione	"001880110131205"
`pensione_lorda`	float	null	Rata mensile lorda

Cedolino INPDAP/NOIPA (cedolino_inpdap)¶

Esempio Response completa¶

{
  "event": "document.processed",
  "created_at": "2025-09-08T17:45:00+00:00",
  "document_id": "abc12345-6789-def0-1234-56789abcdef0",
  "application_id": "def98765-4321-fedc-ba09-0123456789ab",
  "applicant_reference": "USER-001",
  "status": "DONE",
  "document_type": "cedolino_pensione",
  "extracted_data": {
      "categoria" : "cedolino_inpdap",
      "nome": "BIANCHI LUCIA FRANCESCA",
      "codice_fiscale": "BNCLCF58D47H501R",
      "periodo": "07/2025",
      "pensione_lorda": 2350.80,
      "pensione_netta": 1780.45,
      "codice_prestazione": "218880110131205",
      "trattenuta": 420.35,
      "recupero_obbligatorio": 150.00,
      "decorrenza_inizio": "01/09/2018",
      "recupero_indebiti_rateale": 75.50,
      "codice_pensione_descrizione": "Pensione di anzianità",
      "codice_sede_descrizione": "Sede INPDAP Roma",
      "numero_pensione": "880110131205",
      "invalidita": false
  }
}

Campi Cedolino INPDAP¶

Campo	Tipo	Obbligatorio	Descrizione	Esempio
`nome`	string	Sì	Nome e cognome dipendente	"BIANCHI LUCIA FRANCESCA"
`codice_fiscale`	string	null	No	Codice fiscale (16 caratteri)
`periodo`	string	Sì	Periodo di paga (MM/AAAA)	"07/2025"
`pensione_lorda`	float	null	No	Totale stipendio lordo
`pensione_netta`	float	null	No	Pensione netta finale
`codice_prestazione`	string	Sì	Codice prestazione pensione	"218880110131205"
`trattenuta`	float	null	No	Trattenuta obbligatoria
`recupero_obbligatorio`	float	null	No	Recupero obbligatorio
`decorrenza_inizio`	string	null	No	Data decorrenza (GG/MM/AAAA)
`recupero_indebiti_rateale`	float	null	No	Recupero indebiti rateale

Codice Prestazione INPDAP¶

Il codice prestazione INPDAP inizia con un prefisso di 3 cifre seguito da 12 cifre:

Formato: XXX + XXXXXXXXXXXX (es. "218880110131205")
Varianti: Tutto attaccato o con spazio tra prefisso e resto

Cedolino Enasarco (cedolino_enasarco)¶

Esempio Response¶

{
  "event": "document.processed",
  "created_at": "2025-09-08T17:45:00+00:00",
  "document_id": "abc12345-6789-def0-1234-56789abcdef0",
  "application_id": "def98765-4321-fedc-ba09-0123456789ab",
  "applicant_reference": "USER-001",
  "status": "DONE",
  "document_type": "cedolino_pensione",
  "extracted_data": {
      "categoria" : "cedolino_enasarco",
      "nome": "GALLI ROBERTO MICHELE",
      "periodo": "06/2025",
      "pensione_lorda": 1680.90,
      "pensione_netta": 1340.75,
      "trattenuta": 340.15
  }
}

Campi Cedolino Enasarco¶

Campo	Tipo	Obbligatorio	Descrizione	Esempio
`nome`	string	null	No	Nome e cognome iscritto
`periodo`	string	null	No	Periodo riferimento (MM/AAAA)
`pensione_lorda`	float	Sì	Importo lordo pensione	1680.90
`pensione_netta`	float	Sì	Importo netto a pagare	1340.75
`trattenuta`	float	null	No	Trattenute tassabili emolumenti

Decodifica Codice Prestazione¶

Struttura Codice¶

Il codice_prestazione è composto da:

3 cifre iniziali: Identificativo tipo prestazione
12 cifre successive: Dati specifici pensione

Prefissi Comuni¶

Prefisso	Tipo Prestazione	Ente
`001`	Pensione di vecchiaia	INPS
`002`	Pensione di invalidità	INPS
`003`	Pensione ai superstiti	INPS
`218`	Pensione dipendenti pubblici	INPDAP
`320`	Pensione ex INPDAP	NOIPA

Campi Derivati dal Codice¶

Dall'analisi del codice_prestazione si estraggono:

Descrizione tipo pensione
Sede di riferimento
Numero identificativo
Flag invalidità

Note Implementative¶

Validazione Codice Fiscale¶

Tutti i documenti supportano correzione automatica CF
Validazione lunghezza 16 caratteri

Formati Data¶

Standard: GG/MM/AAAA (es. "15/06/2025")
Periodo: MM/AAAA (es. "06/2025")

Enti Previdenziali¶

INPS: Gestione pensioni private
INPDAP: Ex dipendenti pubblici (ora NOIPA)
Enasarco: Agenti e rappresentanti
NOIPA: Nuova gestione dipendenti pubblici

Campi Obbligatori per Tipo¶

Tipo	Campi Obbligatori
`cedolino_inps`	nome, periodo, codice_prestazione
`cu_inps`	codice_prestazione
`obis_m_inps`	codice_prestazione
`cedolino_inpdap`	nome, periodo, codice_prestazione
`cedolino_enasarco`	pensione_lorda, pensione_netta

Arricchimento Automatico¶

I documenti con codice_prestazione vengono automaticamente arricchiti
Decodifica automatica tipo pensione e sede

Gestione Errori¶

Correzione automatica spazi nel codice prestazione
Normalizzazione formati numerici
Validazione coerenza dati estratti

Cedolini Pensione - Dati Estratti Macrocategorie Supportate Categorie Supportate Cedolino INPS ( )Esempio Response completa Campi Cedolino INPS Campi Derivati Certificazione Unica INPS ( )Esempio Response Campi CU INPS Modello OBIS/M INPS ( )Esempio Response completa Campi OBIS/M INPS Cedolino INPDAP/NOIPA ( )Esempio Response completa Campi Cedolino INPDAP Codice Prestazione INPDAP Cedolino Enasarco ( )Esempio Response Campi Cedolino Enasarco Decodifica Codice Prestazione Struttura Codice Prefissi Comuni Campi Derivati dal Codice Note Implementative Validazione Codice Fiscale Formati Data Enti Previdenziali Campi Obbligatori per Tipo Arricchimento Automatico Gestione Errori