Questa guida è rivolta al personale addetto alla configurazione dell'integrazione per la PDND sulla piattaforma Interoperabilità. Richiede accesso alla piattaforma per l'interoperabilità.

La registrazione alla piattaforma potrà essere eseguita seguendo questo link:

https://www.interop.pagopa.it/

Le operazioni di seguito descritte potranno essere svolte dopo aver comunicato a noi di Cineca le informazioni che sono necessarie per abilitare il servizio.

In particolare il referente del servizio e il referente al supporto (dei quali ci serviranno Nome, Cognome e indirizzo mail valido, tale indirizzo può anche essere una casella di un ufficio di competenza).

Per la comunicazione di queste informazioni contattare Filippo Ferri al seguente indirizzo mail f.ferri@cineca.it

Quanti eservice devo aggiungere?

In base all'ente, è necessario aggiungere un eservice per ogni ifs utilizzato dall'ente, sia in ambiente di collaudo che in ambiente di produzione.

Come aggiungo un eservice?

  1. Accedere a PDND Interoperabilità.
  2. Cliccare su "I tuoi e-service" nel menu laterale, sotto "Erogazione".
  3. Cliccare su "Crea nuovo".

  4. Compilare i campi. Per la PDND, generalmente si ha a che fare con servizi REST che erogano informazioni.
    Il nome e la descrizione dell'e-service sono disponibili nella Tabella 1 – Descrizione delle nove API assegnate alle cinque fasce di Università e AFAM del progetto GitHub api-padigitale2026-misura1.3.1-uni-afam (https://github.com/italia/api-padigitale2026-misura1.3.1-uni-afam/tree/2.1) - Versione del 8-novembre. Questi codici, nomi e descrizione devono essere copiati così come da GitHub o dalla tabella sottostante
    Assicurarsi che siano spuntate la tecnologia REST e tipo di e-service Eroga prima di proseguire.

    Codice e-serviceNome e-serviceDescrizione e-service
    IFS01Consultazione offerta formativa (IFS01)Consente di consultare i corsi di studio offerti per ogni anno accademico e i relativi dettagli
    IFS02

    Consultazione iscrizioni accademiche (IFS02)

    Consente di consultare le iscrizioni per corso di studi negli ultimi 3 anni accademici, le prove d'iscrizione/ammissione, la trascrizione (esami, voti, ecc) degli studi, le attività svolte al di fuori dell'Istituto in cui uno studente si è diplomato

    IFS03Consultazione titoli accademici (IFS03)Consente di consultare il dettaglio dei titoli accademici conseguiti, le prove riguardanti il completamento e il livello di qualifica degli studi di istruzione terziaria e quelle relative allo strumento "Diploma Supplement"
    IFS04Rettifica iscrizioni accademiche (IFS04)Consente di richiedere la rettifica di un'iscrizione accademica e consultarne lo stato. Inoltre, permette di comunicare la presenza di anomalie sui dati delle iscrizioni accademiche
    IFS05Rettifica titoli accademici (IFS05)Consente di richiedere la rettifica di un titolo accademico e consultarne lo stato. Inoltre, permette di comunicare la presenza di anomalie sui dati dei titoli accademici
    IFS06Consultazione variazioni iscrizioni accademiche (IFS06)Consente di consultare le variazioni delle iscrizioni negli ultimi tre anni accademici
    IFS07Consultazione variazioni titoli accademici (IFS07)Consente di consultare le variazioni dei titoli accademici
    IFS08Consultazione numero iscritti per fasce ISEE (IFS08)Consente di consultare il numero di studenti divisi per fasce ISEE dato un anno accademico
    IFS09Consultazione numero iscritti a un corso di studi (IFS09)Consente di consultare il numero di studenti iscritti a un corso di studi dato un anno accademico
  5. Procedere cliccando su "Salva bozza e prosegui".

  6. La Durata validità, Chiamate API per fruitore e Chiamate API totali variano in base alla dimensione dell'Ente, fare riferimento alla tabella sottostante per maggiori informazioni. Se si desidera fornire automaticamente la fruizione del servizio ai richiedenti (consigliato in ambiente di collaudo), attivare il toggle dedicato sull'interfaccia.
    Prestare attenzione a quanto si inserisce nel campo audience: se si sta configurando l'integrazione per l'ente unix, per il servizio IFS01 in ambiente collaudo, bisognerà inserire unix-pdnd-collaudo/ifs01, quindi la regola generale è  (nome_ente)-pdnd-(ambiente)/(codice ifs). Gli ambienti possono essere collaudo oppure prod.
    Un esempio di audience per il collaudo dell'università unicineca che vuole attivare l'eservice ifs01 diventa quindi unicineca-pdnd-collaudo/ifs01. Il nome_ente da utilizzare è quello legato a Esse3 o comunque concordato con Cineca.
    Una configurazione errata in questo punto causerà la mancata erogazione del servizio (errore "The requested audience does not match the authorized audience").

    Codice e-serviceDurata validità (minuti)Chiamate API Fruitore
    Ateneo con iscrizioni negli ultimi 3 anni < 80.000

    Chiamate API Fruitore
    Ateneo con iscrizioni negli ultimi 3 anni >= 80.000

    		Chiamate API Totali
    Ateneo con iscrizioni negli ultimi 3 anni < 80.000

    Chiamate API Totali
    Ateneo con iscrizioni negli ultimi 3 anni >= 80.000

    IFS0110

    14400 

    28800 

    18000 

    36000 

    IFS0210

    86400 

    216000 

    108000 

    270000 

    IFS0310

    86400 

    216000 

    108000 

    270000 

    IFS0410

    14400 

    28800 

    18000 

    36000 

    IFS0510

    14400 

    28800 

    18000 

    36000 

    IFS0610

    1440 

    1440 

    1800 

    1800 

    IFS0710

    1440 

    1440 

    1800 

    1800 

    IFS0810

    1440 

    1440 

    1800 

    1800 

    IFS0910

    1440 

    1440 

    1800 

    1800 

  7. Procedere cliccando su "Salva bozza e prosegui".

  8. Impostare gli attributi minimi, indicati nella tabella che segue per ogni IFS. E' possibile definire altri attributi aggiuntivi. L'attributo "ENTE" deve venire sostituito con il nome del consorziato.


    Codice e-serviceAttributo certificato

    IFS01 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS02 

    PUBBLICHE AMMINISTRAZIONI, ENTE, Cineca Consorzio Interuniversitario

    IFS03 

    PUBBLICHE AMMINISTRAZIONI, ENTE, Cineca Consorzio Interuniversitario

    IFS04 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS05 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS06 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS07 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS08 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

    IFS09 

    MINISTERO DELL'UNIVERSITA' E DELLA RICERCA, ENTE, Cineca Consorzio Interuniversitario

  9. Procedere cliccando su "Salva bozza e prosegui".
  10. Accedere al servizio di preparazione della specifica API fornito da CINECA, disponible a questo indirizzo: https://pdnd-api-documentation.api.cineca.it/swagger-ui
  11. Cliccare su "try it out", inserire le informazioni richieste (la password è la doc_password contenuta nella configurazione dell'ente ed è stata comunicata in fase di collaudo) e poi su execute.
  12. Cliccare su "download";

           Da controllare la versione del file YAML che sia la versione 2.1.0 controllabile nel campo version del Response Body.

      13. Modificare l'estensione del file scaricato in ".yaml" e caricarla su PDND Interoperabilità.

      14. Cliccare su "Vai al riepilogo". Verificare le informazioni contenute, e cliccare su "Pubblica" per concludere.

Nel caso in cui sia necessaria una modifica, è necessario creare una nuova bozza dell'eservice, e ripetere il processo a partire dal punto 6: si viene a creare così una nuova versione dell'eservice, che andrà a sostituire quella precedente.

  • No labels