Alle Ihre Sendungen über API und in Echtzeit
Automatisieren Sie den Versand von Dokumenten, Einschreiben, Telegrammen, Werbung mit der Post<br>
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.
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.
Die Lieferzeiten variieren je nach Zielland.
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 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.
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.
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 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.
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.
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
- Posta 1
- Posta 4
- 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
- Posta 1
- Posta 4
- Postapriority
- Postamail
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 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.
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.
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
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 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
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 /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 /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
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.