International Postapriority

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 SENDING 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:

   {
  "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:

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 PRIORITY POST 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.

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 Postapriority 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.

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

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.