Umfang

Die Products API stellt Geschäftskunden und Entwicklern strukturierte Produkt- und Tarifinformationen der Deutschen Post zur Verfügung.    
Sie dient dazu, Versandprozesse in digitale Systeme zu integrieren und unterstützt bei der Ermittlung der passenden Produkte, Preise und Zusatzleistungen. Produktspezifische Zusatzinformationen und ergänzende Hinweise entnehmen Sie bitte den Produktseiten der Deutschen Post: Leistungen und Preise

Ausnahme

Die Products API liefert keine kundenindividuellen Preise.

Hinweis

Sie können auf die Products API (Post & Parcel Germany) mit demselben API-KEY Ihrer App zugreifen, der auch für die Deutsche Post INTERNETMARKE API verwendet wird.

Benutzung der API

Fachliche Hauptfunktionen

1. Bereitstellung von Produktinformationen

• Zugriff auf relevante Postprodukte
• Beschreibung von Leistungsmerkmalen (z. B. Gewicht, Maße)
• Kennzeichnung von Zusatzservices (z. B. Einschreiben)   
   

2. Tarif- und Preisermittlung

• Rückgabe gültiger Preise für das gewählte Produkt
• Berücksichtigung von:  
  • Gewicht  
  • Maße  
  • Zielregion  

Fachliche Datenobjekte

Zugriff erhalten

So registrieren Sie Ihre Products API und erhalten Ihre API-Abonnement-Schlüssel:

Aktuell ist die API ein Service zur Nutzung der Deutsche Post INTERNETMARKE API. 

Authentication

Die Authentifizierung der API basiert auf einem API-Schlüssel. Um Produktinformationen anzufordern, verwenden Sie bitte Ihren persönlichen API-Schlüssel aus dem vorherigen Abschnitt „Get Access“, wie folgt:

Wenn Sie die Deutsche Post INTERNETMARKE (Post & Parcel Germany) API nutzen, haben Sie automatisch Zugriff auf die Produkt API. Ihr API-Schlüssel / Ihre client-Id berechtigt Sie automatisch zur Nutzung der Products API.

curl --request GET \
 --url 'https://api-eu.dhl.com/post/de/information/v1/products?profile=IM-PARTNER' \
 --header 'dhl-api-key: {{YOUR_API_KEY}}'

Für diese spezielle API stellen wir ausschließlich den rPoduktions-Webservice-Endpunkt bereit. Auf diese Weise ist sichergestellt, dass Sie auch im Rahmen Ihrer Entwicklung immer über valide Produktinformationen verfügen.

Hinweis:

Aktuell stellen wir nur das „IM-PARTNER“-Profil für Entwicklungspartner/Nutzer der Internetmarken-API zur Verfügung. Weitere Profile werden wir zu einem späteren Zeitpunkt bereitstellen.

Die API benutzen

Beispiel für die Anforderung einer Produktliste innerhalb des Profils IM-PARTNER (profile=IM-PARTNER) und zur Reduzierung der zurückgegebenen Werte mit dem shortVersion-Parameter (shortVersion=true). Die Short-Response gibt ein definiertes Antwortschema zurück.

Request:

curl --request GET \
 --url 'https://api-eu.dhl.com/post/de/information/v1/products?profile=IM-PARTNER&shortVersion=true' \
 --header 'dhl-api-key: {{YOUR_API_KEY}}'

Response:

{
 "type": "PwsProducts",
 "date": "11.12.25, 13:46",
 "shortSalesProducts": [
   {
     "productid": "355",
     "extProductname": "Streifbandzeitung 501 g bis 1000 g",
     "extProductid": "405",
     "extIdSource": "PPL",
     "transport": "national",
     "startDate": "2023-01-01T00:00:00",
     "endDate": "2025-12-31T23:59:59",
     "grossprice": 2.68,
     "startdatePrice": "2023-01-01T00:00:00",
     "currency": "EUR",
     "minLength": 140,
     "maxLength": 353,
     "minWidth": 90,
     "maxWidth": 250,
     "minHeight": 0,
     "maxHeight": 50,
     "minWeight": 501,
     "maxWeight": 1000
   }, 
   { ... }]
}

Anmerkungen:

•    Die Angabe des gewünschten Profils im Request ist notwendig.
•    Zurzeit wird nur die shortVersion (shortVersion=true) offiziell supportet, die longVersion (shortVersion=false) ist aufgrund der dynamischen Inhalte (produktspezifische Strukturen), Komplexität und Größe der Response aktuell internen Aufrufen vorbehalten. Eine Nutzung innerhalb Ihrer Applikation erfolgt auf eigene Verantwortung.