The International Postapriority service, or international priority mail, allows you to send low-cost communications with the ability to track delivery status. All through the API.

With International Postapriority, you can send letters and documents to one or more recipients (no limits), whether private individuals, companies, or post boxes, all with a single dispatch.

INTERNATIONAL POSTAPRIORITY REQUEST

POST /prioritarie/

To send an International Postapriority, you need to use the same endpoint as for the Italian Postapriority service POST /prioritarie/ and provide information such as:

• sender's name and address
• recipient's name and address
• text

   {
  "data": {
    "sender": {
      "name": "Paolo",
      "surname": "De Carolis",
      "street": "piazza",
      "address": "cavour",
      "house_number": "43",
      "city": "roma",
      "zip_code": "00121",
      "province": "rm",
      "country": "IT",
      "email": "[email protected]",
    },
   "recipients": [
    {
      "name": "string",
      "surname": "string",
      "address": "string",
      "city": "string",
      "province": "ee",
      "country": "string",
      "id": "664228bbbf1239901b0815f2",
      "status": "NEW"
    }
  ],
 "document": [
     "Example document"
    ],
 "options": {
    "double_sided": false,  
    "colors": false,
    "auto_confirm": false,    
  }
}

In this case, the data requested for the recipient are partially different; the fields street (e.g., viale) and house number must be entered directly in the address field, and the province will always be "ee".

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

• single-sided / double-sided
• colors
• schedule sending (timestamp_sending)
• sending receipt

It is also possible to set up auto-confirm (auto_confirm) and thus send the shipment automatically (if the value is set to "true"). In this case, the cost of the shipment will be charged immediately and the sending scheduled.

If you wish to verify the shipment data and associated costs before sending, auto_confirm should be set to false.

INTERNATIONAL POSTAPRIORITY RESPONSE

POST /prioritarie/

The response will include all the information regarding the sender, recipient, and message, along with detailed information about costs and the ID required for sending confirmation.

   {
  "data": {
    "sender": {
      "name": "Paolo",
      "surname": "De Carolis",
      "dug": "piazza",
      "address": "cavour",
      "house_number": "43",
      "city": "roma",
      "postal_code": "00121",
      "province": "rm",
      "country": "IT",
      "email": "[email protected]",
    },
   "recipients": [
    {
      "name": "string",
      "surname": "string",
      "address": "string",
      "city": "string",
      "postal_code": "string",
      "province": "ee",
      "country": "string",
      "id": "664228bbbf1239901b0815f2",
      "state": "NEW"
    }
  ],
 "document": [
     "Example document"
    ],
 "options": {
    "frontback": false,  
    "colors": false,
    "autoconfirm": false,
    "timestamp_sending": 1627659712    
  },
},
"product": "international priority",,
   "creation_timestamp": 1627659712,
   "update_timestamp": 1627659712,
   "username": "[email protected]",,
   "confirmed": true,,
   "state": "CONFIRMED",
   "validated_document": {
     "pdf": "https://ws.ufficiopostale.com/Up/pdf/test-document.pdf",
     "jpg": "https://ws.ufficiopostale.com/Up/jpg/test-document.jpg",
     "words": 1,
      "size": 9350
   },
   "pricing": {
     "details": [
       {
         "service_code": "pages",
         "service_description": "Postal fee pages",
         "vat_percentage": 0,
         "quantity": 2,
         "total_unit_amount": 3.44,
         "net_unit_amount": 3.44,
         "vat_unit_amount": 0
       },
       {
         "service_code": "PRINT",
         "service_description": "Printing cost",
         "vat_percentage": 0,
         "quantity": 2,
         "total_unit_amount": 0.1,
         "net_unit_amount": 0.1,
         "vat_unit_amount": 0
       },
       {
         "service_code": "ENVELOP",
         "service_description": "Enveloping",
         "vat_percentage": 0,
         "quantity": 2,
         "total_unit_amount": 0,
         "net_unit_amount": 0,
         "vat_unit_amount": 0
       }
     ],
     "total": {
       "net_total_amount":  8.6,
       "vat_total_amount": 0,
       "total_amount":  8.6
     },
   "lock": false,
   "confirmed_timestamp": 1724754216,
   "id": "66cda9285673a1b85f092f03"
 }
],
"success": true,
"message": "",
"error": null
}

Sending Confirmation

PATCH /prioritarie/

To confirm the sending of International Postapriority, a second request with the PATCH method is required, and the ID of the previously made request must be provided.

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

The number of pages for International Postapriority can be between 1 and 100. Beyond the 50th page, the print type will automatically be double-sided. The prices shown are for the most commonly used price ranges only. When sending with the POST /prioritarie/ endpoint, it will be possible to obtain the cost of each shipment before charging, which is calculated based on the number of pages and selected options.

Delivery times for International Postapriority depend on the destination country and are as follows:

• Europe: 3 working days (excluding Saturday and holidays) after the shipping day, for 85% of shipments
• Mediterranean Basin: 4/5 working days (excluding Saturday and holidays) after the shipping day, for 85% of shipments
• North America: 5/6 working days (excluding Saturday and holidays) after the shipping day, for 85% of shipments
• Other Americas, Asia, and Oceania: 7/8 working days (excluding Saturday and holidays) after the shipping day, for 85% of shipments Other African countries: 8/9 working days (excluding Saturday and holidays) after the shipping day, for 85% of shipments

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