{"openapi":"3.0.1","info":{"title":"Ufficio Postale","version":"1.2.2","description":"Dieser Webdienst ermöglicht die Zustellung von Postprodukten wie Raccomandate, Telegrammi und Lettere über Poste Italiane <OL><LI>Erstellen Sie eine neue Sendung mit einer POST-Anfrage</LI><LI>Prüfen Sie die Preise und bestätigen Sie diese mit einem PATCH oder nutzen Sie <EM>die automatische Bestätigung: true</EM></LI><LI>Erhalten Sie Statusaktualisierungen zu Ihrer Sendung, indem Sie eine <EM>Callback-URL</EM> angeben</LI></OL> <BR> <STRONG>Hinweis: </STRONG> Es gibt einige Einschränkungen hinsichtlich der Größe eines PDF-Dokuments. Bitte lesen Sie das Feld „document“ in der Beschreibung des Endpunkts, den Sie verwenden möchten. <BR> <H2>Fehlerbehandlung</H2> Wenn ein Fehler beim Versand auftritt, enthält die Antwort eine **message** und ein **data.wrong_fields: []**: Jedes Element von **wrong_fields** ist eine Zeichenkette, die angibt, wo der Fehler entstanden ist. Dies erleichtert die Integration in Ihr Frontend-Formular erheblich, wo Sie die fehlerhaften Einträge hervorheben können<H2>Testen</H2>Bei Verwendung der sandbox-Umgebung erhalten Sie kurz nach dem Erstellen der Anfrage mit Platzhalterinhalten Update-Callbacks. Bei einigen Produkten ist es zudem möglich, die Ausführung des Callbacks in der sandbox-Umgebung zu erzwingen.","termsOfService":"https://openapi.it/en/terms-and-conditions","contact":{"url":"https://openapi.it/en/support","name":"Support"},"x-logo":{"url":"https://ws.ufficiopostale.com/img/logo.png"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"servers":[{"url":"https://ws.ufficiopostale.com","description":"Produktion"},{"url":"https://test.ws.ufficiopostale.com","description":"Sandbox"}],"paths":{"/telegrammi/{id}":{"get":{"tags":["Telegrammi"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}}],"summary":"Informationen zu einem Telegramm abrufen","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stati":{"$ref":"#/components/schemas/ExampleState"},"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"IdRicevuta":{"type":"string","description":"Beleg-ID","maxLength":50},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}}},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"mittente":{"type":"boolean","description":"Flag oder Objekt zur Kennzeichnung des Absenders"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":3010,"data":null}}}}}},"patch":{"summary":"Den Versand eines Telegramms bestätigen","description":"Bestätigung des Versands eines Telegramms, das mit „autoconfirm = false“ erstellt wurde","tags":["Telegrammi"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"examples":{"0":{"value":{"confirmed":true}}}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleResponseTelegram"},"example":{"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":"test@test.com"},"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,"ar_c":false,"ar_e":false,"ricevuta":false,"autoconfirm":false,"timestamp_invio":1687787732},"prodotto":"telegramma","creation_timestamp":1687787729,"update_timestamp":1687787742,"username":"prova-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/telegrammaUBLwd2TfrzVnSTMymTi5SnmAo.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/telegrammaUBLwd2TfrzVnSTMymTi5SnmAo.jpg","filename":"telegrammaUBLwd2TfrzVnSTMymTi5SnmAo.pdf","parole":25,"size":176},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"pricing":{"dettaglio":[{"codice_servizio":"parole","descrizione_servizio":"Tariffa postale parole","percentuale_iva":0,"quantita":25,"importo_unitario_netto":6.92,"importo_unitario_iva":0,"importo_unitario_totale":6.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}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Telegramma non specificato","error":3030,"data":null}}}}}}},"/telegrammi/{id}/accettazione":{"get":{"tags":["Telegrammi"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls diese bei der Einreichung angefordert wurde. \n – Die Annahme ist der Vorgang, durch den die Bestätigung des Eingangs eines Antrags durch das System bescheinigt wird. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft, und sofern diese korrekt sind, wird eine Empfangsbestätigung erstellt. Diese Quittung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Beginn der weiteren Bearbeitung markiert.\n\n Die Annahmebestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Telegramme-Empfangsbestätigung herunterladen","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/telegrammi/":{"get":{"summary":"Deine Telegramme auflisten","tags":["Telegrammi"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Telegrammi"],"description":"Senden Sie ein Telegramm. Im Textkörper der Nachricht sollten Sie Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um das Telegramm für eine spätere Bestätigung mittels einer PATCH-Anfrage zu speichern, während Sie mit der Antwort benutzerdefinierte Logik ausführen.\n\n\n\nDieser Endpunkt unterstützt nun das Versenden von Auslands-Telegrammen. Hier sind die wichtigsten Details:\n\n- **Unterstützung für Auslands-Telegramme**: Sie können nun Telegramme an internationale Ziele versenden.\n- **Einzelner Empfänger**: Auslands-Telegramme sind auf jeweils nur einen Empfänger beschränkt.\n- **Adressformat**: Bei Auslands-Telegrammen ist es entscheidend, die vollständige Adresse im Feld „indirizzo“ (Adresse) anzugeben, wie im Beispiel gezeigt.\n- **Einstellung für die Provinz**: Das Feld „province“ (Provinz) wird bei Auslandsadressen automatisch auf „EE“ (estero/Ausland) gesetzt.\n- **Preisinformationen**: Um die Tarife für Auslands-Telegramme zu überprüfen, können Sie den [/pricing/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_pricing_) verwenden.\n- **Verfügbare Optionen**: Alle für Auslandstelegramme spezifischen Optionen sind im Schema aufgeführt. Nicht aufgeführte zusätzliche Optionen werden ignoriert.\n- **Länderliste**: Eine Liste der Länder, in die Sie Auslands-Telegramme versenden können, finden Sie unter dem [/nazioni/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_nazioni_). \n\nDie vollständige Liste der Felder und Optionen, die sowohl für inländische als auch für ausländische Telegramme verfügbar sind, finden Sie im Schema.\n","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/telegramma_options"},{"$ref":"#/components/schemas/telegramma_foreign_options"}]},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"ragione_sociale":{"description":"Das Feld **ragione_sociale** kann verwendet werden, wenn Sie E-Mails im Namen eines Unternehmens versenden: Wenn dieses Feld ausgefüllt ist, stehen weder **nome** noch **cognome** zur Verfügung.","type":"string","maxLength":41},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":36},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico"],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"oneOf":[{"type":"object","title":"recipient","properties":{"titolo":{"type":"string","example":"Mr/Mrs","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41},"ragione_sociale":{"description":"Das Feld **ragione_sociale** kann verwendet werden, wenn Sie E-Mails im Namen eines Unternehmens versenden: Ist dieses Feld ausgefüllt, stehen weder **nome** noch **cognome** zur Verfügung.","type":"string","maxLength":41},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":36},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":40},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 40 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":41}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico"]},{"$ref":"#/components/schemas/telegramma_foreign_recipient_object"}]},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"$ref":"#/components/schemas/documentoTelegramma"}}},"examples":{"telegrammaItalia":{"summary":"Telegramm","value":{"mittente":{"ragione_sociale":"openapi spa","dug":"piazza","indirizzo":"cavur '","civico":"43","comune":"roma","cap":"00121","provincia":"rm","email":"prova.******@gmail.com","nazione":"IT"},"destinatari":[{"nome":"Giacomo","cognome":"Rossi","dug":"VIA","indirizzo":"PROVA","civico":"8","comune":"MIlano","cap":"20123","provincia":"MI","nazione":"IT","id":"664228bbbf*****01b0815f2","state":"NEW"}],"documento":["XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXXXX XX XXXXXXXX XXXXXXX XX 250.000 XXXX, XXXXXX XX XXXXXXX XX X. 3 XXXXXXX XXX XX XXXXXX XX 30000 XXXX. XX XXXXXXXX XXXXXXXX XXXXXXX XXXXXX XXXXX XX 30 XXXXXXXXX 2023, XXXXXXXXXX XX XXXXX XXXXXXXXXXXXXX XX XXXXX XX XXXXXXXXXXXXXX XXXXXX X XXXXXX XX XXXXXXXXX XXXXXX XX XXXX XXXXXXXXXXX. XX XXXXXXXXX XX XX XXXXXXXX XXXX XXXXXXXX XXXXXXXX; XX XXXX XXXXXXXXX, XX XXXXXXXXX XXXXX XXXXXXXXXXXX X XXXXXXXXXXXX XX XXXXXX XXXXXXXXXXXXX XXXXX XXXX XXXXXXXXX, XXXXXXXXXXXX XX XXXXXXXXXX XX XXXXXXXXXXXX XX XXXX XXXXX XXXXXX."],"opzioni":{"autoconfirm":false,"mittente":true,"ar_c":false,"ar_e":false},"callback":{"url":"https://your-server.site/123232","custom":123}}},"telegrammaEstero":{"summary":"Auslands-Telegramm","value":{"data":{"mittente":{"ragione_sociale":"openapi spa","dug":"viale","indirizzo":"cavur'","civico":"221","comune":"roma","cap":"00143","provincia":"rm","email":"prova.******@gmail.com","nazione":"IT"},"destinatari":[{"nome":"Tony","cognome":"Stark","indirizzo":"99 **** Avenue","comune":"Wycombe","cap":"NP131AA","provincia":"ee","nazione":"GB","state":"NEW","id":"664228bbbf1*****1b081123"}],"documento":["XX XXXXXX XXXXXXXXXXXXXXX XXXXX XXXXXXXX XXXXXXXXX XXXXXXXXX XXXXX XXXXXXXX XXX, XX XXXXXXXX XXXXX X XXX XXXXX XX XXXXXXX XXX 18 XXXXX 2023,XXXXXXX XX XXXXX XX XXXXXXX XXXXXXXX XX XXXXXXXX XXXXXXX XX 250.000 XXXX, XXXXXX XX XXXXXXX XX X. 3 XXXXXXX XXX XX XXXXXX XX 30000 XXXX. XX XXXXXXXX XXXXXXXX XXXXXXX XXXXXX XXXXX XX 30 XXXXXXXXX 2023, XXXXXXXXXX XX XXXXX XXXXXXXXXXXXXX XX XXXXX XX XXXXXXXXXXXXXX XXXXXX X XXXXXX XX XXXXXXXXX XXXXXX XX XXXX XXXXXXXXXXX. XX XXXXXXXXX XX XX XXXXXXXX XXXX XXXXXXXX XXXXXXXX; XX XXXX XXXXXXXXX, XX XXXXXXXXX XXXXX XXXXXXXXXXXX X XXXXXXXXXXXX XX XXXXXX XXXXXXXXXXXXX XXXXX XXXX XXXXXXXXX, XXXXXXXXXXXX XX XXXXXXXXXX XX XXXXXXXXXXXX XX XXXX XXXXX XXXXXX."],"opzioni":{"mittente":true,"ricevuta":true,"autoconfirm":true},"callback":{"url":"https://your-server.site/123232","custom":123}}}}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalServiceResponse"},"examples":{"0":{"value":{"data":{"mittente":{"ragione_sociale":"openapi spa","dug":"piazza","indirizzo":"cavur '","civico":"43","comune":"roma","cap":"00121","provincia":"rm","email":"prova.******@gmail.com","nazione":"IT","destinatari":[{"nome":"Giacomo","cognome":"Rossi","dug":"VIA","indirizzo":"PROVA","civico":"8","comune":"MIlano","cap":"20123","provincia":"MI","nazione":"IT","id":"664228bbbf1239901b0815f2","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,"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}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":3020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":{"wrong_fields":["mittente.nome","mittente.cognome","mittente.ragione_sociale"]}}}}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"example":{"success":false,"message":"Errore inizializzazione file temporaneo","error":13080,"data":null}}}}}}},"/pricing/":{"get":{"tags":["Ufficio Postale"],"summary":"Preise anzeigen","description":"Gibt eine Liste mit Preisen für verschiedene Arten von Dienstleistungen zurück","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"tipologia":{"type":"string"},"prodotto":{"type":"string"},"descrizione":{"type":"string"},"riferimento_prezzo":{"type":"string"},"accetta_allegati":{"type":"boolean"},"attivo":{"type":"boolean"},"tariffe":{"type":"array","items":{"type":"object","properties":{"iva_tariffa_postale":{"type":"number"},"iva_stampa_imbustamento":{"type":"number"},"tipologia":{"type":"string"},"da":{"type":"number"},"a":{"type":"number"},"tariffa_postale":{"type":"number"},"zona":{"oneOf":[{"type":"string"},{"type":"number"}]},"stampa":{"type":"number"},"imbustamento":{"type":"number"}}}},"options":{"type":"object","properties":{"<Option_Key>":{"type":"object","properties":{"nome_option":{"type":"string"},"nome_option_invio":{"type":"string"},"prezzo_option":{"type":"number"},"iva":{"type":"number"},"attivo":{"type":"boolean"},"valore_option":{"type":"string","description":"Der Wert der Option in der Eigenschaft <code>opzioni</code> eines Produkts (z. B.: <code>colori</code>, <code>fronteretro</code> usw.)"}}}}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"200":{"description":"OK","value":{"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}}}}}}}}},"/pricing/{service}":{"get":{"tags":["Ufficio Postale"],"summary":"Preise für eine bestimmte Dienstleistung abrufen","description":"Gibt Preisinformationen für den angegebenen Postdienst zurück.","parameters":[{"in":"path","name":"service","required":true,"schema":{"type":"string","enum":["atti_giudiziari","raccomandate","telegrammi","ordinarie","prioritarie","telegrammi_estero","raccomandate_estero","ordinarie_estero","prioritarie_estero","raccomandate_smart","posta_massiva","posta_massiva_top"]},"description":"Der jeweilige Postdienst, für den Sie Preisinformationen einholen möchten."}],"responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingResponseSchema"},"examples":{"TelegrammaEsteroPricing":{"value":{"data":{"tipologia":"telegramma","prodotto":"telegramma_estero","descrizione":"Telegramma_estero","riferimento_prezzo":"parole","accetta_allegati":1,"attivo":1,"tariffe":[{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"parole","zona":"A","tariffa_postale":0.32,"stampa":0.32,"imbustamento":0.12,"prezzo_fisso":7.23,"iva_prezzo_fisso":0},{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"parole","zona":"G","tariffa_postale":0.77,"stampa":0.32,"imbustamento":0.12}]},"success":true,"message":"","error":null}},"RaccomandataEsteroPricing":{"value":{"data":{"tipologia":"raccomandata","prodotto":"raccomandata_estero","descrizione":"Raccomandata_estero","riferimento_prezzo":"pagina","accetta_allegati":1,"attivo":1,"tariffe":[{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"pagine","da":1,"a":1,"tariffa_postale":7.57,"zona":1,"stampa":0.94,"imbustamento":0.12},{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"pagine","da":2,"a":2,"tariffa_postale":7.63,"zona":1,"stampa":0.95,"imbustamento":0.12},{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"pagine","da":3,"a":3,"tariffa_postale":7.69,"zona":1,"stampa":0.96,"imbustamento":0.12},{"iva_tariffa_postale":0,"iva_imbustamento":0,"iva_stampa_imbustamento":0,"tipologia":"pagine","da":4,"a":4,"tariffa_postale":7.75,"zona":1,"stampa":0.97,"imbustamento":0.12}]},"success":true,"message":"","error":null}}}}}}}}},"/nazioni/{service}":{"get":{"tags":["Ufficio Postale"],"summary":"Länderliste abrufen","description":"Gibt eine Liste der Länder zurück, in denen die jeweiligen Postdienste verfügbar sind. \nOptional können Sie nach Dienstart filtern, indem Sie einen Pfadparameter hinzufügen.\nVerfügbare Dienstarten sind: telegramma_estero, raccomandata_estero, ordinaria_estero, prioritaria_estero.\n\nBeispiel: /nazioni/telegramma_estero\n\nDadurch werden nur Länder zurückgegeben, in denen der angegebene Dienst verfügbar ist, einschließlich der Preiszone.\n\nInformationen zu den Zonen:\n- Für raccomandata_estero, ordinaria_estero und prioritaria_estero: Die Zonen reichen von 1 bis 3.\n- Für „telegramma_estero“: Die Zonen reichen von A bis H.\n\nDie Zone bestimmt die Preisstufe für jedes Land und jeden Dienst.\nDetaillierte Preisinformationen finden Sie unter dem Endpunkt /pricing/.\n","parameters":[{"in":"path","name":"service","required":true,"schema":{"type":"string","enum":["telegramma_estero","raccomandata_estero","ordinaria_estero","prioritaria_estero"]},"description":"Optional. Länder nach einem bestimmten Postdienst filtern."}],"responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CountriesServiceResponse"}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Weitere Informationen zur Antwort","maxLength":255},"error":{"type":"object","nullable":true,"description":"ERROR-Details (falls vorhanden)"}}},"examples":{"raccomandata_estero":{"summary":"Antwort zu „raccomandata_estero“","value":{"data":{"AL":{"nome":"Albania","name":"Albania","zona":1},"DZ":{"nome":"Algeria","name":"Algeria","zona":1},"AD":{"nome":"Andorra","name":"Andorra","zona":1},"AO":{"nome":"Angola","name":"Angola","zona":2}},"success":true,"message":"","error":null}},"telegramma_estero":{"summary":"Antwort auf „telegramma_estero“","value":{"data":{"AL":{"nome":"Albania","name":"Albania","zona":"C"},"DZ":{"nome":"Algeria","name":"Algeria","zona":"A"},"AD":{"nome":"Andorra","name":"Andorra","zona":"A"},"AO":{"nome":"Angola","name":"Angola","zona":"G"}},"success":true,"message":"","error":null}}}}}}}}},"/nazioni/":{"get":{"tags":["Ufficio Postale"],"summary":"Vollständige Länderliste abrufen","description":"Gibt eine Liste aller Länder mit den dort verfügbaren Postdiensten zurück.","responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountriesResponse"},"example":{"data":{"AL":{"nome":"Albania","name":"Albania","products":{"telegramma_estero":true,"raccomandata_estero":true,"ordinaria_estero":true,"prioritaria_estero":true}},"DZ":{"nome":"Algeria","name":"Algeria","products":{"telegramma_estero":true,"raccomandata_estero":true,"ordinaria_estero":true,"prioritaria_estero":true}},"IC":{"nome":"Isole Canarie","name":"Canary Islands","products":{"telegramma_estero":true}},"CC":{"nome":"Isole Cocos","name":"Cocos (Keeling) Islands","products":{"telegramma_estero":true}}},"success":true,"message":"","error":null}}}}}}},"/covers/":{"get":{"tags":["Ufficio Postale"],"summary":"Alle Abdeckungskonfigurationen anzeigen","description":"Ruft eine Liste aller erstellten Abdeckungskonfigurationen ab","responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"example":{"data":[{"header":"text header","mittente":"yourbase64","dettaglioMittente":"yourbase64","body":"yourbase64","footer":"text footer","dettaglioLettera":"text","creation_timestamp":1725895605,"update_timestamp":1725896412,"status":"READY","error":"","id":"66df13b5e19ee05eb800234a"},{"header":"yourbase64","mittente":"yourbase64","dettaglioMittente":"yourbase64","body":"yourbase64","footer":"base64","dettaglioLettera":"base64","creation_timestamp":1728658590,"update_timestamp":1728658590,"status":"ERROR CREATE","error":"\"Errore in creaCover: Code: a:InternalServiceFault, String: Error in deserializing body of request message for operation 'CreaCover'., Detail: The maximum string content length quota (8192) has been exceeded while reading XML data. This quota may be increased by changing the MaxStringContentLength property on the XmlDictionaryReaderQuotas object used when creating the XML reader. Line 1, position 2321.\",\n","last_callback_status\"":{"status_code":200,"responde_data":""},"callback":{"url":"https://your-server.site/123232","custom":123},"id":"67093c9e46d1398aa40c64a2"},{"header":"yourbase64","mittente":"yourbase64","dettaglioMittente":"yourbase64","body":"yourbase64","footer":"base64","dettaglioLettera":"base64","creation_timestamp":1728658590,"update_timestamp":1728658590,"status":"NEW","callback":{"url":"https://your-server.site/123232","custom":123},"id":"67093c9e46d1398aa40c64a2"}],"success":true,"message":"","error":null}}}}}},"post":{"tags":["Ufficio Postale"],"summary":"Ein neues Cover erstellen","description":"Erstellen Sie ein neues Deckblatt für Postdienste, darunter REGISTERED Mail, Priority Mail und Standardpost.\n\nSie können entweder einen benutzerdefinierten Text oder ein Bild einfügen; das Bild muss in einem unterstützten Format vorliegen (z. B. JPEG, PNG).\n\n\nDetails und Beispiele zu den einzelnen Feldern finden Sie im Schema.\n\n\n[Beispiel-Versandetikett als PDF](https://storage.googleapis.com/docs-openapi-it-bucket/copertina-def.pdf)\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverRequest"}}}},"responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverResponse"},"example":{"data":{"header":"yourbase64","mittente":"yourbase64","dettaglioMittente":"yourbase64","body":"yourbase64","footer":"base64","dettaglioLettera":"base64","creation_timestamp":1728658590,"update_timestamp":1728658590,"status":"NEW","callback":{"url":"https://your-server.site/123232","custom":123},"id":"67093c9e46d1398aa40c64a2"},"success":true,"message":"","error":null}}}},"400":{"description":"Erfolgreiche Antwort","content":{"application/json":{"example":{"success":false,"message":"Invalid fields detected: {*****}. Only the following fields are allowed: 'header', 'mittente', 'dettaglioMittente', 'body', 'footer', 'opzioni', 'dettaglioLettera'","error":1050,"data":null}}}}}}},"/covers/{id}":{"get":{"tags":["Ufficio Postale"],"summary":"Konfiguration des konkreten Versicherungsschutzes abrufen","description":"Ruft die Konfiguration eines bestimmten Covers anhand seiner ID ab. Optional kann die Vorschau heruntergeladen werden, wenn der Status „READY“ lautet.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Eindeutige Kennung des Deckblatts"}],"responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverDetailResponse"},"example":{"data":{"header":"yourbase64","mittente":"yourbase64","dettaglioMittente":"yourbase64","body":"yourbase64","footer":"base64","dettaglioLettera":"base64","creation_timestamp":1728658590,"update_timestamp":1728658590,"status":"NEW","callback":{"url":"https://your-server.site/123232","custom":123},"id":"67093c9e46d1398aa40c64a2"},"success":true,"message":"","error":null}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"No configuration found","error":1045,"data":null}}}}}}},"/covers/{id}/preview":{"get":{"tags":["Ufficio Postale"],"summary":"Konkrete Deckungsübersicht anzeigen","description":"Ruft die Konfiguration eines bestimmten Covers anhand seiner ID ab. Optional kann die Vorschau heruntergeladen werden, wenn der Status „READY“ lautet. Wenn der Status des Covers „READY“ lautet, wird anstelle der Konfiguration die Vorschau zum Herunterladen zurückgegeben.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"Eindeutige Kennung des Deckblatts"}],"responses":{"200":{"description":"Erfolgreiche Antwort","content":{"application/pdf":{"schema":{"type":"string","format":"binary","description":"PDF-Datei in der Vorschau anzeigen (nur wenn „preview=true“ und der Status „READY“ ist)"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"example":{"success":false,"message":"No configuration found","error":1045,"data":null}}}}}}},"/dug/":{"get":{"tags":["Ufficio Postale"],"summary":"Liste aller verfügbaren dugs","description":"(allgemeine städtebauliche Bezeichnungen)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"codice_dug":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"data":[{"codice_dug":"BGO","dug":"Borgo"}],"message":"1 Risultato","success":true,"error":null}}}}}}}}},"/posta_massiva_top/":{"get":{"tags":["Posta Massiva Top"],"summary":"Füge deinen „Posta Massiva Top“ zur Liste hinzu","description":"Füge deinen „Posta Massiva Top“ zur Liste hinzu","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassivaTop1"},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"SENT","id":"xxxxxxxe557d71a5b600ee11d"},{"mittente":{"nome":"Fabio","email":"fabio@openapi.com","cognome":"verdi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"NEW","id":"xxxxxxxe557d71a5b600ee14d"},{"mittente":{"nome":"Sara","email":"sara@openapi.com","cognome":"Rossi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"NEW","id":"xxxxxxxe557d71a5b6005e13d"}],"message":"3 Risultati","success":true,"error":null}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Posta Massiva Top"],"description":"Senden Sie einen „Posta Massiva Top“-Befehl. Im Textkörper der Nachricht sollten Sie Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die Bestätigung für eine spätere Bestätigung mittels einer PATCH-Anfrage aufzuheben, während Sie mit der Antwort eine benutzerdefinierte Logik ausführen.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"allOf":[{"$ref":"#/components/schemas/posta_massiva_top_options"}],"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"co":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia","email"],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"description":"Die Angabe des vollständigen Namens (Vorname, Nachname) oder des Firmennamens (Firmenbezeichnung) ist obligatorisch.","type":"object","title":"Recipient or Casella postale","oneOf":[{"type":"object","title":"Recipient","allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"required":["cap","comune","dug","indirizzo","nazione","civico","provincia"]}]},{"type":"object","title":"Casella postale","required":["casella_postale","ufficio_postale","comune","provincia","cap"],"allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"casella_postale":{"type":"string","description":"Die Nummer Ihres „Casella Postale“-Postfachs: <a href=\"https://www.poste.it/prodotti/caselle-postali.html\">https://www.poste.it/prodotti/caselle-postali.html</a>","maxLength":10},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"ufficio_postale":{"type":"string","description":"Die Poststelle, an die Ihre Post gesendet werden soll","maxLength":36},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5}}}]}]},"documento":{"$ref":"#/components/schemas/documento"},"callback":{"$ref":"#/components/schemas/callback"}}},"example":{"mittente":{"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","dug":"via","indirizzo":"Morandi","civico":"6","comune":"Roma","cap":"00101","provincia":"RM","nazione":"Italia"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"autoconfirm":false}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassivaTop2"},"example":{"data":[{"mittente":{"nome":"Mario","email":"john.doe@openapi.it","cognome":"Rossi","dug":"via","indirizzo":"Dante Alighieri","civico":"1","comune":"Roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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_top","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.jpg","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}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Oggetto Mittente assente","error":11010,"data":null}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Errore durante il calcolo del prezzo","error":16300,"data":null}}}}}}},"/posta_massiva_top/{id}":{"get":{"tags":["Posta Massiva Top"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}}],"summary":"Füge deinen „Posta Massiva Top“-Single hinzu","description":"Füge deinen „Posta Massiva Top“-Single hinzu","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ExempleResponseMassivaTop2"}]},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"trastevere","civico":"8","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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},"callback":{"url":"https://your-server.site/123232","custom":123},"prodotto":"posta_massiva_top","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.jpg","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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand bestätigen – Posta Massiva Top","tags":["Posta Massiva Top"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigung des Versands einer E-Mail, die mit „autoconfirm = false“ erstellt wurde","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"example":{"confirmed":true}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassivaTop2"},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"ener bettica","civico":"7","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"prodotto":"posta_massiva_top","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivayvSPArFg2S7ccrrK99YIuyItJ.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivayvSPArFg2S7ccrrK99YIuyItJ.jpg","filename":"posta_massivayvSPArFg2S7ccrrK99YIuyItJ.pdf","pagine":1,"size":6840,"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52050":{"value":{"success":false,"message":"Conferma non revocabile","error":52050,"data":null}},"52060":{"value":{"success":false,"message":"Elemento già confermato o non confermabile","error":52060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52030":{"value":{"success":false,"message":"Elemento non specificato","error":52030,"data":null}},"52040":{"value":{"success":false,"message":"Elemento errato","error":52040,"data":null}}}}}}}}},"/posta_massiva_top/{id}/accettazione":{"get":{"tags":["Posta Massiva Top"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls diese bei der Einreichung angefordert wurde. \n – Die Annahme ist der Vorgang, durch den die Bestätigung des Eingangs eines Antrags durch das System bescheinigt wird. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft, und sofern diese korrekt sind, wird eine Empfangsbestätigung erstellt. Diese Quittung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Beginn der weiteren Bearbeitung markiert.\n\n Die Annahmebestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Download der Einwilligungserklärung für Massenpost „Top“","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/posta_massiva/":{"get":{"tags":["Posta Massiva"],"summary":"Tragen Sie Ihre Posta Massiva ein","description":"Tragen Sie Ihre Posta Massiva ein","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassiva1"},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"SENT","id":"xxxxxxxe557d71a5b600ee11d"},{"mittente":{"nome":"Fabio","email":"fabio@openapi.com","cognome":"verdi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"NEW","id":"xxxxxxxe557d71a5b600ee14d"},{"mittente":{"nome":"Sara","email":"sara@openapi.com","cognome":"Rossi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"NEW","id":"xxxxxxxe557d71a5b6005e13d"}],"message":"3 Risultati","success":true,"error":null}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Posta Massiva"],"description":"Senden Sie eine „posta_massiva“. Im Textkörper der Nachricht sollten Sie Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die Bestätigung für eine spätere Bestätigung mittels einer PATCH-Anfrage aufzuheben, während Sie mit der Antwort eine benutzerdefinierte Logik ausführen.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"allOf":[{"$ref":"#/components/schemas/posta_p_options"}],"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"co":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia","email"],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"description":"Die Angabe des vollständigen Namens (Vorname, Nachname) oder des Firmennamens (Firmenbezeichnung) ist obligatorisch.","type":"object","title":"Recipient or Casella postale","oneOf":[{"type":"object","title":"Recipient","allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"provincia":{"type":"string","description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"required":["cap","comune","dug","indirizzo","nazione","civico","provincia"]}]},{"type":"object","title":"Casella postale","required":["casella_postale","ufficio_postale","comune","provincia","cap"],"allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"casella_postale":{"type":"string","description":"Die Nummer Ihres „Casella Postale“-Postfachs: <a href=\"https://www.poste.it/prodotti/caselle-postali.html\">https://www.poste.it/prodotti/caselle-postali.html</a>","maxLength":10},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"ufficio_postale":{"type":"string","description":"Die Poststelle, an die Ihre Post gesendet werden soll","maxLength":36},"provincia":{"type":"string","description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5}}}]}]},"documento":{"$ref":"#/components/schemas/documento"},"callback":{"$ref":"#/components/schemas/callback"}}},"example":{"mittente":{"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","dug":"via","indirizzo":"Morandi","civico":"6","comune":"Roma","cap":"00101","provincia":"RM","nazione":"Italia"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"autoconfirm":false}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassiva2"},"example":{"data":[{"mittente":{"nome":"Mario","email":"john.doe@openapi.it","cognome":"Rossi","dug":"via","indirizzo":"Dante Alighieri","civico":"1","comune":"Roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.jpg","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}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Oggetto Mittente assente","error":11010,"data":null}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Errore durante il calcolo del prezzo","error":16300,"data":null}}}}}}},"/posta_massiva/{id}":{"get":{"tags":["Posta Massiva"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}}],"summary":"Stellen Sie Ihre einzelne Posta Massiva ein","description":"Stellen Sie Ihre einzelne Posta Massiva ein","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ExempleResponseMassiva2"}]},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"trastevere","civico":"8","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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},"callback":{"url":"https://your-server.site/123232","custom":123},"prodotto":"posta_massiva","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivaCw4wGmsHe9ddsD2RAB2ZyMdUm.jpg","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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand von Posta Massiva bestätigen","tags":["Posta Massiva"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigung des Versands einer E-Mail, die mit „autoconfirm = false“ erstellt wurde","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"example":{"confirmed":true}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseMassiva2"},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"ener bettica","civico":"7","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"prodotto":"posta_massiva","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/posta_massivayvSPArFg2S7ccrrK99YIuyItJ.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/posta_massivayvSPArFg2S7ccrrK99YIuyItJ.jpg","filename":"posta_massivayvSPArFg2S7ccrrK99YIuyItJ.pdf","pagine":1,"size":6840,"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52050":{"value":{"success":false,"message":"Conferma non revocabile","error":52050,"data":null}},"52060":{"value":{"success":false,"message":"Elemento già confermato o non confermabile","error":52060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52030":{"value":{"success":false,"message":"Elemento non specificato","error":52030,"data":null}},"52040":{"value":{"success":false,"message":"Elemento errato","error":52040,"data":null}}}}}}}}},"/posta_massiva/{id}/accettazione":{"get":{"tags":["Posta Massiva"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls dies bei der Einreichung verlangt wird. \n – Die Annahme ist der Vorgang, durch den die Bestätigung des Eingangs eines Antrags durch das System bescheinigt wird. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft, und sofern diese korrekt sind, wird eine Empfangsbestätigung erstellt. Diese Quittung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\n Die Annahmebestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Download der Einwilligungserklärung für Massenpost","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/raccomandate_smart/":{"get":{"tags":["Raccomandata Smart"],"summary":"Führen Sie Ihre „raccomandate_smart“ auf","description":"Führen Sie Ihre „raccomandate_smart“ auf","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[{"mittente":{"ragione_sociale":"openapi srl","nome":"Mario","email":"mario@openapi.com","cognome":"Rossi"},"creation_timestamp":1657169682,"update_timestamp":1676901090,"confirmed":false,"state":"SENT","id":"xxxxxxxe557d71a5b600ee11d"}],"message":"1 Risultati","success":true,"error":null}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Raccomandata Smart"],"description":"Senden Sie eine „Raccomandata Smart“. Geben Sie im Hauptteil der Nachricht die Daten des Absenders und des/der Empfänger(s) an. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die Bestätigung für eine spätere Bestätigung per PATCH-Anfrage aufzuheben, während Sie mit der Antwort eine benutzerdefinierte Logik ausführen.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"allOf":[{"$ref":"#/components/schemas/raccomandata_s_options"}],"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"co":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia","email"],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"description":"Die Angabe des vollständigen Namens (Vorname, Nachname) oder des Firmennamens (Firmenbezeichnung) ist obligatorisch.","type":"object","title":"Recipient or Casella postale","oneOf":[{"type":"object","title":"Recipient","allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"required":["cap","comune","dug","indirizzo","nazione","civico","provincia"]}]},{"type":"object","title":"Casella postale","required":["casella_postale","ufficio_postale","comune","provincia","cap"],"allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"casella_postale":{"type":"string","description":"Die Nummer Ihres „Casella Postale“-Postfachs: <a href=\"https://www.poste.it/prodotti/caselle-postali.html\">https://www.poste.it/prodotti/caselle-postali.html</a>","maxLength":10},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"ufficio_postale":{"type":"string","description":"Die Poststelle, an die Ihre Post gesendet werden soll","maxLength":36},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5}}}]}]},"documento":{"$ref":"#/components/schemas/documento"},"callback":{"$ref":"#/components/schemas/callback"}}},"example":{"mittente":{"ragione_sociale":"Openapi SRL","civico":"221","comune":"roma","dug":"via","indirizzo":"Filippo tommaso marinetti","cap":"00143","provincia":"RM","nazione":"IT","email":"l.paderi@openapi.it"},"destinatari":[{"nome":"Mario","cognome":"Rossi","dug":"via","indirizzo":"Dante Alighieri","civico":"6","comune":"Roma","cap":"00143","provincia":"RM","nazione":"Italia"}],"documento":["https://www.soundczech.cz/temp/lorem-ipsum.pdf"],"opzioni":{"fronteretro":false,"colori":false,"ar":true,"autoconfirm":false},"callback":{"url":"https://your-server.site/123232","custom":123}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseSmart"},"example":{"data":[{"mittente":{"ragione_sociale":"Openapi SRL","civico":"221","comune":"roma","dug":"via","indirizzo":"Filippo tommaso marinetti","cap":"00143","provincia":"RM","nazione":"IT","email":"l.paderi@openapi.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"},"documento":["https://www.soundczech.cz/temp/lorem-ipsum.pdf"],"opzioni":{"fronteretro":false,"colori":false,"ar":true,"autoconfirm":false},"callback":{"url":"https://your-server.site/123232","custom":123},"prodotto":"raccomandata_smart","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"NEW","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.jpg","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}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"examples":{"11010":{"value":{"success":false,"message":"Oggetto Mittente assente","error":11010,"data":null}},"11015":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale'","error":11015,"data":null}},"11020":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":null}},"11030":{"value":{"success":false,"message":"Dati obbligatori 'nome' e 'cognome' con 'titolo' specificato","error":11030,"data":null}}}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"example":{"success":false,"message":"Errore durante il calcolo del prezzo","error":16300,"data":null}}}}}}},"/raccomandate_smart/{id}":{"get":{"tags":["Raccomandata Smart"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}}],"summary":"Führen Sie Ihr „Raccomandata Smart“-Einzelprodukt auf","description":"Führen Sie Ihr „Raccomandata Smart“ auf","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"allOf":[{"properties":{"stati":{"$ref":"#/components/schemas/ExampleState"}}},{"$ref":"#/components/schemas/ExempleResponseSmart"}]},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"ener bettica","civico":"14","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"prodotto":"raccomandata_smart","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":false,"state":"NEW","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/raccomandata_smartu6pccgbnFNeRA69t7hvPDOKMa.jpg","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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand von „Raccomandata Smart“ bestätigen","tags":["Raccomandata Smart"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigung des Versands einer E-Mail, die mit „autoconfirm = false“ erstellt wurde","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"example":{"confirmed":true}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExempleResponseSmart"},"example":{"data":[{"mittente":{"nome":"Mario","email":"mario@openapi.com","cognome":"Rossi","dug":"via","indirizzo":"romagna","civico":"12","comune":"roma","cap":"00100","provincia":"RM","nazione":"IT","intestazione_completa":"Mario Rossi"},"destinatari":{"nome":"Mario","email":"mario@openapi.com","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"],"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"opzioni":{"fronteretro":false,"colori":true,"autoconfirm":true,"timestamp_invio":1687169681},"prodotto":"raccomandata_smart","creation_timestamp":1687169678,"update_timestamp":1687169682,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/raccomandata_smartyvSPArFg2S7ccrrK99YIuyItJ.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/raccomandata_smartyvSPArFg2S7ccrrK99YIuyItJ.jpg","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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52050":{"value":{"success":false,"message":"Conferma non revocabile","error":52050,"data":null}},"52060":{"value":{"success":false,"message":"Raccomandata smart già confermata o non confermabile","error":52060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"52030":{"value":{"success":false,"message":"Raccomandata smart non specificata","error":52030,"data":null}},"52040":{"value":{"success":false,"message":"Raccomandata smart errata","error":52040,"data":null}}}}}}}}},"/raccomandate_smart/{id}/accettazione":{"get":{"tags":["Raccomandata Smart"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls diese bei der Einreichung angefordert wurde. \n – Die Annahme ist der Vorgang, durch den die Bestätigung des Eingangs eines Antrags durch das System bescheinigt wird. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft, und sofern diese korrekt sind, wird eine Empfangsbestätigung erstellt. Diese Quittung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\n Die Annahmebestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Download der Empfangsbestätigung per Einschreiben (Smart)","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/raccomandate/":{"get":{"summary":"Listen Sie Ihre „Raccomandate“ auf","tags":["Raccomandate"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"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}}}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Raccomandate"],"description":"Senden Sie eine Raccomandata. Sie sollten im Hauptteil der Nachricht Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die Raccomandata für eine spätere Bestätigung mittels einer PATCH-Anfrage zu speichern, während Sie mit der Antwort benutzerdefinierte Logik ausführen.  Überprüfen Sie das Feld „NumeroRaccomandata“ im Empfängerobjekt, wenn Sie die Sendungsverfolgungsnummer benötigen.\n\n\n\nDieser Endpunkt unterstützt nun den Versand internationaler REGISTERED-Einschreiben. Hier sind die wichtigsten Details:\n\n- **Unterstützung für internationale REGISTERED-Einschreiben**: Sie können nun Einschreiben an internationale Ziele versenden.\n- **Mehrere Empfänger**: Ausländische „Raccomandata“-Sendungen sind auf jeweils nur einen Empfänger beschränkt.\n- **Adressformat**: Stellen Sie bei internationalem REGISTERED-Einschreiben sicher, dass Sie die vollständige Adresse in den entsprechenden Feldern angeben, wie im Beispiel gezeigt.\n- **Einstellung für die Provinz**: Bei internationalen Adressen sollte das Feld „province“ (Provinz) leer gelassen oder entsprechend dem Format des Ziellandes ausgefüllt werden.\n- **Preisinformationen**: Um die Tarife für internationale REGISTERED Einschreiben zu überprüfen, können Sie den [/pricing/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_pricing_) verwenden.\n- **Verfügbare Optionen**: Alle für REGISTERED Einschreiben spezifischen Optionen sind im Schema aufgeführt. Nicht aufgeführte zusätzliche Optionen werden ignoriert.\n- **Länderliste**: Eine Liste der Länder, in die Sie REGISTERED Einschreiben versenden können, finden Sie unter dem [/nazioni/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_nazioni_). Dieser Endpunkt liefert sowohl Preisinformationen als auch die Liste der für internationale Dienste verfügbaren Länder.\n\n\nDie vollständige Liste der Felder und Optionen für inländische und internationale REGISTERED Einschreiben finden Sie im Schema.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/raccomandata_options"},{"$ref":"#/components/schemas/ForeignRaccomandataOption"}]},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"$ref":"#/components/schemas/common_sender_object"},"destinatari":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/recipient_object_with_casl_postale"},{"$ref":"#/components/schemas/ForeignRecipient"}]},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"$ref":"#/components/schemas/documento"}}},"examples":{"raccomandata":{"value":{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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":"IT"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"ar":true,"autoconfirm":true}}},"Foreign  raccomandata":{"value":{"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","indirizzo":"78 **** Avenue","civico":"6","comune":"WYCOMBE","cap":"HP136HN","provincia":"EE","nazione":"GB","email":"john.doe@openapi.it"}],"documento":["Example document"],"opzioni":{"colori":true,"autoconfirm":true}}}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalServiceResponse"},"examples":{"0":{"value":{"data":[{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":{"wrong_fields":["mittente.nome","mittente.cognome","mittente.ragione_sociale"]}}}}}}},"500":{"description":"Interner Serverfehler","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"example":{"success":false,"message":"Errore inizializzazione file temporaneo","error":13080,"data":null}}}}}}},"/atti_giudiziari/{id}/destinatari/{IdDestinatario}/archiviazione":{"get":{"tags":["Atti Giudiziari"],"description":"Laden Sie das Archivdokument herunter, sobald es bereitsteht. Den Status können Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#scope=GET:ws.ufficiopostale.com/atti_giudiziari/{id}) einsehen. Die Dokumente werden vom zuständigen Vertreter von Poste Italiane digital signiert, mit einem Zeitstempel versehen und in einem speziellen Dokumentenmanagementsystem gespeichert.\n\n**Hinweis:** Der Kunde erklärt die Einhaltung der Bestimmungen des **Gesetzes Nr. 53 vom 21. Januar 1994**, insbesondere hinsichtlich der Verwaltung und Aufbewahrung digital archivierter Dokumente. Im Einzelnen:\n\n- Der Kunde ist dafür verantwortlich, das digitale Archiv des Dokuments innerhalb von **2 Monaten** nach dessen Verfügbarkeit herunterzuladen.\n- Der Kunde übernimmt die volle Verantwortung für die Aufbewahrung dieser Kopie, da sie nach Ablauf der angegebenen Frist nicht mehr in unseren Archiven gespeichert wird.\n- Wird das Dokument nicht heruntergeladen oder ordnungsgemäß aufbewahrt, geht die archivierte Version verloren, und eine Wiederherstellung aus unseren Systemen ist nicht mehr möglich.\n\n \n","summary":"Download: Archivierung von Gerichtsakten","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}},{"name":"IdDestinatario","description":"Die „destinatari.id“ können Sie [hier](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Atti Giudiziari/get_raccomandate__id_) einsehen.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"path non valido ES: {id}/destinatari/{idDestinatario}/archiviazione","error":2013,"data":null}}}}}}},"/atti_giudiziari/{id}/destinatari/{IdDestinatario}/ardigitale":{"get":{"tags":["Atti Giudiziari"],"summary":"Digitale Empfangsbestätigung herunterladen (AR Digitale)","description":"Lädt die Empfangsbestätigung (Avviso di Ricevimento – AR) in digitaler Form für einen bestimmten Empfänger eines gerichtlichen Schriftstücks (Atto Giudiziario) herunter.\n\nDie digitale Empfangsbestätigung (Avviso di Ricevimento Digitale – AR Digitale) ist ein rechtsgültiges elektronisches Dokument, das die Zustellung des Schriftstücks bestätigt. Sie wird nur erstellt, wenn bei der Übermittlung die Option für die digitale Empfangsbestätigung aktiviert wurde. Das zurückgesendete Dokument ist digital signiert und mit einem Zeitstempel versehen.\n","parameters":[{"name":"id","in":"path","required":true,"description":"ID des Antrags auf Erlass einer gerichtlichen Verfügung (Atto Giudiziario).","schema":{"type":"string"}},{"name":"IdDestinatario","in":"path","required":true,"description":"ID des Empfängers, für den die digitale Empfangsbestätigung (AR Digitale) angefordert wird. Diese ist im `destinatari`-Objekt der Antwort auf den Aufruf `GET /atti_giudiziari/{id}` zu finden.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Die PDF-Datei der digitalen Empfangsbestätigung.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden. Die digitale Empfangsbestätigung (AR Digitale) ist nicht verfügbar oder die Ressource wurde nicht gefunden.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","nullable":true},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Digital Return Receipt not found or not yet available.","error":2017,"data":null}}}}}}},"/atti_giudiziari/{id}/accettazione":{"get":{"tags":["Atti Giudiziari"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls dies bei der Einreichung verlangt wird. \n  – Die Annahme ist der Vorgang, der die Bestätigung eines Antrags durch das System bescheinigt. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft; sind diese korrekt, wird eine Empfangsbestätigung erstellt. Diese Empfangsbestätigung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\n  Die Empfangsbestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n  - Angaben zur angeforderten Dienstleistung, zum Absender und zum Empfänger.\n  - Eine digitale Signatur und einen Zeitstempel, die die Rechtsgültigkeit gewährleisten.\n \nDie Annahme ist ein grundlegender Schritt, um Rückverfolgbarkeit, Transparenz und die Einhaltung gesetzlicher Vorschriften für die erbrachten Dienstleistungen zu gewährleisten.\n","summary":"Download: Annahme von gerichtlichen Schriftstücken","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/atti_giudiziari/{id}":{"get":{"tags":["Atti Giudiziari"],"description":"Überprüfen Sie das Feld <code>NumeroRaccomandata</code> im Empfängerobjekt, wenn Sie die Sendungsverfolgungsnummer benötigen.","summary":"Informationen zu einem „Atto Giudiziaro“ abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}},{"name":"callback","in":"query","required":false,"description":"Simuliert den Fortschritt des Versandstatus: <B>Jedes Mal, wenn dieser Endpunkt aufgerufen wird, wechselt Ihre Anfrage zum nächsten Versandstatus</B>.<BR>Sofern in der Anfrage angegeben, erhalten Sie Aktualisierungen per Callback.<BR>Bitte beachten Sie, dass diese Option <B>NUR für die sandbox-Umgebung</B> verfügbar ist.","schema":{"type":"string","example":"<empty string>"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stati":{"$ref":"#/components/schemas/ExampleState"},"mittente":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"IdRicevuta":{"type":"string","description":"Beleg-ID","maxLength":50},"NumeroRaccomandata":{"type":"string"},"tracking":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer"},"descrizione":{"type":"string","description":"Mögliche Werte:\n- Zugestellt\n- Nicht zustellbar\n- Im Lager\n- Nicht zugestellt\n- An Lager gesendet\n- Angenommen\n- Vernichtet wegen Manipulation/verdächtiger Ware\n- Nichtzustellung aufgrund höherer Gewalt\n- Angenommen (CAD)\n- Angenommen (CAN)\n- Online angenommen\n- Versand gedruckt\n"},"type":{"type":"string","description":"Mögliche Codes:\n- 01: Zugestellt\n- 03: Nicht zustellbar\n- 04: Im Lager\n- 05: Nicht abgeholt\n- 06: Ins Lager geschickt\n- 81: Angenommen\n- 88: Vernichtet wegen Manipulation/verdächtiger Ware\n- 91: Nichtzustellung aufgrund höherer Gewalt\n- 93: Angenommen (CAD)\n- 93: Angenommen (CAN)\n- 100: Online angenommen\n- 110: Versand ausgedruckt\n"},"definitivo":{"type":"boolean","description":"Gibt an, ob der Status endgültig ist."}}}},"archiviazione":{"description":"Der Status des Dateispeichervorgangs. Mögliche Werte sind „WAITING“ oder „DONE“. Wenn der Status „DONE“ lautet, kann die archivierte Datei kostenlos über den Endpunkt heruntergeladen werden. Zum Herunterladen klicken Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#/Raccomandate/get_atti_giudiziari__id__destinatari__IdDestinatario__archiviazione)","type":"string","enum":["WAITING","DONE"]}}},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"ar":{"type":"boolean"},"ricevuta":{"type":"boolean"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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","archiviazione":"WAITING"}],"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":"atto_giudiziaro","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":"RicevutaRitorno","descrizione_servizio":"Ricevuta Ritorno","percentuale_iva":0,"quantita":1,"importo_unitario_totale":0.8,"importo_unitario_netto":0.8,"importo_unitario_iva":0},{"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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand bestätigen – Gerichtsvollzieher","tags":["Atti Giudiziari"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigen Sie den Versand eines „atto_giudiziaro“, das mit „autoconfirm = false“ erstellt wurde.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"examples":{"0":{"value":{"confirmed":true}}}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleResponseRaccomandate"},"example":{"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":"test@test.com"},"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":true,"ricevuta":false,"autoconfirm":false,"timestamp_invio":1687787732},"prodotto":"atto_giudiziaro","creation_timestamp":1687787729,"update_timestamp":1687787742,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/atto_giudiziaroUBLwd2TfrzVnSTMymTi5SnmAo.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/atto_giudiziaroUBLwd2TfrzVnSTMymTi5SnmAo.jpg","filename":"atto_giudiziaroUBLwd2TfrzVnSTMymTi5SnmAo.pdf","pagine":1,"size":6308},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"pricing":{"dettaglio":[{"codice_servizio":"RicevutaRitorno","descrizione_servizio":"Ricevuta Ritorno","percentuale_iva":0,"quantita":1,"importo_unitario_totale":0.8,"importo_unitario_netto":0.8,"importo_unitario_iva":0},{"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"0":{"value":{"success":false,"message":"Atto giudiziario già confermato o non confermabile","error":2060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}}}}},"/atti_giudiziari/":{"get":{"summary":"Listen Sie Ihre Gerichtsvollzieher auf","tags":["Atti Giudiziari"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"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}}}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Atti Giudiziari"],"description":"Ein „Atto Giudiziario“ ist ein Rechtsdokument, das zur formellen Zustellung gerichtlicher Schriftstücke wie Vorladungen, Zahlungsaufforderungen oder Gerichtsurteile dient. Nach italienischem Recht müssen diese Dokumente über einen speziellen REGISTERED-Einschreibedienst versandt werden, der Folgendes gewährleistet:\n\n - Nachverfolgbarkeit der Zustellung.\n  -  die Ausstellung einer Empfangsbestätigung (Avviso di Ricevimento, AR).\n - Die gesetzlich vorgeschriebene Rechtswirksamkeit der Zustellung.\n - Der Versand eines „Atto Giudiziario“ über eine API ermöglicht es Unternehmen, den Prozess des Versands, der Bestätigung und der Nachverfolgung zu automatisieren und zentral zu verwalten, wobei die Vorschriften bezüglich gerichtlicher Zustellungen eingehalten werden.\n\n\nVersenden Sie einen „Atto Giudiziario“ unter Einhaltung der folgenden Anforderungen:\n\n - Die Zustellung ist auf das Staatsgebiet beschränkt, bei einem Höchstgewicht von 2 kg.\n - Sendungen ins Ausland, einschließlich Vatikanstadt und San Marino, sind nicht zulässig.\n - Sendungen können nicht an Postfächer adressiert werden.\n - Die Zustellung erfolgt innerhalb von 5 Werktagen, zuzüglich weiterer 2 Tage für den Druck.\n - Für alle Sendungen innerhalb des Staatsgebiets gilt ein einheitlicher Inlandstarif, unabhängig vom logistischen Bestimmungsort.\n - Der Empfänger der Rückscheinbestätigung (23L) muss denselben Namen wie der Absender tragen.\n - Die Option „AR“ ist obligatorisch und kann auf „true“ gesetzt werden, oder es kann ein Objekt mit den Angaben des AR-Empfängers bereitgestellt werden.\n   - WICHTIG: Der Name des Empfängers muss mit dem Absender des „Atto Giudiziario“ übereinstimmen.\n - Der Parameter „autoconfirm“ kann auf `false` gesetzt werden, um die Raccomandata für eine spätere Bestätigung über eine PATCH-Anfrage zu speichern, was eine benutzerdefinierte Verarbeitung der Antwort ermöglicht.\n\n  Überprüfen Sie das Feld „NumeroRaccomandata“ im Empfängerobjekt, wenn Sie die Sendungsverfolgungsnummer benötigen.\n\n\n**Hinweis:** Der Kunde erklärt die Einhaltung der Bestimmungen des **Gesetzes Nr. 53 vom 21. Januar 1994**, insbesondere hinsichtlich der Verwaltung und Aufbewahrung digital archivierter Dokumente. Im Einzelnen:\n\n- Der Kunde ist dafür verantwortlich, das digitale Archiv des Dokuments innerhalb von **2 Monaten** nach dessen Verfügbarkeit herunterzuladen.\n- Der Kunde übernimmt die volle Verantwortung für die Aufbewahrung dieser Kopie, da sie nach Ablauf der angegebenen Frist nicht mehr in unseren Archiven gespeichert wird.\n- Wird das Dokument nicht heruntergeladen oder ordnungsgemäß aufbewahrt, geht die archivierte Version verloren, und eine Wiederherstellung aus unseren Systemen ist nicht mehr möglich.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"$ref":"#/components/schemas/atti_giudiziari_options"},"mittente":{"$ref":"#/components/schemas/atti_giudiziari_sender_object"},"destinatari":{"$ref":"#/components/schemas/atti_giudiziari_recipient_object"},"documento":{"$ref":"#/components/schemas/documento"},"callback":{"$ref":"#/components/schemas/callback"}}},"example":{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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":"IT"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"ar":true,"autoconfirm":true,"atti_giudiziari":{"centro_costo_cliente":"ABC123","note":"Consegnare entro 72h","notificante":{"tipologia":"UfficialeGiudiziario","valore":"prova"},"numero_cronologico":"2023001","oggetto":"Diffida art. 123","partner_tecnologico":"TechPartner Srl","tipo_lingua":"IT"}}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalServiceResponse"},"examples":{"0":{"value":{"data":[{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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":"atto_giudiziario","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}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":{"wrong_fields":["mittente.nome","mittente.cognome","mittente.ragione_sociale"]}}}}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"example":{"success":false,"message":"Errore inizializzazione file temporaneo","error":13080,"data":null}}}}}}},"/ordinarie/":{"get":{"summary":"Führen Sie Ihre Wünsche auf","tags":["Posta Ordinaria"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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}}}}}},"post":{"summary":"Erstellen Sie Ihre Anfrage","tags":["Posta Ordinaria"],"description":"Senden Sie eine Standard-E-Mail. Im E-Mail-Text sollten Sie Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die E-Mail für eine spätere Bestätigung per PATCH-Anfrage zu speichern, während Sie mit der Antwort benutzerdefinierte Logik ausführen.\n\nDieser Endpunkt unterstützt nun den Versand von Ordinaria ins Ausland. Hier sind die wichtigsten Details:\n\n- **Unterstützung für Ordinaria ins Ausland**: Sie können Ordinaria nun an internationale Ziele versenden.\n- **Einzelner Empfänger**: Ordinaria ins Ausland sind auf jeweils nur einen Empfänger beschränkt.\n- **Adressformat**: Bei Ordinaria ins Ausland ist es entscheidend, die vollständige Adresse im Feld „indirizzo“ (Adresse) anzugeben, wie im Beispiel gezeigt.\n- **Einstellung für die Province**: Das Feld „province“ (Provinz) wird bei Adressen im Ausland automatisch auf „EE“ (estero/Ausland) gesetzt.\n- **Preisinformationen**: Um die Tarife für Ordinaria-Sendungen ins Ausland zu überprüfen, können Sie den [/pricing/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_pricing_) verwenden.\n- **Verfügbare Optionen**: Alle für internationale Ordinaria spezifischen Optionen sind im Schema aufgeführt. Nicht aufgeführte zusätzliche Optionen werden ignoriert.\n- **Länderliste**: Eine Liste der Länder, in die Sie „Ordinaria“ ins Ausland versenden können, finden Sie unter dem [/nazioni/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_nazioni_). \n\nDie vollständige Liste der Felder und Optionen, die sowohl für inländische als auch für ausländische Standardpost verfügbar sind, finden Sie im Schema.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/posta_options"},{"$ref":"#/components/schemas/ForeignPostaOption"}]},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"allOf":[{"$ref":"#/components/schemas/common_sender_object"}],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/recipient_object_with_casl_postale"},{"$ref":"#/components/schemas/ForeignRecipient"}]},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"$ref":"#/components/schemas/documento"}}},"examples":{"Ordinaria":{"value":{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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,"autoconfirm":true}}},"Foreign Ordinaria":{"value":{"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","indirizzo":"37 STREET Avenue","comune":"LONDRA","cap":"00101","provincia":"EE","nazione":"GB","id":"6103f711dd2507415c5db6ce","state":"NEW"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"autoconfirm":true}}}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalServiceResponse"},"examples":{"posta ordinaria":{"value":{"data":[{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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","dettaglio_immobile":"scala B","civico":"1","comune":"Roma","cap":"00100","provincia":"RM","nazione":"IT","email":"john.doe@openapi.it"},"autoconfirm":true,"timestamp_invio":1627649810},"prodotto":"ordinaria","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":"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}},"Foreign ordinaria":{"value":{"data":[{"opzioni":{"colori":false,"autoconfirm":true,"fronteretro":false,"timestamp_invio":1724754216},"mittente":{"cap":"10024","comune":"moncalieri","dug":"via","indirizzo":"cavour","nazione":"IT","ragione_sociale":"Stefano Giacone","civico":"22","provincia":"TO","email":"stefano.giacone@gmail.com"},"destinatari":[{"nome":"Luca","cognome":"Scuriatti","indirizzo":"37 Rectory Avenue","comune":"High Wycombe","cap":"HP136HN","provincia":"ee","nazione":"GB","id":"66cda9255673a1b85f092f02","state":"NEW"}],"documento":["https://app.italianelite.eu/clicksend/EExtreme_recensione_con_omaggio.pdf"],"prodotto":"ordinaria_estero","creation_timestamp":1724754213,"update_timestamp":1724754216,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://alpha.ws.ufficiopostale.com/Up/pdf/ordinaria7QTR9pH7aj8tFbIdIa516jSxd.pdf","jpg":"https://alpha.ws.ufficiopostale.com/Up/jpg/ordinaria7QTR9pH7aj8tFbIdIa516jSxd.jpg","filename":"ordinaria7QTR9pH7aj8tFbIdIa516jSxd.pdf","pagine":1,"size":157746},"pricing":{"dettaglio":[{"codice_servizio":"pagine","descrizione_servizio":"Tariffa postale pagine","percentuale_iva":0,"quantita":1,"zona":1,"importo_unitario_netto":7.57,"importo_unitario_iva":0,"importo_unitario_totale":7.57},{"codice_servizio":"STAMPA","descrizione_servizio":"Costo Stampa","zona":1,"quantita":1,"importo_unitario_netto":0.94,"percentuale_iva":0,"importo_unitario_iva":0,"importo_unitario_totale":0.94},{"codice_servizio":"IMBUST","descrizione_servizio":"Imbustamento","zona":1,"quantita":1,"importo_unitario_netto":0.12,"percentuale_iva":0,"importo_unitario_iva":0,"importo_unitario_totale":0.12}],"totale":{"importo_totale_netto":8.629999999999999,"importo_totale_iva":0,"importo_totale":8.629999999999999}},"confirmed_timestamp":1724754216,"id":"66cda9285673a1b85f092f03"}],"success":true,"message":"","error":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":{"wrong_fields":["mittente.nome","mittente.cognome","mittente.ragione_sociale"]}}}}}}},"500":{"description":"Interner Server-ERROR","content":{"application/json":{"schema":{"type":"object","properties":{"trace":{"type":"string"},"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"execution_time":{"type":"number"}}},"example":{"success":false,"message":"Errore inizializzazione file temporaneo","error":13080,"data":null}}}}}}},"/ordinarie/{id}/destinatari/{IdDestinatario}/archiviazione":{"get":{"tags":["Posta Ordinaria"],"description":"Laden Sie das Archivdokument herunter, sobald es bereitsteht. Den Status können Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#scope=GET:ws.ufficiopostale.com/ordinarie/{id}) überprüfen. Die Dokumente werden vom zuständigen Vertreter von Poste Italiane digital signiert, mit einem Zeitstempel versehen und in einem speziellen Dokumentenmanagementsystem gespeichert.\n","summary":"Download „Ordentliche Archivierung“","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}},{"name":"IdDestinatario","description":"Die „destinatari.id“ können Sie [hier](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ordinarie/get_ordinarie__id_) einsehen.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"path non valido ES: {id}/destinatari/{idDestinatario}/archiviazione","error":2013,"data":null}}}}}}},"/ordinarie/{id}":{"get":{"tags":["Posta Ordinaria"],"summary":"Informationen zu einer einzelnen E-Mail abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stati":{"$ref":"#/components/schemas/ExampleState"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"archiviazione":{"description":"Der Status des Dateispeichervorgangs. Mögliche Werte sind „WAITING“ oder „DONE“. Wenn der Status „DONE“ lautet, kann die archivierte Datei kostenlos über den Endpunkt heruntergeladen werden. Zum Herunterladen klicken Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#/Raccomandate/get_raccomandate__id__destinatari__IdDestinatario__archiviazione)","type":"string","enum":["WAITING","DONE"]}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"ricevuta":{"type":"boolean"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"callback":{"$ref":"#/components/schemas/callback"},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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,"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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand per Posta Ordinaria bestätigen","tags":["Posta Ordinaria"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigung des Versands einer E-Mail, die mit „autoconfirm = false“ erstellt wurde","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"examples":{"0":{"value":{"confirmed":true}}}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleResponseOrdinaria"},"example":{"data":[{"mittente":{"titolo":"mr","nome":"Lorenzo","cognome":"Paderi","dug":"Piazza","indirizzo":"ener bettica","civico":"1","comune":"roma","cap":"00121","provincia":"RM","nazione":"IT","email":"l.paderi@altravia.com"},"destinatari":[{"titolo":"mr","nome":"Lorenzo","cognome":"Paderi","dug":"Piazza","indirizzo":"ener bettica","civico":"11","comune":"roma","cap":"00121","provincia":"RM","nazione":"IT","email":"l.paderi@altravia.com","id":"64999de413df9dd7900e42c0","state":"NEW"}],"documento":["https://www.nasa.gov/pdf/65431main_ffs_factsheets_issoverview.pdf","https://www.nasa.gov/pdf/65431main_ffs_factsheets_issoverview.pdf"],"opzioni":{"fronteretro":false,"colori":true,"autoconfirm":false,"timestamp_invio":1687789031},"prodotto":"ordinaria","creation_timestamp":1687789028,"update_timestamp":1687789043,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/ordinariaZTq31xBfGVtjo4YxQJzSrvNRb.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/ordinariaZTq31xBfGVtjo4YxQJzSrvNRb.jpg","filename":"ordinariaZTq31xBfGVtjo4YxQJzSrvNRb.pdf","pagine":4,"size":149658},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"0":{"value":{"success":false,"message":"Raccomandata già confermata o non confermabile","error":2060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Lettera ordinaria non specificata","error":4030,"data":null}}}}}}},"/ordinarie/{id}/accettazione":{"get":{"tags":["Posta Ordinaria"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls dies bei der Einreichung verlangt wird. \n – Die Annahme ist der Vorgang, durch den die Bestätigung des Eingangs eines Antrags durch das System bescheinigt wird. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft, und sofern diese korrekt sind, wird eine Empfangsbestätigung erstellt. Diese Quittung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\n Die Annahmebestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Download der Empfangsbestätigung per Normalpost","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/prioritarie/":{"get":{"summary":"Listen Sie Ihre Anfragen auf (wird am 01.05.2026 eingestellt)","tags":["Posta Prioritaria"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"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}}}}}}},"deprecated":true,"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet eingestuft."},"post":{"summary":"Erstellen Sie Ihre Anfrage (wird am 01.05.2026 eingestellt)","tags":["Posta Prioritaria"],"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet markiert.\n\nSenden Sie eine Prioritätsnachricht. Sie sollten im Nachrichtentext Angaben zum Absender und zum/zu den Empfänger(n) machen. Zudem kann der Parameter „autoconfirm“ auf „false“ gesetzt werden, um die E-Mail für eine spätere Bestätigung per PATCH-Anfrage zu speichern, während Sie mit der Antwort benutzerdefinierte Logik ausführen. Überprüfen Sie das Feld „IdRicevuta“ im Empfängerobjekt, wenn Sie die Sendungsverfolgungsnummer benötigen.\n\n\nDieser Endpunkt unterstützt nun den Versand von „Prioritaria“-Sendungen ins Ausland. Hier sind die wichtigsten Details:\n  \n  - **Unterstützung für internationale „Prioritaria“-Sendungen**: Sie können nun „Prioritaria“-Sendungen an internationale Ziele versenden.\n  - **Einzelner Empfänger**: Internationale „Prioritaria“-Sendungen sind auf nur einen Empfänger beschränkt.\n  - **Adressformat**: Bei „Prioritaria“-Sendungen ins Ausland ist es entscheidend, die vollständige Adresse im Feld „indirizzo“ (Adresse) anzugeben, wie im Beispiel gezeigt.\n  - **Einstellung für die Provinz**: Das Feld „province“ (Provinz) wird bei Adressen im Ausland automatisch auf „EE“ (estero/Ausland) gesetzt.\n  - **Preisinformationen**: Um die Tarife für internationale „Prioritaria“-Sendungen zu überprüfen, können Sie den [/pricing/ Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_pricing_) verwenden.\n  - **Verfügbare Optionen**: Alle für „Prioritaria“ ins Ausland spezifischen Optionen sind im Schema aufgeführt. Nicht aufgeführte zusätzliche Optionen werden ignoriert.\n  - **Länderliste**: Eine Liste der Länder, in die Sie „Prioritaria“ ins Ausland versenden können, finden Sie unter dem [/nazioni/-Endpunkt](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Ufficio%20Postale/get_nazioni_). \n  \n  Die vollständige Liste der Felder und Optionen, die sowohl für inländische als auch für internationale Prioritaria-Sendungen verfügbar sind, finden Sie im Schema.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opzioni":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/posta_options"},{"$ref":"#/components/schemas/ForeignPostaOption"}]},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"destinatari":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/recipient_object_with_casl_postale"},{"$ref":"#/components/schemas/ForeignRecipient"}]},"description":"Empfängerliste"},"mittente":{"allOf":[{"$ref":"#/components/schemas/common_sender_object"}],"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"documento":{"$ref":"#/components/schemas/documento"},"callback":{"$ref":"#/components/schemas/callback"}}},"examples":{"prioritaria":{"value":{"mittente":{"titolo":"mr","nome":"Mario","cognome":"Rossi","dug":"Via","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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,"autoconfirm":true}}},"Foreign prioritaria":{"value":{"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","indirizzo":"37 Street Avenue","comune":"Londra","cap":"00101","provincia":"EE","nazione":"Italia"}],"documento":["Example document"],"opzioni":{"fronteretro":false,"colori":false,"autoconfirm":true}}}}}}},"callbacks":{"callback":{"{$request.body#/opzioni/callback_url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCallback"}}}},"responses":{"200":{"description":"OK"}}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalServiceResponse"},"examples":{"0":{"value":{"data":[{"mittente":{"titolo":"mr","nome":"John","cognome":"Doe","dug":"Piazza","indirizzo":"Dante Alighieri","dettaglio_immobile":"scala B","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","dettaglio_immobile":"interno A","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":"prioritaria","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}}}}}},"422":{"description":"Nicht verarbeitbare Entität","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"success":false,"message":"Dati obbligatori 'ragione_sociale' o 'nome' e 'cognome'","error":11020,"data":{"wrong_fields":["mittente.nome","mittente.cognome","mittente.ragione_sociale"]}}}}}}}},"deprecated":true}},"/prioritarie/{id}/destinatari/{IdDestinatario}/archiviazione":{"get":{"tags":["Posta Prioritaria"],"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet eingestuft.\n\nLaden Sie das Archivdokument herunter, sobald es verfügbar ist. Den Status können Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#scope=GET:ws.ufficiopostale.com/prioritarie/{id}) überprüfen. Die Dokumente werden vom zuständigen Vertreter von Poste Italiane digital signiert, mit einem Zeitstempel versehen und in einem speziellen Dokumentenmanagementsystem gespeichert.","summary":"Download „Prioritäre Archivierung“ (Veraltet ab 01.05.2026)","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}},{"name":"IdDestinatario","description":"Die „destinatari.id“ können Sie [hier](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Prioritaria/get_prioritarie__id_) einsehen.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"path non valido ES: {id}/destinatari/{idDestinatario}/archiviazione","error":2013,"data":null}}}}},"deprecated":true}},"/prioritarie/{id}":{"get":{"tags":["Posta Prioritaria"],"summary":"Informationen zu einer einzelnen Priority-Mail-Sendung abrufen (wird am 01.05.2026 eingestellt)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}},{"name":"callback","in":"query","required":false,"description":"Simuliert den Fortschritt des Versandstatus: <B>Jedes Mal, wenn dieser Endpunkt aufgerufen wird, wechselt Ihre Anfrage zum nächsten Versandstatus</B>.<BR>Sofern in der Anfrage angegeben, erhalten Sie Aktualisierungen per Callback.<BR>Bitte beachten Sie, dass diese Option <B>NUR für die sandbox-Umgebung</B> verfügbar ist.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stati":{"$ref":"#/components/schemas/ExampleState"},"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"archiviazione":{"description":"Der Status des Dateispeichervorgangs. Mögliche Werte sind „WAITING“ oder „DONE“. Wenn der Status „DONE“ lautet, kann die archivierte Datei kostenlos über den Endpunkt heruntergeladen werden. Zum Herunterladen klicken Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#/Posta%20Ordinaria/get_ordinarie__id__destinatari__IdDestinatario__archiviazione)","type":"string","enum":["WAITING","DONE"]},"tracking":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer"},"descrizione":{"type":"string","description":"Mögliche Werte:\n- Online angenommen\n- Die Sendung wurde zugestellt\n"},"type":{"type":"string","description":"Mögliche Codes:\n- 00: Online angenommen\n- C: Die Sendung wurde zugestellt\n"},"definitivo":{"type":"boolean","description":"Gibt an, ob der Status endgültig ist."}}}}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"callback":{"$ref":"#/components/schemas/callback"},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"ricevuta":{"type":"boolean"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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,"timestamp_invio":1635168169},"prodotto":"prioritaria","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}}}}},"deprecated":true,"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet eingestuft."},"patch":{"summary":"Versand per Posta Prioritaria bestätigen (wird am 01.05.2026 eingestellt)","tags":["Posta Prioritaria"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet markiert.\n\nBestätigen Sie den Versand einer E-Mail, die mit „autoconfirm = false“ erstellt wurde.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"examples":{"0":{"value":{"confirmed":true}}}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleResponsePrioritarie"},"example":{"data":[{"mittente":{"titolo":"mr","nome":"Lorenzo","cognome":"Paderi","dug":"Piazza","indirizzo":"ener bettica","civico":"43","comune":"roma","cap":"00121","provincia":"RM","nazione":"IT","email":"l.paderi@altravia.com"},"destinatari":[{"titolo":"mr","nome":"Lorenzo","cognome":"Paderi","dug":"Piazza","indirizzo":"ener bettica","civico":"43","comune":"roma","cap":"00121","provincia":"RM","nazione":"IT","email":"l.paderi@altravia.com","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,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/prioritariaCukonJsUHfAJMObAd1WFFPGP7.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/prioritariaCukonJsUHfAJMObAd1WFFPGP7.jpg","filename":"prioritariaCukonJsUHfAJMObAd1WFFPGP7.pdf","pagine":1,"size":5273},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"0":{"value":{"success":false,"message":"Lettera già confermata o non confermabile","error":2060,"data":null}}}}}}},"deprecated":true}},"/prioritarie/{id}/accettazione":{"get":{"tags":["Posta Prioritaria"],"description":"Dieser Endpunkt wird am 01.05.2026 als veraltet eingestuft.\n\nLaden Sie die Empfangsbestätigung „accettazione“ herunter, falls diese zum Zeitpunkt der Einreichung angefordert wurde. \n – Die Annahme ist der Vorgang, der die Bestätigung eines Antrags durch das System bescheinigt. In dieser Phase werden die vom Nutzer bereitgestellten Daten validiert, und sofern diese korrekt sind, wird eine Empfangsbestätigung generiert. Diese Empfangsbestätigung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\nDie Empfangsbestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur beantragten Dienstleistung, zum Absender und zum Empfänger.","summary":"Download der Annahmeerklärung für Posta Prioritaria (wird am 01.05.2026 außer Kraft gesetzt)","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}},"deprecated":true}},"/raccomandate/{id}/destinatari/{IdDestinatario}/archiviazione":{"get":{"tags":["Raccomandate"],"description":"Laden Sie das Archivdokument herunter, sobald es bereitsteht. Den Status können Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#scope=GET:ws.ufficiopostale.com/raccomandate/{id}) einsehen. Die Dokumente werden vom zuständigen Vertreter von Poste Italiane digital signiert, mit einem Zeitstempel versehen und in einem speziellen Dokumentenmanagementsystem gespeichert.\n","summary":"Download – Einschreiben-Archivierung","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}},{"name":"IdDestinatario","description":"Die „destinatari.id“ können Sie [hier](https://console.openapi.com/it/apis/ufficiopostale/documentation#/Raccomandate/get_raccomandate__id_) einsehen.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"path non valido ES: {id}/destinatari/{idDestinatario}/archiviazione","error":2013,"data":null}}}}}}},"/raccomandate/{id}/accettazione":{"get":{"tags":["Raccomandate"],"description":"Laden Sie die Empfangsbestätigung („accettazione“) herunter, falls dies bei der Einreichung verlangt wird. \n – Die Annahme ist der Vorgang, der die Bestätigung eines Antrags durch das System bescheinigt. In dieser Phase werden die vom Nutzer angegebenen Daten überprüft; sind diese korrekt, wird eine Empfangsbestätigung erstellt. Diese Empfangsbestätigung ist ein digitales Dokument, das die Annahme des Antrags offiziell bestätigt und den Ausgangspunkt für die weitere Bearbeitung markiert.\n\n Die Empfangsbestätigung enthält:\n \n - Datum und Uhrzeit der Annahme.\n - Angaben zur angeforderten Dienstleistung, zum Absender und zum Empfänger.\n - Eine digitale Signatur und einen Zeitstempel, die die rechtliche Gültigkeit gewährleisten.\n \n Die Annahme ist ein grundlegender Schritt, um Rückverfolgbarkeit, Transparenz und die Einhaltung gesetzlicher Vorschriften für die erbrachten Dienstleistungen zu gewährleisten.\n","summary":"Download der Empfangsbestätigung für Raccomandate","parameters":[{"name":"id","description":"ID der Anfrage","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"data":[],"success":true,"message":"","error":null}}}}}}},"/raccomandate/{id}":{"get":{"tags":["Raccomandate"],"description":"Überprüfen Sie das Feld <code>NumeroRaccomandata</code> im Empfängerobjekt, wenn Sie die Sendungsverfolgungsnummer benötigen.","summary":"Informationen zu einer Raccomandata abrufen","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Wenn die Option aktiviert wurde, gibt die Funktion ein bestimmtes Schema zurück, dessen Status mit dem angeforderten übereinstimmt.","schema":{"type":"string","example":"NEW"}},{"name":"callback","in":"query","required":false,"description":"Simuliert den Fortschritt des Versandstatus: <B>Jedes Mal, wenn dieser Endpunkt aufgerufen wird, wechselt Ihre Anfrage zum nächsten Versandstatus</B>.<BR>Sofern in der Anfrage angegeben, erhalten Sie Aktualisierungen per Callback.<BR>Bitte beachten Sie, dass diese Option <B>NUR für die sandbox-Umgebung</B> verfügbar ist.","schema":{"type":"string","example":"<empty string>"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"stati":{"$ref":"#/components/schemas/ExampleState"},"mittente":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"IdRicevuta":{"type":"string","description":"Beleg-ID","maxLength":50},"NumeroRaccomandata":{"type":"string"},"tracking":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"integer"},"descrizione":{"type":"string","description":"Mögliche Werte:\n- Online angenommen\n- Zugestellt\n- Im Lager\n- In Rückgabe\n- Digital zugestellt\n- In Bearbeitung\n"},"type":{"type":"string","description":"Mögliche Codes:\n- 00: Online angenommen\n- 01: Zugestellt\n- 02: Im Lager\n- 03: In Rückgabe\n- 04: Digital zugestellt\n- 99: In Bearbeitung\n"},"definitivo":{"type":"boolean","description":"Gibt an, ob der Status endgültig ist."}}}},"archiviazione":{"description":"Der Status des Dateispeichervorgangs. Mögliche Werte sind „WAITING“ oder „DONE“. Wenn der Status „DONE“ lautet, kann die archivierte Datei kostenlos über den Endpunkt heruntergeladen werden. Zum Herunterladen klicken Sie [hier](https://console.openapi.com/apis/ufficiopostale/documentation#/Raccomandate/get_raccomandate__id__destinatari__IdDestinatario__archiviazione)","type":"string","enum":["WAITING","DONE"]}}},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"ar":{"type":"boolean"},"ricevuta":{"type":"boolean"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"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","archiviazione":"WAITING"}],"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,"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}}}},"404":{"description":"Nicht gefunden","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"wrong_fields":{"type":"array","items":{"type":"string"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"example":{"success":false,"message":"Id Specificato non valido","error":54010,"data":null}}}}}},"patch":{"summary":"Versand per Raccomandate bestätigen","tags":["Raccomandate"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Bestätigung des Versands einer Raccomandata, die mit „autoconfirm = false“ erstellt wurde","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"}}},"examples":{"0":{"value":{"confirmed":true}}}}}},"responses":{"202":{"description":"ACCEPTED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleResponseRaccomandate"},"example":{"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":"test@test.com"},"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,"username":"gcloud-tests@openapi.it","confirmed":true,"state":"CONFIRMED","documento_validato":{"pdf":"https://test.ws.ufficiopostale.com/Up/pdf/raccomandataUBLwd2TfrzVnSTMymTi5SnmAo.pdf","jpg":"https://test.ws.ufficiopostale.com/Up/jpg/raccomandataUBLwd2TfrzVnSTMymTi5SnmAo.jpg","filename":"raccomandataUBLwd2TfrzVnSTMymTi5SnmAo.pdf","pagine":1,"size":6308},"callback":{"method":"JSON","url":"https://your-webhook.site/","user_id":"","username":"","field":"","headers":{"chiave":"valore"},"data":{},"retry":0,"scope":null,"domain":null,"custom":null},"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}}}},"406":{"description":"Nicht akzeptabel","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"examples":{"0":{"value":{"success":false,"message":"Raccomandata già confermata o non confermabile","error":2060,"data":null}}}}}},"421":{"description":"Falsch adressierte Anfrage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/patch_response_object"},"example":{"success":false,"message":"Impossibile Modificare oggetto","error":52020,"data":null}}}}}}},"/tracking/{id}":{"get":{"tags":["Ufficio Postale"],"summary":"Verfolgen Sie Ihr Produkt","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"descrizione":{"type":"string"},"definitivo":{"type":"boolean"},"type":{"type":"string"},"timestamp":{"type":"integer"}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"examples":{"0":{"value":{"data":[{"timestamp":1604567446,"descrizione":"accettata online","type":"00","definitivo":false}],"message":"1 Risultati","success":true,"error":null}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http","bearerFormat":"","description":"","x-last-modified":1627583898094}},"schemas":{"ExampleState":{"type":"object","properties":{"NEW":{"type":"string"},"SENT":{"type":"string"},"CONFIRMED":{"type":"string"}}},"ExampleResponseOrdinaria":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}}},"description":"Empfängerliste"},"callback":{"$ref":"#/components/schemas/callback"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExampleResponsePrioritarie":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"ricevuta":{"type":"boolean"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"callback":{"$ref":"#/components/schemas/callback"},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExampleResponseRaccomandate":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"ar":{"type":"boolean"},"ricevuta":{"type":"boolean"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"callback":{"$ref":"#/components/schemas/callback"},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExampleResponseTelegram":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"callback":{"$ref":"#/components/schemas/callback"},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"ar":{"type":"boolean"},"ricevuta":{"type":"boolean"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ResponseCallback":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"totale":{"type":"object","properties":{"importo_totale":{"type":"number"}}},"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"},"quantita":{"type":"integer"}}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"ExempleResponseSmart":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"callback":{"$ref":"#/components/schemas/callback"},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"totale":{"type":"object","properties":{"importo_totale":{"type":"number"}}},"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"},"quantita":{"type":"integer"}}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExempleResponseMassiva1":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExempleResponseMassiva2":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Cap + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"document_has_covers":{"description":"Gibt an, ob das PDF-Quelldokument bereits ein vorab erstelltes Deckblatt für jeden Empfänger enthält.","type":"object","properties":{"true":{"description":"Die PDF-Vorlage enthält die Deckblätter. Das System druckt das Dokument unverändert aus.","type":"boolean"},"false":{"description":"Die PDF-Vorlage enthält ausschließlich den Inhalt der E-Mail. Das System erstellt für jedes Dokument automatisch ein Deckblatt unter Verwendung der angegebenen Empfängerdaten.","type":"boolean"}}}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"$ref":"#/components/schemas/ExampleState"},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"number"},"size":{"type":"number"}}},"callback":{"$ref":"#/components/schemas/callback"},"pricing":{"type":"object","properties":{"totale":{"type":"object","properties":{"importo_totale":{"type":"number"}}},"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"},"quantita":{"type":"number"}}}}}},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExempleResponseMassivaTop1":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"ExempleResponseMassivaTop2":{"type":"object","properties":{"data":{"type":"object","properties":{"mittente":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"intestazione_completa":{"type":"string"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"opzioni":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um etwaige Größenbeschränkungen des Dokuments zu umgehen, sofern solche bestehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"prodotto":{"type":"string"},"creation_timestamp":{"type":"number","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"number","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"$ref":"#/components/schemas/ExampleState"},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"number"},"size":{"type":"number"}}},"callback":{"$ref":"#/components/schemas/callback"},"pricing":{"type":"object","properties":{"totale":{"type":"object","properties":{"importo_totale":{"type":"number"}}},"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"importo_unitario_totale":{"type":"number"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"},"quantita":{"type":"number"}}}}}},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"raccomandata_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"ar":{"type":"boolean","description":"Empfangsbestätigung"},"cover":{"type":"string","description":"Dies ist die über den spezifischen Endpunkt [POST /covers](https://console.openapi.com/apis/ufficiopostale/documentation#scope=POST:ws.ufficiopostale.com/covers) generierte Cover-ID, die zur Erstellung eines personalisierten Deckblatts für das Dokument verwendet wird."}}},"atti_giudiziari_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Möglicherweise sollten Sie diese Option in Betracht ziehen, um die Größenbeschränkungen des Dokuments zu umgehen, sofern diese gelten."},"colori":{"type":"boolean","description":"Farbdruck."},"autoconfirm":{"type":"boolean","description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist."},"ar":{"type":"boolean","description":"Fordert die herkömmliche Empfangsbestätigung in Papierform (Avviso di Ricevimento) an."},"ar_digitale":{"type":"boolean","description":"Fordert die Empfangsbestätigung in digitaler Form (AR Digitale) an. Das Dokument wird über den dafür vorgesehenen Endpunkt [hier](https://console.openapi.com/apis/ufficiopostale/documentation#/Atti%20Giudiziari/get_atti_giudiziari__id__destinatari__IdDestinatario__ardigitale) zum Download bereitgestellt."},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übertragen werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"ricevuta":{"type":"boolean","description":"Erstellt eine als PDF herunterladbare Quittung für die Bestellung."},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"atti_giudiziari":{"type":"object","description":"Optionale Zusatzfelder speziell für gerichtliche Dokumente","properties":{"oggetto":{"type":"string","maxLength":200,"description":"Betreff/Beschreibung des gerichtlichen Dokuments"},"note":{"type":"string","maxLength":200,"description":"Weitere Anmerkungen zum gerichtlichen Schriftstück"},"centro_costo_cliente":{"type":"string","maxLength":20,"description":"Kostenstellencode des Kunden"},"notificante":{"type":"object","required":["tipologia","valore"],"description":"Angaben zum Meldenden (falls vorhanden, erforderlich)","properties":{"tipologia":{"type":"string","enum":["ParteIstante","Procuratore","UfficialeGiudiziario"],"description":"Art des Anmelders (Kläger, Rechtsanwalt, Justizbeamter)"},"valore":{"type":"string","description":"Name/Kennung des Anmelders"}}},"tipo_lingua":{"type":"string","maxLength":60,"description":"Sprache des Dokuments"},"numero_cronologico":{"type":"string","maxLength":60,"description":"Chronologische Dokumentennummer"},"partner_tecnologico":{"type":"string","maxLength":20,"description":"Referenz für technische Partner"}}},"cover":{"type":"string","description":"Dies ist die über den spezifischen Endpunkt [POST /covers](https://console.openapi.com/apis/ufficiopostale/documentation#scope=POST:ws.ufficiopostale.com/covers) generierte Cover-ID, die zur Erstellung eines personalisierten Deckblatts für das Dokument verwendet wird."}}},"callback":{"type":"object","description":"Dies ist unser standardisiertes OpenAPI-Callback-System. Es ermöglicht die Konfiguration von Parametern für den Empfang von Benachrichtigungen über Statusaktualisierungen asynchroner Anfragen an diesen Endpunkt.","properties":{"method":{"type":"string","description":"Geben Sie die Callback-Methode an. Bei der Einstellung „POST“ wird eine standardmäßige HTTP-POST-Anfrage initiiert, wobei der Content-Type-Header auf „application/x-www-form-urlencoded“ gesetzt ist. Die JSON-Daten werden in ein Schlüssel-Wert-Paar namens „data“ (anpassbar über den Parameter „field“) im Anfragetext kodiert. Ist die Methode auf „JSON“ gesetzt, wird eine direkte HTTP-POST-Anfrage gesendet, wobei der Content-Type-Header auf „application/json“ gesetzt ist. Die JSON-Rohdaten werden ohne jegliche Kodierung direkt in den Anfragetext eingefügt.","enum":["POST","JSON"],"default":"JSON"},"field":{"type":"string","description":"Dieser Parameter funktioniert in Verbindung mit dem Parameter „method“, der auf „POST“ gesetzt ist. Wenn er als Zeichenfolge angegeben wird, legt er den Namen des Parameters fest, der in der POST-Anfrage gesendet wird.","example":"data","default":"data"},"url":{"type":"string","format":"uri","description":"In diesen Parameter muss eine gültige URL eingegeben werden, die POST-Anfragen verarbeiten kann. Bei Endpunkten, die eine Authentifizierung erfordern, kann der Parameter „headers“ verwendet werden, um „basic auth“ oder „bearer auth“ anzugeben. Das maximale Timeout beträgt 30 Sekunden. Wenn „retry“ gesetzt ist, versucht das System den Vorgang bis zu „retry“-Mal, bis ein Statuscode 200 empfangen wird.","example":"https://www.mysite.com/myEndpoint"},"retry":{"type":"integer","description":"Die maximale Anzahl der Versuche wird durch den Parameter „retry“ festgelegt. Wird die maximale Anzahl der Versuche erreicht, ohne dass ein erfolgreicher Statuscode (z. B. 200 OK) zurückgegeben wird, gilt die Anfrage als endgültiger Fehlschlag. Oft wird zwischen den Versuchen ein Zeitintervall eingefügt, um eine Überlastung des Servers zu vermeiden. Dieses Intervall kann sich mit jedem Versuch exponentiell verlängern, um die Auswirkungen auf einen überlasteten Server zu verringern. Der Parameter „retry“ ist so konfiguriert, dass die Anfrage nur bei bestimmten Statuscodes erneut versucht wird, typischerweise bei solchen, die auf vorübergehende Fehler (z. B. 502, 503) oder Netzwerkprobleme hinweisen.","example":3,"maximum":5,"minimum":5,"default":0},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"Eine Sammlung von HTTP-Headern, die zusammen mit der Anfrage gesendet werden sollen. Jeder Header wird als Schlüssel-Wert-Paar definiert. Header können für verschiedene Zwecke verwendet werden, darunter Authentifizierung, Inhaltsaushandlung und benutzerdefinierte Metadaten.","example":{"session_id":"9834r5fh589494"}},"custom":{"type":"object","description":"Dieses Objekt kann mit beliebigen zusätzlichen Daten gefüllt werden, die Sie in die Callback-Antwort aufnehmen möchten. Auf diese Daten können Sie über den Parameter „custom“ der Callback-Funktion zugreifen. Auf diese Weise können Sie alle relevanten Informationen speichern und abrufen, die Sie für Ihre Anwendung benötigen.","example":{"my_custom_id":"123456789"}}},"required":["url"]},"ForeignRaccomandataOption":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"cover":{"type":"string","description":"Dies ist die über den spezifischen Endpunkt [POST /covers](https://console.openapi.com/apis/ufficiopostale/documentation#scope=POST:ws.ufficiopostale.com/covers) generierte Cover-ID, die zur Erstellung eines personalisierten Deckblatts für das Dokument verwendet wird."}}},"raccomandata_s_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Möglicherweise sollten Sie diese Option in Betracht ziehen, um die Größenbeschränkungen des Dokuments zu umgehen, sofern diese gelten."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"ar":{"type":"boolean","description":"Empfangsbestätigung"},"document_has_covers":{"type":"boolean","description":"auf jeden Empfänger zugeschnittene Dokumente"}}},"posta_massiva_top_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um eventuelle Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"}}},"posta_p_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"document_has_covers":{"description":"Gibt an, ob das PDF-Quelldokument bereits ein vorab erstelltes Deckblatt für jeden Empfänger enthält.","type":"object","properties":{"true":{"description":"Die PDF-Vorlage enthält die Deckblätter. Das System druckt das Dokument unverändert aus.","type":"boolean"},"false":{"description":"Die PDF-Vorlage enthält ausschließlich den Inhalt der E-Mail. Das System erstellt für jedes Dokument automatisch ein Deckblatt unter Verwendung der angegebenen Empfängerdaten.","type":"boolean"}}}}},"PostalServiceResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"opzioni":{"type":"object","properties":{"colori":{"type":"boolean","description":"In Farbe drucken"},"autoconfirm":{"type":"boolean","description":"Den Versand automatisch bestätigen, anstatt auf eine PATCH-Anfrage zu warten"},"fronteretro":{"type":"boolean","description":"Beidseitig drucken"},"timestamp_invio":{"type":"integer"}},"description":"Individuelle Optionen für den Druck oder die Weiterverarbeitung"},"mittente":{"type":"object","properties":{"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"ragione_sociale":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"description":"Flag oder Objekt zur Kennzeichnung des Absenders"},"destinatari":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}}},"description":"Empfängerliste"},"documento":{"type":"array","items":{"type":"string"}},"prodotto":{"type":"string"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung"},"username":{"type":"string"},"confirmed":{"type":"boolean","description":"Ob die Ressource für den Versand bestätigt ist"},"state":{"type":"string","description":"Aktueller Stand","maxLength":20},"documento_validato":{"type":"object","properties":{"pdf":{"type":"string"},"jpg":{"type":"string"},"filename":{"type":"string"},"pagine":{"type":"integer"},"size":{"type":"integer"}}},"pricing":{"type":"object","properties":{"dettaglio":{"type":"array","items":{"type":"object","properties":{"codice_servizio":{"type":"string"},"descrizione_servizio":{"type":"string"},"percentuale_iva":{"type":"number"},"quantita":{"type":"integer"},"zona":{"type":"integer"},"importo_unitario_netto":{"type":"number"},"importo_unitario_iva":{"type":"number"},"importo_unitario_totale":{"type":"number"}}}},"totale":{"type":"object","properties":{"importo_totale_netto":{"type":"number"},"importo_totale_iva":{"type":"number"},"importo_totale":{"type":"number"}}}}},"confirmed_timestamp":{"type":"integer"},"id":{"type":"string","description":"Eindeutige Kennung der Ressource","maxLength":24}}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"object","nullable":true,"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"posta_options":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"cover":{"type":"string","description":"Dies ist die über den spezifischen Endpunkt [POST /covers](https://console.openapi.com/apis/ufficiopostale/documentation#scope=POST:ws.ufficiopostale.com/covers) generierte Cover-ID, die zur Erstellung eines personalisierten Deckblatts für das Dokument verwendet wird."}}},"ForeignPostaOption":{"type":"object","properties":{"fronteretro":{"type":"boolean","description":"Ob das PDF beidseitig gedruckt werden soll. Diese Option sollten Sie in Betracht ziehen, um gegebenenfalls die Größenbeschränkungen des Dokuments zu umgehen."},"colori":{"description":"Farbdruck","type":"boolean"},"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei, die als RECEIVED-Bestellbestätigung heruntergeladen werden kann.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"cover":{"type":"string","description":"Dies ist die über den spezifischen Endpunkt [POST /covers](https://console.openapi.com/apis/ufficiopostale/documentation#scope=POST:ws.ufficiopostale.com/covers) generierte Cover-ID, die zur Erstellung eines personalisierten Deckblatts für das Dokument verwendet wird."}}},"telegramma_options":{"type":"object","properties":{"autoconfirm":{"description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist.","type":"boolean"},"ricevuta":{"description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung.","type":"boolean"},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"mittente":{"type":"boolean","default":false,"description":"Fügt die Daten des Absenders zum Telegrammtext hinzu"},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"},"ar_c":{"type":"boolean","description":"Papierbeleg"},"ar_e":{"type":"string","format":"email","description":"elektronische Quittung per E-Mail"}}},"documento":{"description":"Das Dokument kann entweder eine Zeichenkette oder ein Array von Zeichenketten im Klartext sein. <br> Die Zeichenketten können entweder Folgendes sein:  <ul>\n  <li><b>Klartext</b></li>\n  <li><b>In HTML formatiert</b>, mit Stilen, Header-Tags usw.</li>\n  <LI><B>Eine URL</B>, die entweder auf eine Webseite, eine PDF-Datei oder eine Bilddatei verweist (URLs müssen mit http beginnen). Der Inhalt wird aus dem „Content-Type“-Header abgeleitet</LI>\n  <LI><B>Eine Base64-kodierte PDF-Datei</B>. Kodierte Zeichenfolgen werden anhand des Base64-Inhalts-Headers <code>data:application/pdf;base64,</code> erkannt: Grundsätzlich gilt: Um eine Zeichenfolge als Base64-kodierten Inhalt zu kennzeichnen, sollten Sie der Ausgabe die oben genannte Zeichenfolge voranstellen. <BR>Die Anfrage gibt einen ERROR zurück, wenn der Dekodierungsprozess auf dem Server fehlschlägt</LI>\n</UL> Der Dienst analysiert das Feld „documento“ (Dokument), führt alle Zeichenfolgen/Dokumente/Bilder <B>auf verschiedenen Seiten</B> zusammen, komprimiert sie leicht (sofern möglich) und generiert eine einzige PDF-Datei.\n\n Die maximale Größe für ein PDF-Dokument beträgt nach unserer Komprimierung 5 MB für alle Produkte mit Ausnahme von Posta 4 PRO, Posta Massiva, Posta Massiva Top und Raccomandata Smart (diese drei Produkte akzeptieren maximal 15 MB).\n\n**Die maximale Seitenanzahl** beträgt derzeit 50 bzw. 100 bei Verwendung der Option `fronteretro`.","example":["Lorem ipsum","https://example.com/document.pdf","<strong>Text</strong>","data:application/pdf;base64,JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9Dcm... (base64 encoded)"],"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"string"}]},"documentoTelegramma":{"description":"Das Feld „document“ muss ein Array mit einem einzigen Element vom Typ „text“ sein. Andere Inhaltstypen wie HTML, PDF, URL oder Base64 sind nicht zulässig. Der Text im Array darf 8100 Zeichen und 2000 Wörter nicht überschreiten.","example":["Lorem ipsum"]},"documento_validato_basicauth":{"description":"Wenn diese Option aktiviert ist, können die generierten Dokumente (PDF und Vorschaubild) nur über eine GET-Anfrage an die angegebene URL <b> mit den angegebenen Anmeldedaten in der Basic-Auth-Authentifizierung </b> abgerufen werden.","type":"object","properties":{"username":{"type":"string"},"password":{"type":"string"}}},"common_sender_object":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"co":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"dettaglio_immobile":{"type":"string","maxLength":10,"description":"Weitere oder spezifische Angaben zum Standort der Immobilie (z. B. Gebäude 1, Eingang A)."},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia","email"]},"common_recipient_object":{"type":"object","title":"Recipient","allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"dettaglio_immobile":{"type":"string","maxLength":10,"description":"Weitere oder spezifische Angaben zum Standort der Immobilie (z. B. Gebäude 1, Eingang A)."},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":37},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. IT)","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"required":["cap","comune","dug","indirizzo","nazione","civico","provincia"]}]},"atti_giudiziari_sender_object":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"dettaglio_immobile":{"type":"string","maxLength":10,"description":"Weitere oder spezifische Angaben zum Standort der Immobilie (z. B. Gebäude 1, Eingang A)."},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode des Landes des Absenders. Für diesen Dienst ist ausschließlich „IT“ zulässig.","maxLength":2},"email":{"type":"string","description":"E-Mail-Adresse","maxLength":100}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia","email"]},"atti_giudiziari_recipient_object":{"type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":44,"description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"dug":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"indirizzo":{"type":"string","maxLength":43,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"civico":{"type":"string","maxLength":5,"description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen"},"dettaglio_immobile":{"type":"string","maxLength":10,"description":"Weitere oder spezifische Angaben zum Standort der Immobilie (z. B. Gebäude 1, Eingang A)."},"comune":{"type":"string","maxLength":37,"description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"provincia":{"type":"string","maxLength":2,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","maxLength":5,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"nazione":{"type":"string","description":"ISO-Ländercode des Empfängerlandes. Für diesen Dienst ist nur „IT“ zulässig.","maxLength":2},"co":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44}},"required":["nome","cognome","cap","comune","dug","indirizzo","nazione","civico","provincia"]},"telegramma_foreign_recipient_object":{"title":"foreign_recipient","description":"Bei Auslands-Telegrammen ist nur ein Empfänger zulässig. Es ist unbedingt erforderlich, die vollständige Adresse in das Feld „indirizzo“ (Adresse) einzutragen, wie im Beispiel gezeigt. Das Feld „province“ (Provinz) wird automatisch auf „EE“ (estero/Ausland) gesetzt.","type":"object","properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","maxLength":41,"description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen"},"cognome":{"type":"string","maxLength":41,"description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 41 Zeichen (einschließlich Leerzeichen) umfassen"},"indirizzo":{"type":"string","maxLength":41,"description":"Die Adresse darf nicht länger als 41 Zeichen sein (einschließlich Leerzeichen)"},"comune":{"type":"string","maxLength":36,"description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten"},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":9},"provincia":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode des Landes des Empfängers","maxLength":2}},"required":["nome","cognome","indirizzo","comune","cap","nazione"]},"telegramma_foreign_options":{"type":"object","properties":{"mittente":{"type":"boolean","description":"Falls zutreffend, fügen Sie die Angaben des Absenders in das Telegramm ein und senden Sie eine Kopie des Telegramms an den Absender."},"autoconfirm":{"type":"boolean","description":"Bestätigt die Anfrage automatisch, ohne dass eine zusätzliche PATCH-Anfrage erforderlich ist."},"ricevuta":{"type":"boolean","description":"Erstellt eine PDF-Datei zum Herunterladen als RECEIVED-Bestellbestätigung."},"documento_validato_basicauth":{"$ref":"#/components/schemas/documento_validato_basicauth"},"headers":{"type":"object","properties":{"key":{"type":"string"}},"description":"enthält Schlüssel-Wert-Paare, die als Header übermittelt werden sollen","example":{"session_id":"9834r5fh589494"}},"timestamp_invio":{"type":"integer","description":"Übermittlung des Terminierungsdatums im Zeitstempelformat"}}},"PricingResponseSchema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PricingData"},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Zusätzliche Informationen oder Statusmeldung","maxLength":255},"error":{"type":"object","nullable":true,"description":"ERROR-Details, falls vorhanden. Null, wenn die Anfrage erfolgreich war"}}},"PricingData":{"type":"object","properties":{"tipologia":{"type":"string","description":"Die allgemeine Kategorie der Dienstleistung (z. B. „Telegramma“, „Raccomandata“)"},"prodotto":{"type":"string","description":"Die spezifische Produktbezeichnung (z. B. „telegramma_estero“, „raccomandata_estero“)"},"descrizione":{"type":"string","description":"Eine kurze Beschreibung des Dienstes"},"riferimento_prezzo":{"type":"string","description":"Die Maßeinheit für die Preisberechnung (z. B. „Parole“ für Telegramme, „Pagina“ für REGISTERED Einschreiben)"},"accetta_allegati":{"type":"integer","description":"Gibt an, ob Anhänge akzeptiert werden (1 für „Ja“, 0 für „Nein“)"},"attivo":{"type":"integer","description":"Gibt an, ob der Dienst derzeit aktiv ist (1 für aktiv, 0 für inaktiv)"},"tariffe":{"type":"array","description":"Liste der für diesen Dienst geltenden Tarife","items":{"oneOf":[{"$ref":"#/components/schemas/TelegrammaEsteroTariffa"},{"$ref":"#/components/schemas/RaccomandataEsteroTariffa"}]}}}},"TelegrammaEsteroTariffa":{"type":"object","properties":{"iva_tariffa_postale":{"type":"number","description":"Mehrwertsteuersatz für den Posttarif"},"iva_imbustamento":{"type":"number","description":"Mehrwertsteuersatz für den Umhüllungsprozess"},"iva_stampa_imbustamento":{"type":"number","description":"Mehrwertsteuersatz für Druck- und Kuvertierarbeiten"},"tipologia":{"type":"string","description":"Tarifart (z. B. „Parole“ für Wörter)"},"zona":{"type":"string","description":"Tarifzone (z. B. „A“, „B“, „C“ usw.)"},"tariffa_postale":{"type":"number","description":"Grundtarif pro Wort"},"stampa":{"type":"number","description":"Druckkosten"},"imbustamento":{"type":"number","description":"Kosten für die Umhüllung"},"prezzo_fisso":{"type":"number","nullable":true,"description":"Festpreisanteil, falls zutreffend (kann für manche Zonen null sein)"},"iva_prezzo_fisso":{"type":"number","nullable":true,"description":"Mehrwertsteuersatz für den Festpreisanteil, falls zutreffend"}}},"RaccomandataEsteroTariffa":{"type":"object","properties":{"iva_tariffa_postale":{"type":"number","description":"Mehrwertsteuersatz für den Posttarif"},"iva_imbustamento":{"type":"number","description":"Mehrwertsteuersatz für den Umhüllungsprozess"},"iva_stampa_imbustamento":{"type":"number","description":"Mehrwertsteuersatz für Druck- und Kuvertierarbeiten"},"tipologia":{"type":"string","description":"Tarifart (z. B. „pagine“ für Seiten)"},"da":{"type":"integer","description":"Startnummer für diesen Tarifbereich"},"a":{"type":"integer","description":"Endnummer dieser Tarifgruppe"},"tariffa_postale":{"type":"number","description":"Porto für diesen Seitenbereich"},"zona":{"type":"integer","description":"Tarifzone (z. B. 1, 2, 3)"},"stampa":{"type":"number","description":"Druckkosten pro Seite"},"imbustamento":{"type":"number","description":"Kosten für die Umhüllung"}}},"generic_recipient_object":{"type":"object","properties":{"titolo":{"type":"string","example":"Mr/Mrs","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname + Co. dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"ragione_sociale":{"$ref":"#/components/schemas/ragione_sociale_object"}},"required":["nome","cognome"]},"recipient_object_with_casl_postale":{"description":"Die Angabe des vollständigen Namens (Vorname, Nachname) oder des Firmennamens (Firmenbezeichnung) ist obligatorisch.","type":"object","title":"Recipient or Casella postale","oneOf":[{"$ref":"#/components/schemas/common_recipient_object"},{"type":"object","title":"Casella postale","required":["casella_postale","ufficio_postale","comune","provincia","cap"],"allOf":[{"$ref":"#/components/schemas/generic_recipient_object"},{"type":"object","properties":{"casella_postale":{"type":"string","description":"Die Nummer Ihres „Casella Postale“-Postfachs: <a href=\"https://www.poste.it/prodotti/caselle-postali.html\">https://www.poste.it/prodotti/caselle-postali.html</a>","maxLength":10},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":36},"ufficio_postale":{"type":"string","description":"Die Poststelle, an die Ihre Post gesendet werden soll","maxLength":36},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":5}}}]}]},"CountriesResponse":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CountryInfoFull"}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"object","nullable":true,"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"CountriesServiceResponse":{"type":"object","properties":{"data":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CountryInfoService"}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"object","nullable":true,"description":"ERROR-Code, falls ein Fehler aufgetreten ist"}}},"CountryInfoFull":{"type":"object","properties":{"nome":{"type":"string","description":"Landname auf Italienisch"},"name":{"type":"string","description":"Landname auf Englisch"},"products":{"type":"object","properties":{"telegramma_estero":{"type":"boolean"},"raccomandata_estero":{"type":"boolean"},"ordinaria_estero":{"type":"boolean"},"prioritaria_estero":{"type":"boolean"}}}}},"CoverDetailResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Kennung des Deckblatts","maxLength":24},"header":{"type":"string","description":"Base64-kodiertes Bild oder Text der Titelzeile"},"mittente":{"type":"string","description":"Base64-kodiertes Bild oder Text des Absenderlogos"},"dettaglioMittente":{"type":"string","description":"Base64-kodiertes Bild oder Text mit den Angaben zum Absender"},"body":{"type":"string","description":"Base64-kodiertes Bild oder Text des Umschlagtextes"},"footer":{"type":"string","description":"Base64-kodiertes Bild oder Text der Fußzeile auf dem Umschlag"},"dettaglioLettera":{"type":"string","description":"Base64-kodiertes Bild oder Text mit den Details des Briefes"},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung des Covers"},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung des Covers"},"status":{"type":"string","description":"Aktueller Stand des Umschlags"},"callback":{"$ref":"#/components/schemas/callback"}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Zusätzliche Mitteilung zur Anfrage","maxLength":255},"error":{"type":"string","nullable":true,"description":"Fehlermeldung, falls ein Fehler aufgetreten ist, andernfalls null"}}},"CoverRequest":{"type":"object","properties":{"callback":{"$ref":"#/components/schemas/callback"},"header":{"oneOf":[{"type":"string"},{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild der Kopfzeile. Die empfohlene Größe beträgt 580 x 34 Pixel.\n- Die Kopfzeile des Dokuments. Sie kann Informationen wie das Firmenlogo, den Firmennamen oder andere identifizierende Angaben enthalten.\n\n [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-header.png)\n"}]},"mittente":{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild des Absenderlogos. Die empfohlene Größe beträgt 340 x 79 Pixel. Bild des Absenderlogos. \n– Es muss sich um ein Bild handeln, das alle wesentlichen Angaben zum Absender enthält, wie zum Beispiel: – Vor- und Nachname (oder Firmenname) – Vollständige Adresse – Postleitzahl – City und Province/Provinz – Kontaktdaten (Telefon, E-Mail) – Umsatzsteuer-Identifikationsnummer oder Steuer-ID (falls zutreffend) Das Bild muss in einem unterstützten Format (z. B. JPEG, PNG) vorliegen und die für die Darstellung im Dokument geeigneten Abmessungen aufweisen.\n\n  [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-mittente.png)\n"},"dettaglioMittente":{"oneOf":[{"type":"string"},{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild mit den Angaben zum Absender. Die empfohlene Größe beträgt 261 x 79 Pixel.\n- Detaillierte Informationen zum Absender des Dokuments. Dazu können Name, Adresse, Kontaktdaten und weitere relevante Angaben gehören.\n\n  [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-dettaglio-mittente.png)\n"}]},"body":{"oneOf":[{"type":"string"},{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild des Deckblatttextes. Die empfohlene Größe beträgt 600 x 493 Pixel.\n- Der Hauptinhalt des Dokuments. Hier wird der Haupttext der Mitteilung oder des Schreibens eingefügt.\n\n  [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-body.png)\n"}]},"footer":{"oneOf":[{"type":"string"},{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild der Fußzeile des Deckblatts. Die empfohlene Größe beträgt 600 x 34 Pixel.\n - Die Fußzeile des Dokuments. Sie kann Kontaktinformationen, rechtliche Hinweise oder andere relevante Angaben enthalten.\n \n  [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-footer.png)\n"}]},"dettaglioLettera":{"oneOf":[{"type":"string"},{"type":"string","format":"base64","description":"Text oder Base64-kodiertes Bild mit den Briefdaten. Die empfohlene Größe beträgt 213 x 159 Pixel. Gilt für Standard- und Expresssendungen, jedoch nicht für REGISTERED-Sendungen.\n- Ein Feld zum Einfügen spezifischer Angaben zum Brief, wie z. B. Referenznummern, Betreff oder andere Informationen, die für den Kontext des Dokuments relevant sind.\n\n  [Beispiel](https://storage.googleapis.com/docs-openapi-it-bucket/demo-dettaglio-lettera.png)\n"}]}}},"CoverResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"header":{"type":"string","format":"base64","description":"Base64-kodiertes Bild der Kopfzeile des Covers."},"mittente":{"type":"string","format":"base64","description":"Base64-kodiertes Bild des Absenderlogos."},"dettaglioMittente":{"type":"string","format":"base64","description":"Base64-kodiertes Bild der Absenderdaten."},"body":{"type":"string","format":"base64","description":"Base64-kodiertes Bild des Cover-Motivs."},"footer":{"type":"string","format":"base64","description":"Base64-kodiertes Bild der Fußzeile des Deckblatts."},"dettaglioLettera":{"type":"string","format":"base64","description":"Base64-kodiertes Bild der Briefdetails."},"creation_timestamp":{"type":"integer","description":"Unix-Zeitstempel der Erstellung des Covers."},"update_timestamp":{"type":"integer","description":"Unix-Zeitstempel der letzten Aktualisierung des Covers."},"status":{"type":"string","description":"Aktueller Stand des Umschlags."},"id":{"type":"string","description":"Eindeutige Kennung des Einbands.","maxLength":24}}},"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war."},"message":{"type":"string","description":"Zusätzliche Mitteilung zur Anfrage.","maxLength":255},"error":{"type":"string","nullable":true,"description":"Fehlermeldung, falls ein Fehler aufgetreten ist; andernfalls null."}}},"CountryInfoService":{"type":"object","properties":{"nome":{"type":"string","description":"Landname auf Italienisch"},"name":{"type":"string","description":"Landname auf Englisch"},"zona":{"type":"string","description":"Tarifzone für das Land.\nFür „raccomandata_estero“, „ordinaria_estero“ und „prioritaria_estero“: von 1 bis 3.\nFür „telegramma_estero“: von A bis H.\n"}}},"ForeignRecipient":{"type":"object","required":["nome","cognome","indirizzo","comune","cap","nazione"],"properties":{"titolo":{"type":"string","description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen"},"nome":{"type":"string","description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"cognome":{"type":"string","description":"Titel + Vorname + Nachname dürfen insgesamt nicht mehr als 44 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":44},"indirizzo":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":43},"civico":{"type":"string","description":"dug + Straße + Hausnummer dürfen insgesamt nicht mehr als 43 Zeichen (einschließlich Leerzeichen) umfassen","maxLength":5},"comune":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":44},"cap":{"type":"string","description":"„Gemeinde + Postleitzahl + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":9},"provincia":{"type":"string","description":"„Gemeinde + CAP + Provinz“ darf 44 Zeichen (einschließlich Leerzeichen) nicht überschreiten","maxLength":2},"nazione":{"type":"string","description":"ISO-Ländercode (z. B. GB, US)","maxLength":2}}},"ragione_sociale_object":{"description":"Das Feld **ragione_sociale** kann verwendet werden, wenn Sie E-Mails im Namen eines Unternehmens versenden: Wenn dieses Feld ausgefüllt ist, stehen weder **nome** noch **cognome** zur Verfügung.","type":"string","maxLength":44},"patch_response_object":{"type":"object","properties":{"success":{"type":"boolean","description":"Gibt an, ob die Anfrage erfolgreich war"},"message":{"type":"string","description":"Status- oder Fehlermeldung","maxLength":255},"error":{"type":"integer","description":"ERROR-Code, falls ein Fehler aufgetreten ist"},"data":{"type":"object","default":null}}}}},"externalDocs":{"description":"Zum ersten Mal hier? Erstellen Sie einen neuen Zugriffstoken.","url":"https://console.openapi.com/de/oauth"},"security":[{"bearerAuth":[]}],"tags":[{"name":"Ufficio Postale"},{"name":"Telegrammi"},{"name":"Atti Giudiziari","description":"Dieses Produkt verfügt über einen Sendungsverfolgungscode"},{"name":"Raccomandate","description":"Dieses Produkt verfügt über einen Sendungsverfolgungscode"},{"name":"Posta Prioritaria","description":"Dieses Produkt verfügt über einen Sendungsverfolgungscode"},{"name":"Posta Ordinaria"},{"name":"Raccomandata Smart"},{"name":"Posta Massiva"},{"name":"Posta Massiva Top"}]}