SEND - F.A.Q. per integratori
v2.0
v2.0
  • Knowledge-base di Piattaforma Notifiche
    • Generazione client e definizioni delle API
    • Workflow di Notifica
    • FAQ inserimento notifiche
    • FAQ sulle streams
    • Focus su Interoperabilità e generazione Voucher per SEND - UAT (Piattaforma Notifiche)
      • Configurare l'accesso ad Interoperabilità
      • Focus su creazione richiesta di fruizione generazione Voucher per SEND - UAT (Piattaforma Notifiche)
      • FAQ su Interoperabilità
    • Focus sull'inserimento della notifica
      • Inserimento Notifica con il comando curl
      • Inserimento Notifica con Postman
    • Focus sulla creazione e gestione delle stream
      • Inserimento e creazione stream con il comando curl
      • Inserimento e creazione stream con Postman
    • Focus sulla validazione della Richiesta di invio Notifica
    • Focus sul Perfezionamento della notifica
    • Focus sull'attualizzazione della posizione debitoria
    • PN-Test di validazione avvenuta integrazione con Piattaforma Notifiche
    • Focus sulla validazione dei test con il tool PnValidator
  • Normalizzatore
  • Modalità per simulare i casi di test in ambiente UAT
  • Composizione degli indirizzi
  • API CHANGELOG
    • API VERSIONE GA 2.0
Powered by GitBook
On this page
  • Validazione Sincrona
  • Validazione Asicrona
  1. Knowledge-base di Piattaforma Notifiche

Focus sulla validazione della Richiesta di invio Notifica

Approfondimento sulla validazione che PND effettua sulle richieste di invio Notifica

Last updated 1 year ago

In fase di inserimento di una Richiesta di invio Notifica, Piattaforma Notifiche effettua 2 diversi tipi di validazione per assicurarsi che le informazioni inserite siano corrette e congruenti: la Validazione Sincrona e la Validazione Asincrona.

Validazione Sincrona

Nel momento stesso in cui si chiama il servizio di Richiesta di invio Notifica vengono effettuate delle verifiche formali sui campi inseriti: il dettaglio dei controlli applicati per ogni campo è documentato nel seguente file Swagger: Se la request inviata supera tutti i controlli, il servizio restituisce una response con Status: 202 Accepted e con body contenente: notificationRequestId, paProtocolNumber e idempotenceToken che sono i riferimenti per poter verificare l'esito dei controlli asincroni che verranno effettuati da questo momento in poi.

Validazione Asicrona

Dopo aver inserito con successo una Richiesta di invio Notifica ed aver ottenuto i riferimenti della stessa, Piattaforma Notifiche avvierà le seguenti verifiche:

  • Verifica che gli SHA-256 forniti dal Mittente coincidano con quelli calcolati da PN a partire dai documenti allegati

  • Verifica che il versionToken e la key di ogni allegato inserito all'interno della notifica corrispondano a quelli collegati agli allegati caricati precedentemente in fase di upload (vedi 1.a e 1.b: )

  • Verifica che ciascun CF fornito esista veramente (attualmente sospeso)

  • Verifica che l'indirizzo fisico associato a ciascun destinatario sia esistente e che il CAP inserito sia specifico della località e non generico. Queste verifiche vengono effettuate con Postel. NOTA: in fase di validazione sincrona, il CAP della notifica non è obbligatorio; questo comportamento è stato previsto per permettere l’inserimento di indirizzi esteri, per i quali il CAP potrebbe seguire regole diverse da quelle italiane. Per gli indirizzi italiani invece tale campo è obbligatorio e se non presente la notifica passerà in REFUSED.

I controlli asincroni sulla Richiesta di invio Notifica producono sempre un esito entro 24H dall'inserimento. L'esito dei controlli asincroni può essere verificato con l'apposito servizio o consumando il relativo evento di Timeline; in entrambi i casi sarà possibile ottenere il codice IUN identificativo della Notifica e verrà avviato il processo di Notifica.

https://petstore.swagger.io/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpagopa%2Fpn-delivery%2Fmain%2Fdocs%2Fopenapi%2Fapi-external-b2b-pa-bundle.yaml#/NewNotification/sendNewNotification
https://petstore.swagger.io/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpagopa%2Fpn-delivery%2Fmain%2Fdocs%2Fopenapi%2Fapi-external-b2b-pa-bundle.yaml#/NewNotification/sendNewNotification
Verifica accettazione richiesta notifica