PN-Test di validazione avvenuta integrazione con Piattaforma Notifiche

Scopo di questo documento è di raccogliere i test che una PA mittente, o il suo partner tecnologico, devono effettuare e documentare per validare l’avvenuta integrazione con Piattaforma Notifiche (PN)

Per convalidare i test descritti nel documento: Test di certificazione avvenuta integrazione con Piattaforma Notifiche è possibile utilizzare il tool di validazione PN-Validator, la cui documentazione ed istruzioni di utilizzo sono esposti alla seguente pagina: https://docs.pagopa.it/pnvalidator/

Il PN-Validator genera un report in formato JSON visualizzabile contattando la url: {basUrlValidator}/checklistresult dove sono elencate una serie di domande inizialmente in false, che descrivono le azioni da compiere per considerare validati i test-case. Il report verrà aggiornato di volta in volta che le chiamate effettuate dal partner soddisferanno i requisiti richiesti dal test-case di riferimento, portando le domande in true.

Quando tutte le domande appartenenti al gruppo del test-case passeranno in true, tale test-case è da considerarsi validato; una volta eseguiti positivamente tutti i test e quando tutte le domande presenti nel report saranno passate in true, potranno essere considerati convalidati tutti i test.

Come ulteriore supporto a questa fase dell'integrazione, trovate a questo link il documento Modello di integrazione di Piattaforma Notifiche Digitali:
https://docs.pagopa.it/modello-di-integrazione-di-piattaforma-notifiche/
dove vengono descritti di diversi scenari di integrazione e le due diverse possibili modalità di aggiornamento della posizione debitoria.

In questa fase il report dovrà essere prodotto dal Partner Tecnologico utilizzando la propria soluzione di integrazione verso le API esposte dal tool PN-Validator allo scopo di produrre un report convalidato, che dovrà essere copiato all’interno di un file JSON e condiviso con il Team Supporto Enti (pn-supporto-enti@pagopa.it) che provvederà a verificarne lo stato.

In questa fase il report dovrà essere prodotto all’interno dell’ambiente degli Enti che si intendono convalidare, utilizzando sempre la soluzione sviluppata dal Partner verso le API esposte dal tool di validazione PN-Validator. Questa operazione può sia essere eseguita dagli Enti col supporto del Partner che direttamente dal Partner stesso, sempre rimanendo all’interno dell’ambiente dell’Ente di riferimento.
Dopo aver completato con successo questi passaggi, per ogni Ente sarà possibile allegare i report contenenti il buon esito sul Modulo accessibile da qui: https://pagopa.atlassian.net/servicedesk/customer/portal/5/group/28/create/150
Si evidenzia che sono presenti le istruzioni su come salvare e nominare il report che viene restituito dal tool, mentre nella restante parte del Modulo si richiede la compilazione delle informazioni principali dell’Ente che lo compila. Nell’ultima parte c’è la sezione dedicata al report che deve essere allegato in formato json.

Nel caso specifico dei Partner che hanno sviluppato una soluzione SaaS, rimane comunque fondamentale completare il processo di convalida del report che è collegato all’asseveramento; pertanto è possibile procedere nel seguente modo:

Inviare una PEC all'indirizzo pagopa@pec.governo.it che abbia nell’oggetto un riferimento al Partner Coinvolto ed al fatto che si stia utilizzando la soluzione SaaS e che contenenga i seguenti allegati:

Evidenze da produrre: Report del Validator tool; in alternativa, i documenti e metadati utilizzati per generare la notifica e requestID ottenuto

Evidenze da produrre: Report del Validator tool; in alternativa, i documenti e metadati utilizzati per generare la notifica e requestID ottenuto

TC-INVIO-02: Ricezione dello IUN e degli stati di una notifica
Prerequisito: La PA mittente definisce uno stream attraverso il quale ricevere i dati relativi agli elementi di timeline di una notifica

Evidenza da produrre: Report del Validator tool; in alternativa, il requestID della notifica che ha avuto successo e lo IUN corrispondente; inoltre fornisce, per quello IUN, la data e tipologia di tutti gli eventi ricevuti ed il relativo timestamp (quello restituito dall’API). Viene verificato che le chiamate all’API rispettano le indicazioni fornite attraverso il parametro retry-after

TC-INVIO-03: Scaricamento attestazioni opponibili ai terzi e ricevute
Prerequisito: La PA mittente ha ricevuto gli eventi di timeline di una notifica

Evidenza da produrre: Report del Validator tool; in alternativa, per ogni elemento di timeline contenente un riferimento ad un documento vengono forniti IUN, tipologia dell’elemento di timeline, timestamp e documento scaricato

Scenario 1: La PA mittente ha creato una notifica di test nella quale l’ente creditore per il pagamento coincide con la PA mittente. Si procede all’accesso alla notifica attraverso il portale Destinatario oppure si effettua il pagamento di uno degli IUV associati alla notifica

Evidenza da produrre: Report del Validator tool; in alternativa, IUN, timestamp della richiesta di validazione, timestamp del perfezionamento restituito dall’API, costo della notifica restituito dall’API

Scenario 2: La PA mittente ha creato una notifica di test nella quale l’ente creditore per il pagamento non coincide con la PA mittente (ad esempio nel caso esista un Ente Riscossore diverso dall’Ente mittente della notifica). La Pa mittente del processo d’integrazione verso PN ha provveduto ad includere l’ente creditore responsabile per l’attualizzazione della posizione debitoria. Si procede all’accesso alla notifica attraverso il portale Destinatario oppure si effettua il pagamento di uno degli IUV associati alla notifica

Evidenza da produrre: Report del Validator tool; in alternativa, IUN, timestamp della richiesta di validazione, timestamp del perfezionamento, costo della notifica restituito dall’API