KUEHNE+NAGEL

Diese Anleitung beschreibt, wie du im KNITE API Developer Portal eine Application anlegst und die Zugangsdaten erhältst. Ziel ist die Generierung von Client ID und Client Secret.

---

🔐 API-Zugang zur Kuehne+Nagel ESP API einrichten

🧰 Voraussetzungen

• Bevor du beginnst, stelle sicher, dass du:

  • Zugriff auf einen myKN / K+N SSO Account hast

  • Als Customer User im KN ESP angelegt bist

  • Zugriff auf das KNITE API Developer Portal erhältst

  • Weißt, ob du Staging oder Production einrichten möchtest

  ℹ️ Die Authentifizierung erfolgt über OAuth 2.0. Client ID und Client Secret werden über das KNITE Portal generiert.

---

⚙️ Schritt-für-Schritt-Anleitung

1️⃣ SSO-Account erstellen (falls noch nicht vorhanden)

Ein SSO-Account ist Voraussetzung für den Zugriff auf das KNITE Developer Portal.

1. Öffne: https://mykn.kuehne-nagel.com/

2. Klicke auf Sign Up

3. Gib deine E-Mail-Adresse ein und bestätige sie

4. Trage die erforderlichen Profildaten ein

5. Schließe die Registrierung ab

6. Melde dich anschließend im Developer Portal an

2️⃣ KNITE API Developer Portal öffnen

• Production https://portal.api.kuehne-nagel.com/devportal/apis

3️⃣ Application anlegen

Eine „Application“ repräsentiert das System, das später auf die API zugreift.

1. Öffne das Developer Portal

2. Navigiere zu Applications

3. Klicke auf Add New Application

4. Trage die erforderlichen Informationen ein:

   • Application Name

   • Shared Quote for Application Tokens

5. Speichern

4️⃣ Application für die ESP Order Tracking API freischalten

1. Öffne die angelegte Application

2. Navigiere zu Subscriptions

3. Klicke auf Subscribe APIs

4. Wähle die ESP Order Tracking API

5. Bestätige die Subscription

Nach erfolgreicher Freischaltung erscheint die API in der Übersicht der Application.

5️⃣ Client ID & Client Secret generieren

In diesem Schritt werden die Zugangsdaten erzeugt, die wir für die Integration benötigen.

1. Öffne die Application

2. Wähle im linken Menü:

   • {Environment} → {Authentication Method}

3. Scrolle zum unteren Seitenbereich

4. Klicke auf Generate Keys

Nach dem Generieren stehen dir folgende Daten zur Verfügung:

• Client ID

• Client Secret

• Token-Endpoint (nur zur Referenz)

⚠️ Wichtig: Client Secret wird nur einmal vollständig angezeigt – sicher abspeichern!

🔐 Ergebnis: Diese Daten benötigen wir

Für die weitere Integration werden ausschließlich folgende Informationen benötigt:

• Client ID (Consumer Key/API Key)

• Client Secret (Consumer Secret/API Secret)

💡 Hinweis: Der komplette User Guide findet sich auch auf der Website: https://portal.api.kuehne-nagel.com/devportal/apis/24f13980-9857-41ef-a3e5-3cd7844da5d6/documents/6f139ada-ab42-40f4-bed7-d7b0c75717c8