Ufficio Postale

Per l’invio dei Telegrammi via API l’endpoint di riferimento è POST /telegrammi/.

Nel body della richiesta vanno specificati i dati sul:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Avviso di consegna)

La risposta fornisce i dettagli del telegramma richiesto, in particolare:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id telegramma

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sul telegramma inviato.

È possibile anche salvare il telegramma per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su “false”. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /telegrammi/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio delle raccomandate via API l’endpoint di riferimento è POST /raccomandate/.

Nel body della richiesta vanno specificati i dati sul:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Fronte/retro, Colori, Andata/Ritorno, Avviso di consegna)

La risposta fornisce i dettagli della raccomandata richiesta, in particolare:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id raccomandata

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata inviata e per il tracciamento.

È possibile anche salvare la raccomandata per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio della posta prioritaria via API l’endpoint di riferimento è POST /prioritarie/.

Nel body della richiesta vanno specificati i dati sul:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Fronte/retro, Colori, Avviso di consegna)

La risposta fornisce dettagli su:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id posta prioritaria

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato e per il tracciamento.

È possibile anche salvare la posta prioritaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /prioritarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio della posta ordinaria via API l’endpoint di riferimento è POST /ordinarie/.

Nel body della richiesta vanno specificati i dati su:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Fronte/retro, Colori, Avviso di consegna)

La risposta fornisce dettagli su:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id posta ordinaria

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.

È possibile anche salvare la posta ordinaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /ordinarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio dei Telegrammi via API l’endpoint di riferimento è POST /telegrammi/

Nel body della richiesta vanno specificati i dati sul:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Testo (che include i dati del mittente)
• Opzione aggiuntiva (Ricevuta di invio, Programmare l’invio)

La risposta fornisce i dettagli del telegramma richiesto, in particolare:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Testo inviato
• Prezzo finale
• id telegramma

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sul telegramma inviato.

È possibile anche salvare il telegramma per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su “false”. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /telegrammi/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio delle Raccomandate via API l’endpoint di riferimento è POST /raccomandate/.

Nel body della richiesta vanno specificati i dati sul:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Testo o allegato del documento (url, html, testo semplice)
• Opzione aggiuntiva  (Ricevuta di invio, Fronte/retro, Colori e Programmare l’invio)

La risposta fornisce i dettagli della raccomandata richiesta, in particolare:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id raccomandata

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata inviata e per il tracciamento.

È possibile anche salvare la raccomandata per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio della Posta Prioritaria via API l’endpoint di riferimento è POST /prioritarie/.

Nel body della richiesta vanno specificati i dati sul:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Testo o allegato del documento (url, html, testo semplice)
• Opzione  aggiuntiva  (Ricevuta di invio, Fronte/retro, Colori e Programmare l’invio)

La risposta fornisce dettagli su:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Specifiche sul documento
• Prezzo finale
• id posta prioritaria

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato e per il tracciamento.

È possibile anche salvare la posta prioritaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /prioritarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio della Posta Ordinaria via API l’endpoint di riferimento è POST /ordinarie/.

Nel body della richiesta vanno specificati i dati su:

• Mittente (nome, cognome, indirizzo completo)
• Destinatario/i (nome, cognome, indirizzo completo)
• Testo o allegato del documento (url, html, testo semplice)
• Opzione  aggiuntiva  (Ricevuta di invio, Fronte/retro, Colori e Programmare l’invio)

La risposta fornisce dettagli su:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• Specifiche sul documento
• Prezzo finale
• id posta ordinaria

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.

È possibile anche salvare la posta ordinaria per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /ordinarie/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio delle raccomandate smart via API l’endpoint di riferimento è POST /raccomandate-smart/.

Nel body della richiesta vanno specificati i dati sul:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Fronte/retro, Colori, Andata/Ritorno, Avviso di consegna, eventuale URL Callback)

La risposta fornisce i dettagli della raccomandata smart richiesta, in particolare:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id raccomandata smart

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sulla raccomandata smart inviata e per il tracciamento.

È possibile anche salvare la raccomandata smart per un successivo invio tramite il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /raccomandate_smart/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

Per l’invio della posta massiva via API l’endpoint di riferimento è POST /posta_massiva/.

Nel body della richiesta vanno specificati i dati sul:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• documento
• possibile opzione aggiuntiva (Fronte/retro, Colori, Avviso di consegna)

La risposta fornisce dettagli su:

• mittente (nome, cognome, indirizzo completo)
• destinatario/i (nome, cognome, indirizzo completo)
• specifiche sul documento
• prezzo finale
• id posta massiva

NOTA BENE: L’id ti sarà utile successivamente per ottenere informazioni sull’invio effettuato.

È possibile anche salvare la posta massiva per un successivo invio tramite il il parametro "autoconfirm" che, in questo caso, dovrà essere impostato su false. Per confermare l'invio, in un secondo momento, sarà necessario utilizzare l'endpoint PATCH /posta_massiva/{id} passando l'id della spedizione e nel body della richiesta il valore "confirmed":true

È possibile includere più di un destinatario per i soli servizi nazionali di Ufficio Postale: telegramma, raccomandata, posta prioritaria e ordinaria, raccomandata smart, posta massiva. Per quanto riguarda gli invii verso l’estero, il destinatario può essere solo uno.

L'archiviazione digitale è il servizio gratuito ed attivo di default che consente di accedere al contenuto inviato firmato e marcato digitalmente da Poste Italiane. Il servizio certifica il contenuto invia con valore legale e rende disponibile il contenuto per 12 mesi.

Il servizio è attivo per i seguenti prodotti postali:

• Raccomandata Online
• Raccomandata Internazionale
• Posta 1
• Posta 4
• Postapriority
• Postamail

Sì, è possibile personalizzare completamente la copertina della comunicazione, aggiungendo ad esempio il logo, le informazioni aziendali o eventuali promozioni.

La personalizzazione può essere effettuata tramite API con l'endpoint dedicato oppure attraverso il Playground, che consente anche di visualizzare un’anteprima prima dell'invio.

La personalizzazione della Copertina è disponibile per:

• Raccomandata Online
• Raccomandata Internazionale
• Posta 1
• Posta 4
• Postapriority
• Postamail

Sì, l’elenco è disponibile attraverso il metodo GET.

A seconda del servizio, l’endpoint di riferimento sarà:

• GET /telegrammi/ per i telegrammi (sia nazionali sia internazionali)
• GET /raccomandate/ per le raccomandate (sia nazionali sia internazionali)
• GET /prioritarie/ per la posta prioritaria (sia nazionale sia internazionale)
• GET /ordinarie/ per la posta ordinaria (sia nazionale sia internazionale)
• GET /raccomandate_smart/ per le raccomandate smart
• GET /posta_massiva/ per la posta massiva

Non è richiesto alcun parametro di partenza.

Sì, è possibile fare una verificare dei precedenti invii attraverso gli endpoint:

• GET /telegrammi/{id} per i telegrammi (sia nazionali sia internazionali)
• GET /raccomandate/{id} per le raccomandate (sia nazionali sia internazionali)
• GET /prioritarie/{id} per la posta prioritaria (sia nazionale sia internazionale)
• GET /ordinarie/{id} per la posta ordinaria (sia nazionale sia internazionale)
• GET /raccomandate_smart/{id} per le raccomandate smart
• GET /posta_massiva/{id} per la posta massiva

In tutti i casi, come parametro di partenza è richiesto obbligatoriamente l’id, che si ottiene in fase di invio del prodotto.

Sono invece facoltativi altri parametri (se impostati):

• ricevuta (per telegrammi, raccomandate, posta prioritaria e ordinaria): viene restituito un PDF nella risposta
• state (per tutti i servizi)
• callback (SOLO per l'ambiente sandbox e solo per raccomandate)

L’opzione "mittente" consente di inserire i dati del mittente direttamente nel testo del telegramma.

Per le spedizioni in Italia, è necessario selezionare questa opzione affinché i dati siano visibili.

Per le spedizioni internazionali, invece, l’inserimento del mittente avviene automaticamente.

È importante notare che le parole utilizzate per il mittente saranno incluse nel conteggio complessivo del telegramma.

Se si carica un documento che supera le 50 pagine senza abilitare l’opzione fronte/retro, il sistema genera un messaggio di errore. In questi casi, è quindi obbligatorio selezionare l'opzione fronte/retro per procedere correttamente con l'invio del documento.

I tempi di presa in carico della richiesta da parte di Poste Italiane cambiano a seconda del servizio richiesto:

• Raccomandata: in tempo reale
• Telegramma: in tempo reale
• Posta Ordinaria: in tempo reale
• Posta Prioritaria: in tempo reale
• Posta Massiva: in pochi secondi
• Raccomandata Smart: in pochi secondi

È possibile monitorare le spedizioni di alcuni prodotti diretti in Italia, ma solo per quelli che includono il servizio di tracciamento, come Raccomandata, Posta Prioritaria e Raccomandata Smart.

Per le spedizioni internazionali, il tracciamento è disponibile per la Postapriority Internazionale, permettendo di monitorare l'arrivo della spedizione al Centro di Scambio Internazionale di Poste Italiane.

Le Raccomandate inviate all'estero possono essere tracciate fino alla destinazione finale per le seguenti zone:

Zona 1 (Europa e Bacino del Mediterraneo)

• Europa: Albania, Austria, Belgio, Bielorussia, Bosnia - Erzegovina, Bulgaria, Cipro, Croazia, Danimarca, Estonia, Finlandia, Francia, Germania, Gibilterra, Gran Bretagna, Grecia, Irlanda, Islanda, Lettonia, Liechtenstein, Lituania, Lussemburgo, Malta, Macedonia del Nord, Moldavia, Montenegro, Paesi Bassi, Polonia, Portogallo, Repubblica Ceca, Romania, Russia, San Marino, Serbia, Slovacchia, Slovenia, Spagna, Svezia, Svizzera, Ucraina, Ungheria, Vaticano
• Bacino del Mediterraneo: Algeria, Egitto, Libano, Marocco, Tunisia, Turchia

Zona 2 (Africa, America e Asia)

• Africa: Belize, Botswana, Burkina Faso, Cameroun, Capo Verde, Costa d'Avorio, Etiopia, Ghana, Kenia, Madagascar, Nigeria, Ruanda, Seichelles, Senegal, Sud Africa, Togo, Uganda, Zambia
• America: Argentina, Bahamas, Barbados, Cile, Colombia, Costarica, Cuba, El Salvador, Giamaica, Honduras, Isole Vergini, Panama, Peru, San Vincenzo e Granadine, Stati Uniti d'America
• Asia: Arabia Saudita, Armenia, Azerbajan, Bangladesh, Cambogia, Cina, Corea del Sud, Emirati Arabi Uniti, Filippone, Georgia, Giappone, Hong Kong, India, Indonesia, Iran, Kazakistan, Kuwait, Macao, Malesia, Oman, Pakistan, Qatar, Singapore, Sri Lanka, Tailandia, Taiwan

Zona 3 (Oceania)

• Oceania: Nuova Zelanda, Papua Nuova Guinea, Polinesia Francese

Per effettuare il tracciamento, l'endpoint da utilizzare è GET/tracking/{id}, dove il parametro richiesto è l'id della spedizione.

I tempi medi di consegna cambiano a seconda del servizio richiesto:

• Raccomandata: 4-6 giorni lavorativi (sia verso l'Italia sia verso l'estero)
• Telegramma: a partire da 24 ore (sia verso l'Italia sia verso l'estero)
• Posta Ordinaria: a partire da 4 giorni (sia verso l'Italia sia verso l'estero)
• Posta Prioritaria: a partire da 24 ore (sia verso l'Italia sia verso l'estero)
• Posta Massiva: a partire da 7-9 giorni
• Raccomandata Smart: a partire da 4-7 giorni

I telegrammi internazionali vengono affidati in giornata al gestore postale nazionale, mentre il recapito al destinatario avverrà secondo i tempi previsti dal sistema postale locale.

I tempi di consegna variano a seconda del Paese di destinazione. 

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.

I tempi di consegna delle spedizioni di Postamail Internazionale sono:

• Europa: consegna nell’85% dei casi in 8 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
• Bacino del Mediterraneo: consegna nell’85% dei casi in 12 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
• Nord America e Oceania: consegna nell’85% dei casi in 16 giorni lavorativi (esclusi sabato e festivi) oltre il giorno di spedizione
• Resto del mondo: consegna nell’85% dei casi in 22 giorni lavorativi (esclusi sabato e festivi) oltre a quello di spedizione

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.

Il costo della richiesta singola varia a seconda del servizio e delle opzioni selezionate ed è a partire da 0,32€.

• Per Raccomandata: il costo è a partire da 4,24€.
• Per Telegramma: il costo è a partire da 3,63€.
• Per Posta Ordinaria (Posta 4): il costo è a partire da 1,03€.
• Per Posta Prioritaria (Posta 1): il costo è a partire da 2,28€.
• Per Posta Massiva: il costo è a partire da 0,32€.
• Per Raccomandata Smart: il costo è a partire da 2,60€.
• Per Telegramma Internazionale:  il costo è a partire da 1,90€.
• Per Raccomandata Internazionale:  il costo è a partire da 7,50€.
• Per Postamail Internazionale:  il costo è a partire da 1,30€.
• Per Postapriority Internazionale:  il costo è a partire da 3,60€.

Tutti i prezzi sono disponibili nella sezione dedicata "Prezzi".

È possibile ottenere i dettagli sui prezzi anche attraverso l’endpoint GET /pricing/.

Nella sezione Utilizzo, a livello di API, è possibile monitorare le richieste gratuite ed effettuate tramite ricarica. Sono disponibili sia in modalità grafica (periodo mese e anno), sia con un riepilogo testuale.