International Telegram

  • Openapi starting from € 1,90 + vat

Poste Italiane's service for sending your important communications abroad.

The International Telegram is the service for sending paper telegrams to any country in the world within seconds. The service is available 24/7.

Go to the Documentation
Esempio International Telegram

The International Telegram service allows you to send real-time communications worldwide.

With International Telegrams, you can send paper telegrams to recipients, both private and corporate, in any country in the world via API.

INTERNATIONAL TELEGRAM REQUEST

POST /telegrammi/

To send an international telegram, you need to use the same endpoint used for sending to Italy POST /telegrammi/ and provide information such as:

  • sender's name and address
  • recipient's name and address
  • text
   {
  "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": {
 "mittente": false,
    "callback": false,
    "ricevuta": false,
    "autoconfirm": false
   }
  }
}

 

In this case, the required data for the recipient is slightly different: the dug fields (e.g., avenue) and house number should be entered directly in the address field, and the province will always be "ee".

At the time of the request, it is also possible to select a series of options:

  • sender (inclusion of the sender's details in the message)
  • schedule sending (timestamp_sending)
  • receipt of sending

It is also possible to set automatic confirmation (autoconfirm) and thus send the shipment automatically (if the value is "true"). In this case, the cost of the shipment will be immediately charged, and its sending will be scheduled.

If you wish to check the shipping data and associated costs before sending, autoconfirm should be set to false.

The cost of the International Telegram is calculated based on the zone, words, and options.

INTERNATIONAL TELEGRAM RESPONSE

POST /telegrammi/

The response will include all the information about the sender, the recipient, and the message, plus detailed cost information and the ID needed for sending confirmation.

   {
  "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": "international telegram",,
      "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": "words",
            "descrizione_servizio": "Postal rate words",
            "percentuale_iva": 22,
            "quantita": 2,
            "importo_unitario_totale": 4.27,
            "importo_unitario_netto": 3.5,
            "importo_unitario_iva": 0.77
          },
          {
            "codice_servizio": "PRINT",
            "descrizione_servizio": "Printing cost",
            "percentuale_iva": 22,
            "quantita": 2,
            "importo_unitario_totale": 0,
            "importo_unitario_netto": 0,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "ENVELOPE",
            "descrizione_servizio": "Envelope stuffing",
            "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
}

 

SENDING CONFIRMATION

PATCH /telegrammi/

To confirm the sending of the International Telegram, a second request using the PATCH method is required, where the ID of the previously made request must be transmitted.

The response will include all the data of the International Telegram with the status "confirmed".

International Telegrams are handed over to the national postal service provider on the same day, while delivery to the recipient is according to the local postal system times.

Our prices

Price list for single API calls