Stato di Famiglia - Dati Estratti¶

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

Informazioni Generali¶

Il certificato di stato di famiglia è un documento anagrafico corrente, emesso da ANPR (Anagrafe Nazionale della Popolazione Residente) o da un Comune, che attesta la composizione della famiglia anagrafica. Include l'intestatario, l'elenco completo dei componenti con i relativi dati anagrafici, l'indirizzo della famiglia e gli estremi di protocollo.

Sono riconosciuti anche i certificati contestuali, che uniscono allo stato di famiglia anche la Residenza e/o lo Stato civile: restano classificati come stato_di_famiglia e il campo tipi_certificato indica quali certificazioni contiene il documento.

Non rientrano in questa categoria: autocertificazioni e dichiarazioni sostitutive, stato di famiglia storico, DSU/ISEE, certificati di sola residenza o di solo stato civile.

Le pagine con lo stesso protocollo ANPR costituiscono un unico documento, anche quando le pagine finali contengono soltanto note legali, esenzione da bollo o diritti di segreteria.

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":"stato_di_famiglia",
   "extracted_data":{
        "status": "ok",
        "categoria": "stato_di_famiglia",
        "tipi_certificato": ["stato_di_famiglia", "residenza"],
        "protocollo_anpr": "ANPR-2026-0001234567",
        "protocollo_documento": null,
        "ente_emittente": "Anagrafe Nazionale della Popolazione Residente",
        "comune_registrazione": "MILANO",
        "intestatario": {
          "cognome": "ROSSI",
          "nome": "MARIO",
          "sesso": "M",
          "data_nascita": "01/01/1980",
          "luogo_nascita": "MILANO",
          "provincia_nascita": "MI",
          "atto_nascita": "Atto n. 123 P.1 S.A",
          "codice_fiscale": "RSSMRA80A01F205Z",
          "rapporto_parentela": "Intestatario",
          "stato_civile": "Coniugato"
        },
        "stato_civile_intestatario": "Coniugato",
        "componenti": [
          {
            "cognome": "ROSSI",
            "nome": "MARIO",
            "sesso": "M",
            "data_nascita": "01/01/1980",
            "luogo_nascita": "MILANO",
            "provincia_nascita": "MI",
            "atto_nascita": null,
            "codice_fiscale": "RSSMRA80A01F205Z",
            "rapporto_parentela": "Intestatario",
            "stato_civile": null
          },
          {
            "cognome": "BIANCHI",
            "nome": "LUCIA",
            "sesso": "F",
            "data_nascita": "12/05/1982",
            "luogo_nascita": "TORINO",
            "provincia_nascita": "TO",
            "atto_nascita": null,
            "codice_fiscale": "BNCLCU82E52L219K",
            "rapporto_parentela": "Moglie",
            "stato_civile": null
          }
        ],
        "numero_componenti": 2,
        "indirizzo_residenza": {
          "indirizzo": "VIA GIORDANO BRUNO, 7",
          "cap": "20154",
          "comune": "MILANO",
          "provincia": "MI"
        },
        "data_emissione": "10/09/2026",
        "numero_pagine": 2
  }
}

Struttura Response¶

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

{
  "status": "ok",
  "categoria": "stato_di_famiglia",
  // Dati del certificato (protocollo, ente, tipologie)
  // Intestatario (oggetto)
  // Componenti della famiglia (array)
  // Indirizzo di residenza (oggetto)
  // Emissione e pagine
}

Dati del Certificato¶

{
  "categoria": "stato_di_famiglia",
  "tipi_certificato": ["stato_di_famiglia", "residenza"],
  "protocollo_anpr": "ANPR-2026-0001234567",
  "protocollo_documento": null,
  "ente_emittente": "Anagrafe Nazionale della Popolazione Residente",
  "comune_registrazione": "MILANO",
  "data_emissione": "10/09/2026",
  "numero_pagine": 2
}

Campi Certificato¶

Campo	Tipo	Descrizione	Esempio
`categoria`	string	Categoria documentale, valore fisso	"stato_di_famiglia"
`tipi_certificato`	array[string]	Certificazioni contenute nel documento	["stato_di_famiglia", "residenza"]
`protocollo_anpr`	string	null	Numero di protocollo ANPR
`protocollo_documento`	string	null	Protocollo comunale, quando non è ANPR
`ente_emittente`	string	null	Ente che emette il certificato
`comune_registrazione`	string	null	Comune i cui dati anagrafici sono richiamati
`data_emissione`	string	null	Data riportata sul certificato (DD/MM/YYYY)
`numero_pagine`	int	null	Numero totale di pagine indicato sul certificato

Tipi di Certificato (tipi_certificato)¶

Valore	Descrizione
`stato_di_famiglia`	Composizione della famiglia anagrafica. Sempre presente
`residenza`	Il documento certifica anche la residenza
`stato_civile`	Il documento certifica anche lo stato civile

Intestatario¶

Persona per la quale il certificato è emesso.

{
  "intestatario": {
    "cognome": "ROSSI",
    "nome": "MARIO",
    "sesso": "M",
    "data_nascita": "01/01/1980",
    "luogo_nascita": "MILANO",
    "provincia_nascita": "MI",
    "atto_nascita": "Atto n. 123 P.1 S.A",
    "codice_fiscale": "RSSMRA80A01F205Z",
    "rapporto_parentela": "Intestatario",
    "stato_civile": "Coniugato"
  },
  "stato_civile_intestatario": "Coniugato"
}

Campi Persona¶

Lo stesso schema vale per intestatario e per ogni elemento di componenti.

Campo	Tipo	Descrizione	Esempio
`cognome`	string	null	Cognome della persona
`nome`	string	null	Nome della persona
`sesso`	string	null	Sesso, valori ammessi `M` o `F`
`data_nascita`	string	null	Data di nascita (DD/MM/YYYY)
`luogo_nascita`	string	null	Comune o Stato estero di nascita
`provincia_nascita`	string	null	Sigla provincia di nascita
`atto_nascita`	string	null	Estremi completi dell'atto di nascita
`codice_fiscale`	string	null	Codice fiscale (16 caratteri)
`rapporto_parentela`	string	null	Rapporto di parentela, solo se riportato
`stato_civile`	string	null	Stato civile, solo se riferito alla persona

Campo	Tipo	Descrizione	Esempio
`stato_civile_intestatario`	string	null	Stato civile dell'intestatario, solo nei certificati contestuali che lo riportano

Componenti della Famiglia (componenti)¶

Array contenente tutte le persone elencate nella sezione di composizione della famiglia anagrafica. L'intestatario, quando compare anche nell'elenco, è presente sia in intestatario sia fra i componenti.

{
  "componenti": [
    {
      "cognome": "ROSSI",
      "nome": "MARIO",
      "sesso": "M",
      "data_nascita": "01/01/1980",
      "luogo_nascita": "MILANO",
      "provincia_nascita": "MI",
      "atto_nascita": null,
      "codice_fiscale": "RSSMRA80A01F205Z",
      "rapporto_parentela": "Intestatario",
      "stato_civile": null
    },
    {
      "cognome": "BIANCHI",
      "nome": "LUCIA",
      "sesso": "F",
      "data_nascita": "12/05/1982",
      "luogo_nascita": "TORINO",
      "provincia_nascita": "TO",
      "atto_nascita": null,
      "codice_fiscale": "BNCLCU82E52L219K",
      "rapporto_parentela": "Moglie",
      "stato_civile": null
    }
  ],
  "numero_componenti": 2
}

I campi di ciascun componente sono quelli descritti in Campi Persona.

Campo	Tipo	Descrizione	Esempio
`componenti`	array[object]	Persone della famiglia anagrafica	vedi sopra
`numero_componenti`	int	Numero di persone in `componenti`. Calcolato dal sistema	2

Indirizzo di Residenza (indirizzo_residenza)¶

Indirizzo della famiglia anagrafica, presente quando il certificato lo riporta.

{
  "indirizzo_residenza": {
    "indirizzo": "VIA GIORDANO BRUNO, 7",
    "cap": "20154",
    "comune": "MILANO",
    "provincia": "MI"
  }
}

Campi Indirizzo¶

Campo	Tipo	Descrizione	Esempio
`indirizzo`	string	null	Via/piazza e numero civico
`cap`	string	null	Codice di Avviamento Postale
`comune`	string	null	Comune di residenza
`provincia`	string	null	Sigla della provincia di residenza

Note Implementative¶

Gestione Campi Null¶

Quasi tutti i campi possono essere null se non presenti nel documento
Verificare sempre la presenza prima dell'utilizzo
Fanno eccezione categoria, tipi_certificato, componenti e numero_componenti, sempre valorizzati

Array Vuoti¶

componenti può essere un array vuoto [], con numero_componenti a 0

Campi Calcolati dal Sistema¶

numero_componenti è sempre ricalcolato come lunghezza di componenti: non riflette un valore eventualmente stampato sul certificato
tipi_certificato contiene sempre stato_di_famiglia, anche nei certificati contestuali
Se stato_civile_intestatario è valorizzato e intestatario.stato_civile è vuoto, il primo viene copiato nel secondo

Formati Data¶

Tutte le date sono in formato DD/MM/YYYY

Validazione Codice Fiscale¶

Il codice fiscale è sempre di 16 caratteri e rispetta il formato ufficiale, poiché viene effettuato un controllo in fase di estrazione
Se il codice fiscale letto non supera la validazione, il campo viene restituito a null: un valore assente è preferibile a uno errato
Quando l'intestatario compare anche fra i componenti, il codice fiscale valido dell'uno viene usato per completare l'altro

Certificati Contestuali¶

Un certificato intitolato "Stato civile, di Stato di famiglia, di Residenza" resta document_type: "stato_di_famiglia"
Per sapere cosa contiene davvero il documento, leggere tipi_certificato

Documenti Multipagina¶

Le pagine con lo stesso protocollo_anpr sono un unico documento
Le pagine finali possono contenere solo note legali ed esenzione da bollo: non producono un documento separato

Status Elaborazione¶

status: "ok" indica elaborazione riuscita
In caso di errore la response contiene status: "ko", categoria: "stato_di_famiglia" e message con il dettaglio
Verificare sempre lo status prima di processare i dati

Stato di Famiglia - Dati Estratti Informazioni Generali Esempio Response Completa Struttura Response Dati del Certificato Campi Certificato Tipi di Certificato ( )Intestatario Campi Persona Componenti della Famiglia ( )Indirizzo di Residenza ( )Campi Indirizzo Note Implementative Gestione Campi Null Array Vuoti Campi Calcolati dal Sistema Formati Data Validazione Codice Fiscale Certificati Contestuali Documenti Multipagina Status Elaborazione