Post Office

Der Referenzendpunkt für das Senden von Telegrammen über die API ist POST /telegrammi/.

Im Body der Anfrage werden die Daten des:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger(n) (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle zusätzliche Option (Zustellungsmitteilung)

Die Antwort enthält die Angaben zu dem angeforderten Telegramm, insbesondere

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• Telegramm-ID

BITTE BEACHTEN SIE: Die ID wird später nützlich sein, um Informationen über das gesendete Telegramm zu erhalten.

Es ist auch möglich, das Telegramm für einen späteren Versand zu speichern, und zwar über den Parameter "autoconfirm", der in diesem Fall auf "false" gesetzt werden muss. Um das Senden zu einem späteren Zeitpunkt zu bestätigen, müssen Sie den PATCH-Endpoint /telegrammi/{id} verwenden, indem Sie die Sende-ID und im Körper der Anfrage den Wert "confirmed":true übergeben.

Für das Versenden von Telegrammen per API ist der relevante Endpunkt POST /telegrammi/. Im Body der Anfrage müssen die folgenden Daten angegeben werden:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Text (einschließlich Absenderdaten)
• Zusätzliche Option (Sendequittung, Versand planen)

Die Antwort liefert Details zum angeforderten Telegramm, insbesondere:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Gesendeter Text
• Endpreis
• Telegramm-ID

HINWEIS: Die ID ist später nützlich, um Informationen über das gesendete Telegramm zu erhalten. Es ist auch möglich, das Telegramm für einen späteren Versand zu speichern, indem der Parameter „autoconfirm“ auf „false“ gesetzt wird. Um den Versand später zu bestätigen, muss der Endpunkt PATCH /telegrammi/{id} mit der Versand-ID und im Body der Anfrage dem Wert "confirmed": true verwendet werden.

Für den Versand von Einschreiben über die API ist der Referenzendpunkt POST /raccomandate/.

Im Hauptteil der Anfrage werden die Daten des:

• Absender (Vorname, Nachname, vollständige Adresse)
• Adressat(en) (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle Zusatzoptionen (Vorder-/Rückseite, Farben, Rücksendung, Lieferschein)

Der Rückschein enthält die Angaben zu dem angeforderten Einschreiben, insbesondere

• Absender (Vorname, Nachname, vollständige Anschrift)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• Einschreiben-ID

BITTE BEACHTEN SIE: Die Identifikationsnummer wird später nützlich sein, um Informationen über das gesendete Einschreiben zu erhalten und um es zu verfolgen.

Es ist auch möglich, das Einschreiben für einen späteren Versand über den Parameter "autoconfirm" zu speichern, der in diesem Fall auf "false" gesetzt werden muss. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, muss der PATCH-Endpoint /raccomandate/{id} verwendet werden, indem die ID der Sendung und im Body der Anfrage der Wert "confirmed":true übergeben wird.

Der Referenzendpoint für den Versand von Einschreibe-E-Mails über die API ist POST /raccomandate_smart/.

Im Hauptteil der Anfrage müssen die Daten des:

• Absender (Vorname, Nachname, vollständige Adresse)
• Adressat(en) (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle Zusatzoptionen (Vorder-/Rückseite, Farben, Rücksendung, Lieferschein, eventuelle Rückruf-URL)

Die Antwort enthält die Einzelheiten des angeforderten Einschreibens, insbesondere:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• ID Einschreiben Smart

BITTE BEACHTEN SIE: Die ID wird später nützlich sein, um Informationen über die gesendete Einschreibesendung zu erhalten und sie zu verfolgen.

Sie können das Einschreiben auch für einen späteren Versand über den Parameter "autoconfirm" speichern, der in diesem Fall auf false gesetzt werden muss. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, müssen Sie den PATCH-Endpoint /raccomandate_smart/{id} verwenden, indem Sie die ID des Versandes und im Körper der Anfrage den Wert "confirmed":true übergeben.

Für das Versenden von Einschreiben per API ist der relevante Endpunkt POST /raccomandate/. Im Body der Anfrage müssen die folgenden Daten angegeben werden:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Text oder Anhang des Dokuments (URL, HTML, einfacher Text)
• Zusätzliche Option (Sendequittung, Vorder-/Rückseite, Farbe, Versand planen)

Die Antwort liefert Details zum angeforderten Einschreiben, insbesondere:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Spezifikationen zum Dokument
• Endpreis
• Einschreiben-ID

HINWEIS: Die ID ist später nützlich, um Informationen über das gesendete Einschreiben zu erhalten und für die Nachverfolgung. Es ist auch möglich, das Einschreiben für einen späteren Versand zu speichern, indem der Parameter „autoconfirm“ auf „false“ gesetzt wird. Um den Versand später zu bestätigen, muss der Endpunkt PATCH /raccomandate/{id} mit der Versand-ID und im Body der Anfrage dem Wert "confirmed": true verwendet werden.

Um ein gerichtliches Einschreiben per API zu versenden, verwenden Sie den Endpoint POST /atti_giudiziari/.

Im Body der Anfrage müssen die folgenden Daten angegeben werden:

• Absender: (Name, Nachname, vollständige Adresse)
• Empfänger: (Name, Nachname, vollständige Adresse)
• Dokument
• Optional: zusätzliche Option (Zustellungsbenachrichtigung)

Die Antwort enthält die Details zum angeforderten gerichtlichen Einschreiben, insbesondere:

• Absender: (Name, Nachname, vollständige Adresse)
• Empfänger: (Name, Nachname, vollständige Adresse)
• Dokumentspezifikationen
• Endpreis
• Einschreiben-ID

HINWEIS: Die ID wird später benötigt, um Informationen über das gesendete Einschreiben abzurufen.

Es ist auch möglich, das Einschreiben für einen späteren Versand zu speichern, indem der Parameter "autoconfirm" auf "false" gesetzt wird. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, muss der Endpoint PATCH /atti_giudiziari/{id} verwendet werden. Geben Sie die Versand-ID an und fügen Sie im Body der Anfrage den Wert "confirmed": true hinzu.

Die Lieferzeiten variieren je nach Zielland.

Für das Versenden von Postamail per API ist der relevante Endpunkt POST /ordinarie/. Im Body der Anfrage müssen die folgenden Daten angegeben werden:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Text oder Anhang des Dokuments (URL, HTML, einfacher Text)
• Zusätzliche Option (Sendequittung, Vorder-/Rückseite, Farbe, Versand planen)

Die Antwort liefert Details zu:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Spezifikationen zum Dokument
• Endpreis
• Postamail-ID

HINWEIS: Die ID ist später nützlich, um Informationen über den Versand zu erhalten. Es ist auch möglich, die Postamail für einen späteren Versand zu speichern, indem der Parameter „autoconfirm“ auf „false“ gesetzt wird. Um den Versand später zu bestätigen, muss der Endpunkt PATCH /ordinarie/{id} mit der Versand-ID und im Body der Anfrage dem Wert "confirmed": true verwendet werden.

Für das Versenden von Postapriority per API ist der relevante Endpunkt POST /prioritarie/. Im Body der Anfrage müssen die folgenden Daten angegeben werden:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Text oder Anhang des Dokuments (URL, HTML, einfacher Text)
• Zusätzliche Option (Sendequittung, Vorder-/Rückseite, Farbe, Versand planen)

Die Antwort liefert Details zu:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Spezifikationen zum Dokument
• Endpreis
• Postapriority-ID

HINWEIS: Die ID ist später nützlich, um Informationen über den Versand und für die Nachverfolgung zu erhalten. Es ist auch möglich, die Postapriority für einen späteren Versand zu speichern, indem der Parameter „autoconfirm“ auf „false“ gesetzt wird. Um den Versand später zu bestätigen, muss der Endpunkt PATCH /prioritarie/{id} mit der Versand-ID und im Body der Anfrage dem Wert "confirmed": true verwendet werden.

Für den Versand normaler Post über die API ist der Referenzendpoint POST /ordinarie/.

Im Hauptteil der Anfrage müssen Sie folgende Daten angeben:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle Zusatzoptionen (Vorder-/Rückseite, Farben, Lieferschein)

Die Antwort enthält Angaben zu:

• Absender (Vorname, Nachname, vollständige Anschrift)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• normale Post-ID

BITTE BEACHTEN SIE: Die ID wird später nützlich sein, um Informationen über die gesendete Sendung zu erhalten.

Es ist auch möglich, die gewöhnliche Post für einen späteren Versand zu speichern, und zwar über den Parameter "autoconfirm", der in diesem Fall auf "false" gesetzt werden muss. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, müssen Sie den PATCH-Endpunkt /ordinarie/{id} verwenden, indem Sie die ID der Sendung und im Body der Anfrage den Wert "confirmed":true übergeben.

Die Lieferzeiten für internationale Postamail sind:

• Europa: Zustellung in 85 % der Fälle innerhalb von 8 Werktagen (ohne Samstage und Feiertage) nach dem Versandtag.
• Mittelmeerraum: Zustellung in 85 % der Fälle innerhalb von 12 Werktagen (ohne Samstage und Feiertage) nach dem Versandtag.
• Nordamerika und Ozeanien: Zustellung in 85 % der Fälle innerhalb von 16 Werktagen (ohne Samstage und Feiertage) nach dem Versandtag.
• Rest der Welt: Zustellung in 85 % der Fälle innerhalb von 22 Werktagen (ohne Samstage und Feiertage) nach dem Versandtag.

Bei Online-Sendungen werden zu den angegebenen Zustellzeiten folgende Bearbeitungszeiten hinzugerechnet: Druck innerhalb eines Werktages (T+1), wenn die Sendung bis 14:00 Uhr an einem Werktag (Montag bis Freitag, außer Feiertage) angenommen wird.

Für den Versand von Prioritätspost über die API ist der Referenzendpoint POST /prioritarie/.

Im Hauptteil der Anfrage werden die Daten des:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle Zusatzoptionen (Vorder-/Rückseite, Farben, Lieferschein)

Die Antwort enthält Angaben zu:

• Absender (Vorname, Nachname, vollständige Anschrift)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• Prioritätspost-ID

BITTE BEACHTEN SIE: Die Kennung ist später nützlich, um Informationen über die gesendete Sendung zu erhalten und um die Sendung verfolgen zu können.

Es ist auch möglich, die Prioritätspost-Sendung für einen späteren Versand über den Parameter "autoconfirm" zu speichern, der in diesem Fall auf false gesetzt werden muss. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, müssen Sie den PATCH-Endpoint /prioritarie/{id} verwenden, indem Sie die ID der Sendung und im Body der Anfrage den Wert "confirmed":true übergeben

Die Lieferzeiten für internationale Postapriority hängen vom Zielland ab und sind:

• Europa: 3 Werktage (ohne Samstage und Feiertage) nach dem Versandtag, in 85 % der Sendungen.
• Mittelmeerraum: 4/5 Werktage (ohne Samstage und Feiertage) nach dem Versandtag, in 85 % der Sendungen.
• Nordamerika: 5/6 Werktage (ohne Samstage und Feiertage) nach dem Versandtag, in 85 % der Sendungen.
• Übrige Länder Amerikas, Asien und Ozeanien: 7/8 Werktage (ohne Samstage und Feiertage) nach dem Versandtag, in 85 % der Sendungen.
• Andere afrikanische Länder: 8/9 Werktage (ohne Samstage und Feiertage) nach dem Versandtag, in 85 % der Sendungen.

Bei Online-Sendungen werden zu den angegebenen Zustellzeiten folgende Bearbeitungszeiten hinzugerechnet: Druck innerhalb eines Werktages (T+1), wenn die Sendung bis 14:00 Uhr an einem Werktag (Montag bis Freitag, außer Feiertage) angenommen wird.

Für den Versand von Massenmails über die API ist der Referenzendpoint POST /posta_massiva/.

Im Hauptteil der Anfrage werden die Daten des:

• Absender (Vorname, Nachname, vollständige Adresse)
• Empfänger(n) (Vorname, Nachname, vollständige Adresse)
• Dokument
• eventuelle Zusatzoptionen (Vorder-/Rückseite, Farben, Lieferschein)

Die Antwort enthält Angaben zu:

• Absender (Vorname, Nachname, vollständige Anschrift)
• Empfänger (Vorname, Nachname, vollständige Anschrift)
• Spezifikationen des Dokuments
• Endpreis
• ID Massensendung

BITTE BEACHTEN SIE: Die ID wird später nützlich sein, um Informationen über die Sendung zu erhalten.

Es ist auch möglich, die Massensendung für einen späteren Versand über den Parameter "autoconfirm" zu speichern, der in diesem Fall auf false gesetzt werden muss. Um den Versand zu einem späteren Zeitpunkt zu bestätigen, müssen Sie den PATCH-Endpoint /posta_massiva/{id} verwenden, indem Sie die ID der Sendung und im Body der Anfrage den Wert "confirmed":true übergeben

Die Option „Absender“ ermöglicht es, die Absenderdaten direkt in den Text des Telegramms einzufügen.

• Für Sendungen innerhalb Italiens muss diese Option ausgewählt werden, damit die Absenderdaten sichtbar sind.
• Bei internationalen Sendungen erfolgt die Einfügung der Absenderdaten automatisch.

Es ist wichtig zu beachten, dass die Wörter, die für den Absender verwendet werden, in die Gesamtwortanzahl des Telegramms mit eingerechnet werden.

Wird ein Dokument hochgeladen, das mehr als 50 Seiten umfasst, ohne die Option „Vorder-/Rückseite“ zu aktivieren, generiert das System eine Fehlermeldung. In solchen Fällen muss die Option „Vorder-/Rückseite“ aktiviert werden, um den Dokumentversand korrekt durchzuführen.

Ja, das Titelblatt der Kommunikation kann vollständig personalisiert werden, indem zum Beispiel das Logo, Unternehmensinformationen oder Werbeaktionen hinzugefügt werden.

Die Personalisierung kann über eine API mit dem dedizierten Endpoint oder über den Playground erfolgen, der auch eine Vorschau vor dem Versand ermöglicht.

Die Titelblatt-Personalisierung ist verfügbar für:

• Online-Einschreiben
• Internationales Einschreiben
• Standardbrief Italien (Posta 4)
• Prioritätsbrief Italien (Posta 1)
• Gerichtliche Einschreiben - Italien
• Postapriority
• Postamail

Die digitale Archivierung ist ein kostenloser, standardmäßig aktivierter Service, der den Zugriff auf den gesendeten Inhalt ermöglicht, der von Poste Italiane digital signiert und gestempelt wurde. Dieser Service zertifiziert den gesendeten Inhalt mit rechtlicher Gültigkeit und macht ihn für 12 Monate verfügbar.

Der Service ist für die folgenden Postprodukte verfügbar:

• Online-Einschreiben
• Internationales Einschreiben
• Standardbrief Italien (Posta 4)
• Prioritätsbrief Italien (Posta 1)
• Gerichtliche Einschreiben - Italien
• Postapriority
• Postamail

Internationale Telegramme werden noch am selben Tag dem nationalen Postdienst übergeben. Die Zustellung an den Empfänger erfolgt dann gemäß den im jeweiligen Land geltenden Postlaufzeiten.

Ja, die Liste ist über die GET-Methode verfügbar.

Je nach Dienst ist der Referenzendpunkt folgender:

• GET /telegrammi/ für Telegramme (sowohl nationale als auch internationale)
• GET /raccomandate/ für eingeschriebene Briefe (sowohl nationale als auch internationale)
• GET /prioritarie/ für Prioritätssendungen (sowohl nationale als auch internationale)
• GET /ordinarie/ für normale Post (sowohl nationale als auch internationale)
• GET /raccomandate_smart/ für eingeschriebene Smart
• GET /atti_giudiziari/ für Gerichtliche Einschreiben
• GET /posta_massiva/ für Massenpost

Es ist kein Startparameter erforderlich.

Ja, es ist möglich, eine Überprüfung früherer Sendungen über die Endpunkte vorzunehmen:

• GET /telegrammi/{id} für Telegramme (sowohl nationale als auch internationale) 
• GET /raccomandate/{id} für Einschreiben (sowohl nationale als auch internationale)
• GET /prioritarie/{id} für Prioritätspost (sowohl nationale als auch internationale)
• GET /ordinarie/{id} für normale Post (sowohl nationale als auch internationale)
• GET /raccomandata_smart/{id} für Einschreiben Smart
• GET /atti_giudiziari/{id} für Gerichtliche Einschreiben
• GET /posta_massiva/{id} für Massensendungen

In allen Fällen ist die ID, die beim Versand des Produkts ermittelt wird, als Startparameter erforderlich.

Andere Parameter (falls gesetzt) sind optional:

• Quittung (für Telegramme, Einschreiben, Prioritätspost und normale Post): in der Antwort wird ein PDF-Dokument zurückgegeben
• Status (für alle Dienste)
• Callback (NUR für die Sandbox-Umgebung und nur für Einschreiben)

Die Zeit, die Poste Italiane benötigt, um die Anfrage zu bearbeiten, hängt von der angeforderten Dienstleistung ab:

• Einschreiben: in Echtzeit
• Telegramm: in Echtzeit
• Normale Post: in Echtzeit
• Prioritätspost: in Echtzeit
• Massensendungen: in Sekunden
• Einschreiben Smart: in Sekunden
• Gerichtliche Einschreiben: in Sekunden

Die durchschnittliche Zustellzeit hängt von der gewünschten Dienstleistung ab:

• Einschreiben: 4-6 Arbeitstage
• Telegramm: ab 24 Stunden
• Normale Post: ab 4 Tagen
• Prioritätspost: ab 24 Stunden
• Massensendungen: ab 7-9 Tage
• Einschreiben Smart: von 4-7 Tagen

Die Kosten für eine einzelne Anfrage variieren je nach Dienst und den gewählten Optionen und beginnen bei 0,32 €.

• Für Einschreiben: ab 4,24 €.
• Für Telegramm: ab 3,63 €.
• Für Standardpost (Posta 4): ab 1,03 €.
• Für Prioritätspost (Posta 1): ab 2,28 €.
• Für Massensendungen: ab 0,32 €.
• Für Smart-Einschreiben: ab 2,60 €.
• Für internationales Telegramm: ab 1,90 €.
• Für internationales Einschreiben: ab 7,50 €.
• Für internationale Postamail: ab 1,30 €.
• Für internationale Postapriority: ab 3,60 €.

Alle Preise sind in der speziellen Rubrik „Preise“ verfügbar. Detaillierte Preisinformationen können auch über den Endpunkt GET /pricing/ abgerufen werden.

Im Abschnitt "Usage" auf API-Ebene können Sie Ihre Gratis- und Aufladeanfragen überwachen. Sie sind sowohl in grafischer Form (Zeitraum Monat und Jahr) als auch in Form einer textlichen Zusammenfassung verfügbar.