Fedex Logo

SKAPA EN
WEBHOOK HANTERA WEBHOOKAR

Företagsregler och valideringsprocess


  • Samma försändelsekonto kan inte användas i flera Advanced Integrated Visibility-projekt.
  • Destinations-URL:en/slutpunkten som har skapats av kunden måste
    • vara HTTPs-värd
    • Svara på POST-förfrågningar och analysera JSON-data.
    • Teckenbegränsning på 200 tecken
    • Din URL kommer att blockeras om den innehåller något av följande:
      • Plats för RFC1918 i IP-adressen
      • fedex.com eller någon av dess underdomäner
      • IP-adresser i URL:en (inklusive localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-säkerhet: Endast HTTPS-anslutningar med TLS (SSL) 1.2 eller senare protokollversioner som är konfigurerade med ett certifikat från en giltig certifikatutfärdare stöds. Tillåt IP-adresserna nedan för att ta emot uppdateringar från FedEx servrar utan några störningar:
    Prod

         Klienter kan tillåta: ”nat.fxconnect.eastus2.heap-prod.fedex.io”

         Med hjälp av CIDR ”20.65.16.22/31”
  • Kunder kan ibland få uppdateringarna om spårningshändelser i fel ordning och måste titta på skanningshändelsens tidsstämpel för korrekt ordning.
  • Radera konton i FedEx Developer Portal:
    • Användaren/kunden kan inte ta bort ett konto om följande uppfylls:
      1. Kontot är kopplat till ett aktivt Advanced Integrated Visibility-projekt.
      2. Kontot är tillgängligt eller kopplat till ett projekt.
      3. Det är det enda kontot i ett projekt/Advanced Integrated Visibility.
        Obs! Användaren/kunden måste först ta bort kontot från projektet/Advanced Integrated Visibility och därefter ta bort det från organisationen.
    • Användaren/kunden kan ta bort ett konto om följande uppfylls:
      1. Alla konton måste tillhöra samma organisation.
      2. Användaren/kunden måste vara administratör för att kunna ta bort konton från organisationen.

Vanliga restriktioner

  • Alla kundförsändelser som är kopplade till 9-siffriga FedEx-kontonummer för företag – FedEx Express®, FedEx Ground® och FedEx Ground® Economy (tidigare känt som FedEx SmartPost®) – omfattas oavsett destination eller avsändningsland (inkommande, utgående, internationellt, inrikes osv.).
  • Advanced Integrated Visibility-webhook har endast stöd för 9-siffriga företagskontonummer/paketkompatibla konton. Med företagskonton går det att skapa försändelser som är kopplade till alla FedEx-företag, inklusive FedEx Express och FedEx Ground.

    • Obs! 9-siffriga kontonummer för endast LTL-frakt stöds ej. Om du vill lägga till ett LTL-fraktkonto måste du kontakta kundtjänst för att omvandla ett LTL- till företagskonto.
  • Kunder måste hantera ordningen för de försändelsespårningshändelser som de tar emot.
  • Automatiska e-postmeddelanden skickas när det förekommer aktivitet (sparande/misslyckande/skapande/uppdatering/avbrytande/borttagning) för den Advanced Integrated Visibility-webhook som användaren prenumererar på.
  • Översättningar:
    • Översättningar av spårningsdata stöds på 41 språk (språkvarianter). (kommer snart)
      Klicka här för att visa listan över språk som stöds.
    • För närvarande finns det stöd för översättning av spårningsdata på engelska (USA).
    • Översättningar av e-postmeddelanden är endast tillgängliga för språk som stöds av regioner i USA. (Språkvarianter: en-US, es-US.)

 


Användarroller i FedEx Developer Portal:


I FedEx Developer Portal kan du utföra specifika funktioner baserat på den konfigurerade rollen.
Mer information om FedEx Developer Portal finns i guiden för organisationsadministration.

Valideringsprocess för Advanced Integrated Visibility

Vad är MAC/HMAC och hur används det i valideringsprocessen?

En kod för meddelandeautentisering (MAC) tillhandahåller ett sätt att kontrollera integriteten hos information som överförs eller lagras i ett opålitligt medium, baserat på en hemlig nyckel. Vanligtvis används MAC:ar mellan två parter som delar en hemlig nyckel för att validera information som överförts mellan de två parterna.

En MAC-mekanism som är baserad på kryptografiska hashfunktioner kallas HMAC. HMAC kan användas med vilken kryptografisk hashfunktion som helst, t.ex. SHA256, i kombination med en hemlig delad nyckel. HMAC specificeras i RFC 2104. FedEx Advanced Integrated Visibility-webhook kommer att använda HMAC SHA256.

SHA256 (säkerhetstoken + nyttolast) = Base 64-kodad fdx-signatur som en del av nyttolastrubrik

Exempel (på en del av en pseudokod för att illustrera en HMAC SHA256-hashning):

  • Initiera först MAC med HmacSHA256-algoritmen och sedan säkerhetstoken som den hemliga nyckeln.
  • Slutför sedan MAC-åtgärden genom att hex-koda begärans belastning som skickas av FedEx.
  • Den här sista hashningen bör matcha med värdet på rubriken fdx-signature i pushmeddelandet från FedEx.

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

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

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

Obs! Den hemliga nyckel som används är den säkerhetstoken som du tillhandahåller när du konfigurerar Advanced Integrated Visibility eller testar Advanced Integrated Visibility-URL:en.

 

Beräkning av försening

 

Tidpunkten för händelsen visar när en händelse inträffade i nätverket.
Tills händelsen loggas i systemet (indikeras av meddelandets tidsstämpel) kan varken webbhookar eller andra system bearbeta eller leverera den.

Rekommendation

Kunder bör använda tidsstämpeln för meddelanden för att beräkna försening eftersom den bäst representerar när händelsen blev tillgänglig för digitala system. Tidsstämpeln stämmer bäst överens med tidpunkten för FedEx digitala uppdateringar och är vanligtvis snabbare än – eller i nära takt med – uppdateringar som syns på fedex.com.

 

Valideringsregler: 

  • Namnet för Advanced Integrated Visibility-webhook  måste vara unikt.
  • Advanced Integrated Visibility-webhookens  destinations-URL måste vara i standardiserat syntaktiskt format.
  • Alla fält som krävs för att skapa en Advanced Integrated Visibility-webhook måste vara ifyllda.
  • Minst ett tillgängligt FedEx-försändelsekontonummer måste vara kopplat för att du ska kunna skapa en Advanced Integrated Visibility- webhook .
  • För en lyckad validering:
    • Kunden får ett bekräftelsemeddelande när en Advanced Integrated Visibility-webhook har skapats.

      Exempel på bekräftelsemeddelande: Namn för<<Advanced Integrated Visibility-webhook >>har skapats. Det kan ta upp till tio minuter innan ändringarna tillämpas.

  • För misslyckad validering:
    • Om FedEx tar emot något annat svar än 200 (OK) eller 202 (Accepted) kommer valideringen av Advanced Integrated Visibility-webhookens destinations-URL att betraktas som misslyckad.

Exempel på företagsregler och valideringsprocess


  • Samma försändelsekonto kan inte användas i flera Advanced Integrated Visibility-projekt.
  • Destinations-URL:en/slutpunkten som har skapats av kunden måste
    • vara HTTPs-värd
    • Svara på POST-förfrågningar och analysera JSON-data.
    • Teckenbegränsning på 200 tecken
    • Din URL kommer att blockeras om den innehåller något av följande:
      • Plats för RFC1918 i IP-adressen
      • fedex.com eller någon av dess underdomäner
      • IP-adresser i URL:en (inklusive localhost, 127.0.0.1)

 

  • Advanced Integrated Visibility-säkerhet: Endast HTTPS-anslutningar med TLS (SSL) 1.2 eller senare protokollversioner som är konfigurerade med ett certifikat från en giltig certifikatutfärdare stöds. Tillåt IP-adresserna nedan för att ta emot uppdateringar från FedEx servrar utan några störningar:
    Prod

         Klienter kan tillåta: ”nat.fxconnect.eastus2.heap-prod.fedex.io”

         Med hjälp av CIDR ”20.65.16.22/31”
  • Kunder kan ibland få uppdateringarna om spårningshändelser i fel ordning och måste titta på skanningshändelsens tidsstämpel för korrekt ordning.
  • Radera konton i FedEx Developer Portal:
    • Användaren/kunden kan inte ta bort ett konto om följande uppfylls:
      1. Kontot är kopplat till ett aktivt Advanced Integrated Visibility-projekt.
      2. Kontot är tillgängligt eller kopplat till ett projekt.
      3. Det är det enda kontot i ett projekt/Advanced Integrated Visibility.
        Obs! Användaren/kunden måste först ta bort kontot från projektet/Advanced Integrated Visibility och därefter ta bort det från organisationen.
    • Användaren/kunden kan ta bort ett konto om följande uppfylls:
      1. Alla konton måste tillhöra samma organisation.
      2. Användaren/kunden måste vara administratör för att kunna ta bort konton från organisationen.
CLOSE

Response

Copy