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 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 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
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
Sì, è possibile includere anche a più di un destinatario per tutti i servizi di Ufficio Postale: telegramma, raccomandata, posta prioritaria e ordinaria, raccomandata smart, posta massiva.
Sì, l’elenco è disponibile attraverso il metodo GET.
A seconda del servizio, l’endpoint di riferimento sarà:
- GET /telegrammi/ per i telegrammi
- GET /raccomandate/ per le raccomandate
- GET /prioritarie/ per la posta prioritaria
- GET /ordinarie/ per la posta ordinaria
- 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
- GET /raccomandate/{id} per le raccomandate
- GET /prioritarie/{id} per la posta prioritaria
- GET /ordinarie/{id} per la posta ordinaria
- 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)
È possibile monitorare le singole spedizioni per i prodotti che prevedono il tracciamento (raccomandata, posta prioritaria, raccomandata smart) attraverso l’endpoint GET /tracking/{id}, a partire dal parametro id.
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
I tempi medi di consegna cambiano a seconda del servizio richiesto:
- Raccomandata: 4-6 giorni lavorativi
- Telegramma: a partire da 24 ore
- Posta Ordinaria: a partire da 4 giorni
- Posta Prioritaria: a partire da 24 ore
- Posta Massiva: a partire da 7-9 giorni
- Raccomandata Smart: a partire da 4-7 giorni
Il costo della richiesta singola varia a seconda dell’endpoint ed è a partire da 0,32€.
Per Raccomandata: il costo di partenza è 4,24€.
Per Telegramma: il costo di partenza è 3,63€.
Per Posta Ordinaria (Posta 4): il costo di partenza è 1,03€.
Per Posta Prioritaria: il costo di partenza è 2,28€.
Per Posta Massiva: il costo di partenza è 0,32€.
Per Raccomandata Smart: il costo di partenza è 2,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.
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