Tutte le tue spedizioni tramite API ed in tempo reale
Automatizza l’invio di documenti, raccomandate, telegrammi, pubblicità con 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.
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, ovvero la raccomandata, la posta prioritaria e la raccomandata smart.
L'endpoint di riferimento è GET /tracking/{id} e il parametro di partenza è l'id.
Non è previsto il tracciamento per i prodotti inviati all'estero.
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.