---

AM.exchange Handbuch für SW-Entwickler

Version 5.4 vom 30. Oktober 2025

---

Diese Inhaltsübersicht gibt Ihnen einen kurzen Überblick über die wesentlichen Bestandteile des AM.exchange Entwicklerhandbuches und beinhaltet Verweise zu den dem Handbuch beiliegenden, weiterführenden Informationen. Die jeweils aktuellste Version des AM.exchange Handbuches für SW-Entwickler finden Sie hier im Entwicklerportal der Deutschen Post.

Das AM.exchange-Handbuch

Das zentrale Dokument, das Sie zum Studium der erforderlichen Grundlagen zunächst lesen sollten, ist das AM.exchange-Entwicklerhandbuch.pdf.

AM.exchange Code-Beispiele

Eine umfangreiche Sammlung von Beispielen für Operationsaufrufe finden Sie im Handbuch AM.exchange-Beispiele.pdf. Dieses Beispielhandbuch enthält Hyperlinks, die Sie direkt zu den zugehörenden Beispieldateien im XML-Format führen.

Mit der zudem vorhandenen Beispielübersicht finden Sie schnell die für Sie relevanten Code-Beispiele. Diese ist in den Formaten Excel und PDF verfügbar.

XML-Schema Dokumentation

Eine umfassende Erklärung der XML-Schemas aller Service-Operationen liegt als Browser-Version im HTML-Format, sowie als druckbare Version im PDF-Format vor. Beide Versionen enthalten sowohl Strukturinformationen (XML-Baumstruktur) als auch Detailinformationen (Guidelines) zu allen Datenfeldern der Nachrichten.

Browser-Version - Strukturdiagramme und Guidelines

· createOrderRequest	· createOrderResponse
· changeOrderRequest	· changeOrderResponse
· cancelOrderRequest	· cancelOrderResponse
· seekOrderRequest	· seekOrderResponse
· getOrderRequest	· getOrderResponse
· processOrderManagementOperationsRequest	· processOrderManagementOperationsResponse
· seekOrderMessageRequest	· seekOrderMessageResponse

PDF-Version - Strukturdiagramme

· createOrderRequest	· createOrderResponse
· changeOrderRequest	· changeOrderResponse
· cancelOrderRequest	· cancelOrderResponse
· seekOrderRequest	· seekOrderResponse
· getOrderRequest	· getOrderResponse
· processOrderManagementOperationsRequest	· processOrderManagementOperationsResponse
· seekOrderMessageRequest	· seekOrderMessageResponse

PDF-Version - Guidelines

· createOrderRequest	· createOrderResponse
· changeOrderRequest	· changeOrderResponse
· cancelOrderRequest	· cancelOrderResponse
· seekOrderRequest	· seekOrderResponse
· getOrderRequest	· getOrderResponse
· processOrderManagementOperationsRequest	· processOrderManagementOperationsResponse
· seekOrderMessageRequest	· seekOrderMessageResponse

XML-Schemas

Neben der Dokumentation der XML-Schemas finden Sie natürlich auch die XML-Schemas (.xsd) selbst als Anlage zum Handbuch. Aus technischen Gründen unterscheiden sich die Schemas für die AM-Produktionsumgebung und die AM-Abnahmeumgebung in den verwendeten Name-Spaces im XML-Header. (Bitte achten Sie daher besonders darauf, gegen welches Schema Sie Ihre XML-Dateien validieren.)

XML-Schemas - AM-Abnahmeumgebung

· createOrderRequest.xsd	· createOrderResponse.xsd
· changeOrderRequest.xsd	· changeOrderResponse.xsd
· cancelOrderRequest.xsd	· cancelOrderResponse.xsd
· seekOrderRequest.xsd	· seekOrderResponse.xsd
· getOrderRequest.xsd	· getOrderResponse.xsd
· processOrderManagementOperationsRequest.xsd	· processOrderManagementOperationsResponse.xsd
· seekOrderMessageRequest.xsd	· seekOrderMessageResponse.xsd
· common.xsd
· errorHandling.xsd

XML-Schemas - AM-Produktionsumgebung

· createOrderRequest.xsd	· createOrderResponse.xsd
· changeOrderRequest.xsd	· changeOrderResponse.xsd
· cancelOrderRequest.xsd	· cancelOrderResponse.xsd
· seekOrderRequest.xsd	· seekOrderResponse.xsd
· getOrderRequest.xsd	· getOrderResponse.xsd
· processOrderManagementOperationsRequest.xsd	· processOrderManagementOperationsResponse.xsd
· seekOrderMessageRequest.xsd	· seekOrderMessageResponse.xsd
· common.xsd
· errorHandling.xsd

Änderungshistorie der XML-Schemas

In der Änderungshistorie ist im Detail aufgelistet, welche Änderungen sich in den einzelnen Schema-Versionen ergeben haben.

· Änderungshistorie AM-XML-Schemata.pdf

WSDL-Dateien

Für Entwickler, die den Web Service zur synchronen Datenübertragung nutzen möchten, sind hier die WSDL-Dateien angehängt.

· OrderManagement.wsdl (WSDL für die AM-Produktionsumgebung)

· CertificationOrderManagement.wsdl (WSDL für die AM-Zertifizierungsumgebung)

Produktnummern-Tabellen

Die Produktnummern-Tabellen National und International enthalten alle Produktnummern, mit denen Sie die Produkte der Deutschen Post eindeutig identifizieren können. Eine Liste aller für AM.exchange gültigen Produktnummern ist auch im XML-Format enthalten.

· AM.exchange Produkte National.pdf

· AM.exchange Produkte International.pdf

· AM.exchange Produkte.xml

· Änderungshistorie AM.exchange Produkte.pdf

Liste der Produktionsstätten

Die Code-Tabelle Produktionsstätten enthält die Liste aller gültigen Einlieferungsstellen mit dem jeweiligen Code, der bei Einlieferungen im Feld "ProductionPlantID" zu verwenden ist. In der Übersicht sind die Kontaktinformationen der Depots enthalten. Sie wird in den Formaten PDF und XML ausgeliefert.

· Produktionsstätten.pdf

· Produktionsstätten.xml

Die XML Datei im alten Format (ohne Kontaktinformationen der Depots) finden Sie unter

· Codetables\Produktionsstätten_ohne_Kontakt.xml

Allgemeine Code-Tabelle

Die allgemeine Schlüsseltabelle enthält alle sonstigen im AM.exchange Protokoll verwendeten Codes. Zur einfachen elektronischen Verarbeitung der enthaltenen Werte wird Ihnen diese Tabelle in den Formaten PDF und XML bereitgestellt.

· AM.exchange Codetable.pdf

· AM.exchange Codetable.xml

Übersicht Freimachungsarten

Diese Übersicht gibt die prinzipiell anwendbaren Freimachungsarten je Produktfamilie an.

· AM.exchange Freimachungsarten .pdf

Fehlercodes und Fehlermeldungen

Diese Tabelle enthält alle AM.exchange Fehlercodes und Fehlermeldungen.

· AM.exchange-Meldungstexte.pdf

Spezifikation Matrixcode für Bundzettel Presse

Dieses Dokument beinhaltet die Spezifikation des Matrixcode für den Bundleitzettel Presse.

· Spezifikation_Matrixcode\Pressepost_Bundleitzettel.pdf