# 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