Il servizio di Postapriority Internazionale, cioè posta prioritaria estero, consente di inviare via API comunicazioni a basso costo con la possibilità di verificare l'esito di consegna.

Con Postapriority Internazionale spedisci lettere e documenti a uno o più destinatari (non ci sono limiti), sia privati sia aziende e caselle postali, tutto con un unico invio.

RICHIESTA INVIO POSTAPRIORITY INTERNAZIONALE

POST /prioritarie/

Per inviare una Postapriority Internazionale è necessario utilizzare lo stesso endpoint del servizio di Postapriority Italia POST /prioritarie/ e passare informazioni quali:

• nome ed indirizzo del mittente
• nome ed indirizzo del destinatario
• testo

   {
  "data": {
    "mittente": {
      "nome": "Paolo",
      "cognome": "De Carolis",
      "dug": "piazza",
      "indirizzo": "cavour",
      "civico": "43",
      "comune": "roma",
      "cap": "00121",
      "provincia": "rm",
      "nazione": "IT",
      "email": "[email protected]",
    },
   "destinatari": [
    {
      "nome": "string",
      "cognome": "string",
      "indirizzo": "string"
      "comune": "string",
      "provincia": "ee",
      "nazione": "string",
      "id": "664228bbbf1239901b0815f2",
      "state": "NEW"
    }
  ],
 "documento": [
     "Example document"
    ],
 "opzioni": {
    "fronteretro": false,  
    "colori": false,
    "autoconfirm": false,    
  }
}

In questo caso i dati richiesti per il destinatario sono parzialmente differenti, i campi dug (es. viale) e numero civico dovranno essere inseriti direttamente nel campo indirizzo e la provincia sarà sempre "ee".

In fase di richiesta è possibile selezionare anche una serie di opzioni:

• fronte / retro
• colori
• programmare l'invio (timestamp_invio)
• ricevuta d'invio

Inoltre è possibile impostare la conferma automatica (autoconfirm) e quindi inviare automaticamente la spedizione (se il valore è uguale a "true"). In questo caso si procederà immediatamente all'addebito del costo della spedizione e a pianificarne l'invio.

Per il servizio Postapriority Internazionale è inoltre possibile personalizzare interamente anche la copertina della comunicazione inserendo ad esempio logo ed informazioni aziendali o promozioni. La customizzazione può avvenire tramite API o tramite Playground che consente anche di visualizzare un'anteprima prima della spedizione.

Il servizio include gratuitamente anche l'opzione archiviazione digitale per 12 mesi del contenuto firmato e marcato digitalmente da Poste Italiane. L'archiviazione digitale a norma di legge certifica il contenuto che non può essere disconosciuto dalla controparte in eventuale controversia legale.

Se invece prima dell'invio si desiderano verificare i dati della spedizione ed i costi associati, 'autoconfirm' dovrà essere impostato come 'false'.

RISPOSTA INVIO POSTAPRIORITY INTERNAZIONALE

POST /prioritarie/

La risposta riporterà tutte le informazioni riguardanti il mittente, il destinatario e il messaggio più le informazioni dettagliate sui costi e all'id necessario per la conferma di invio.

   {
  "data": {
    "mittente": {
      "nome": "Paolo",
      "cognome": "De Carolis",
      "dug": "piazza",
      "indirizzo": "cavour",
      "civico": "43",
      "comune": "roma",
      "cap": "00121",
      "provincia": "rm",
      "nazione": "IT",
      "email": "[email protected]",
    },
   "destinatari": [
    {
      "nome": "string",
      "cognome": "string",
      "indirizzo": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "ee",
      "nazione": "string",
      "id": "664228bbbf1239901b0815f2",
      "state": "NEW"
    }
  ],
 "documento": [
     "Example document"
    ],
 "opzioni": {
    "fronteretro": false,  
    "colori": false,
    "autoconfirm": false,
    "timestamp_invio": 1627659712    
  },
},
"prodotto": "prioritaria estero",,
   "creation_timestamp": 1627659712,
   "update_timestamp": 1627659712,
   "username": "[email protected]",,
   "confirmed": true,,
   "state": "CONFIRMED",
   "documento_validato": {
     "pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
     "jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
     "parole": 1,
      "size": 9350
   },
   "pricing": {
     "dettaglio": [
       {
         "codice_servizio": "pagine",
         "descrizione_servizio": "Tariffa postale pagine",
         "percentuale_iva": 0,
         "quantita": 2,
         "importo_unitario_totale": 3.44,
         "importo_unitario_netto": 3.44,
         "importo_unitario_iva": 0
       },
       {
         "codice_servizio": "STAMPA",
         "descrizione_servizio": "Costo Stampa",
         "percentuale_iva": 0,
         "quantita": 2,
         "importo_unitario_totale": 0.1,
         "importo_unitario_netto": 0.1,
         "importo_unitario_iva": 0
       },
       {
         "codice_servizio": "IMBUST",
         "descrizione_servizio": "Imbustamento",
         "percentuale_iva": 0,
         "quantita": 2,
         "importo_unitario_totale": 0,
         "importo_unitario_netto": 0,
         "importo_unitario_iva": 0
       }
     ],
     "totale": {
       "importo_totale_netto":  8.6,
       "importo_totale_iva": 0,
       "importo_totale":  8.6
     },
   "lock": false,
   "confirmed_timestamp": 1724754216,
   "id": "66cda9285673a1b85f092f03"
 }
],
"success": true,
"message": "",
"error": null
}

CONFERMA INVIO

PATCH /prioritarie/

Per procedere a conferma dell'invio della Postapriority Internazionale sarà necessario effettuare una seconda richiesta con il metodo PATCH e passare l'id della richiesta precedentemente effettuata.

La risposta riporterà tutti i dati della Postapriority Internazionale con lo stato "confermato".

Il numero di pagine per Postapriority Internazionale può essere compreso tra 1 e 100. Oltre la 50° pagina la tipologia di stampa sarà automaticamente fronte/retro. I prezzi a lato riguardano solo le fasce di prezzi più utilizzate. In fase di invio con l'endpoint POST /prioritarie/ sarà possibile ottenere, prima dell'addebito, il costo di ciascuna spedizione che è calcolato in base al numero alle pagine e alle opzioni scelte.

I tempi di consegna degli invii di Postapriority Internazionale dipendono dal Paese di destinazione e sono:

• Europa: 3 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione, nell'85% degli invii
• Bacino del Mediterraneo: 4/5 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione, nell'85% degli invii
• Paesi del Nord America: 5/6 giorni lavorativi (esclusi sabato e festivi) oltre a quello di spedizione, nell'85% degli invii
• Paesi del resto delle Americhe, Asia e Oceania: 7/8 giorni lavorativi (esclusi sabato e festivi) oltre a quello di spedizione, nell'85% degli invii Altri Paesi dell'Africa: 8/9 giorni lavorativi (esclusi sabato e festivi), oltre quello di spedizione, nell’85% degli invii

In caso di spedizioni online, ai tempi di recapito indicati si sommano i seguenti tempi di lavorazione: stampa in un giorno lavorativo (T+1), se la spedizione è accettata entro le ore 14:00 dal lunedì al venerdì, esclusi i festivi.