# Integrazione con PDND

## Flusso di Integrazione e Fruizione

### Processo di Adesione e Configurazione (Lato Ente/PDND e OpenCity):

* L'ente (es. Comune) deve prima abilitarsi sulla piattaforma PDND (procedura di PagoPA tramite SPID).
* Sulla piattaforma PDND (spesso guidati o fatti da noi per l'ente):
  * Si crea un Client.
  * Si richiede la Fruizione degli e-service desiderati (es. ANPR stato famiglia). Questa richiesta deve essere approvata dall'ente erogatore.
  * Si crea una Finalità per ogni e-service richiesto, specificando le motivazioni e l'analisi del rischio. Anche questa finalità deve essere approvata.
  * Si associa la Finalità approvata e la Chiave Pubblica al Client sulla PDND.
* Sulla Piattaforma OpenCity:
  * Si crea un Client corrispondente a quello creato sulla PDND.
  * Si genera una Chiave Pubblica (tramite un'API del PDND Connector) e la si associa al Client sulla PDND.
  * Si inseriscono gli identificativi ottenuti dalla PDND: Client ID, KID e Purpose ID (ParID).
  * Si abilitano gli E-service (configurati con il Client e la Finalità) a livello di "tenant" (per tutti i servizi compatibili) o di "singolo servizio".
  * Si configura il Nested Form sul frontend per ricevere i dati da quello specifico e-service.

## Ulteriori Dettagli e Supporto

### **Documentazione**

* Le slide [OpenCity\_Richiesta di fruizione dati via PDND\_public link.pdf](https://docs.google.com/presentation/d/1vwNEXNLN--xdE-MHkOKzLiya6DjtRGeE0aNjvIMk6MQ/edit?slide=id.g2286e170a2b_0_0#slide=id.g2286e170a2b_0_0) sono ottime per gli step lato Ente/PDND.
* Le registrazioni video sono essenziali per vedere il flusso pratico:
  * La "Videolezione 1: Formazione Pdnd" per il contesto generale, gli attori, e la demo di configurazione/fruizione;
  * La "Videolezione 2: Revisione codice PDND" per il funzionamento interno del Connector (flusso GET/POST, struttura codice).

### **Ambiente di Lavoro**

Serve l'accesso alla piattaforma PDND (test/collaudo) con permessi adeguati (amministratore è meglio). Richiedere i permessi per comuni di test come Asolo o Vicopisano. Configurare un ambiente locale per testare il PDND Connector, magari copiando le configurazioni esistenti da S3 (richiedere credenziali).

### **Processo di Lavoro**

Seguire la [Guida Passo Passo per l'Integrazione della PDND](https://docs.google.com/document/d/1evLrT2gaSsrRnvVrT1Ss6B_gfpIGa0JNDODIcXNG6_Y/edit?tab=t.0): identificare l'e-service (con PMs), studiarlo (dati vs form), e creare una issue dettagliata che includa lo studio, la mappatura, e la definizione della risposta del Connector.

### **Problemi Noti**

Ci sono aree in miglioramento: lo Swagger del Connector potrebbe non funzionare nell'ambiente QA, la gestione degli ambienti collaudo/produzione sulla UI della Stanza ha delle criticità (è stata aperta una issue per questo), la strategia di caching nel Connector ha delle criticità.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opencityitalia.it/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-pdnd.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.