Ufficio Postale

URL: https://openapi.it/en/support License: Terms of Service

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

Create a new mail with a POST request
Check the prices and confirm it with a PATCH, or use autoconfirm: true
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.wrong_fields: []: each element of wrong_fields 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

First time here? Generate a new access token

Raccomandate

This product offers a tracking code

List your Raccomandate

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"mittente": {"nome": "Alberto",
"cognome": "Rossi",
"email": "john.doe@openapi.it"
},
"creation_timestamp": 1608040424,
"update_timestamp": 1608040424,
"confirmed": false,
"state": "NEW",
"id": "5fd8bfeaa10b340e2e558db7"
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Send a Raccomandata. You should provide informatio

Send a Raccomandata. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the Raccomandata for a later confirmation with a PATCH request, while you do custom logic with the response. Check the NumeroRaccomandata field in the recipient object if you need the tracking number

Authorizations:

bearerAuth

Request Body schema: application/json

	object
	object
	Array of Recipient (object) or Casella postale (object) <= 2 items [ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.

Responses

Response Schema: application/json

	object
	object
	Array of objects[ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.
	object (documento_validato) The output of the document generation process.

Request samples

Content type

application/json

{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "Italia"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": true,
"autoconfirm": true
}
}

Response samples

200
422

Content type

application/json

{"data": [{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "IT",
"id": "6103f711dd2507415c5db6ce",
"state": "NEW"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"id": "6103f711dd2507415c5db6cf",
"state": "NEW"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"autoconfirm": true,
"timestamp_invio": 1627649810
},
"prodotto": "raccomandata",
"creation_timestamp": 1627649809,
"update_timestamp": 1627649810,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
"pagine": 1,
"size": 9350
},
"pricing": {"dettaglio": [{"codice_servizio": "RicevutaRitorno",
"descrizione_servizio": "Ricevuta di Ritorno",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.8,
"importo_unitario_netto": 0.8,
"importo_unitario_iva": 0
},
{"codice_servizio": "pagine",
"descrizione_servizio": "Tariffa Postale pagine",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 3.4,
"importo_unitario_netto": 3.4,
"importo_unitario_iva": 0
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.1,
"importo_unitario_netto": 0.1,
"importo_unitario_iva": 0
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {"importo_totale_netto": 8.6,
"importo_totale_iva": 0,
"importo_totale": 8.6
}
},
"lock": false,
"confirmed_timestamp": 1627649810,
"id": "6103f712dd2507415c5db6d0"
}
],
"success": true,
"message": "",
"error": null
}

Get information about a Raccomandata

Check the NumeroRaccomandata field in the recipient object if you need the tracking number

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

query Parameters

ricevuta

string

Default: "<string>"

Example: ricevuta=1

If the option was set, returns a PDF file as the received

Responses

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate/%7Bid%7D?ricevuta=1");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": {"mittente": {"nome": "Mario",
"cognome": "Bianchi",
"dug": "piazza",
"indirizzo": "italia",
"civico": "10",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"state": "SENT"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"dug": "piazza",
"indirizzo": "italia",
"civico": "10",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"id": "000000000000000000000000",
"state": "SENT",
"NumeroRaccomandata": "123412341234"
}
],
"documento": ["Test di invio"
],
"opzioni": {"fronteretro": false,
"colori": true,
"ar": {"nome": "Mario",
"cognome": "Bianchi",
"dug": "piazza",
"indirizzo": "italia",
"civico": "10",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"state": "SENT"
},
"ricevuta": false,
"autoconfirm": false,
"callback_url": "https://webhook.site/1231234124",
"timestamp_invio": 1662372837
},
"prodotto": "raccomandata",
"creation_timestamp": 1662372836,
"update_timestamp": 1662372836,
"username": "m.rossi@example.com",
"confirmed": false,
"state": "NEW",
"documento_validato": {"pdf": "https://xxxxxxxxx.pdf",
"jpg": "https://xxxxxxxxx.jpg",
"filename": "example.pdf",
"pagine": 1,
"size": 4513
},
"pricing": {"dettaglio": [{"codice_servizio": "StampaColori",
"descrizione_servizio": "Stampa Colori",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0.976,
"importo_unitario_netto": 0.8,
"importo_unitario_iva": 0.176
},
{"codice_servizio": "RicevutaRitorno",
"descrizione_servizio": "Ricevuta di Ritorno",
"percentuale_iva": 0,
"quantita": 1,
"importo_unitario_totale": 0.8,
"importo_unitario_netto": 0.8,
"importo_unitario_iva": 0
},
{"codice_servizio": "pagine",
"descrizione_servizio": "Tariffa Postale pagine",
"percentuale_iva": 0,
"quantita": 1,
"importo_unitario_totale": 3.4,
"importo_unitario_netto": 3.4,
"importo_unitario_iva": 0
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 20,
"quantita": 1,
"importo_unitario_totale": 0.12000000000000001,
"importo_unitario_netto": 0.1,
"importo_unitario_iva": 0.02
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 1.2,
"importo_unitario_netto": 1,
"importo_unitario_iva": 0.2
}
],
"totale": {"importo_totale_netto": 6.1,
"importo_totale_iva": 0.396,
"importo_totale": 6.4959999999999996
}
},
"id": "4242424242424242424242"
},
"message": "",
"success": true,
"error": null
}

Confirm sending a Raccomandata that was created wi

Confirm sending a Raccomandata that was created with "autosend = false"

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Request Body schema: application/json

confirmed

boolean

Default: "<boolean>"

Responses

Response Schema: application/json

trace	string
data	object Default: null
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"confirmed": true
}

Response samples

200
406

Content type

application/json

{"success": true,
"message": "<product> confirmed",
"error": 2060,
"data": null,
"trace": "WyJsaWJfdXBfUk9MLnBocEA5NiIsImNsYXNzLkF2V3MucGhwQDIxNyIsImluZGV4LnBocEAxNiJd"
}

Posta prioritaria

This product offers a code to track status updates

List your requests

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/prioritarie/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"mittente": {"nome": "Alberto",
"cognome": "Rossi",
"email": "john.doe@openapi.it"
},
"creation_timestamp": 1608040424,
"update_timestamp": 1608040424,
"confirmed": false,
"state": "NEW",
"id": "5fd8bfeaa10b340e2e558db7"
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Send a priority mail. You should provide informati

Send a priority mail. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the mail for a later confirmation with a PATCH request, while you do custom logic with the response. Check the IdRicevuta field in the recipient object if you need the tracking number

Authorizations:

bearerAuth

Request Body schema: application/json

	object
	Array of Recipient (object) or Casella postale (object) <= 2 items [ items ]
	object
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.

Responses

Response Schema: application/json

	object
	object
	Array of objects[ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.
	object (documento_validato) The output of the document generation process.

Request samples

Content type

application/json

{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "Italia"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": true,
"autoconfirm": true
}
}

Response samples

200
422

Content type

application/json

{"data": [{"mittente": {"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"autoconfirm": true,
"timestamp_invio": 1627649810
},
"prodotto": "raccomandata",
"creation_timestamp": 1627649809,
"update_timestamp": 1627649810,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
"pagine": 1,
"size": 9350
},
"pricing": {"dettaglio": [{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {"importo_totale_netto": 8.6,
"importo_totale_iva": 0,
"importo_totale": 8.6
}
},
"lock": false,
"confirmed_timestamp": 1627649810,
"id": "6103f712dd2507415c5db6d0"
}
],
"success": true,
"message": "",
"error": null
}

Get information about a single priority mail

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

query Parameters

ricevuta

string

Default: "<string>"

Example: ricevuta=1

If the option was set, returns a PDF file as the received

Responses

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/prioritarie/%7Bid%7D?ricevuta=1");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": {"mittente": {"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
}
],
"documento": ["testo di prova"
],
"opzioni": {"fronteretro": false,
"colori": false,
"autoconfirm": true,
"callback_url": "https://example.com/webhooks",
"timestamp_invio": 1635168169
},
"prodotto": "ordinaria",
"creation_timestamp": 1635168169,
"update_timestamp": 1635168169,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/test.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test.jpg",
"pagine": 1,
"size": 5249
},
"pricing": {"dettaglio": [{"codice_servizio": "pagine",
"descrizione_servizio": "Tariffa Postale pagine",
"percentuale_iva": 0,
"quantita": 1,
"importo_unitario_totale": 0.85,
"importo_unitario_netto": 0.85,
"importo_unitario_iva": 0
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0.20740000000000003,
"importo_unitario_netto": 0.17,
"importo_unitario_iva": 0.0374
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0.31720000000000004,
"importo_unitario_netto": 0.26,
"importo_unitario_iva": 0.0572
}
],
"totale": {"importo_totale_netto": 1.28,
"importo_totale_iva": 0.0946,
"importo_totale": 1.3746
}
},
"confirmed_timestamp": 1635168169,
"id": "az034324hjksd829jwqlo12uo"
},
"message": "",
"success": true,
"error": null
}

Confirm sending a mail that was created with "auto

Confirm sending a mail that was created with "autosend = false"

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Request Body schema: application/json

confirmed

boolean

Default: "<boolean>"

Responses

Response Schema: application/json

trace	string
data	object Default: null
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"confirmed": true
}

Response samples

200
406

Content type

application/json

{"success": true,
"message": "Confermata",
"error": 2060,
"data": null,
"trace": "WyJsaWJfdXBfUk9MLnBocEA5NiIsImNsYXNzLkF2V3MucGhwQDIxNyIsImluZGV4LnBocEAxNiJd"
}

Telegrammi

Get information about a telegram

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

query Parameters

ricevuta

string

Default: "<string>"

Example: ricevuta=1

If the option was set, returns a PDF file as the received

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/telegrammi/%7Bid%7D?ricevuta=1");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": {"mittente": {"nome": "Mario",
"cognome": "Rossi",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "4",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "PRIMO",
"cognome": "ROSSI",
"dug": "VIA",
"indirizzo": "PRIMO MAGGIO",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"id": "609d43e457d71a5b600ee17c",
"state": "NEW",
"IdRicevuta": "WG55505B956001"
}
],
"documento": ["Test document"
],
"opzioni": {"ar_c": {"nome": "Mario",
"cognome": "Rossi",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "4",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"fronteretro": false,
"colori": false,
"autoconfirm": true,
"mittente": false,
"ar_e": false,
"timestamp_invio": 1620919269
},
"prodotto": "telegramma",
"creation_timestamp": 1620919268,
"update_timestamp": 1620919779,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "SENT",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/0000000eeaaaa11111111xxxxx.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/0000000eeaaaa11111111xxxxx.jpg",
"parole": 2,
"size": 11
},
"pricing": {"dettaglio": [{"codice_servizio": "RicevutaRitornoCartacea",
"descrizione_servizio": "Ricevuta cartacea",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 7.93,
"importo_unitario_netto": 6.5,
"importo_unitario_iva": 1.4300000000000002
},
{"codice_servizio": "parole",
"descrizione_servizio": "Tariffa Postale parole",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {"importo_totale_netto": 10,
"importo_totale_iva": 2.2,
"importo_totale": 12.2
}
},
"confirmed_timestamp": 1620919269,
"GuidUtente": "xxxxxx-ae90-48b5-bec1-abcdefg",
"IDRichiesta": "xxxxxx-ae90-48b5-bec1-abcdefg",
"sending_timestamp": 1620919746,
"substate": "SENT",
"error": null,
"error_timestamp": 1620919356,
"sent_timestamp": 1620919779,
"id": "xxxxxxxe557d71a5b600ee17d"
},
"message": "",
"success": true,
"error": null
}

Confirm send of a telegram

Confirm sending a telegram that was created with "autosend = false"

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Request Body schema: application/json

confirmed

boolean

Default: "<boolean>"

Responses

Request samples

Content type

application/json

{"confirmed": true
}

Response samples

202

Content type

application/json

{"success": true,
"message": "<product> confirmed",
"error": 2060,
"data": null,
"trace": "WyJsaWJfdXBfUk9MLnBocEA5NiIsImNsYXNzLkF2V3MucGhwQDIxNyIsImluZGV4LnBocEAxNiJd"
}

List your telegrams

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/telegrammi/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"mittente": {"nome": "Mario",
"cognome": "Rossi",
"email": "john.doe@openapi.it"
},
"creation_timestamp": 1620919268,
"update_timestamp": 1620919779,
"confirmed": true,
"state": "SENT",
"error": null,
"id": "xxxxxxxe557d71a5b600ee17d"
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Send a telegram. You should provide information ab

Send a telegram. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the telegram for a later confirmation with a PATCH request, while you do custom logic with the response.

Authorizations:

bearerAuth

Request Body schema: application/json

	object
	object
	Array of objects <= 2 items [ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.

Responses

Response Schema: application/json

	object
	object
	Array of objects[ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.
	object (documento_validato) The output of the document generation process.

Request samples

Content type

application/json

{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "Italia"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": true,
"autoconfirm": true
}
}

Response samples

200
422

Content type

application/json

{"data": [{"mittente": {"nome": "Alberto",
"cognome": "Rossi",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "2b",
"comune": "verona",
"cap": "37138",
"provincia": "vr",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "VIA",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "IT",
"id": "61041dc0ac2b1f63327e92d0",
"state": "NEW"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "PIAZZA",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"id": "61041dc0ac2b1f63327e92d1",
"state": "NEW"
}
],
"documento": "lorem ipsum",
"opzioni": {"fronteretro": false,
"colori": false,
"autoconfirm": true,
"mittente": false,
"ar_c": false,
"ar_e": false,
"timestamp_invio": 1627659712
},
"prodotto": "telegramma",
"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": "parole",
"descrizione_servizio": "Tariffa Postale parole",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 4.27,
"importo_unitario_netto": 3.5,
"importo_unitario_iva": 0.77
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 22,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"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
}
},
"lock": false,
"confirmed_timestamp": 1627659712,
"id": "61041dc0ac2b1f63327e92d2"
}
],
"success": true,
"message": "",
"error": null
}

Ufficio Postale

Get pricings

Returns a list of prices for various kinds of services

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/pricing/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"tipologia": "raccomandata",
"prodotto": "raccomandata",
"descrizione": "Raccomandata",
"riferimento_prezzo": "pagina",
"accetta_allegati": 1,
"attivo": 1,
"tariffe": [{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 0,
"a": 1,
"tariffa_postale": 3.4,
"zona": 0,
"stampa": 0.1,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 2,
"a": 2,
"tariffa_postale": 3.4,
"zona": 0,
"stampa": 0.2,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 3,
"a": 3,
"tariffa_postale": 3.4,
"zona": 0,
"stampa": 0.3,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 4,
"a": 5,
"tariffa_postale": 4.55,
"zona": 0,
"stampa": 0.3,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 6,
"a": 9,
"tariffa_postale": 4.55,
"zona": 0,
"stampa": 0.35,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 10,
"a": 13,
"tariffa_postale": 4.55,
"zona": 0,
"stampa": 0.4,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 14,
"a": 18,
"tariffa_postale": 4.55,
"zona": 0,
"stampa": 0.45,
"imbustamento": 0
},
{"iva_tariffa_postale": 0,
"iva_stampa_imbustamento": 0,
"tipologia": "pagine",
"da": 19,
"a": 10000000,
"tariffa_postale": 4.55,
"zona": 0,
"stampa": 0.45,
"imbustamento": 0
}
],
"options": {"StampaColori": {"nome_option": "Stampa Colori",
"nome_option_invio": "StampaColori",
"prezzo_option": 0.8,
"iva": 0,
"attivo": 1
},
"RicevutaRitorno": {"nome_option": "Ricevuta di Ritorno",
"nome_option_invio": "RicevutaRitorno",
"prezzo_option": 0.8,
"iva": 0,
"attivo": 1
},
"FronteRetro": {"nome_option": "Stampa Fronte/Retro",
"nome_option_invio": "FronteRetro",
"prezzo_option": 0.3,
"iva": 0,
"attivo": 1
}
},
"username": null
}
],
"success": true,
"message": "",
"error": null
}

List of addresses

Authorizations:

bearerAuth

query Parameters

cap	string Default: "<string>" Example: cap=05100
comune	string Default: "<string>" Example: comune=terni
dug	string Default: "<string>" Example: dug=via

Responses

Response Schema: application/json

data	Array of strings <= 2 items
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/indirizzi/?cap=05100&comune=terni&dug=via");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": ["string"
],
"success": true,
"message": "string",
"error": null
}

List of all available dugs

(denomiazioni urbanistiche generiche)

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/dug/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"codice_dug": "BGO",
"dug": "Borgo"
}
],
"message": "1 Risultato",
"success": true,
"error": null
}

Track your product

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/tracking/%7Bid%7D");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"timestamp": 1604567446,
"descrizione": "accettata online",
"type": "00",
"definitivo": false
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Get information about a postal code Deprecated

Authorizations:

bearerAuth

path Parameters

code

required

string

Default: "<string>"

Example: 05100

Responses

Response Schema: application/json

	object
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/comuni/05100");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"nome_provincia": "Terni",
"sigla_provincia": "TR",
"regione": "Umbria",
"comuni": ["Terni"
],
"dettaglio_comuni": [{"nome": "Terni",
"popolazione": 109193,
"codice_catastale": "L117",
"codice_istat": "055032"
}
]
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Posta ordinaria

List your requests

Authorizations:

bearerAuth

Responses

Response Schema: application/json

	Array of objects[ items ]
success	boolean
message	string
error	any

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/ordinarie/");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": [{"mittente": {"nome": "Alberto",
"cognome": "Rossi",
"email": "john.doe@openapi.it"
},
"creation_timestamp": 1608040424,
"update_timestamp": 1608040424,
"confirmed": false,
"state": "NEW",
"id": "5fd8bfeaa10b340e2e558db7"
}
],
"message": "1 Risultati",
"success": true,
"error": null
}

Send a standard mail. You should provide informati

Send a standard mail. You should provide information about the sender and the receiver(s) in the post body. Additionally, the "autoconfirm" parameter can be set to false to save the mail for a later confirmation with a PATCH request, while you do custom logic with the response.

Authorizations:

bearerAuth

Request Body schema: application/json

	object
	object
	Array of Recipient (object) or Casella postale (object) <= 2 items [ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.

Responses

Response Schema: application/json

	object
	object
	Array of objects[ items ]
	Array of strings or string (documento) The document can either be a string or an array of strings in plain text. The strings can either be: Plain text Formatted in HTML, with style, header tags etc.. An URL pointing to either a webpage, a PDF or an image file (urls must start with http). The content is deduced from the "Content-Type" header A base64-encoded PDF file. Encoded strings are deducted by the base64 content header `data:application/pdf;base64,`: basically, in order to mark a string as a base64-encoded content, you should prepend the aforementioned string to the output. The request will return an error if the decoding process fails on the server The service analyses the "documento" (document) field, merges all the strings/document/images in different pages, compresses it slightly (if possible) and generates a single PDF file. The maximum size for a PDF document, after our compression, is 5 MB for every products execept Posta 4 PRO. The maximum number of pages is currently 18, or 36 is using the `fronteretro` option.
	object (documento_validato) The output of the document generation process.

Request samples

Content type

application/json

{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "Italia"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "Italia"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": true,
"autoconfirm": true
}
}

Response samples

200
422

Content type

application/json

{"data": [{"mittente": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "via",
"indirizzo": "Dante Alighieri",
"civico": "6",
"comune": "Roma",
"cap": "00101",
"provincia": "RE",
"nazione": "IT",
"id": "6103f711dd2507415c5db6ce",
"state": "NEW"
},
{"nome": "Mario",
"cognome": "Rossi",
"co": "OPENAPI SRL",
"dug": "piazza",
"indirizzo": "San Giovanni",
"civico": "6",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"id": "6103f711dd2507415c5db6cf",
"state": "NEW"
}
],
"documento": ["Example document"
],
"opzioni": {"fronteretro": false,
"colori": false,
"ar": {"titolo": "mr",
"nome": "Mario",
"cognome": "Rossi",
"dug": "Via",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "Roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"autoconfirm": true,
"timestamp_invio": 1627649810
},
"prodotto": "raccomandata",
"creation_timestamp": 1627649809,
"update_timestamp": 1627649810,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/f7294e76871965ea206d560d77ff079e.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/f7294e76871965ea206d560d77ff079e.jpg",
"pagine": 1,
"size": 9350
},
"pricing": {"dettaglio": [{"codice_servizio": "RicevutaRitorno",
"descrizione_servizio": "Ricevuta di Ritorno",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.8,
"importo_unitario_netto": 0.8,
"importo_unitario_iva": 0
},
{"codice_servizio": "pagine",
"descrizione_servizio": "Tariffa Postale pagine",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 3.4,
"importo_unitario_netto": 3.4,
"importo_unitario_iva": 0
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0.1,
"importo_unitario_netto": 0.1,
"importo_unitario_iva": 0
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 0,
"quantita": 2,
"importo_unitario_totale": 0,
"importo_unitario_netto": 0,
"importo_unitario_iva": 0
}
],
"totale": {"importo_totale_netto": 8.6,
"importo_totale_iva": 0,
"importo_totale": 8.6
}
},
"lock": false,
"confirmed_timestamp": 1627649810,
"id": "6103f712dd2507415c5db6d0"
}
],
"success": true,
"message": "",
"error": null
}

Get information about a single mail

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

query Parameters

ricevuta

string

Default: "<string>"

Example: ricevuta=1

If the option was set, returns a PDF file as the received

Responses

Request samples

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/ordinarie/%7Bid%7D?ricevuta=1");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

Response samples

200

Content type

application/json

{"data": {"mittente": {"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
},
"destinatari": [{"titolo": "mr",
"nome": "John",
"cognome": "Doe",
"dug": "Piazza",
"indirizzo": "Dante Alighieri",
"civico": "1",
"comune": "roma",
"cap": "00100",
"provincia": "RM",
"nazione": "IT",
"email": "john.doe@openapi.it"
}
],
"documento": ["testo di prova"
],
"opzioni": {"fronteretro": false,
"colori": false,
"autoconfirm": true,
"callback_url": "https://example.com/webhooks",
"timestamp_invio": 1635168169
},
"prodotto": "ordinaria",
"creation_timestamp": 1635168169,
"update_timestamp": 1635168169,
"username": "john.doe@openapi.it",
"confirmed": true,
"state": "CONFIRMED",
"documento_validato": {"pdf": "https://ws.ufficiopostale.com/Up/pdf/test.pdf",
"jpg": "https://ws.ufficiopostale.com/Up/jpg/test.jpg",
"pagine": 1,
"size": 5249
},
"pricing": {"dettaglio": [{"codice_servizio": "pagine",
"descrizione_servizio": "Tariffa Postale pagine",
"percentuale_iva": 0,
"quantita": 1,
"importo_unitario_totale": 0.85,
"importo_unitario_netto": 0.85,
"importo_unitario_iva": 0
},
{"codice_servizio": "STAMPA",
"descrizione_servizio": "Costo Stampa",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0.20740000000000003,
"importo_unitario_netto": 0.17,
"importo_unitario_iva": 0.0374
},
{"codice_servizio": "IMBUST",
"descrizione_servizio": "Imbustamento",
"percentuale_iva": 22,
"quantita": 1,
"importo_unitario_totale": 0.31720000000000004,
"importo_unitario_netto": 0.26,
"importo_unitario_iva": 0.0572
}
],
"totale": {"importo_totale_netto": 1.28,
"importo_totale_iva": 0.0946,
"importo_totale": 1.3746
}
},
"confirmed_timestamp": 1635168169,
"id": "az034324hjksd829jwqlo12uo"
},
"message": "",
"success": true,
"error": null
}

Confirm sending a mail that was created with "auto

Confirm sending a mail that was created with "autosend = false"

Authorizations:

bearerAuth

path Parameters

id

required

string

Default: "<string>"

Request Body schema: application/json

confirmed

boolean

Default: "<boolean>"

Responses

Response Schema: application/json

trace	string
data	object Default: null
success	boolean
message	string
error	integer

Request samples

Content type

application/json

{"confirmed": true
}

Response samples

200
406

Content type

application/json

{"success": true,
"message": "Confermata",
"error": 2060,
"data": null,
"trace": "WyJsaWJfdXBfUk9MLnBocEA5NiIsImNsYXNzLkF2V3MucGhwQDIxNyIsImluZGV4LnBocEAxNiJd"
}