Einrichtung des Advanced Integrated Visibility Webhook
Überblick
Mit dem Advanced Integrated Visibility Webhook kann FedEx in nahezu Echtzeit sichere Tracking-Ereignisdaten zu Sendungen an eine bestimmte Ziel-URL für Sendungen senden, die mit einer oder mehreren FedEx-Kundennummern verknüpft sind. Sie können ein Webhook-Projekt erstellen, um über das FedEx Developer Portal auf diese Funktionalität zuzugreifen.
Navigationspfade
Sie können die Webhook-Erstellungsseite über eine der folgenden Möglichkeiten aufrufen:
- Meine Projekte: Linker Navigationsbereich → Registerkarte Webhooks → +EIN Webhook-PROJEKT ERSTELLEN
Über den API-Katalog:
- Linke Navigationsleiste → API-Katalog
- Nach „Advanced Integrated Visibility“ suchen oder filtern
- Übersicht → Klicken Sie auf Dokumentation → Klicken Sie in der Sandbox-Konsole auf +EIN PROJEKT ERSTELLEN
- Docs → Klicken Sie auf +EINEN Webhook erstellen
Schritte zur Erstellung eines Webhooks
Schritt 1: Unternehmenstyp auswählen
Klicken Sie auf +EIN PROJEKT ERSTELLEN und wählen Sie Ihren Unternehmenstyp aus dem Dropdown-Menü:
- Versand mit FedEx, Integration von FedEx Webhook in das System erforderlich
- Verkauf oder Bereitstellung einer Softwarelösung mit FedEx Daten, kein zertifizierter FedEx Compatible Provider
- Ist ein zertifizierter FedEx Compatible Provider.
Hinweis: Derzeit ist die FedEx Advanced Integrated Visibility Webhook-Lösung für diese Option nicht verfügbar. Wenn Sie als Mitglied des FedEx Compatible-Programms Zugriff auf Basic Integrated Visibility oder andere FedEx Integrationslösungen erhalten möchten, wenden Sie sich an Ihre*n Vertriebsmanager*in. Wenn Sie nicht wissen, wer Ihr*e Vertriebsmanager*in ist, wenden Sie sich an den*die Administrator*in Ihres Unternehmens.
Wählen Sie anschließend Advanced Integrated Visibility-Abonnement auf Basis der Kundennummer als Abonnementtyp aus.
Ein Advanced Integrated Visibility-Abonnement auf Basis der Kundennummer erstellen
Dieser Prozess umfasst vier Hauptschritte:
- Projekt konfigurieren
- Projektdetails eingeben
- Versandkonten auswählen
- Angaben bestätigen und Bedingungen akzeptieren
Schritt 1: Projekt konfigurieren
Schritte auf der Seite Webhook konfigurieren:
- Kundennummer für Rechnungsstellung
- Überprüfen Sie das Standardabrechnungskonto.
- So können Sie es ändern:
- Klicken Sie auf ABRECHNUNGSKONTO ZU IHRER ORGANISATION HINZUFÜGEN (wenn nur ein Konto vorhanden ist) oder
- Klicken Sie auf EIN WEITERES ABRECHNUNGSKONTO AUSWÄHLEN (wenn mehrere Abrechnungskonten vorhanden sind).
Hinweis: Ein US-basiertes Abrechnungskonto ist erforderlich. Für Preisinformationen siehe den Advanced Integrated Visibility Overview Pricing Guide.
Auswahl der Funktionen:
- Wählen Sie die Funktionen, die Sie aktivieren möchten, und klicken Sie dann auf Weiter.
Funktionsbeschreibungen
| Feldname | Beschreibung |
|---|---|
| Zustellnachweis | Bestätigt, dass eine Sendung erfolgreich zugestellt wurde. Zustellnachweis per Foto (PPODA): Stellt ein Foto bereit, das den genauen Zustellort zeigt. Unterschriftsnachweis (SPOD): Stellt ein Bild der Unterschrift und des Namens des Empfängers sowie des Zustelldatums, der Uhrzeit und des Zustellorts bereit. |
| Vorauss. Zustellg. | Hilft Empfängern bei der Planung durch die Bereitstellung von: voraussichtliches Zustelldatum (EDD) voraussichtliches Zustellfenster (EDTW) |
| Sendungsverfolgungsereignisse | Ermöglicht die Auswahl einer oder mehrerer Ereigniskategorien, um Benachrichtigungen zu erhalten: Versand In-Transit Lieferung Zustellausnahme Individuelle Zustelloptionen |
| Ereignisbasierte Filterung | Filtert Webhook-Antworten, um Folgendes einzuschließen: Eingehende Sendungen Ausgehende Sendungen Drittanbieter-Sendungen |
Geben Sie auf der Seite „Details eingeben“ die folgenden Informationen ein:
| Feldname | Beschreibung |
|---|---|
| Webhook-Projektname | Ein eindeutiger, nicht leerer Name für Ihr Webhook-Projekt. Ein vorgeschlagener Name wird automatisch ausgefüllt, kann aber bearbeitet werden. Dieser Name darf in keinem anderen Webhook wiederholt werden. |
| Ziel-URL | Der sichere HTTPS-Endpunkt, an den FedEx Tracking-Ereignisdaten senden wird. Anforderungen: Muss gültig und funktionierend sein Muss einer standardisierten Syntax folgen Dürfen nicht fedex.com oder seine Subdomains enthalten Kann über mehrere Webhooks hinweg wiederverwendet werden Weitere Details finden Sie im Abschnitt „Geschäftsregeln und Best Practices“. |
| Sicherheits-Token | Ein gemeinsamer geheimer Schlüssel zur Authentifizierung und Validierung von Webhook-Antworten mittels HMAC. Anforderungen: 26–100 Zeichen Muss mindestens 1 Großbuchstabe, 1 Kleinbuchstabe und 1 Ziffer enthalten Kann für mehrere Webhooks wiederverwendet werden |
| Payload-Sprache (Land) | Wählen Sie aus der Dropdownliste die bevorzugte Sprache für die Übersetzung Ihrer Tracking-Daten aus. |
| Sendungsverfolgungstyp | Wählen Sie aus, wie die Tracking-Daten übermittelt werden sollen: Detailliertes Tracking – Vollständige Ereignishistorie Ereignisspezifisches Tracking – Nur das letzte Ereignis. |
| E-Mail-Adresse | Geben Sie eine gültige E-Mail-Adresse an, um Benachrichtigungen zu erhalten. |
| E-Mail-Sprache (Land) | Wählen Sie die bevorzugte Sprache für E-Mail-Benachrichtigungen aus. Hinweis: Nur US-Gebietsschemas werden unterstützt (z. B. en-US, es-US). |
Schritt 3: Versandkonten auswählen
Auf der Seite Versandkonten auswählen:
- Wählen Sie eine oder mehrere FedEx-Kontonummern aus, um sie mit Ihrem Webhook-Projekt zu verknüpfen.
Wichtige Hinweise:
- Es werden nur Konten angezeigt, die nicht bereits verknüpft mit anderen Webhooks sind.
- Sie müssen mindestens ein Kundenkonto verknüpfen, um fortzufahren.
- Maximal 100 Konten können über die Webhook-Benutzeroberfläche hinzugefügt werden.
- Um mehr als 100 Konten zu verknüpfen, verwenden Sie die Webhooks-API.
Wenden Sie sich an den FedEx Kundendienst oder das Helpdesk, um API-Zugang anzufordern.
Schritt 4: Details bestätigen und erstellen
Auf der Seite Details bestätigen:
1. Überprüfen Sie alle Informationen, die Sie für das Webhook-Projekt eingegeben haben.
2. Markieren Sie das Kästchen, um die Allgemeinen Geschäftsbedingungen zu akzeptieren.
3. Klicken Sie auf Erstellen, um die Webhook-Einrichtung fertigzustellen.
Nach erfolgreicher Abgabe wird der Webhook mit einer systemgenerierten Abonnement-ID erstellt und auf Aktiv gesetzt.
Validierungsregeln
Allgemeine Anforderungen:
- Der Webhook-Name muss eindeutig sein.
- Die Ziel-URL muss einem standardisierten syntaktischen Format folgen (sicheres HTTPS, kein fedex.com oder dessen Subdomains).
- Alle erforderlichen Felder müssen ausgefüllt werden – kein Pflichtfeld darf leer bleiben.
- Es muss mindestens eine gültige FedEx Versandkontonummer mit dem Webhook verknüpft sein.
Erfolgreiche Validierung:
Wurde der Webhook erfolgreich erstellt, erhält der*die Kund*in eine Bestätigungsnachricht.
<<Webhook-Name>> erfolgreich erstellt. Es kann bis zu 10 Minuten dauern, bis Änderungen in Kraft treten.
Nicht erfolgreiche/fehlgeschlagene Validierung:
Wenn FedEx eine andere Antwort als HTTP 200 (OK) oder 202 (Akzeptiert) von der Ziel-URL erhält, gilt die Webhook-Validierung als fehlgeschlagen.
