Fedex Logo

WEBHOOK
ERSTELLEN WEBHOOKS VERWALTEN

Geschäftsregeln und Validierungsprozess


  • Eine einzelne Versandkontonummer kann nicht in mehreren Advanced Integrated Visibility verwendet werden.
  • Folgende Voraussetzungen gelten für die Ziel-URL/den Endpunkt des*der Kund*in:
    • muss ein HTTPS-Host ein
    • muss auf POST-Anfragen antworten und JSON-Payloads analysieren.
    • Max. 200 Zeichen
    • Ihre URL wird blockiert, wenn Folgendes enthalten ist:
      • RFC1918-IP-Bereich
      • fedex.com oder Subdomains
      • IP-Adressen in der URL (einschließlich localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-Sicherheit: Es werden nur HTTPS-Verbindungen unterstützt, die TLS (SSL) 1.2 oder eine höhere Protokollversion verwenden und mit einem Zertifikat von einer gültigen Zertifizierungsstelle (Certificate Authority, CA) konfiguriert sind. Setzen Sie die folgenden IP-Adressen auf Ihre Zulassungsliste, um Updates von FedEx Servern zu erhalten:
    Prod

         Zulassung von: „nat.fxconnect.eastus2.heap-prod.fedex.io“

         über CIDR „20.65.16.22/31“ durch Client
  • Kund*innen erhalten Updates zu Sendungsverfolgungsereignissen mitunter nicht in der richtigen Reihenfolge. Sie müssen daher auf den Zeitstempel des Scanvorgangs achten.
  • Löschen von Kundenkonto/Kundenkonten im FedEx Developer Portal:
    • Benutzer*innen/Kund*innen können ein Kundenkonto NICHT löschen, sofern folgende Bedingungen vorliegen:
      1. Wenn es mit einem aktiven Advanced Integrated Visibility verknüpft ist.
      2. Das Kundenkonto ist verfügbar oder mit einem Projekt verknüpft
      3. Wenn es das einzige Konto in einem Projekt/Advanced Integrated Visibility ist.
        Hinweis: Benutzer*innen/Kund*innen müssen das Kundenkonto zunächst aus dem Projekt/Advanced Integrated Visibility entfernen und es dann aus der Organisation löschen.
    • Benutzer*innen/Kund*innen können ein Kundenkonto löschen, sofern folgende Bedingungen vorliegen:
      1. Das Kundenkonto gehört zur gleichen Organisation
      2. Der*Die Benutzer*in/Kund*in ist Administrator*in

Allgemeine Einschränkungen

  • Alle Sendungen des*der Kund*in, die mit den neunstelligen FedEx Kundennummern von Betriebsgesellschaften – FedEx Express®, FedEx Ground® und FedEx Ground® Economy (früher FedEx SmartPost®) – verknüpft sind, sind unabhängig von Bestimmungsort oder Ursprungsort zulässig (Eingehend, Ausgehend, International, National usw.).
  • Advanced Integrated Visibility-Webhook unterstützt nur neunstellige Kundenkonten auf Unternehmens-/Paketebene. Mit Kundenkonten von Unternehmen können Sendungen erstellt werden, die allen FedEx Betriebsgesellschaften, einschließlich FedEx Express und FedEx Ground, zugeordnet sind.

    • Hinweis: Neunstellige „Nur LTL Fracht“-Kundenkonten werden nicht unterstützt. Wenn Sie ein LTL Fracht-Kundenkonto verwenden möchten, wenden Sie sich an den Kundendienst, um ein LTL Fracht-Kundenkonto auf ein Unternehmenskundenkonto zu portieren.
  • Kund*innen müssen die für Sendungen empfangenen Sendungsverfolgungsereignisse selbst anordnen.
  • Automatisierte E-Mail-Benachrichtigungen werden gesendet, sofern eine Aktivität (Gespeichert/Fehlgeschlagen/Erstellen/Aktualisieren/Abbrechen/Löschen) für den abonnierten Advanced Integrated Visibility-Webhook registriert wird.
  • Übersetzungen:
    • Tracking-Payloads werden in 41 Sprachen (Gebietsschemas) übersetzt.(Demnächst verfügbar)
      Hier finden Sie die Liste der unterstützten Sprachen.
    • Derzeit wird die Übersetzung von Tracking-Payloads nur in Englisch (USA) unterstützt.
    • E-Mail-Benachrichtigungen werden nur in für die US-Region verfügbare Sprachen übersetzt (Gebietsschema: en-US, es-US).

 


Benutzerrollen im FedEx Developer Portal:


Im FedEx Developer Portal können Sie je nach Rolle bestimmte Funktionen nutzen und Vorgänge durchführen.
In unserem Leitfaden zur Organisationsverwaltung erfahren Sie mehr über das FedEx Developer Portal.

Validierungsvorgang für Advanced Integrated Visibility

Was bedeutet MAC/HMAC und wie werden diese in der Validierung verwendet?

Ein Message Authentication Code (MAC) bietet die Möglichkeit, die Integrität von Informationen zu prüfen, die über ein unzuverlässiges Medium übermittelt werden oder darauf gespeichert sind. Dies erfolgt über einen geheimen Schlüssel. MACs werden in der Regel zwischen zwei Parteien mit einem gemeinsamen geheimen Schlüssel verwendet, um die zwischen diesen beiden Parteien übermittelten Informationen zu validieren.

Ein MAC-Mechanismus, der auf kryptografischen Hash-Funktionen basiert, wird HMAC genannt. HMAC kann mit einer beliebigen kryptografischen Hash-Funktion, z. B. SHA256, in Kombination mit einem gemeinsamen geheimen Schlüssel verwendet werden. HMAC wird in RFC 2104 angegeben. FedEx Advanced Integrated Visibility-Webhook verwendet HMAC SHA256.

SHA256 (Sicherheitstoken + Payload) =  base64-kodierte FDX-Signatur als Teil der Payload-Kopfzeile

Beispiel (Pseudocode-Snippet zur Veranschaulichung von HMAC-SHA256-Hashing):

  • Bereiten Sie zunächst den MAC vor, indem Sie den HMAC-SHA256-Algorithmus und das Sicherheitstoken als geheimen Schlüssel verwenden.
  • Schließen Sie den MAC-Vorgang dann ab, indem Sie den von FedEx gesendeten Anfrage-Payload per Hexadezimal-Codierung verschlüsseln.
  • Dieser endgültige Hash muss mit dem Wert der Kopfzeile „fdx-signature“ in der von FedEx gesendeten PUSH-Anfrage übereinstimmen.

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

Hinweis: Der verwendete geheime Schlüssel ist das Sicherheitstoken, das Sie beim Einrichten des Advanced Integrated Visibility oder beim Testen der Advanced Integrated Visibility-URL angeben.

 

Latenzberechnung

 

Die Zeit der Event-Erstellung gibt an, wann ein Event tatsächlich im Netzwerk eingetreten ist.
Solange das Event nicht im System protokolliert ist (gekennzeichnet durch den Zeitstempel der Nachrichtenerstellung), können weder Webhooks noch andere Systeme es verarbeiten oder übermitteln.

Empfehlung

Kunden sollten den Zeitstempel der Nachrichtenerstellung verwenden, um die Latenz zu messen, da dieser am besten darstellt, wann das Ereignis für digitale Systeme verfügbar wurde. Dieser Zeitstempel stimmt am besten mit dem Zeitpunkt der digitalen Updates von FedEx überein und ist in der Regel schneller als – oder weitgehend abgestimmt auf – die auf fedex.com sichtbaren Updates.

 

Validierungsregeln: 

  • Der Advanced Integrated Visibility-Webhook-Name sollte eindeutig sein.
  • Die Bestimmungsort-URL des Advanced Integrated Visibility-Webhooks muss im Standardformat vorliegen.
  • Alle Pflichtfelder zum Erstellen einer Advanced Integrated Visibility-Webhook-URL müssen ausgefüllt sein.
  • Es muss mindestens eine verfügbare FedEx Versandkontonummer verknüpft werden, um einen Advanced Integrated Visibility-Webhook erstellen zu können.
  • Erfolgreiche Validierung:
    • Wurde ein Advanced Integrated Visibility-Webhook erfolgreich erstellt, erhält der*die Kund*in eine Bestätigungsnachricht.

      Beispiel einer Bestätigungsnachricht: <<Advanced Integrated Visibility 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 (und nicht 200 (OK) oder 202 (Accepted) (Akzeptiert)) erhält, ist die Validierung der Advanced Integrated Visibility Webhook-Ziel-URL fehlgeschlagen.

Beispiel für Geschäftsregeln und Validierungsprozess


  • Eine einzelne Versandkontonummer kann nicht in mehreren Advanced Integrated Visibility verwendet werden.
  • Folgende Voraussetzungen gelten für die Ziel-URL/den Endpunkt des*der Kund*in:
    • muss ein HTTPS-Host ein
    • muss auf POST-Anfragen antworten und JSON-Payloads analysieren.
    • Max. 200 Zeichen
    • Ihre URL wird blockiert, wenn Folgendes enthalten ist:
      • RFC1918-IP-Bereich
      • fedex.com oder Subdomains
      • IP-Adressen in der URL (einschließlich localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-Sicherheit: Es werden nur HTTPS-Verbindungen unterstützt, die TLS (SSL) 1.2 oder eine höhere Protokollversion verwenden und mit einem Zertifikat von einer gültigen Zertifizierungsstelle (Certificate Authority, CA) konfiguriert sind. Setzen Sie die folgenden IP-Adressen auf Ihre Zulassungsliste, um Updates von FedEx Servern zu erhalten:
    Prod

         Zulassung von: „nat.fxconnect.eastus2.heap-prod.fedex.io“

         über CIDR „20.65.16.22/31“ durch Client
  • Kund*innen erhalten Updates zu Sendungsverfolgungsereignissen mitunter nicht in der richtigen Reihenfolge. Sie müssen daher auf den Zeitstempel des Scanvorgangs achten.
  • Löschen von Kundenkonto/Kundenkonten im FedEx Developer Portal:
    • Benutzer*innen/Kund*innen können ein Kundenkonto NICHT löschen, sofern folgende Bedingungen vorliegen:
      1. Wenn es mit einem aktiven Advanced Integrated Visibility verknüpft ist.
      2. Das Kundenkonto ist verfügbar oder mit einem Projekt verknüpft
      3. Wenn es das einzige Konto in einem Projekt/Advanced Integrated Visibility ist.
        Hinweis: Benutzer*innen/Kund*innen müssen das Kundenkonto zunächst aus dem Projekt/Advanced Integrated Visibility entfernen und es dann aus der Organisation löschen.
    • Benutzer*innen/Kund*innen können ein Kundenkonto löschen, sofern folgende Bedingungen vorliegen:
      1. Das Kundenkonto gehört zur gleichen Organisation
      2. Der*Die Benutzer*in/Kund*in ist Administrator*in
CLOSE

Response

Copy