International Registered Mail

The International Registered Mail service allows you to send any type of document (letter, invoice, etc.) to any country in the world in just a few seconds and with tracking system. 

You can send registered mail through the API to one or more recipients (no limits) whether private individuals or companies, to standard addresses or PO boxes, all with a single submission.

The maximum number of pages is currently 50, or 100 if the double-sided option is used. If a document exceeding 50 pages is uploaded without enabling the double-sided option, the system will generate an error message. In such cases, it is mandatory to select the double-sided option to proceed correctly with the document submission. The maximum size for a PDF document, after our compression, is 5 MB for all products, except for Posta 4 PRO, Posta Massiva, and Raccomandata Smart (these 3 products accept up to a maximum of 15 MB).

When sending using the POST /raccomandate/ endpoint, it is possible to get, before charging, the cost of each shipment, which is calculated based on the number of pages, the selected options, and the destination country. Destination countries are grouped into 3 zones:

INTERNATIONAL REGISTERED MAIL

POST /raccomandate/

To send an International Registered Mail, use the same endpoint as the Italian service POST /raccomandate/ and provide the following information:

   {
 "sender": {
  "first_name": "string",
  "last_name": "string",
  "street": "string",
  "address": "string",
  "number": "string",
  "city": "string",
  "postcode": "string",
  "region": "string",
  "country": "string",
},
   "recipients": [
    - {
      "first_name": "string",
      "last_name": "string",
      "address": "string",
      "city": "string",
      "postcode": "string",
      "region": "ee",
      "country": "string",
    },
  ],
 - "document": [
    "Text"
  ],
 - "options": {
    "double_sided": false,
    "color": false,
    "auto_confirm": false,}
}

When making the request, you can also select a series of options:

In this case, the data required for the recipient are partially different; the "dug" fields (e.g., boulevard) and house number should be entered directly into the address field, and the province will always be "ee".

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

If, however, you want to verify the shipment details and associated costs before sending, autoconfirm should be set to false. In the POST request response, you will have access to a series of information such as ID (needed for shipping confirmation) and shipping costs.

INTERNATIONAL REGISTERED MAIL RESPONSE

POST /raccomandate/

The response will include all information about the sender, recipient, and message, as well as detailed information about the costs.

   {
"mittente": {
  "nome": "string",
  "cognome": "string",
  "dug": "string",
  "indirizzo": "string",
  "civico": "string",
  "comune": "string",
  "cap": "string",
  "provincia": "string",
  "nazione": "string",
},
   "destinatari": [
    - {
      "nome": "string",
      "cognome": "string",
      "dug": "string",
      "indirizzo": "string",
      "civico": "string",
      "comune": "string",
      "cap": "string",
      "provincia": "string",
      "nazione": "string",
    },
  ],
 - "documento": [
    "Text"
  ],
 - "opzioni": {
    "fronteretro": false,
    "colori": false,
    "autoconfirm": false,
    "ar": true,
    "timestamp_invio": 1627649809,
},
      "prodotto": "international registered mail",
      "creation_timestamp": 1627649809,
      "update_timestamp": 1627649810,
      "username": "[email protected]",
      "confirmed": true,
      "state": "CONFIRMED",
      "documento_validato": {
        "pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
        "jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
        "pagine": 1,
        "size": 9350
      },
      "pricing": {
        "dettaglio": [
          {
            "codice_servizio": "ReturnReceipt",
            "descrizione_servizio": "Return Receipt",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0.8,
            "importo_unitario_netto": 0.8,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "pages",
            "descrizione_servizio": "Postal Rate Pages",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 3.4,
            "importo_unitario_netto": 3.4,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "PRINT",
            "descrizione_servizio": "Print Cost",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0.1,
            "importo_unitario_netto": 0.1,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "ENVELOPE",
            "descrizione_servizio": "Envelope",
            "percentuale_iva": 0,
            "quantita": 2,
            "importo_unitario_totale": 0,
            "importo_unitario_netto": 0,
            "importo_unitario_iva": 0
          }
        ],
        "totale": {
          "importo_totale_netto": 8.6,
          "importo_totale_iva": 0,
          "importo_totale": 8.6
        }
      },
      "lock": false,
      "confirmed_timestamp": 1627649810,
      "id": "6103f712dd2507415c5db6d0"
    }
  ],

Send Confirmation

PATCH /raccomandate/

To confirm the sending of the International Registered Mail, you need to make a second request using the PATCH method and pass the ID of the previously made request.

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

It is also possible to fully customize the cover of the communication, for example by adding a logo, company information, or promotions. Customization can be done through the API or via the Playground, which also allows you to preview before sending.

The International Registered Mail  includes a free 12-month digital archiving option for the content signed and digitally stamped by Poste Italiane. The legal compliance of the digital archiving certifies the content, ensuring it cannot be denied by the recipient in case of a legal dispute.

Due to the differences in objectives between countries, Poste Italiane cannot set a quality goal for delivery times to foreign countries.

NOTE: The prices at the time of purchase via API are further detailed between postal rate, printing, and envelope. The tracking code is provided synchronously within a few seconds of the sending confirmation.