Alle Ihre Sendungen über API und in Echtzeit
Automatisieren Sie den Versand von Dokumenten, Einschreiben, Telegrammen, Werbung mit der Post<br>
All das Wissen, das Sie benötigen
Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.
Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.
- Oas file url https://console.openapi.com/oas/de/ufficiopostale.openapi.json
- Fork or import with Postman
- Production domain ws.ufficiopostale.com
- Sandbox domain test.ws.ufficiopostale.com
-
Production Scopes 33
- GET ws.ufficiopostale.com/indirizzi
- GET ws.ufficiopostale.com/dug
- GET ws.ufficiopostale.com/raccomandate
- PATCH ws.ufficiopostale.com/telegrammi
- PATCH ws.ufficiopostale.com/ordinarie
- GET ws.ufficiopostale.com/ordinarie
- POST ws.ufficiopostale.com/prioritarie
- GET ws.ufficiopostale.com/tracking
- GET ws.ufficiopostale.com/comuni
- POST ws.ufficiopostale.com/raccomandate
- PATCH ws.ufficiopostale.com/raccomandate
- GET ws.ufficiopostale.com/pricing
- POST ws.ufficiopostale.com/telegrammi
- GET ws.ufficiopostale.com/telegrammi
- POST ws.ufficiopostale.com/ordinarie
- PATCH ws.ufficiopostale.com/prioritarie
- GET ws.ufficiopostale.com/prioritarie
- GET ws.ufficiopostale.com/posta_4_pro
- POST ws.ufficiopostale.com/posta_4_pro
- PATCH ws.ufficiopostale.com/posta_4_pro
- POST ws.ufficiopostale.com/posta_massiva
- GET ws.ufficiopostale.com/posta_massiva
- PATCH ws.ufficiopostale.com/posta_massiva
- GET ws.ufficiopostale.com/raccomandate_smart
- POST ws.ufficiopostale.com/raccomandate_smart
- PATCH ws.ufficiopostale.com/raccomandate_smart
- GET ws.ufficiopostale.com/nazioni
- POST ws.ufficiopostale.com/covers
- GET ws.ufficiopostale.com/covers
- DELETE ws.ufficiopostale.com/covers
- GET ws.ufficiopostale.com/atti_giudiziari
- PATCH ws.ufficiopostale.com/atti_giudiziari
- POST ws.ufficiopostale.com/atti_giudiziari
-
Sandbox Scopes 33
- GET test.ws.ufficiopostale.com/tracking
- GET test.ws.ufficiopostale.com/dug
- GET test.ws.ufficiopostale.com/raccomandate
- POST test.ws.ufficiopostale.com/raccomandate
- PATCH test.ws.ufficiopostale.com/raccomandate
- POST test.ws.ufficiopostale.com/telegrammi
- POST test.ws.ufficiopostale.com/ordinarie
- GET test.ws.ufficiopostale.com/indirizzi
- GET test.ws.ufficiopostale.com/comuni
- GET test.ws.ufficiopostale.com/pricing
- PATCH test.ws.ufficiopostale.com/telegrammi
- GET test.ws.ufficiopostale.com/telegrammi
- GET test.ws.ufficiopostale.com/ordinarie
- PATCH test.ws.ufficiopostale.com/ordinarie
- POST test.ws.ufficiopostale.com/prioritarie
- GET test.ws.ufficiopostale.com/prioritarie
- PATCH test.ws.ufficiopostale.com/prioritarie
- GET test.ws.ufficiopostale.com/posta_4_pro
- POST test.ws.ufficiopostale.com/posta_4_pro
- PATCH test.ws.ufficiopostale.com/posta_4_pro
- GET test.ws.ufficiopostale.com/posta_massiva
- POST test.ws.ufficiopostale.com/posta_massiva
- PATCH test.ws.ufficiopostale.com/posta_massiva
- GET test.ws.ufficiopostale.com/raccomandate_smart
- POST test.ws.ufficiopostale.com/raccomandate_smart
- PATCH test.ws.ufficiopostale.com/raccomandate_smart
- GET test.ws.ufficiopostale.com/nazioni
- POST test.ws.ufficiopostale.com/covers
- GET test.ws.ufficiopostale.com/covers
- DELETE test.ws.ufficiopostale.com/covers
- POST test.ws.ufficiopostale.com/atti_giudiziari
- PATCH test.ws.ufficiopostale.com/atti_giudiziari
- GET test.ws.ufficiopostale.com/atti_giudiziari
Ufficio Postale (1.0.0)
Dieser Webservice ermöglicht die Zustellung von Postprodukten wie Raccomandate, Telegrammi, Posta Prioritaria durch Poste Italiane
- Erstellen Sie eine neue Mail mit einer POST-Anfrage
- Prüfen Sie die Preise und bestätigen Sie sie mit einem PATCH, oder verwenden Sie autoconfirm: true
- Empfangen Sie die Status-Updates Ihrer Mail, indem Sie eine callback url
Hinweis: Es gibt einige Einschränkungen bezüglich der Größe eines PDF-Dokuments. Bitte lesen Sie das Feld "Dokument" in der Beschreibung des Endpunkts, den Sie verwenden möchten.
Fehlerbehandlung
Wenn ein Sendefehler auftritt, enthält die Antwort eine Meldung und ein data.wrong_fields: []: Jedes Element von falsche_Felder ist eine Zeichenkette, die angibt, von wo aus der Fehler erzeugt wurde. Dies macht es sehr einfach, in Ihr Front-End-Formular zu integrieren, wo Sie die falschen Einträge hervorheben könnenTesting
Wenn Sie die Sandbox-Umgebung verwenden, erhalten Sie kurz nach der Erstellung der Anfrage Aktualisierungs-Callbacks mit Platzhalterinhalten. Bei einigen Produkten ist es auch möglich, die Ausführung des Callbacks in der Sandbox-Umgebung zu erzwingen.Preise erhalten
Liefert eine Liste von Preisen für verschiedene Arten von Dienstleistungen
Authorizations:
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
OK
- "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
Liste der Adressen
Authorizations:
query Parameters
cap | string Example: cap=05100 |
comune | string Example: comune=terni |
dug | string Example: dug=via |
Responses
Response Schema: application/json
data | Array of strings |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/indirizzi/?cap=SOME_STRING_VALUE&comune=SOME_STRING_VALUE&dug=SOME_STRING_VALUE"); 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
- "data": [
- "string"
- "success": true,
- "message": "string",
- "error": null
Liste aller verfügbaren Drogen
(generische städtische Bezeichnungen)
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "codice_dug": "BGO",
- "dug": "Borgo"
- "message": "1 Risultato",
- "success": true,
- "error": null
Verfolgen Sie Ihr Produkt
Authorizations:
path Parameters
id required | string |
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "timestamp": 1604567446,
- "descrizione": "accettata online",
- "type": "00",
- "definitivo": false
- "message": "1 Risultati",
- "success": true,
- "error": null
Informationen über eine Postleitzahl abrufen Deprecated
Authorizations:
path Parameters
code required | string Example: 05100 |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
OK
- "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
Informationen über ein Telegramm abrufen
Authorizations:
path Parameters
id required | string |
query Parameters
ricevuta | string Example: ricevuta=1 Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben |
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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&state=NEW"); 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
- 404
- "data": {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "4",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "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": "[email protected]"
- "fronteretro": false,
- "colori": false,
- "autoconfirm": true,
- "mittente": false,
- "ar_e": false,
- "timestamp_invio": 1620919269
- "prodotto": "telegramma",
- "creation_timestamp": 1620919268,
- "update_timestamp": 1620919779,
- "confirmed": true,
- "state": "SENT",
- "documento_validato": {
- "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
Bestätigen Sie den Versand eines Telegramms
Bestätigen Sie das Senden eines Telegramms, das mit "autoconfirm = false" erstellt wurde.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 421
- "data": [
- {
- "mittente": {
- "ragione_sociale": "Mario Rossi Srl",
- "dug": "Viale",
- "indirizzo": "dei Giardini",
- "civico": "82",
- "comune": "san dona' di piave",
- "cap": "30027",
- "provincia": "VE",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "ragione_sociale": "prova spa",
- "dug": "viale",
- "indirizzo": "rossi mario",
- "civico": "82",
- "comune": "san dona' di piave",
- "cap": "30027",
- "provincia": "VE",
- "nazione": "IT",
- "id": "649998d25b295d43ac0f1e78",
- "state": "NEW"
- "documento": [
- "tmpfiles.org/dl/980693/br223_compressed.pdf"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "ar": false,
- "ricevuta": false,
- "autoconfirm": false,
- "timestamp_invio": 1687787732
- "prodotto": "raccomandata",
- "creation_timestamp": 1687787729,
- "update_timestamp": 1687787742,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "raccomandataUBLwd2TfrzVnSTMymTi5SnmAo.pdf",
- "pagine": 1,
- "size": 6308
- "pricing": {
- "dettaglio": [
- {
- "codice_servizio": "FronteRetro",
- "descrizione_servizio": "Fronte Retro",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_totale": 0.05,
- "importo_unitario_netto": 0.05,
- "importo_unitario_iva": 0
- {
- "codice_servizio": "StampaColori",
- "descrizione_servizio": "Stampa Colori",
- "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_netto": 3.92,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 3.92
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_netto": 0.32,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 0.32
- {
- "codice_servizio": "IMBUST",
- "descrizione_servizio": "Imbustamento",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_netto": 0.12,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 0.12
- "totale": {
- "importo_totale_netto": 5.21,
- "importo_totale_iva": 0,
- "importo_totale": 5.21
- "confirmed_timestamp": 1687787742,
- "id": "649998d45b295d43ac0f1e79"
- "success": true,
- "message": "",
- "error": null
Liste Ihrer Telegramme
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "creation_timestamp": 1620919268,
- "update_timestamp": 1620919779,
- "confirmed": true,
- "state": "SENT",
- "error": null,
- "id": "xxxxxxxe557d71a5b600ee17d"
- "message": "1 Risultati",
- "success": true,
- "error": null
Senden Sie ein Telegramm. Sie sollten Informatione
Senden Sie ein Telegramm. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Zusätzlich kann der Parameter "autoconfirm" auf false gesetzt werden, um das Telegramm für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen.
Authorizations:
Request Body schema: application/json
object | |
object | |
Array of objects (Recipient) | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
object | |
Array of objects | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". | |
object (documento_validato) Die Ausgabe des Dokumentenerstellungsprozesses. |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "[email protected]"
- "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": {
- "autoconfirm": true
Response samples
- 201
- 421
- 422
- 500
- "data": [
- {
- "mittente": {
- "nome": "Alberto",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "2b",
- "comune": "verona",
- "cap": "37138",
- "provincia": "vr",
- "nazione": "IT",
- "email": "[email protected]"
- "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": {
- "autoconfirm": true,
- "mittente": false,
- "ar_c": false,
- "ar_e": false,
- "timestamp_invio": 1627659712
- "prodotto": "telegramma",
- "creation_timestamp": 1627659712,
- "update_timestamp": 1627659712,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
List your Raccomandate
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "creation_timestamp": 1608040424,
- "update_timestamp": 1608040424,
- "confirmed": false,
- "state": "NEW",
- "id": "5fd8bfeaa10b340e2e558db7"
- "message": "1 Risultati",
- "success": true,
- "error": null
Senden Sie ein Raccomandat. Sie sollten Informatio
Senden Sie ein Raccomandat. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Zusätzlich kann der Parameter "autoconfirm" auf false gesetzt werden, um die Raccomandata für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen. Überprüfen Sie das Feld NumeroRaccomandata im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen
Authorizations:
Request Body schema: application/json
object | |
object | |
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale) | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
object | |
Array of objects | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". | |
object (documento_validato) Die Ausgabe des Dokumentenerstellungsprozesses. |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "[email protected]"
- "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
- 201
- 421
- 422
- 500
- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "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": "[email protected]"
- "autoconfirm": true,
- "timestamp_invio": 1627649810
- "prodotto": "raccomandata",
- "creation_timestamp": 1627649809,
- "update_timestamp": 1627649810,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
Informationen über eine Raccomandate erhalten
Überprüfen Sie das Feld NumeroRaccomandata im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen
Authorizations:
path Parameters
id required | string |
query Parameters
ricevuta | string Example: ricevuta=1 Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben |
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
callback | string Example: callback=<empty string> Simuliert den Fortschritt des Versandstatus: Jedes Mal, wenn dieser Endpunkt aufgerufen wird, schreitet Ihre Anfrage zum nächsten Versandstatus. |
Responses
Response Schema: application/json
object | |
message | string |
success | boolean |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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&state=NEW&callback=%3Cempty%20string%3E"); 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
- 404
- "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,
- "timestamp_invio": 1662372837
- "prodotto": "raccomandata",
- "creation_timestamp": 1662372836,
- "update_timestamp": 1662372836,
- "confirmed": false,
- "state": "NEW",
- "documento_validato": {
- "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
Bestätigen Sie den Versand einer Raccomandate, die
Bestätigen Sie den Versand einer Raccomandate, die mit "autoconfirm = false" erstellt wurde
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 406
- 421
- "data": [
- {
- "mittente": {
- "ragione_sociale": "Mario Rossi Srl",
- "dug": "Viale",
- "indirizzo": "dei Giardini",
- "civico": "82",
- "comune": "san dona' di piave",
- "cap": "30027",
- "provincia": "VE",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "ragione_sociale": "prova spa",
- "dug": "viale",
- "indirizzo": "rossi mario",
- "civico": "82",
- "comune": "san dona' di piave",
- "cap": "30027",
- "provincia": "VE",
- "nazione": "IT",
- "id": "649998d25b295d43ac0f1e78",
- "state": "NEW"
- "documento": [
- "tmpfiles.org/dl/980693/br223_compressed.pdf"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "ar": false,
- "ricevuta": false,
- "autoconfirm": false,
- "timestamp_invio": 1687787732
- "prodotto": "raccomandata",
- "creation_timestamp": 1687787729,
- "update_timestamp": 1687787742,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "raccomandataUBLwd2TfrzVnSTMymTi5SnmAo.pdf",
- "pagine": 1,
- "size": 6308
- "pricing": {
- "dettaglio": [
- {
- "codice_servizio": "FronteRetro",
- "descrizione_servizio": "Fronte Retro",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_totale": 0.05,
- "importo_unitario_netto": 0.05,
- "importo_unitario_iva": 0
- {
- "codice_servizio": "StampaColori",
- "descrizione_servizio": "Stampa Colori",
- "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_netto": 3.92,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 3.92
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_netto": 0.32,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 0.32
- {
- "codice_servizio": "IMBUST",
- "descrizione_servizio": "Imbustamento",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_netto": 0.12,
- "importo_unitario_iva": 0,
- "importo_unitario_totale": 0.12
- "totale": {
- "importo_totale_netto": 5.21,
- "importo_totale_iva": 0,
- "importo_totale": 5.21
- "confirmed_timestamp": 1687787742,
- "id": "649998d45b295d43ac0f1e79"
- "success": true,
- "message": "",
- "error": null
Ihre Anfragen auflisten
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "creation_timestamp": 1608040424,
- "update_timestamp": 1608040424,
- "confirmed": false,
- "state": "NEW",
- "id": "5fd8bfeaa10b340e2e558db7"
- "message": "1 Risultati",
- "success": true,
- "error": null
Senden Sie eine Prioritätssendung. Sie sollten im
Senden Sie eine Prioritätssendung. Sie sollten im Nachrichtentext Informationen über den Absender und den/die Empfänger angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um die Mail für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen. Überprüfen Sie das Feld IdRicevuta im Empfängerobjekt, wenn Sie die Tracking-Nummer benötigen.
Authorizations:
Request Body schema: application/json
object | |
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale) | |
object | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
object | |
Array of objects | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". | |
object (documento_validato) Die Ausgabe des Dokumentenerstellungsprozesses. |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "[email protected]"
- "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
- 201
- 422
- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "documento": [
- "Example document"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "autoconfirm": true,
- "timestamp_invio": 1627649810
- "prodotto": "raccomandata",
- "creation_timestamp": 1627649809,
- "update_timestamp": 1627649810,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
Informationen über eine einzelne Prioritätssendung erhalten
Authorizations:
path Parameters
id required | string |
query Parameters
ricevuta | string Example: ricevuta=1 Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben |
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
Responses
Response Schema: application/json
object | |
message | string |
success | boolean |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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&state=NEW"); 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
- "data": {
- "mittente": {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "documento": [
- "testo di prova"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "autoconfirm": true,
- "timestamp_invio": 1635168169
- "prodotto": "ordinaria",
- "creation_timestamp": 1635168169,
- "update_timestamp": 1635168169,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Bestätigen Sie den Versand einer E-Mail, die mit "
Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 406
- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Lorenzo",
- "cognome": "Paderi",
- "dug": "Piazza",
- "indirizzo": "ener bettica",
- "civico": "43",
- "comune": "roma",
- "cap": "00121",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "titolo": "mr",
- "nome": "Lorenzo",
- "cognome": "Paderi",
- "dug": "Piazza",
- "indirizzo": "ener bettica",
- "civico": "43",
- "comune": "roma",
- "cap": "00121",
- "provincia": "RM",
- "nazione": "IT",
- "id": "6499a05813df9dd7900e42c4",
- "state": "NEW"
- "documento": [
- "Lorem ipsum dixit nuovo test2"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "autoconfirm": false,
- "ricevuta": true,
- "timestamp_invio": 1687789658
- "prodotto": "prioritaria",
- "creation_timestamp": 1687789656,
- "update_timestamp": 1687789674,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "prioritariaCukonJsUHfAJMObAd1WFFPGP7.pdf",
- "pagine": 1,
- "size": 5273
- "pricing": {
- "dettaglio": [
- {
- "codice_servizio": "RicevutaDiInvio",
- "descrizione_servizio": "Ricevuta Di Invio",
- "percentuale_iva": 0,
- "quantita": 1,
- "importo_unitario_totale": 1,
- "importo_unitario_netto": 1,
- "importo_unitario_iva": 0
- {
- "codice_servizio": "pagine",
- "descrizione_servizio": "Tariffa postale pagine",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 2.1,
- "importo_unitario_iva": 0.462,
- "importo_unitario_totale": 2.5620000000000003
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 0.22,
- "importo_unitario_iva": 0.048400000000000006,
- "importo_unitario_totale": 0.2684
- {
- "codice_servizio": "IMBUST",
- "descrizione_servizio": "Imbustamento",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 0.23,
- "importo_unitario_iva": 0.0506,
- "importo_unitario_totale": 0.2806
- "totale": {
- "importo_totale_netto": 3.5500000000000003,
- "importo_totale_iva": 0.561,
- "importo_totale": 4.111000000000001
- "confirmed_timestamp": 1687789674,
- "id": "6499a05a13df9dd7900e42c5"
- "success": true,
- "message": "",
- "error": null
Ihre Anfragen auflisten
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
success | boolean |
message | string |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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
- "data": [
- {
- "creation_timestamp": 1608040424,
- "update_timestamp": 1608040424,
- "confirmed": false,
- "state": "NEW",
- "id": "5fd8bfeaa10b340e2e558db7"
- "message": "1 Risultati",
- "success": true,
- "error": null
Senden Sie eine Standard-Mail. Sie sollten Informa
Senden Sie eine Standard-Mail. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um die E-Mail für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik ausführen.
Authorizations:
Request Body schema: application/json
object | |
object | |
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale) | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
object | |
Array of objects | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". | |
object (documento_validato) Die Ausgabe des Dokumentenerstellungsprozesses. |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "[email protected]"
- "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
- 201
- 421
- 422
- 500
- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "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": "[email protected]"
- "autoconfirm": true,
- "timestamp_invio": 1627649810
- "prodotto": "raccomandata",
- "creation_timestamp": 1627649809,
- "update_timestamp": 1627649810,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
Informationen über eine einzelne E-Mail abrufen
Authorizations:
path Parameters
id required | string |
query Parameters
ricevuta | string Example: ricevuta=1 Wenn die Option gesetzt wurde, wird eine PDF-Datei als Empfangsdatei zurückgegeben |
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
Responses
Response Schema: application/json
object | |
message | string |
success | boolean |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
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&state=NEW"); 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
- 404
- "data": {
- "mittente": {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "titolo": "mr",
- "nome": "John",
- "cognome": "Doe",
- "dug": "Piazza",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "documento": [
- "testo di prova"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "autoconfirm": true,
- "timestamp_invio": 1635168169
- "prodotto": "ordinaria",
- "creation_timestamp": 1635168169,
- "update_timestamp": 1635168169,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "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
Bestätigen Sie den Versand einer E-Mail, die mit "
Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 406
- 421
- "data": [
- {
- "mittente": {
- "titolo": "mr",
- "nome": "Lorenzo",
- "cognome": "Paderi",
- "dug": "Piazza",
- "indirizzo": "ener bettica",
- "civico": "1",
- "comune": "roma",
- "cap": "00121",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "titolo": "mr",
- "nome": "Lorenzo",
- "cognome": "Paderi",
- "dug": "Piazza",
- "indirizzo": "ener bettica",
- "civico": "11",
- "comune": "roma",
- "cap": "00121",
- "provincia": "RM",
- "nazione": "IT",
- "id": "64999de413df9dd7900e42c0",
- "state": "NEW"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": false,
- "timestamp_invio": 1687789031
- "prodotto": "ordinaria",
- "creation_timestamp": 1687789028,
- "update_timestamp": 1687789043,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "ordinariaZTq31xBfGVtjo4YxQJzSrvNRb.pdf",
- "pagine": 4,
- "size": 149658
- "pricing": {
- "dettaglio": [
- {
- "codice_servizio": "StampaColori",
- "descrizione_servizio": "Stampa Colori",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_totale": 0.8539999999999999,
- "importo_unitario_netto": 0.7,
- "importo_unitario_iva": 0.15399999999999997
- {
- "codice_servizio": "pagine",
- "descrizione_servizio": "Tariffa postale pagine",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 0.95,
- "importo_unitario_iva": 0.209,
- "importo_unitario_totale": 1.159
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 0.4,
- "importo_unitario_iva": 0.088,
- "importo_unitario_totale": 0.488
- {
- "codice_servizio": "IMBUST",
- "descrizione_servizio": "Imbustamento",
- "percentuale_iva": 22,
- "quantita": 1,
- "importo_unitario_netto": 0.14,
- "importo_unitario_iva": 0.030800000000000004,
- "importo_unitario_totale": 0.1708
- "totale": {
- "importo_totale_netto": 2.19,
- "importo_totale_iva": 0.48179999999999995,
- "importo_totale": 2.6717999999999997
- "confirmed_timestamp": 1687789043,
- "id": "64999de713df9dd7900e42c1"
- "success": true,
- "message": "",
- "error": null
Ihr raccomandate_smart auflisten
Ihr raccomandate_smart auflisten
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
message | string |
success | boolean |
error | any |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate_smart/"); 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
- "data": [
- {
- "mittente": {
- "ragione_sociale": "openapi srl",
- "nome": "Mario",
- "cognome": "Rossi"
- "creation_timestamp": 1657169682,
- "update_timestamp": 1676901090,
- "confirmed": false,
- "state": "SENT",
- "id": "xxxxxxxe557d71a5b600ee11d"
- "message": "1 Risultati",
- "success": true,
- "error": null
Senden Sie einen Raccomandata Smart. Sie sollten I
Senden Sie einen Raccomandata Smart. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um ihn für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen.
Authorizations:
Request Body schema: application/json
object | |
object | |
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale) | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | integer |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": [
- {
- "ragione_sociale": "Openapi SRL",
- "civico": "221",
- "comune": "roma",
- "dug": "via",
- "indirizzo": "Filippo tommaso marinetti",
- "cap": "00143",
- "provincia": "RM",
- "nazione": "IT",
- "email": "[email protected]"
- "destinatari": [
- {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "6",
- "comune": "Roma",
- "cap": "00143",
- "provincia": "RM",
- "nazione": "Italia"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "ar": true,
- "autoconfirm": false,
Response samples
- 201
- 421
- 422
- 500
- "data": [
- {
- "mittente": {
- "ragione_sociale": "Openapi SRL",
- "civico": "221",
- "comune": "roma",
- "dug": "via",
- "indirizzo": "Filippo tommaso marinetti",
- "cap": "00143",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "6",
- "comune": "Roma",
- "cap": "00143",
- "provincia": "RM",
- "nazione": "Italia",
- "intestazione_completa": "Mario Rossi",
- "zona": "AM",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "ar": true,
- "autoconfirm": false,
- "prodotto": "raccomandata_smart",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": false,
- "state": "NEW",
- "documento_validato": {
- "filename": "raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.pdf",
- "pagine": 2,
- "size": 49553,
- "pricing": {
- "totale": {
- "importo_totale": 0.58
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.28,
- "importo_unitario_netto": 0.22,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "Spedizione",
- "importo_unitario_totale": 0.3,
- "importo_unitario_netto": 0.3,
- "importo_unitario_iva": 0,
- "quantita": 1
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
Listen Sie Ihre einzelnen raccomandata smart
Listen Sie Ihre einzelnen raccomandata smart
Authorizations:
path Parameters
id required | string |
query Parameters
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
Responses
Response Schema: application/json
object (ExampleState) | |
object | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/raccomandate_smart/%7Bid%7D?state=NEW"); 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
- 404
- "data": [
- {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "ener bettica",
- "civico": "14",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "lazio",
- "civico": "12",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "documento": [
- "test prova"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": true,
- "timestamp_invio": 1687169681
- "prodotto": "raccomandata_smart",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": false,
- "state": "NEW",
- "documento_validato": {
- "filename": "raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.pdf",
- "pagine": 2,
- "size": 49553,
- "pricing": {
- "totale": {
- "importo_totale": 0.58
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.28,
- "importo_unitario_netto": 0.22,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "Spedizione",
- "importo_unitario_totale": 0.3,
- "importo_unitario_netto": 0.3,
- "importo_unitario_iva": 0,
- "quantita": 1
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null
Bestätigen Sie den Versand einer E-Mail, die mit "
Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 406
- 421
- "data": [
- {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "romagna",
- "civico": "12",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "alighieri",
- "civico": "15",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "documento": [
- "test prova"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": true,
- "timestamp_invio": 1687169681
- "prodotto": "raccomandata_smart",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "raccomandata_smartyvSPArFg2S7ccrrK99YIuyItJ.pdf",
- "pagine": 1,
- "size": 6840,
- "pricing": {
- "totale": {
- "importo_totale": 2.2
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.29,
- "importo_unitario_netto": 0.23,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "spedizione",
- "importo_unitario_totale": 1.91,
- "importo_unitario_netto": 1.91,
- "importo_unitario_iva": 0,
- "quantita": 1
- "confirmed_timestamp": "1687169682,",
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null
Ihr posta_massiva auflisten
Ihr posta_massiva auflisten
Authorizations:
Responses
Response Schema: application/json
Array of objects | |
message | string |
success | boolean |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/posta_massiva/"); 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
- "data": [
- {
- "creation_timestamp": 1657169682,
- "update_timestamp": 1676901090,
- "confirmed": false,
- "state": "SENT",
- "id": "xxxxxxxe557d71a5b600ee11d"
- {
- "creation_timestamp": 1657169682,
- "update_timestamp": 1676901090,
- "confirmed": false,
- "state": "NEW",
- "id": "xxxxxxxe557d71a5b600ee14d"
- {
- "creation_timestamp": 1657169682,
- "update_timestamp": 1676901090,
- "confirmed": false,
- "state": "NEW",
- "id": "xxxxxxxe557d71a5b6005e13d"
- "message": "3 Risultati",
- "success": true,
- "error": null
Senden Sie ein posta_massiva. Sie sollten Informat
Senden Sie ein posta_massiva. Sie sollten Informationen über den Absender und den/die Empfänger im Nachrichtentext angeben. Außerdem kann der Parameter "autoconfirm" auf false gesetzt werden, um ihn für eine spätere Bestätigung mit einer PATCH-Anfrage zu speichern, während Sie mit der Antwort eine eigene Logik erstellen.
Authorizations:
Request Body schema: application/json
object | |
object | |
Array of Recipient (object) or Casella postale (object) (Recipient or Casella postale) | |
Array of strings or string (documento) Das Dokument kann entweder ein String oder ein Array von Strings im Klartext sein.
Die maximale Größe eines PDF-Dokuments nach unserer Komprimierung beträgt 5 MB für alle Produkte außer Posta 4 PRO, Posta Massiva und Raccomandata Smart (diese 3 Produkte akzeptieren bis zu 15 MB). Die maximale Seitenzahl liegt derzeit bei 50 bzw. 100 bei Verwendung der Option "Fronteretro". |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | integer |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "Via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "Italia",
- "email": "[email protected]"
- "destinatari": [
- {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Morandi",
- "civico": "6",
- "comune": "Roma",
- "cap": "00101",
- "provincia": "RM",
- "nazione": "Italia"
- "documento": [
- "Example document"
- "opzioni": {
- "fronteretro": false,
- "colori": false,
- "autoconfirm": false
Response samples
- 201
- 421
- 422
- 500
- "data": [
- {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Dante Alighieri",
- "civico": "1",
- "comune": "Roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "Morandi",
- "civico": "6",
- "comune": "Roma",
- "cap": "00101",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "documento": [
- "Example document"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": false
- "prodotto": "posta_massiva",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": false,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf",
- "pagine": 1,
- "size": 6849,
- "pricing": {
- "totale": {
- "importo_totale": 0.74
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.29,
- "importo_unitario_netto": 0.23,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "Spedizione",
- "importo_unitario_totale": 0.45,
- "importo_unitario_netto": 0.45,
- "importo_unitario_iva": 0,
- "quantita": 1
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null
Callback payload samples
- "mittente": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string"
- "destinatari": {
- "nome": "string",
- "email": "string",
- "cognome": "string",
- "dug": "string",
- "indirizzo": "string",
- "civico": "string",
- "comune": "string",
- "cap": 0,
- "provincia": "string",
- "nazione": "string",
- "intestazione_completa": "string",
- "id": "string",
- "state": "string"
- "documento": [
- "string"
- "opzioni": {
- "fronteretro": true,
- "colori": true,
- "autoconfirm": true,
- "callback_url": "string",
- "timestamp_invio": 0
- "prodotto": "string",
- "creation_timestamp": 0,
- "update_timestamp": 0,
- "username": "string",
- "confirmed": true,
- "state": "string",
- "documento_validato": {
- "pdf": "string",
- "jpg": "string",
- "filename": "string",
- "pagine": 0,
- "size": 0
- "pricing": {
- "totale": {
- "importo_totale": 0
- "dettaglio": [
- {
- "codice_servizio": "string",
- "descrizione_servizio": "string",
- "importo_unitario_totale": 0,
- "importo_unitario_netto": 0,
- "importo_unitario_iva": 0,
- "quantita": 0
- "confirmed_timestamp": 0,
- "id": "string"
Ihre Einzelperson posta_massiva auflisten
Ihre Einzelperson posta_massiva auflisten
Authorizations:
path Parameters
id required | string |
query Parameters
state | string Example: state=NEW Wenn die Option gesetzt wurde, wird ein spezifisches Schema mit dem gleichen Status wie das angeforderte zurückgegeben. |
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.ufficiopostale.com/posta_massiva/%7Bid%7D?state=NEW"); 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
- 404
- "data": [
- {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "trastevere",
- "civico": "8",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "ener bettica",
- "civico": "7",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "documento": [
- "test prova"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": true,
- "timestamp_invio": 1687169681
- "prodotto": "posta_massiva",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": false,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf",
- "pagine": 1,
- "size": 6849,
- "pricing": {
- "totale": {
- "importo_totale": 0.74
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.29,
- "importo_unitario_netto": 0.23,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "Spedizione",
- "importo_unitario_totale": 0.45,
- "importo_unitario_netto": 0.45,
- "importo_unitario_iva": 0,
- "quantita": 1
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null
Bestätigen Sie den Versand einer E-Mail, die mit "
Bestätigen Sie den Versand einer E-Mail, die mit "autoconfirm = false" erstellt wurde.
Authorizations:
path Parameters
id required | string |
Request Body schema: application/json
confirmed | boolean |
Responses
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "confirmed": true
Response samples
- 202
- 406
- 421
- "data": [
- {
- "mittente": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "ener bettica",
- "civico": "7",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi"
- "destinatari": {
- "nome": "Mario",
- "cognome": "Rossi",
- "dug": "via",
- "indirizzo": "umbria",
- "civico": "10",
- "comune": "roma",
- "cap": "00100",
- "provincia": "RM",
- "nazione": "IT",
- "intestazione_completa": "Mario Rossi",
- "id": "xxxxxxxe557d71a5b600ee17d",
- "state": "NEW"
- "documento": [
- "test prova"
- "opzioni": {
- "fronteretro": false,
- "colori": true,
- "autoconfirm": true,
- "timestamp_invio": 1687169681
- "prodotto": "posta_massiva",
- "creation_timestamp": 1687169678,
- "update_timestamp": 1687169682,
- "confirmed": true,
- "state": "CONFIRMED",
- "documento_validato": {
- "filename": "posta_massivayvSPArFg2S7ccrrK99YIuyItJ.pdf",
- "pagine": 1,
- "size": 6840,
- "pricing": {
- "totale": {
- "importo_totale": 2.2
- "dettaglio": [
- {
- "codice_servizio": "STAMPA",
- "descrizione_servizio": "Costo Stampa",
- "importo_unitario_totale": 0.29,
- "importo_unitario_netto": 0.23,
- "importo_unitario_iva": 0.06,
- "quantita": 1
- {
- "codice_servizio": "spedizione",
- "descrizione_servizio": "spedizione",
- "importo_unitario_totale": 1.91,
- "importo_unitario_netto": 1.91,
- "importo_unitario_iva": 0,
- "quantita": 1
- "confirmed_timestamp": "1687169682,",
- "id": "xxxxxxxe557d71a5b600ee13d"
- "success": true,
- "message": "",
- "error": null