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. ordinarie-{id} - {{baseUrl}}/ordinarie/:id GET {{baseUrl}}/ordinarie/:id?ricevuta=<string>&state=<string>

  2. ordinarie-{id} - {{baseUrl}}/ordinarie/:id PATCH {{baseUrl}}/ordinarie/:id

  3. raccomandate - {{baseUrl}}/raccomandate/ POST {{baseUrl}}/raccomandate/

  4. ordinarie - {{baseUrl}}/ordinarie/ GET {{baseUrl}}/ordinarie/

  5. ordinarie - {{baseUrl}}/ordinarie/ POST {{baseUrl}}/ordinarie/

  6. prioritarie-{id} - {{baseUrl}}/prioritarie/:id GET {{baseUrl}}/prioritarie/:id?ricevuta=<string>&state=<string>

  7. prioritarie-{id} - {{baseUrl}}/prioritarie/:id PATCH {{baseUrl}}/prioritarie/:id

  8. prioritarie - {{baseUrl}}/prioritarie/ GET {{baseUrl}}/prioritarie/

  9. prioritarie - {{baseUrl}}/prioritarie/ POST {{baseUrl}}/prioritarie/

  10. telegrammi-{id} - {{baseUrl}}/telegrammi/:id PATCH {{baseUrl}}/telegrammi/:id