Best for:
- Business customers of Deutsche Post AG
- Electronic order management of Deutsche Post AG's commercial and logistics processes (Mail)
You are on the documentation page of the Post DE Order Management (AM) API of Deutsche Post AG. In this and the following chapters we offer you:
- An Overview of the business functions covered via the API
- The business tables relevant for using the API: Product table and Production location table
- The Developer's Guide of the API contains topics of connection and authentication and API Specification
- Find further Support in section Additional Information
- Latest Release Notes
Scope
Electronic order management provides information technology support for Deutsche Post's commercial and logistics processes. The customer benefits from these options in several ways:
- Simple exchange of information between the parties involved in the order.
- Lean pre-notification and posting process.
- Via an Internet portal (AM.portal), Deutsche Post offers customers the option of tracking their postings from advance notice to posting to successful postal verification at the point of acceptance.
- For pre-announced orders, invoicing can be done electronically.
Using the API
AM can be used to map all product families of the Post corporate division and all franking types, i.e.:
- DIALOGPOST
- Letter Mail
- POSTAKTUELL
- Postwurf Special
- Press Distribution products
- Products international
AM.exchange
AM.exchange is the B2B protocol for electronic data exchange between customers, system partners and Deutsche Post.
AM.portal
AM.portal is an Internet portal that provides customers and system partners using the AM.exchange protocol with information on orders and order status.
Figure: Overview of data communication between customer and Deutsche Post
Brief overview of AM.exchange protocol
The AM.exchange protocol provides a collection of messages, so-called requests and responses, for the exchange of information with the order management system of Deutsche Post AG. The corresponding OrderManagement service is used to exchange order-related information.
Order Management Interface
The Order Management interface is used to exchange order-related information. The core of this message collection is the message for order creation: service operation createOrder. In addition, further service operations are available: changeOrder (change of an order), cancelOrder (cancellation of an order), seekOrder (search for orders), getOrder (loading of an order) and seekOrderMessage (search for system messages).
The following information collection provides IT project managers and software developers with all the important information on the subject of Deutsche Post's AM.exchange protocol. Among other things, it answers the following questions:
- What possibilities does the AM.exchange protocol offer?
- What do the processes look like in detail?
- What data is exchanged?
- Which technical transmission channels can be used?
- Which products and franking types are supported?
- What testing options are available?
- Who is the contact person for questions about AM.exchange?
We have more details for you in the Developer's Guide
Please note the following information on the currently valid order management versions:
- The Developer's Manual in version 5.3.1 contains the specifications changed as of 01/01/2025 with regard to additional Order – Teilleistung Brief as well as discount - changes for Dialogpost and is thus applicable for developers who want to implement these specifications.
- The Developer's Manual in version 5.2.3 contains the specifications valid until 31/12/2024 with regard to additional Order – Teilleistung Brief and is thus applicable for developers who want to implement and productively use these specifications in 2024.
Deutsche Post offers its customers two data transmission channels. Each customer can decide which of the following options to use, depending on the technical options available to them and the use case:
SOAP-Webservice
Communication with the AM.Exchange web service with order management runs exclusively on the basis of SOAP via https. This ensures secure, encrypted transmission of data between customers and Deutsche Post. The web service enables synchronous data communication between customers and Deutsche Post, which means that the connection remains established until the request has been answered and the caller can then process the response immediately.
An overview of how the web service works is provided in the Postman Collectiont located in the download area
Secure File Transfer Protocol (SFTP)
The use of SFTP is very similar to FTP from the user's point of view. However, a significant difference is that with the SFTP protocol the data is encrypted during data transfer by using the SSH protocol. With this type of transfer, communication is asynchronous, i.e. the customer places a file with the response on the SFTP account assigned to him and receives a file with the response in the same account as soon as processing of the request is complete.
Do you have questions about the listed interfaces? You can find our contact options at the following address:
https://www.deutschepost.de/de/e/elektronisches_auftragsmanagement/kontakt.html
General
This appendix briefly lists the major changes for the different manual versions. The latest changes are listed at the beginning of this appendix, the changes in the older
in the older manuals are further down.
Please note the following information about the currently valid versions of the order management:
The Developer's Manual in version 5.3 contains the specifications changed as of 01/01/2025 with regard to additional Order – Teilleistung Brief and is thus applicable for developers who want to implement these specifications.
The Developer's Manual in version 5.2.3 contains the specifications valid until 31/12/2024 with regard to additional Order – Teilleistung Brief and is thus applicable for developers who want to implement and productively use these specifications in 2024.
Changes in AM.exchange Produktionsstätten version 5.3.1
Initial version after extraction from the main document
Changes in AM.exchange Produkte version 5.3.1
Initial version after extraction from the main document
Changes in manual version 5.3.1
Appendix G:
Example 045 removed
Examples 23, 32, 33, 35, 36, 42, 43, 46, 47, 50, 52, 65, 66, 74, 75, 76, 77, 90, 97, 129, 130 changed: Dialogpost: partial elimination of discounts
Example 006 changed: elimination of differentiation Warensendung 500/1000;
Appendix H :
AM.exchange product tables: Product table updated;
Changes in manual version 5.3
Chapter 5.4: Adjustments for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
Chapter 8.13: Appendix Mehrfachversand has been removed;
Chapter 8.7: Adjustments for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
Chapter 8.7.1 the chapter has been removed;
Appendix D: Adjustments of the schema documentation for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
Appendix E: Adjustments of the schema documentation for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
Appendix G: Example 016 extended by Bsp_016_06_ab_01012025_createOrder_Request: ZA - Adaptation for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
Appendix H :
AM.exchange code table updated: Adaptation for new additional Order partial service Letter – Teilleistung Brief from 01/01/2025;
AM.exchange product tables: Product table updated;
Changes in manual version 5.2.3
Various textual adjustments throughout the document AM.portal -> AM.GKP;
Chapter 8.18: the chapter has been removed;
Chapter Targeted order display in the AM.portal has been completely removed
The previous chapter 9.2 The meaning of the service versions is given the designation 9.1;
Appendix G - Examples 004, 101, 127, 143, 144 removed
Examples 006, 009, 011, 030, 122, 123, 128, 145 and all Press Distribution Examples changed;
Appendix H :
Production sites - table updated;
AM.exchange product tables: Product table updated;
Appendix I - updated message texts added
Changes in manual version 5.2.2
Production sites - table updated;
26.Jan.2024
Production sites - table updated;
AM.exchange product tables: Product table updated
02.Oct.2023
Chapter 8.11: Discontinuation of the PWZ franking service
Figures 16, 18, 23 updated
Annex G - Examples 023, 031, 042, 052 and 078: Change in franking from AS /FS
PWZ to FV (AS and PWZ no longer valid from 01.01.2024);
Example 117 removed
Anhanh H :
General code table updated;
Production sites - table updated;
AM.exchange product tables: Product table updated
The PDF form of the product tables with multiple pages can be found here:
Codetables\AM.exchange Products National_multipage.pdf
Codetables\AM.exchange Products International_multipage.pdf
Appendix I - updated message texts added
Appendix J - the document Specification Matrixcode has been updated
Notifications
Guten Tag,
ab sofort ist das AM.exchange - Entwicklerhandbuch in der Version 5.3.3 verfügbar.
Wesentliche Änderung: Anpassung des Beispiels 009 und Aktualisierung der Produkttabellen.
Weitere Änderungen entnehmen Sie bitte der Änderungshistorie.
Beste Grüße
--
Kundenintegrationsservices / Customer Integration Services (CIS)
Abt. 1110 Kundenintegration Post
Deutsche Post AG
SNL IT P&P
64276 Darmstadt
Deutschland
Telefon: +49 228 182-23500
Telefax: +49 228 182-23509
it-csp@deutschepost.de
Servicezeiten: Mo - Fr von 8 - 16 Uhr
(außer an bundeseinheitlichen Feiertagen und Fronleichnam; Heiligabend und Silvester bis 12 Uhr)
Guten Tag,
Ab sofort ist das AM.exchange Entwicklerhandbuch in der Version 5.3.3 verfügbar.
Wesentliche Änderung: Anpassung des Beispiels 009 und Aktualisierung der Produkttabellen.
Weitere Änderungen entnehmen Sie bitte der Änderungshistorie.
Beste Grüße
--
Kundenintegrationsservices / Customer Integration Services (CIS)
Abt. 1110 Kundenintegration Post
Deutsche Post AG
SNL IT P&P
64276 Darmstadt
Deutschland
Telefon: +49 228 182-23500
Telefax: +49 228 182-23509
it-csp@deutschepost.de
Servicezeiten: Mo - Fr von 8 - 16 Uhr
(außer an bundeseinheitlichen Feiertagen und Fronleichnam; Heiligabend und Silvester bis 12 Uhr)