SEND - F.A.Q. per integratori
v2.4
v2.4
  • Knowledge-base di Piattaforma Notifiche
    • Generazione client e definizioni delle API
    • Workflow di Notifica
    • Inserimento della notifica
      • Inserimento Notifica con il comando curl
      • Inserimento Notifica con Postman
      • FAQ inserimento notifiche
    • Integrazione SEND - PDND Interoperabilità
      • Configurare l'accesso ad Interoperabilità
      • Creazione richiesta di fruizione generazione Voucher per SEND - UAT (Piattaforma Notifiche)
      • FAQ su Interoperabilità
    • Creazione e gestione degli stream
      • Inserimento e creazione stream con il comando curl
      • Inserimento e creazione stream con Postman
      • FAQ sugli streams
      • Stream di timeline
        • Decodifiche SEND_DIGITAL
        • Decodifiche SEND_ANALOG
        • Tipologie di scansioni per ANALOG_DELIVERY
    • Validazione della Richiesta di Notifica
      • Normalizzatore
      • Composizione degli indirizzi
    • Perfezionamento della notifica
    • Pagamenti e Spese di notifica
      • Pagamenti pagoPA
      • Pagamenti F24
    • PN-Test di validazione avvenuta integrazione con Piattaforma Notifiche
    • Validazione dei test con il tool PnValidator
    • API di stato della Piattaforma
    • Full Digital - Poste Italiane
  • Simulare i casi di test in ambiente UAT
  • 🏷️Tassonomia SEND
  • API CHANGELOG
    • API VERSIONE GA 2.0
    • API VERSIONE GA 2.1
    • API VERSIONE GA 2.3
    • API VERSIONE GA 2.4
    • API VERSIONE GA24Q4.A
    • API VERSIONE GA24Q4.B
Powered by GitBook
On this page
  • Validazione Sincrona
  • Validazione Asicrona
  1. Knowledge-base di Piattaforma Notifiche

Validazione della Richiesta di Notifica

Approfondimento sulla validazione che PND effettua sulle richieste di invio Notifica

Last updated 11 months 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 con normalizzatore degli indirizzi di POSTEL che l'indirizzo fisico associato a ciascun destinatario sia idoneo all'invio postale. 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.

  • Verifica della validità dei metadati F24 tramite (vedi json schema )

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/sendNewNotificationV23
https://petstore.swagger.io/?url=https%3A%2F%2Fraw.githubusercontent.com%2Fpagopa%2Fpn-delivery%2Fmain%2Fdocs%2Fopenapi%2Fapi-external-b2b-pa-bundle.yaml#/NewNotification/sendNewNotificationV23
https://raw.githubusercontent.com/pagopa/pn-f24/main/docs/openapi/json-schema-from-deref-mod.json
Verifica accettazione richiesta notifica