FedEx Web Services auf FedEx RESTful APIs (2025)
Die FedEx Web Services in ihrer Gesamtheit, einschließlich der Versanddienste, werden ab dem 1. Juni 2026 eingestellt. Nach der Abschaltung können die WSDLs nicht mehr verwendet werden. Alle SOAP-basierten FedEx Web Services befinden sich in der Entwicklungsbegrenzung und wurden durch die FedEx RESTful APIs ersetzt.
Einführung
Um die neuen FedEx RESTful APIs nutzen zu können, werden zunächst alle Kontodaten benötigt. Die FedEx APIs unterstützen die OAuth 2.0-Authentifizierungsmethode (mit Inhaber-Token) zur Autorisierung Ihrer API-Abfragen bei FedEx Ressourcen.
OAuth2 Einrichtung
Um OAuth 2.0-Authentifizierungsmethode einzurichten, den Carrier API Konfigurator (HeidlerCarrierAPIConfigurator.exe) öffnen und zu Einstellungen → Web Service Account navigieren.
Wählen Sie den Auftraggeber (den Absender der Sendung) aus, der diesen Account verwenden soll, um über die FedEx REST API zuzugreifen.
Um den angezeigten Datensatz zu bearbeiten, wählen Sie ihn bitte aus und klicken Sie auf den Button „Editieren“ oder doppelklicken Sie einfach auf den Datensatz. Im angezeigten Fenster bitte zunächst „OAuth2 - API-Anmeldeinformationen“ auswählen (siehe 1 im Bild unten). Danach klicken Sie auf den Button „Parent Zugangsdaten“ (siehe 2 im Bild unten), um die API Client-ID und das Client-Secret einzugeben.
Es gibt zwei Varianten, wie Sie sich als Heidler-Kunde mit der neuen FedEx API authentifizieren können:
- Sie verwenden Ihren eigenen FedEx-Account mit einer eigenen API Client-ID und einem eigenen Client-Secret (Parent Credentials)
- Bitte geben Sie Ihre FedEx Account API Client-ID und das Client-Secret ein (siehe Bild unten).
- Sie verwenden Ihren eigenen FedEx-Account, aber die API Client-ID und das API-Client-Secret von Heidler als FedEx Integrator (Parent Credentials) sowie einen über Heidler registrierten Child Key und Child Secret (Child Credentials) für Ihren FedEx-Account.
- In diesem Fall (für die Parent Credentials) wenden Sie sich bitte an unser Support-Team, um die Heidler FedEx Integrator Account API-Client-ID und das Client-Secret einzugeben (siehe Bild oben).
- Falls Sie bereits Child Credentials besitzen, geben Sie die Werte bitte in die Felder „Child Key“ und „Child Secret“ ein. Wenn Sie noch keine Child Credentials haben, folgen Sie bitte den Anweisungen im Abschnitt Child Credentials Registrierung.
Child Credentials Registrierung
Um Child Credentials zu registrieren, benötigen Sie einen gültigen FedEx Account sowie die FedEx Integrator API Client-ID und das Client Secret (Parent Credentials) von Heidler.
Bitte navigieren Sie wie beschrieben in der OAuth2 Einrichtung zu den FedEx Frachtführer Account-Einstellungen. Klicken Sie auf den Button „Registrieren“. Blättern Sie die FedEx EULA (Endbenutzer-Lizenzvereinbarung) mit Hilfe des „Nächste Seite“-Buttons durch (siehe 1 im Bild unten), bis der Button ausgegraut ist und Sie auf der letzten Seite angekommen sind. Der Button „Ich akzeptiere“ wird aktiviert, sobald Sie die Lesebestätigungs-Checkbox („Ich habe die Bedingungen des FedEx-Endbenutzer-Lizenzvertrags (EULA) gelesen“) angehakt haben (siehe 2 im Bild unten). Klicken Sie auf den Button „Ich akzeptiere“ (siehe 3 im Bild unten), um den Registrierungsprozess zu starten.
Als ersten Schritt wird die Rechnungsadresse Ihres FedEx-Accounts geprüft. Wählen Sie dafür zunächst die Umgebung aus (siehe 1 im Bild unten), für die Ihr FedEx-Account angelegt ist, z. B. PROD oder TEST. Anschließend tragen Sie Ihre Rechnungsadresse unter „Kundeninformationen“ ein. Klicken Sie danach auf den Button „OK“ (siehe 2 im Bild unten).
