Quota Cedibile¶

Totale delle voci estratte da un documento di Quota Cedibile INPS per pensionati e dipendenti pubblici.

Descrizione del Documento¶

La Quota Cedibile è il documento rilasciato dall'INPS che certifica l'importo massimo della pensione o dello stipendio che può essere ceduto a terzi (istituti di credito, finanziarie) per la restituzione di prestiti come la cessione del quinto o il prestito con delega di pagamento.

Document Type	Descrizione	Ente Erogatore
`quota_cedibile`	Comunicazione Quota Cedibile per cessione del quinto	INPS (Istituto Nazionale Previdenza Sociale)

Esempio Response Completa¶

{
   "event":"document.processed",
   "created_at":"2024-02-09T14:30:00.000Z",
   "document_id":"doc_12345",
   "application_id":"app_67890",
   "status":"DONE",
   "applicant_reference":"USR_001",
   "document_type":"quota_cedibile",
   "extracted_data":{
        "nome": "Giuseppe Verdi",
        "codice_fiscale": "VRDGPP55A01F205X",
        "importo_massimo_rata_cedibile": 380.25,
        "indirizzo": "Corso Italia 45, 20121 Milano MI",
        "trattenuta": 150.00,
        "quota_cedibile": 530.25,
        "decorrenza_inizio": "03/2023",
        "decorrenza_fine": "02/2028",
        "categoria": "quota_cedibile",
        "status": "ok"
   }
}

Struttura dei Dati Estratti¶

Campi Estratti¶

Campo	Tipo	Descrizione	Obbligatorio
`nome`	`string`	Nome e cognome completo del pensionato o dipendente	No
`codice_fiscale`	`string`	Codice fiscale italiano (16 caratteri)	No
`importo_massimo_rata_cedibile`	`float`	Importo massimo della rata mensile che può essere ceduta (€)	No
`indirizzo`	`string`	Indirizzo di residenza completo	No
`trattenuta`	`float`	Importo della rata mensile attualmente trattenuta (€)	No
`quota_cedibile`	`float`	Quota totale cedibile della pensione/stipendio (€)	No
`decorrenza_inizio`	`string`	Data inizio trattenuta (formato MM/AAAA)	No
`decorrenza_fine`	`string`	Data fine trattenuta (formato MM/AAAA)	No
`categoria`	`string`	Categoria del documento (sempre "quota_cedibile")	Sì
`status`	`string`	Stato dell'elaborazione ("ok" o "error")	Sì

Note sui Campi¶

Tutti i campi estratti possono essere null se non presenti o non leggibili nel documento
Gli importi sono sempre valori positivi con 2 decimali
Le date sono nel formato MM/AAAA (mese/anno)
Il codice fiscale viene validato e corretto automaticamente per errori OCR comuni

Validazioni Automatiche¶

Codice Fiscale¶

Il sistema applica correzioni automatiche per errori tipici di OCR:

Mapping caratteri confondibili:

Posizioni	Tipo Atteso	Correzione Applicata
0-5, 8, 11, 15	Lettera	`0→O`, `1→I`, `5→S`, `8→B`, `2→Z`
6-7, 9-10, 12-14	Numero	`O→0`, `I→1`, `S→5`, `B→8`, `Z→2`

Pattern di validazione:

^[A-Z]{6}[0-9]{2}[A-Z][0-9]{2}[A-Z][0-9]{3}[A-Z]$

Se il codice fiscale non supera la validazione, viene restituito null.

Importi¶

Regole di normalizzazione:

Tutti gli importi vengono convertiti in valori assoluti (positivi)
Formato: float con 2 decimali
Separatore decimale: punto (.)
Il simbolo € viene rimosso se presente

Esempi:

Input: "380,25 €" → Output: 380.25
Input: "-150.00" → Output: 150.00

Quota Cedibile Descrizione del Documento Esempio Response Completa Struttura dei Dati Estratti Campi Estratti Note sui Campi Validazioni Automatiche Codice Fiscale Importi