Stream di timeline

Configurazione DEFAULT filterValues per stream di eventi di timeline

Configurando uno stream senza specificare alcun elemento in filterValues verranno riportati quelli di DEFAULT, ovvero quelli che hanno ripercussione sul cambiamento di stato del workflow o che riportano dati di interesse per il mittente, sia di carattere legale (es: legal facts) sia di business (es: numero della raccomandata).

Se oltre a questi eventi si vogliono aggiungere altri di interesse (es: SEND_COURTESY_MESSAGE per sapere se sono stati inviati messaggi di cortesia ai destinatari) è sufficiente indicare nel filtro DEFAULT e le categorie di eventi ulteriori.

Questa nuova API espone l'elemento timestamp che rappresenta l'istante in cui la piattaforma ha ricevuto l'informazione. Mentre per gli eventi che si verificano all'esterno della piattaforma (es: consegna della raccomandata) la data in cui si è verificata è indicata in un elemento all'interno dell'oggetto details (es: negli eventi della categoria SEND_ANALOG_FEEDBACK il timestamp è il momento in cui SEND ha ricevuto l'informazione dell'esito della notifica cartacea, mentre elemento notificationDate all'interno dell'oggetto detailsindica la data di consegna della raccomandata).

Nelle tabelle sottostanti sono riportati per ogni categoria di eventi la drescrione, se hanno collegato degli atti a volore legale (LegalFact) e i dettagli di maggior interesse contenuti nell'oggetto details.

NOTA: le date sono espresse nel formato standard ISO 8601, anche detta "Zulu time", che esprime la data UTC (es: 2024-02-29T11:44:17.511990926Z corrisponde alle 12:44:17s del 29/02/2024).

In questa sezione sono indicati gli eventi di timeline inclusi nella configurazione "DEFAULT" e sono stati suddivisi per fase e tipologia del workflow.

Gli eventi descritti nella tabella sottostante sono relativi al processo di accettazione della notifica.

Indica che la richiesta di notifica è stata rifiutata per un fallimento in fase di validazione

Indica che la richiesta di notifica è stata accettata a seguito dei controlli di validazione

Gli eventi descritti nella tabella sottostante sono relativi al processo del workflow digitale, compreso l'eventuale invio dell'AAR tramite raccomandata semplice.

SEND_DIGITAL_DOMICILE

Indica un tentativo di invio digitale della notifica

Indica la ricezione di un esito ad un invio a domicilio digitale

Per i dettagli delle codifiche di deliveryFailureCause e deliveryDetailCode si rimanda alla pagina Decodifiche SEND_DIGITAL.

Indica il completamento con successo il workflow di invio digitale.

Indica il completamento con fallimento il workflow di invio digitale:tutti i tentativi di invio ai domicili digitali sono falliti

Indica l'invio di raccomandata semplice

Indica la ricezione di informazioni relative all'invio della raccomandata semplice

(*) Per la decodifica dei codici di deliveryDetailCode all'interno dei details degli eventi si rimanda alla pagina Decodifica in send_analog_progress

Invio cartaceo dell’avviso di notifica

Ricezione esito dell'invio cartaceo

(*) Per la decodifica dei codici di e deliveryFailureCause e deliveryDetailCode all'interno dei details degli eventi di SEND_ANALOG_FEEDBACK si rimanda alla pagina Decodifiche SEND_ANALOG

Completato con successo il workflow di invio cartaceo.

Completato con fallimento il workflow di invio cartaceo.

Il destinatario è risultato irraggiungibile.

Perfezionamento per decorrenza termini

Visualizzazione della notifica (perfeziona la notifica se non già perfezionata per decorrenza termini o da altro destinatario)

Evento di fine della cancellazione della notifica dal parte del mittente.

Resa al mittente per destinatario dichiarato deceduto

Evento di accesso alla notifica tramite RADD

Evento per destinatario deceduto

In questo paragrafo sono indicati altri eventi della timeline che non hanno effetto sullo stato della notifica e non hanno una importanza prioritaria per il mittente, ma possono essere interessanti per recuperare delle informazioni di dettaglio. Ricordiamo che questi dati sono mantenuti dalla piattaforma in modo sicuro per 10 anni e sono sempre disponibili per essere recuperati tramite le API.

Generazione dell’AAR (Avviso di Avvenuta Ricezione)

Invio di un messaggio di cortesia.

Indica che il workflow può essere sospeso per 120h a fronte di un invio di un messaggio di cortesia.

Indica la ricezione di un domicilio digitale dai registri nazionali

Gli eventi di PROGRESS sono eventi restituiti dai servizi esterni di invio digitale (SEND_DIGITAL_PROGRESS) e cartaceo (SEND_ANALOG_PROGRESS).

Questi eventi possono contenere anche dei legalFact esterni come il messaggio di consegna della PEC (in formato EML) nel caso di invio digitale o le scansioni della ricevuta di consegna, del plico, del avviso di ricevimento, dell'indagine del postino nel caso di invio di raccomandata.

Indica un evento successivo relativo all'invio della PEC.

Indica un evento successivo relativo all'invio cartaceo

Invio cartaceo non possibile: non è stato trovato nessun indirizzo valido per predisporre il tentativo.

(*) Per la decodifica dei codici di deliveryDetailCode all'interno dei details degli eventi di SEND_ANALOG_PROGRESS si rimanda alla pagina