Fedex Logo

VYTVOŘIT
WEBHOOK SPRAVOVAT WEBHOOKY

Obchodní pravidla a proces ověření


  • Jedno číslo přepravního účtu nelze použít ve více předplatných Advanced Integrated Visibility.
  • Cílová adresa URL / koncový bod vytvořený zákazníkem musí:
    • být hostitelem HTTPS;
    • Reagovat na požadavky POST a analyzovat datový obsah JSON.
    • Max. 200 znaků
    • Vaše adresa URL bude zablokována, pokud zahrnuje:
      • adresní prostor IP adres RFC1918
      • doménu fedex.com nebo některou z jejích subdomén
      • IP adresy v adrese URL (včetně localhost, 127.0.0.1)

 

  • Zabezpečení Advanced Integrated Visibility: Podporována jsou pouze HTTPS připojení používající protokoly TLS (SSL) verze 1.2 nebo vyšší, které jsou nakonfigurovány s certifikátem od platné certifikační autority (CA). Abyste mohli bez přerušení přijímat aktualizace ze serverů společnosti FedEx, přidejte následující IP adresy na seznam povolených:
    Produkční prostředí

         Klienti mohou na seznam povolených IP adres přidat: „nat.fxconnect.eastus2.heap-prod.fedex.io“

         Za použití CIDR „20.65.16.22/31“
  • Zákazníci mohou někdy obdržet aktuální informace o událostech sledování v nesprávném pořadí, a aby zjistili správné pořadí, musí se podívat na časové razítko události skenování.
  • Odstranění účtu (účtů) na portálu FedEx Developer Portal:
    • Uživatel/zákazník nemůže odstranit účty:
      1. Pokud je to spojeno s jakoukoli aktivní službou Advanced Integrated Visibility.
      2. Pokud je účet k dispozici nebo je přidružen k projektu.
      3. Pokud je to jediný účet v rámci projektu nebo služby Advanced Integrated Visibility.
        Poznámka: Uživatel/zákazník musí nejprve odebrat účet z projektu nebo služby Advanced Integrated Visibility a teprve poté jej odstranit z organizace.
    • Uživatel/zákazník může odstranit účty:
      1. Účet musí patřit do stejné organizace.
      2. Uživatel/zákazník musí být administrátorem, aby mohl odstranit účty z organizace.

Běžná omezení

  • Týká se to všech zásilek zákazníků přidružených k devítimístným číslům účtů FedEx provozních společností – FedEx Express®, FedEx Ground® a FedEx Ground® Economy (dříve pod názvem FedEx SmartPost®) – bez ohledu na místo určení nebo původu (importní, exportní, mezinárodní, vnitrostátní atd.).
  • Služba webhooku Advanced Integrated Visibility podporuje pouze devítimístná čísla podnikových zákaznických účtů nebo zákaznických účtů s podporou zásilek. Podnikové zákaznické účty umožňují vytvářet zásilky spojené se všemi provozními společnostmi FedEx, včetně společností FedEx Express a FedEx Ground.

    • Poznámka: Devítimístná čísla účtů pouze LTL Freight nejsou podporována. Chcete‑li přidat účet LTL Freight, musíte se obrátit na zákaznickou podporu s žádostí o převod účtu LTL na podnikový účet.
  • Zákazníci musí spravovat pořadí přijatých událostí sledování zásilek na své straně.
  • Automatická e-mailová upozornění jsou odesílána vždy, když dojde k jakékoli aktivitě (Uloženo/Neúspěšné/Vytvořeno/Aktualizováno/Zrušeno/Smazáno) u přihlášené služby webhooku Advanced Integrated Visibility.
  • Překlady:
    • Překlady datového obsahu sledování jsou podporovány ve 41 jazycích (národních prostředích).(Již brzy)
      Chcete‑li zobrazit seznam podporovaných jazyků, klikněte sem.
    • V současné době je překlad datového obsahu sledování podporován v angličtině (USA).
    • Překlad e‑mailových oznámení je k dispozici pouze pro jazyky podporované regiony USA. (Národní prostředí: en-US, es-US)

 


Role uživatelů na portálu FedEx Developer Portal:


Na portálu FedEx Developer Portal můžete provádět konkrétní funkce na základě nakonfigurované role.
Další informace o portálu FedEx Developer Portal najdete v příručce pro správu organizace.

Proces ověřování služby Advanced Integrated Visibility

Co je MAC/HMAC a jak se používá v procesu ověření?

MAC (Message Authentication Code) umožňuje kontrolovat integritu informací přenášených nebo uložených na nespolehlivém médiu na základě tajného klíče. MAC se obvykle používá mezi dvěma stranami, které sdílejí tajný klíč pro ověřování informací přenášených mezi oběma stranami.

Jako HMAC se označuje mechanismus MAC založený na kryptografických hashovacích funkcích. HMAC lze použít s jakoukoli kryptografickou hashovací funkcí, např. SHA256, v kombinaci se sdíleným tajným klíčem. Specifikace HMAC je uvedena v dokumentu RFC 2104. Webhook FedEx Advanced Integrated Visibility bude používat HMAC SHA256.

SHA256 (token zabezpečení + datový obsah) =  Fdx-signature zakódovaný do báze 64 jako součást hlavičky datového obsahu

Příklad (úryvku pseudokódu pro ilustraci hashování HMAC SHA256):

  • Nejprve se inicializuje MAC s použitím algoritmu HmacSHA256 a tokenu zabezpečení jako tajného klíče.
  • Pak se dokončí operace MAC zakódováním datového obsahu požadavku odeslaného společností FedEx do šestnáctkové soustavy.
  • Tato konečná hodnota hash by měla odpovídat hodnotě hlavičky fdx-signature v požadavku PUSH odeslaném společností FedEx.

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

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

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

Poznámka: Použitý tajný klíč je bezpečnostní token, který poskytnete při nastavování služby Advanced Integrated Visibility nebo při testování URL služby Advanced Integrated Visibility.

 

Výpočet latence

 

Čas vytvoření události představuje, kdy k události v síti skutečně došlo.
Dokud událost není přihlášena do systému (označeno časovým razítkem vytvoření zprávy), webhooky ani žádné jiné systémy ji nemohou zpracovat ani doručit.

Doporučení

Zákazníci by měli k měření latence používat časové razítko vytvoření zprávy, protože nejlépe představuje čas, kdy byla událost zpřístupněna digitálním systémům. Toto časové razítko se nejvíce shoduje s načasováním digitálních aktualizací FedEx a obvykle je rychlejší než aktualizace viditelné na fedex.com – nebo s nimi téměř shodné.

 

Pravidla ověřování: 

  • Název služby webhooku Advanced Integrated Visibility musí být jedinečný.
  • Cílová URL adresa webhooku Advanced Integrated Visibility musí být ve standardizovaném syntaktickém formátu.
  • Žádné z povinných polí pro vytvoření webhooku Advanced Integrated Visibility nesmí být prázdné.
  • Pro vytvoření webhooku Advanced Integrated Visibility musí být přiřazeno alespoň jedno dostupné číslo zákaznického účtu pro zasílání FedEx.
  • V případě úspěšného ověření:
    • Po úspěšném vytvoření webhooku  Advanced Integrated Visibility obdrží zákazník potvrzovací zprávu.

      Ukázka potvrzovací zprávy: Webhook <<Název webhooku Advanced Integrated Visibility>> byl úspěšně vytvořen. Změny se mohou projevit až po 10 minutách.

  • V případě neúspěšného ověření:
    • Pokud systém FedEx obdrží jakoukoli odpověď jinou než 200 (OK) nebo 202 (Přijato), bude ověření cílové adresy URL webhooku Advanced Integrated Visibility považováno za neúspěšné.

Vzorová obchodní pravidla a proces ověření


  • Jedno číslo přepravního účtu nelze použít ve více předplatných Advanced Integrated Visibility.
  • Cílová adresa URL / koncový bod vytvořený zákazníkem musí:
    • být hostitelem HTTPS;
    • Reagovat na požadavky POST a analyzovat datový obsah JSON.
    • Max. 200 znaků
    • Vaše adresa URL bude zablokována, pokud zahrnuje:
      • adresní prostor IP adres RFC1918
      • doménu fedex.com nebo některou z jejích subdomén
      • IP adresy v adrese URL (včetně localhost, 127.0.0.1)

 

  • Zabezpečení Advanced Integrated Visibility: Podporována jsou pouze HTTPS připojení používající protokoly TLS (SSL) verze 1.2 nebo vyšší, které jsou nakonfigurovány s certifikátem od platné certifikační autority (CA). Abyste mohli bez přerušení přijímat aktualizace ze serverů společnosti FedEx, přidejte následující IP adresy na seznam povolených:
    Produkční prostředí

         Klienti mohou na seznam povolených IP adres přidat: „nat.fxconnect.eastus2.heap-prod.fedex.io“

         Za použití CIDR „20.65.16.22/31“
  • Zákazníci mohou někdy obdržet aktuální informace o událostech sledování v nesprávném pořadí, a aby zjistili správné pořadí, musí se podívat na časové razítko události skenování.
  • Odstranění účtu (účtů) na portálu FedEx Developer Portal:
    • Uživatel/zákazník nemůže odstranit účty:
      1. Pokud je to spojeno s jakoukoli aktivní službou Advanced Integrated Visibility.
      2. Pokud je účet k dispozici nebo je přidružen k projektu.
      3. Pokud je to jediný účet v rámci projektu nebo služby Advanced Integrated Visibility.
        Poznámka: Uživatel/zákazník musí nejprve odebrat účet z projektu nebo služby Advanced Integrated Visibility a teprve poté jej odstranit z organizace.
    • Uživatel/zákazník může odstranit účty:
      1. Účet musí patřit do stejné organizace.
      2. Uživatel/zákazník musí být administrátorem, aby mohl odstranit účty z organizace.
CLOSE

Response

Copy