Áttekintés
A Speciális integrált láthatóság webhook lehetővé teszi a FedEx számára, hogy közel valós idejű, biztonságos nyomonkövetési eseményadatokat küldjön egy megadott cél URL-címre az egy vagy több FedEx-ügyfélszámhoz tartozó küldemények esetében. Létrehozhat egy webhookprojektet, hogy elérje ezt a funkciót a FedEx Developer Portal keresztül.
Navigációs útvonalak
A webhook létrehozási oldalát az alábbiak egyikével érheti el:
1. A Saját projekteken keresztül:
- Bal oldali navigációs panel → Webhookok fül → +Webhook PROJEKT LÉTREHOZÁSA
2. API-katalóguson keresztül:
Bal oldali navigációs panel → API-katalógus
Keresés vagy szűrés Speciális integrált láthatóság alapján
Válasszon:
- Áttekintés → Kattintson a Dokumentáció menüpontra, majd a Tesztkonzolban kattintson a +PROJEKT LÉTREHOZÁSA lehetőségre
- Dokumentumok > Kattintson a +Webhook LÉTREHOZÁSA lehetőségre
Webhook létrehozásának lépései
1. lépés: Vállalattípus kiválasztása
Kattintson a +PROJEKT LÉTREHOZÁSA gombra , és válassza ki a vállalat típusát a legördülő menüből:
1. A FedEx-szel fuvaroztat, és a FedEx-webhookot integrálnia kell a rendszerébe.
2. FedEx-adatokat használó szoftvermegoldást értékesít vagy nyújt, és nem tanúsítvánnyal rendelkező FedEx Compatible szolgáltató.
3. FedEx Compatible tanúsítvánnyal rendelkező szolgáltató.
Megjegyzés: Jelenleg a FedEx Speciális integrált láthatóság webhookmegoldása nem érhető el ehhez a lehetőséghez. A FedEx Compatible program tagjaként, ha szeretne hozzáférni az Alapvető integrált láthatósághoz vagy a FedEx más integrációs megoldásaihoz, kérjük, forduljon a csatornakezelőjéhez. Amennyiben nem tudja, ki a csatornakezelője, forduljon a vállalati rendszergazdájához.
Ezután válassza a Speciális integrált láthatósági ügyfélszám alapú előfizetés lehetőséget előfizetési típusként.
Speciális integrált láthatóság ügyfélszám alapú előfizetése létrehozása
A létrehozási folyamat négy fő lépésből áll:
1. lépés: Speciális integrált láthatóság ügyfélszám alapú előfizetés engedélyezése
Ezt a lépést egy FedEx-rendszergazda vagy egy FedEx-képviselő intézi harmadik fél ügyfelek kérésére.
- MNDA-dokumentum: A FedEx-rendszergazda vagy a FedEx-képviselő átveszi a Kölcsönös titoktartási megállapodást (MNDA) az első fél/szállító ügyfélszámainak listájával együtt.
Megjegyzés: A feltöltés során más szervezetekhez tartozó duplikált ügyfélszámok megengedettek.
- Adott esetben az Egyéni árképzés szervezeti szinten lesz engedélyezve.
Megjegyzés: Ez a funkció nem része a júliusi verziónak.
2. lépés: + Projekt létrehozása
A Termék(ek) kiválasztása oldalon:
1. Kattintson a Speciális integrált láthatóság – Ügyfélszám menüpontra, majd a Tovább lehetőségre.
2. Válassza ki a számlázási ügyfélszámokat, fogadja el a fizetési feltételeket, majd kattintson a Tovább gombra.
Legalább egy számlázási ügyfélszámot hozzá kell adni.
3. A Részletek megerősítése oldalon:
- A projektinformációk áttekintése.
- Fogadja el a Használati feltételeket.
- Ha Egyéni árképzés alkalmazandó, a kapcsolódó dokumentum automatikusan megjelenik.
4. Sikeres létrehozás esetén egy megerősítő üzenet jelenik meg:
„Sikeresen hozzáadta a terméket a 'Saját Projekthe'.”
5. Projekt áttekintése – API-kulcs aktiválási folyamata
- A Projekt áttekintése oldalon az API-kulcsok fül alatt az API-k szakaszban az előfizetés élesítési állapota kezdetben „Letiltva” lesz.
- Kérésre egy FedEx-rendszergazda vagy képviselő aktiválja a terméket.
- Az engedélyezést követően az Élesítési kulcs fül elérhetővé válik, és az élesítési állapot „Megerősítésre vár” értékre frissül.
- A FedEx-rendszergazda vagy -képviselő általi végső aktiválás után az élesítési állapot „Engedélyezve” lesz.
3. lépés: Projekt áttekintése – Webhook konfigurálása
1. Navigáljon a Projekt áttekintése oldalra.
2. Válassza ki a Webhookok fület.
3. Kattintson a + Webhookok konfigurálása lehetőségre a webhook konfigurálásának megkezdéséhez. A rendszer átirányítja Önt a Webhookok fülre
Funkciók leírása
| Mezőnév | Leírás |
|---|---|
| Kézbesítési igazolás | Megerősíti, hogy a küldeményt sikeresen kézbesítették. A következőket tartalmazza:
|
| Kézbesítés becsült ideje | Segíti a címzetteket a tervezésben a következőkkel:
|
| Nyomonkövetési események | Lehetővé teszi egy vagy több eseménykategória kiválasztását az értesítések fogadásához:
|
| Eseményalapú szűrés | A webhook válaszait a következőkre szűri:
|
2. A Részletek megadása oldalon adja meg a következő információkat:
| Mezőnév | Leírás |
|---|---|
| Webhookprojekt neve | Egy egyedi, nem üres név az Ön webhookprojektjéhez. A javasolt név automatikusan kitöltésre kerül, de szerkeszthető marad. Ezt a nevet nem szabad megismételni semmilyen más webhookban. |
| Cél-URL-cím | A biztonságos HTTPS-végpont, ahová a FedEx elküldi a nyomonkövetési eseményadatokat. Követelmények:
|
| Biztonsági token | Egy megosztott titkos kód, amely a webhookválaszok HMAC-en keresztüli hitelesítésére és érvényesítésére szolgál. Követelmények:
|
| Adattartalom nyelve (ország) | Válassza ki a legördülő listából, melyik nyelvre szeretné lefordítani a nyomonkövetési adatokat. |
| Nyomonkövetési típus | Válassza ki, hogyan szeretné kézbesíteni a nyomonkövetési adatokat:
|
| E-mail-cím | Adjon meg érvényes e-mail-címet az értesítések fogadásához. |
| Az e-mail nyelve (ország) | Válassza ki az e-mailes értesítések kívánt nyelvét. Megjegyzés: Kizárólag az egyesült államokbeli területi értékek támogatottak (pl. en-US, es-US). |
3. lépés: Válasszon fuvarozási ügyfélszámokat
A Fuvarozási ügyfélszámok kiválasztása oldalon:
- Válasszon ki egy vagy több FedEx-ügyfélszámot, amelyet a webhookprojektjéhez kíván társítani.
Fontos megjegyzések:
- Csak azok az ügyfélszámok jelennek meg, amelyeket még nem társítottak más webhookokhoz.
- Legalább egy ügyfélszámot társítania kell a folytatáshoz.
- Legfeljebb 100 ügyfélszám adható hozzá a webhook felhasználói felületén keresztül.
- Több mint 100 ügyfélszám társításához használja a webhooks API-t.
Lépjen kapcsolatba a FedEx ügyfélszolgálatával vagy a telefonos ügyfélszolgálattal, hogy API-hozzáférést kérjen.
4. lépés: A részletek megerősítése és létrehozása
A Részletek megerősítése oldalon:
1. Nézze át az összes információt, amit a webhookprojekthez adott.
2. Jelölje be a négyzetet a Használati feltételek elfogadadásához.
3. Kattintson a Létrehozás lehetőségre a webhook beállításának véglegesítéséhez.
Sikeres beküldés esetén a webhook létrejön egy rendszer által generált előfizetés-azonosítóval, és Aktív állapotba kerül.
Ellenőrzési szabályok:
Általános követelmények:
- A webhook nevének egyedinek kell lennie.
- A cél URL-címnek szabványos szintaktikai formátumot kell követnie (biztonságos HTTPS, nem fedex.com vagy annak aldomainjei).
- Minden kötelező mezőt ki kell tölteni – egyetlen kötelező mező sem maradhat üresen.
- Legalább egy érvényes FedEx fuvarozási ügyfélszámot kell társítani a webhookhoz.
Sikeres ellenőrzés:
Ha a webhook sikeresen létrejön, az ügyfél visszaigazoló üzenetet kap róla:
<<Webhook neve>> sikeresen létrehozva. A módosítások életbe lépése akár 10 percet is igénybe vehet.
Sikertelen/meghiúsult ellenőrzés:
Ha a FedEx a cél URL-címtől a HTTP 200 (OK) vagy 202 (Elfogadva) értéktől eltérő választ kap, a webhook érvényesítése sikertelennek minősül.
