Alle Ihre Sendungen über API und in Echtzeit
Automatisieren Sie den Versand von Dokumenten, Einschreiben, Telegrammen, Werbung mit der Post<br>
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, es ist auch möglich, mehr als einen Empfänger für alle Postdienste anzugeben: Telegramm, Einschreiben, Prioritäts- und normale Post, eingeschriebene Smart, Massensendungen.
Ja, die Liste ist über die GET-Methode verfügbar.
Je nach Dienst ist der Referenzendpunkt folgender:
- GET /telegrammi/ für Telegramme
- GET /raccomandate/ für eingeschriebene Briefe
- GET /prioritarie/ für Prioritätssendungen
- GET /ordinarie/ für normale Post
- 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
- GET /raccomandate/{id} für Einschreiben
- GET /prioritarie/{id} für Prioritätspost
- GET /ordinarie/{id} für normale Post
- 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)
Sie können einzelne Sendungen für Produkte mit Sendungsverfolgung (Einschreiben, Priority Mail, Einschreiben Smart) über den GET-Endpoint /tracking/{id}, beginnend mit dem Parameter id, verfolgen.
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 Endpoint und liegen bei nur 0,32€.
- Für Einschreiben: Die Kosten beginnen bei 4,24€.
- Für Telegramm: Die Kosten für ausgehende Sendungen betragen 3,63€.
- Für Normale Post (Post 4): Die Kosten für den Abgang betragen 1,03€.
- Für Prioritätspost: Die Kosten für die ausgehende Sendung betragen 2,28€.
- Für Massensendungen: Die Kosten für die ausgehende Sendung betragen 0,32€.
- Für Einschreiben Smart: Die Abfahrtskosten betragen 2,60€.
Alle Preise finden Sie in der Rubrik "Pricing".
Sie können die Preise auch über den Endpoint GET /pricing/ abrufen.
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.