DevPortalPagoPA



Tabella dei contenuti

Decodifiche SEND_DIGITAL

Decodifica del campo deliveryDetailCode degli eventi di invio digitale
Gli eventi SEND_DIGITAL_PROGRESS e SEND_DIGITAL_FEEDBACK contengono il campo deliveryDetailCode all'interno dell'elemeto details che riporta il motivo specifico del successo, del fallimento o l'avanzamento della spedizione digitale.

Tabella decodifica deliveryDetailCode - Domicilio digitale PEC

deliveryDetailCodeDescrizione
deliveryDetailCodeDescrizione
C000COMUNICAZIONE CON SERVER PEC AVVENUTA (senza busta)
C001ACCETTAZIONE (con busta)
C002NON_ACCETTAZIONE (con busta)
C003AVVENUTA_CONSEGNA (con busta)
C004ERRORE_CONSEGNA (con busta)
C005PRESA_IN_CARICO (senza busta)
C006RILEVAZIONE_VIRUS (con busta)
C007PREAVVISO_ERRORE_CONSEGNA (senza busta)
C008ERRORE_COMUNICAZIONE_SERVER_PEC - con retry da parte di PN (senza busta)
C009ERRORE_DOMINIO_PEC_NON_VALIDO - senza retry: indica un dominio pec non valido; (senza busta)
C010ERROR_INVIO_PEC - con retry da parte di PN: indica un errore generico di invio pec (senza busta)
DP00Tentativo reinvio richiesto: codice interno a delivery push che indica una richiesta di ritentativo
DP10Scaduto timeout di invio a ext-channel, senza ottenere un evento di risposta OK/KO/RETRY_PROGRESS

Esempi

L'evento SEND_DIGITAL_FEEDBACK riporta il codice deliveryDetailCode=C003 corrispondente alla consegna da parte del server di destinazione.
1{
2	"elementId": "SEND_DIGITAL_FEEDBACK.IUN_QLYM-PHLG-ZAPJ-202402-H-1.RECINDEX_0.SOURCE_SPECIAL.REPEAT_false.ATTEMPT_0",
3	"timestamp": "2024-02-29T11:42:39.4248206Z",
4	"legalFactsIds": [
5		{
6			"key": "safestorage://PN_EXTERNAL_LEGAL_FACTS-788282a3268c471b9900ea8bfe1aeb4a.xml",
7			"category": "PEC_RECEIPT"
8		}
9	],
10	"category": "SEND_DIGITAL_FEEDBACK",
11	"details": {
12		"recIndex": 0,
13		"digitalAddress": {
14			"type": "PEC",
15			"address": "notifichedigitali-dev@pec.pagopa.it"
16		},
17		"digitalAddressSource": "SPECIAL",
18		"responseStatus": "OK",
19		"notificationDate": "2024-02-29T11:42:39.4248206Z",
20		"deliveryDetailCode": "C003",
21		"sendingReceipts": [
22			{}
23		]
24	}
25}
26
L'evento SEND_DIGITAL_PROGRESS riporta il campo deliveryDetailCode=C001 corrispondente a accettazione da parte del server del mittente.
1{
2	"elementId": "DIGITAL_PROG.IUN_QLYM-PHLG-ZAPJ-202402-H-1.RECINDEX_0.SOURCE_SPECIAL.REPEAT_false.ATTEMPT_0.IDX_1",
3	"timestamp": "2024-02-29T11:42:29.18130614Z",
4	"legalFactsIds": [
5		{
6			"key": "safestorage://PN_EXTERNAL_LEGAL_FACTS-1d1edd160f614833899bba9702b61efc.xml",
7			"category": "PEC_RECEIPT"
8		}
9	],
10	"category": "SEND_DIGITAL_PROGRESS",
11	"details": {
12		"recIndex": 0,
13		"digitalAddress": {
14			"type": "PEC",
15			"address": "notifichedigitali-dev@pec.pagopa.it"
16		},
17		"digitalAddressSource": "SPECIAL",
18		"eventTimestamp": "2024-02-29T11:42:29.18130614Z",
19		"retryNumber": 0,
20		"notificationDate": "2024-02-29T11:42:30.440213674Z",
21		"deliveryDetailCode": "C001",
22		"sendingReceipts": [
23			{}
24		],
25		"shouldRetry": false
26}
27

Tabella decodifica deliveryDetailCode - Domicilio digitale SERCQ

Qualsiasi destinatario di notifiche (che sia persona fisica o persona giuridica) potrà abilitare SEND come recapito legale, senza dover possedere/impostare una PEC.
L’utente potrà abilitare SEND a domicilio digitale interagendo con un’apposita sezione nella sezione recapiti.
deliveryDetailCodeDescrizione
Q003Invio concluso positivamente
Q010Fallimento invio a SERCQ
Q011Indirizzo SERCQ errato

Esempio

Nel caso di domicilio digitale SERCQ si avranno solo due eventi delle categorie:
  • SEND_DIGITAL_DOMICILE
  • SEND_DIGITAL_FEEDBACK
1{
2  "elementId": "SEND_DIGITAL.IUN_WNUN-HRJQ-ZWVJ-202508-W-1.RECINDEX_0.SOURCE_PLATFORM.REPEAT_false.ATTEMPT_0",
3  "timestamp": "2025-08-02T11:43:42.178756013Z",
4  "ingestionTimestamp": "2025-08-02T11:43:44.439677417Z",
5  "eventTimestamp": "2025-08-02T11:43:42.178756013Z",
6  "notificationSentAt": "2025-08-02T11:39:41.261607760Z",
7  "legalFactsIds": [],
8  "category": "SEND_DIGITAL_DOMICILE",
9  "details": {
10    "recIndex": 0,
11    "digitalAddress": {
12      "type": "SERCQ",
13      "address": "x-pagopa-pn-sercq:send-self:notification-already-delivered?timestamp=2025-08-02T11:43:42.178756013Z"
14    },
15    "digitalAddressSource": "PLATFORM",
16    "retryNumber": 0
17  }
18},
19{
20  "elementId": "SEND_DIGITAL_FEEDBACK.IUN_WNUN-HRJQ-ZWVJ-202508-W-1.RECINDEX_0.SOURCE_PLATFORM.REPEAT_false.ATTEMPT_0",
21  "timestamp": "2025-08-02T11:43:42.178756013Z",
22  "ingestionTimestamp": "2025-08-02T11:43:45.693889411Z",
23  "eventTimestamp": "2025-08-02T11:43:42.178756013Z",
24  "notificationSentAt": "2025-08-02T11:39:41.261607760Z",
25  "category": "SEND_DIGITAL_FEEDBACK",
26  "details": {
27    "recIndex": 0,
28    "digitalAddress": {
29      "type": "SERCQ",
30      "address": "x-pagopa-pn-sercq:send-self:notification-already-delivered?timestamp=2025-08-02T11:43:42.178756013Z"
31    },
32    "digitalAddressSource": "PLATFORM",
33    "responseStatus": "OK",
34    "notificationDate": "2025-08-02T11:43:42.178756013Z",
35    "deliveryDetailCode": "Q003",
36    "sendingReceipts": [
37      {
38        "id": "9e18f38e-fabb-44fc-9b8a-52ab5e097310",
39        "system": "@send-self"
40      }
41    ]
42  }
43}
44

Hai bisogno di aiuto?

Invia una richiesta di supporto utilizzando SEND - Supporto Enti