Tabella dei contenuti
API VERSIONE GA26Q2.B
Il rilascio GA26Q2.B introduce il nuovo elemento NOTIFICATION_TIMELINE_REWORKED, progettato per migliorare la tracciabilità delle correzioni nella storia degli stati di una notifica.
CORREZIONE DI TIMELINE
L'esposizione delle modifiche varia in base alla versione delle API utilizzate dal Partner Tecnologico.
Tutti gli eventi oggetto di correzione riporteranno lo specifico suffisso _REWORK_<n>, che ne permette il riconoscimento immediato.
Implementazione API: retrieveSentNotification v2.8 e Stream v2.9
Nelle nuove versioni che utilizzano i percorsi:
- /delivery/v2.8/notifications/sent/{iun}
- /delivery-progresses/v2.9/streams
è disponibile il nuovo elemento di timeline di categoria NOTIFICATION_TIMELINE_REWORKED, che offre visibilità completa sulle operazioni di correzione e rettifica. Il campo details.invalidatedTimelineAndStatusHistory contiene l'elenco dettagliato di tutti gli stati e gli eventi invalidati, permettendo ai sistemi client di ricostruire con precisione la cronologia corretta della notifica.
1{
2 "elementId": "NOTIFICATION_TIMELINE_REWORKED.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0.ATTEMPT_0.REWORK_0",
3 "timestamp": "2026-06-05T14:56:57.125685027Z",
4 "category": "NOTIFICATION_TIMELINE_REWORKED",
5 "details": {
6 "recIndex": 0,
7 "invalidatedTimelineAndStatusHistory": [
8 {
9 "status": "ACCEPTED",
10 "activeFrom": "2026-06-05T14:37",
11 "relatedTimelineElements": [
12 {
13 "elementId": "PREPARE_ANALOG_DOMICILE.IUN_UJRX-APEQ-UEYZ-20260",
14 "timestamp": "2026-06-05T14:42:54.916859238Z",
15 "category": "PREPARE_ANALOG_DOMICILE",
16 }
17 ],
18 },
19 {
20 "status": "DELIVERING",
21 "activeFrom": "2026-06-05T14:43:00.673439925Z",
22 "relatedTimelineElements": [
23 {
24 "elementId": "SEND_ANALOG_DOMICILE.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0.ATTEMPT_0",
25 "timestamp": "2026-06-05T14:43:00.673439925Z",
26 "category": "SEND_ANALOG_DOMICILE",
27 {
28 "elementId": "SEND_ANALOG_PROGRESS.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0.ATTEMPT_0.IDX_2",
29 "timestamp": "2026-06-05T14:44:37.214928187Z",
30 "category": "SEND_ANALOG_PROGRESS",
31 ....
32 },
33 {
34 "elementId": "SEND_ANALOG_PROGRESS.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0.ATTEMPT_0.IDX_2.REWORK_0",
35 "timestamp": "2026-06-05T14:58:25Z",
36 "category": "SEND_ANALOG_PROGRESS",
37 ....
38 },
39 {
40 "elementId": "SEND_ANALOG_FEEDBACK.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0.ATTEMPT_0",
41 "timestamp": "2026-06-05T14:58:25Z",
42 "category": "SEND_ANALOG_FEEDBACK",
43 ....
44 },
45 {
46 "elementId": "PREPARE_ANALOG_DOMICILE_FAILURE.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0",
47 "timestamp": "2026-06-05T14:58:25Z",
48 "category": "PREPARE_ANALOG_DOMICILE_FAILURE",
49 ....
50 }
51 ],
52 },
53 {
54 "status": "UNREACHABLE",
55 "activeFrom": "2026-06-05T14:45:38.878305032Z",
56 "relatedTimelineElements": [
57 {
58 "elementId": "COMPLETELY_UNREACHABLE.IUN_UJRX-APEQ-UEYZ-202606-R-1.RECINDEX_0",
59 "timestamp": "2026-06-05T14:46:14.67662536Z",
60 "eventTimestamp": "2026-06-05T14:45:38.878305032Z",
61 "category": "ANALOG_FAILURE_DELIVERY"
62 ....
63 },
64 ...
65 ]
66 }
67
68API versioni precedenti
Nelle versioni precedenti alle release menzionate, l'elemento NOTIFICATION_TIMELINE_REWORKED non è riportato, al fine di preservare i contratti esistenti. I sistemi client riceveranno solo i nuovi eventi correttivi all'interno del flusso standard.
NOTA: Le versioni precedenti alla v2.8 dell'API retrieveSentNotification mostreranno in timeline solo gli eventi del workflow rettificato, mentre gli elementi invalidati dal processo di correzione resteranno nascosti.
Per non incorrere in duplicazione degli elementId invalidati, ma comunque presenti in timeline, gli eventi successivi possono riportare nel campo timelineElementId il suffisso _REWORK_<n>.
Un esempio di elemento di timeline che può essere restituito utilizzando le API delle versioni precedenti è mostrato sotto:
1 {
2 "elementId": "SEND_ANALOG_PROGRESS.IUN_NMDX-NVHP-UEZE-202606-Y-1.RECINDEX_0.ATTEMPT_0.IDX_1.REWORK_0",
3 "timestamp": "2026-06-05T13:37:46Z",
4 "category": "SEND_ANALOG_PROGRESS",
5 "details": {
6 "recIndex": 0,
7 "notificationDate": "2026-06-05T13:37:46Z",
8 "deliveryDetailCode": "CON080",
9 "serviceLevel": "AR_REGISTERED_LETTER",
10 "sendRequestId": "SEND_ANALOG_DOMICILE.IUN_NMDX-NVHP-UEZE-202606-Y-1.RECINDEX_0.ATTEMPT_0.REWORK_0",
11 "registeredLetterCode": "2ef060d6fb4c4848b416495649b7d188"
12 }
13}
14In questa pagina
