Sie befinden sich auf der Dokumentations-Seite der Post DE Auftragsmanagement (AM) API der Deutsche Post AG. In diesem und den folgenden Kapiteln bieten wir Ihnen:

• Einen Überblick der fachlichen Funktionen, die die API abdeckt
• Die technische Dokumentation der API als Zusammenstellung eines Entwicklerhandbuchs, das Themen zu Verbindungen, Authentifizierung, API Spezifikationen  und Beispiele enthält.
• Weiterhin finden Sie Themen zum Support unter Weitere Informationen
• Am Ende befinden sich die Release Notes

Umfang

Mit dem elektronischen Auftragsmanagement wird der kaufmännische und logistische Prozess der Deutschen Post informationstechnisch begleitet. Der Kunde profitiert in mehrerer Hinsicht von diesen Möglichkeiten:

• Einfacher  Informationsaustausch zwischen den Auftragsbeteiligten.
• Schlanker  Vorankündigungs- und Einlieferungsprozess.
• Über ein Internet-Portal (AM.GKP) bietet die Deutsche Post dem Kunden die Möglichkeit, seine Einlieferungen von der Vorankündigung über die Einlieferung bis zur erfolgten postalischen Prüfung bei der Sendungsannahme zu verfolgen.
• Für vorangekündigte Aufträge kann die Rechnungsstellung auf elektronischem Weg erfolgen.

Benutzung der API

Mit AM können alle Produktfamilien des Unternehmensbereichs Post und alle Freimachungsarten abgebildet werden, d.h. für:

• DIALOGPOST
• Briefsendungen
• POSTAKTUELL 
• Postwurf Spezial
• Produkte der Presse Distribution
• Produkte international

AM.exchange

AM.exchange ist das B2B-Protokoll zum elektronischen Datenaustausch zwischen den Kunden, Systempartnern und der Deutschen Post.

AM.GKP

AM.GKP ist ein Internet-Portal, das Kunden und Systempartnern, die das AM.exchange-Protokoll nutzen, Informationen zu Aufträgen und zum Auftragsstatus zur Verfügung stellt.

Abbildung: Überblick Datenkommunikation zwischen Kunde und Deutsche Post

Kurzübersicht AM.exchange-Protokoll

Das AM.exchange-Protokoll bietet eine Sammlung von Nachrichten, sog. Requests und Responses, zum Austausch von Informationen mit dem Auftragsmanagement-System der Deutschen Post AG. Der entsprechende Service OrderManagement dient dem Austausch von auftragsbezogenen Informationen.

Schnittstelle Ordermanagement

Die Schnittstelle Ordermanagement dient dem Austausch von auftragsbezogenen Informationen. Den Kern dieser Nachrichtensammlung bildet die Nachricht zur Auftragsanlage: Serviceoperation createOrder. Darüberhinaus stehen noch weitere Serviceoperationen zur Verfügung: changeOrder (Änderung eines Auftrags), cancelOrder (Storno eines Auftrags), seekOrder (Suche nach Aufträgen), getOrder (Laden eines Auftrags) und seekOrderMessage (Suche nach Systemmeldungen).

Die folgende Informationssammlung gibt IT-Projektleitern und Softwareentwicklern alle wichtigen Informationen zum Thema AM.exchange-Protokoll der Deutschen Post an die Hand. Es beantwortet unter anderem die folgenden Fragen:

• Welche Möglichkeiten bietet das AM.exchange-Protokoll?
• Wie sehen die Prozesse im Detail aus?
• Welche Daten werden ausgetauscht?
• Welche technischen Übertragungskanäle können genutzt werden?
• Welche Produkte und Freimachungsarten werden unterstützt?
• Welche Möglichkeiten zum Testen stehen Ihnen zur Verfügung?
• Wer ist Ansprechpartner bei Fragen zu AM.exchange?

Weitere Details haben wir Ihnen als Download unter dem Punkt Entwicklerhandbuch zusammengestellt.

Bitte beachten Sie die folgenden Hinweise zu den aktuell gültigen Ordermanagement Versionen:

• Das Entwicklerhandbuch in der Version 5.3.1 enthält die zum 01.01.2025 geänderten Vorgaben im Hinblick auf die Teilleistung Brief sowie Rabattänderungen bei Dialogpost und gilt somit für Entwickler, die diese Vorgaben implementieren möchten.
   
• Das Entwicklerhandbuch in der Version 5.2.3 enthält die noch bis 31.12.2024 gültigen Vorgaben im Hinblick auf die Teilleistung und gilt somit für Entwickler, die noch 2024 die Teilleistung implementieren und produktiv nutzen möchten.