Le nostre tariffe
Listino prezzi a chiamata
- Telegramma Internazionale € 1,90 + iva
Telegramma Internazionale
- Home
- Servizi Postali
- Telegramma Internazionale
-
a partire da € 1,90 + iva
Il servizio di Poste Italiane per spedire all'estero le tue comunicazioni importanti.
Il Telegramma Internazionale è il servizio per inviare telegrammi cartacei in qualsiasi Paese del Mondo in pochi secondi. Il servizio è attivo 24 ore su 24
Il servizio di Telegrammi Internazionali consente di inviare comunicazioni in tempo reale ed in tutto il mondo.
Con Telegrammi Internazionali puoi inviare tramite API telegrammi cartacei a destinatari, sia privati sia azienda, in qualsiasi Paese del Mondo.
RICHIESTA INVIO TELEGRAMMA INTERNAZIONALE
POST /telegrammi/
Per inviare un telegramma internazionale è necessario utilizzare lo stesso endpoint utilizzato per l'invio verso l'Italia - POST /telegrammi/ - e passare informazioni quali:
- nome ed indirizzo del mittente
- nome ed indirizzo del destinatario
- testo
{
"data": {
"mittente": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "[email protected]",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2"
}
],
- "documento": [
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX"
],
- "opzioni": {
"mittente": false,
"callback": false,
"ricevuta": 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:
- mittente (inserimento dei dati del mittente nel messaggio)
- programmare l'invio (timestamp_invio)
- ricevuta dell'invio
Inoltre si può 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.
Se invece prima dell'invio si desiderano verificare i dati della spedizione ed i costi associati, "autoconfirm" dovrà essere impostato come "false".
L'importo del costo del telegramma internazionale è calcolato in base alla zona, alle parole e alle opzioni.
RISPOSTA INVIO TELEGRAMMA INTERNAZIONALE
POST /telegrammi/
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": {
"ragione sociale": "openapi spa",
"dug": "piazza",
"indirizzo": "cavour",
"civico": "43",
"comune": "roma",
"cap": "00121",
"provincia": "rm",
"email": "[email protected]",
"nazione": "IT"
},
"destinatari": [
{
"nome": "string",
"cognome": "string",
"indirizzo": "string",
"comune": "string",
"cap": "string",
"provincia": "ee",
"nazione": "string",
"id": "664228bbbf1239901b0815f2",
"state": "NEW"
}
],
- "documento":
"XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXX",
"opzioni": {
"autoconfirm": false,
"mittente": false,
"ar_c": false,
"ar_e": false,
"timestamp_invio": 1627659712
},
"prodotto": "telegramma etero",,
"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,
"txt": "L",
"size": 1
},
"pricing": {
"dettaglio": [
{
"codice_servizio": "parole",
"descrizione_servizio": "Tariffa Postale parole",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{
"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{
"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {
"importo_totale_netto": 7,
"importo_totale_iva": 1.54,
"importo_totale": 8.54
}
},
"lock": false,
"confirmed_timestamp": 1627659712,
"id": "61041dc0ac2b1f63327e92d2"
}
},
"success": true,
"message": "",
"error": null
}
CONFERMA INVIO
PATCH /telegrammi/
Per procedere a conferma dell'invio del telegramma 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 telegramma internazionale con lo stato "confermato"
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.