> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/utilizzo-di-dati-certificati-da-pdnd/integrare-un-servizio-digitale-con-la-piattaforma-digitale-nazionale-dati.md).

# Integrare un servizio digitale con la Piattaforma Digitale Nazionale Dati

#### Gli e-service disponibili

Questi sono gli e-service supportati dal PDND Connector, cioè quelli che la piattaforma è in grado di chiamare.&#x20;

| E-service                            | Nested form           |
| ------------------------------------ | --------------------- |
| C020 Accertamento Residenza          | Residenza (archetipo) |
| C021 Stato famiglia                  | OC - Figli            |
| C021 Stato famiglia                  | OC - Genitori         |
| C021 Stato famiglia                  | OC - Coniuge          |
| C021 Stato famiglia                  | OC - Nucleo familiare |
| Attestazione ISEE                    | OC - ISEE Ordinario   |
| Attestazione ISEE                    | OC - ISEE Minorenni   |
| Consultazione Indicatore Nucleo ICEF | OC - ICEF             |

{% hint style="info" %}
OC - ISEE Minorenni richiede una configurazione aggiuntiva: vedi [l’ISEE per un minorenne e PDND](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form#lisee-per-un-minorenne-e-pdnd).
{% endhint %}

### Quando la PDND precompila i dati

La PDND recupera i dati a partire dal codice fiscale del richiedente. Si tratta dei suoi dati personali e di quelli delle persone collegate in anagrafe, come i figli, il coniuge, il nucleo familiare oppure l'ISEE.

Per questo la precompilazione si attiva in base alla qualifica di chi presenta la richiesta. Se con la qualifica scelta i dati collegati al richiedente non sono pertinenti, la PDND non si attiva e i campi restano da compilare.&#x20;

In questo modo il cittadino trova sempre i campi precompilati con dati pertinenti e può proseguire la compilazione.

**Elenco ruoli che escludono la precompilazione della PDND**

I servizi digitali prevedono la select “In qualità di”, con property name `for_whom` oppure `in_virtue`, che serve a indicare la qualifica del richiedente. La select va posizionata prima del nested form.

Se il cittadino sceglie una delle qualifiche elencate qui sotto, la PDND non precompila i campi dei nested form successivi, che restano liberi e modificabili. Con tutte le altre qualifiche, la PDND precompila i campi con i dati collegati al richiedente.

| Valori che escludono la precompilazione della PDND | Nested form           |
| -------------------------------------------------- | --------------------- |
| tutore                                             | OC - Coniuge          |
| tutore                                             | OC - Genitore         |
| delegato, tutore                                   | OC - Nucleo familiare |
| tutore                                             | OC - Figli            |
| delegato, tutore                                   | OC - ISEE Ordinario   |
| delegato, tutore                                   | OC - ISEE Minorenni   |
| delegato, tutore                                   | OC - ICEF             |

### Esempio di precompilazione in base alla qualifica

Se il richiedente presenta la richiesta come "genitore", e nel servizio è presente il nested form OC-Figli la PDND precompila i dati dei figli. Se invece la presenta come "tutore" la PDND non si attiva, perché il minore non fa parte del suo nucleo familiare.

{% columns %}
{% column %}

<figure><img src="https://4252442743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrdV0mwA7iy2c3I7wu5BX%2Fuploads%2FaxvP2tUhAIIEA1SX9sQP%2Ftutore%20-%20figli.png?alt=media&amp;token=b54cb748-f890-451a-a1c0-8c1fb6a12741" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="https://4252442743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrdV0mwA7iy2c3I7wu5BX%2Fuploads%2FQmKdvtOOJmhonuFrdjmy%2Fscreenshot_oscurato.png?alt=media&amp;token=0d976c03-372f-47d0-b4fb-015f2e3d89a1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### Configurare la qualifica del richiedente

Per attivare l’e-service in base alla qualifica del richiedente, inserisci nel modulo del servizio una [select](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/la-select) **“In qualità di”** con property name `for_whom`, posizionata prima del nested form.\
In base al nested form che vuoi utilizzare controlla il for\_whom&#x20;

<figure><img src="https://4252442743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrdV0mwA7iy2c3I7wu5BX%2Fuploads%2FUooHILn1JNAvWwUsFWob%2Fselect%20in%20qualita%CC%80%20di.gif?alt=media&amp;token=9001c705-7f75-4750-b6ce-08a16ca70ae1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se la select “In qualità di” non è presente e l’e-service è configurato correttamente, cioè con il[ property name assegnato](https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/i-componenti/i-nested-form), la PDND si attiva sempre: i campi del nested form vengono precompilati con i dati associati al codice fiscale del richiedente.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.opencityitalia.it/stanza-del-cittadino/guida-alla-creazione-dei-servizi-digitali/creare-un-servizio/utilizzo-di-dati-certificati-da-pdnd/integrare-un-servizio-digitale-con-la-piattaforma-digitale-nazionale-dati.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
