Ufficio Postale

Number of APIs: 29

This web service allows the delivery of postal products like Raccomandate, Telegrammi, Posta Prioritaria through Poste Italiane

1. Create a new mail with a POST request
2. Check the prices and confirm it with a PATCH, or use autoconfirm: true
3. Receive the status updates of your mail by providing a callback url

Note: There are some limitations regarding the size of a PDF document. Please read the 'document' field in the description of the endpoint that you want to use.

Error handling

When a sending error occurs, the response will include a message and a data.wrongfields: []: each element of wrongfields is a string which indicates where the error was generated from. This makes it very easy to integrate in your front-end form, where you can highlight the wrong entries

Testing

When using the Sandbox environment, you will receive update callbacks a short time after creating the request with placeholder content. It is also possible, for some products, to force the execution of the callback in the sandbox environment.

Contact Support: Name: Support

1. {{baseUrl}}/indirizzi/

GET {{baseUrl}}/indirizzi/?cap=<string>&comune=<string>&dug=<string>

---

2. {{baseUrl}}/dug/

GET {{baseUrl}}/dug/

---

3. {{baseUrl}}/comuni/:code

GET {{baseUrl}}/comuni/:code

---

4. {{baseUrl}}/tracking/:id

GET {{baseUrl}}/tracking/:id

---

5. {{baseUrl}}/pricing/

GET {{baseUrl}}/pricing/

---

6. ordinarie-{id} - {{baseUrl}}/ordinarie/:id

GET {{baseUrl}}/ordinarie/:id?ricevuta=<string>&state=<string>

---

7. ordinarie-{id} - {{baseUrl}}/ordinarie/:id

PATCH {{baseUrl}}/ordinarie/:id

---

8. raccomandate - {{baseUrl}}/raccomandate/

POST {{baseUrl}}/raccomandate/

---

9. ordinarie - {{baseUrl}}/ordinarie/

GET {{baseUrl}}/ordinarie/

---

10. ordinarie - {{baseUrl}}/ordinarie/

POST {{baseUrl}}/ordinarie/

---