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
deliveryDetailCode | Descrizione |
---|---|
deliveryDetailCode | Descrizione |
C000 | COMUNICAZIONE CON SERVER PEC AVVENUTA (senza busta) |
C001 | ACCETTAZIONE (con busta) |
C002 | NON_ACCETTAZIONE (con busta) |
C003 | AVVENUTA_CONSEGNA (con busta) |
C004 | ERRORE_CONSEGNA (con busta) |
C005 | PRESA_IN_CARICO (senza busta) |
C006 | RILEVAZIONE_VIRUS (con busta) |
C007 | PREAVVISO_ERRORE_CONSEGNA (senza busta) |
C008 | ERRORE_COMUNICAZIONE_SERVER_PEC - con retry da parte di PN (senza busta) |
C009 | ERRORE_DOMINIO_PEC_NON_VALIDO - senza retry: indica un dominio pec non valido; (senza busta) |
C010 | ERROR_INVIO_PEC - con retry da parte di PN: indica un errore generico di invio pec (senza busta) |
DP00 | Tentativo reinvio richiesto: codice interno a delivery push che indica una richiesta di ritentativo |
DP10 | Scaduto 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.
deliveryDetailCode | Descrizione |
---|---|
Q003 | Invio concluso positivamente |
Q010 | Fallimento invio a SERCQ |
Q011 | Indirizzo 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