HomeProductsPostamail International

Postamail International

€0.00 + VAT

International Postamail is the standard mail service for sending letters, documents, and communications to any country in the world in just a few seconds. The service is available 24/7.

Delivery

Since 8 business days

available for
  • gz

The Postamail International service allows you to send low-cost communications to all countries in the world with delivery in 8 days. All via API.

With International Postamail, you can send letters and documents to one or more recipients (no limits), both private and business, all with a single call:

REQUEST EXAMPLE

POST /ordinarie/

To send international postamail, you need to use the same endpoint as the Post 4 service POST /ordinarie/ and provide information such as:

  • sender's name and address
  • recipient's name and address
  • text
   {
  "data": {
    "sender": {
      "company": "openapi spa",
      "street": "piazza",
      "address": "cavour",
      "house_number": "43",
      "city": "roma",
      "postal_code": "00121",
      "region": "rm",
      "email": "sender@gmail.com",
      "country": "IT"
    },
   "recipients": [
    {
      "first_name": "string",
      "last_name": "string",
      "address": "string",
      "city": "string",
      "postal_code": "string",
      "region": "ee",
      "country": "string",
      "id": "664228bbbf1239901b0815f2",
      "status": "NEW"
    }
  ],
 - "document": [
    "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"
  ],
 - "options": {
    "double_sided": false,
    "color": false,
    "auto_confirm": false,
    "receipt": false
   }
  }
}

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

During the request, you can also select from a series of options:

  • color printing
  • schedule sending (timestamp_sending)
  • sending receipt
  • double-sided

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

However, if you wish to review the shipping data and associated costs before sending, "autoconfirm" should be set to "false".

RESPONSE EXAMPLE

POST /ordinary/

The response will include all the information about the sender, the recipient, and the message, as well as detailed information about the costs and the ID needed for shipment confirmation.

   {
  "data": {
    "mittente": {
      "ragione sociale": "openapi spa",
      "dug": "piazza",
      "indirizzo": "cavour",
      "civico": "43",
      "comune": "roma",
      "cap": "00121",
      "provincia": "rm",
      "email": "mittente@gmail.com",
      "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": {
    "fronte/retro": false,
    "colori": false,
    "autoconfirm": false,
    "ricevuta": false
   },
   "prodotto": "regular international",,
      "creation_timestamp": 1627659712,
      "update_timestamp": 1627659712,
      "username": "john.doe@openapi.it",,
      "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": "pages",
            "descrizione_servizio": "Postal pages rate",
            "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": "Print cost",
            "percentuale_iva": 22,
            "quantita": 2,
            "importo_unitario_totale": 0,
            "importo_unitario_netto": 0,
            "importo_unitario_iva": 0
          },
          {
            "codice_servizio": "ENVELOPING",
            "descrizione_servizio": "Enveloping",
            "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
        },
      "confirmed_timestamp": 1724754216,
      "id": "66cda9285673a1b85f092f03"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

SENDING CONFIRMATION

PATCH /ordinary/

To confirm the sending of the international ordinary mail, a second request must be made using the PATCH method and passing the ID of the previously made request.

The response will include all the data of the international ordinary mail with the status "confirmed"

The delivery times for International Postamail shipments are:

  • Europe: delivery in 85% of cases within 8 working days (excluding Saturdays and holidays) beyond the day of shipping
  • Mediterranean Basin: delivery in 85% of cases within 12 working days (excluding Saturdays and holidays) beyond the day of shipping
  • North America and Oceania: delivery in 85% of cases within 16 working days (excluding Saturdays and holidays) beyond the day of shipping
  • Rest of the World: delivery in 85% of cases within 22 working days (excluding Saturdays and holidays) beyond the day of shipping

For online shipments, the following processing times are added: printing in one working day (T+1), if the shipment is accepted by 14:00 Monday to Friday, excluding holidays.

Sign Up

Do you need help?

Haven't found the answer you're looking for?

Fill in all the details, we will get back to you as soon as possible!

Frequently Asked Questions

The International Postamail service is a practical and convenient solution for sending letters and documents to any country in the world, using a standard mail system via API. This service is particularly useful for businesses and professionals looking to communicate globally without complications, offering a simple way to manage international shipments.

What is the International Postamail service?