Á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:
- A Saját projekteken keresztül: Bal oldali navigációs panel → Webhook lap → +Webhook PROJEKT LÉTREHOZÁSA
- Az API-katalóguson keresztül:
- Bal oldali navigációs panel → API-katalógus
- Keresés vagy szűrés a Speciális integrált láthatóság alapján
- Áttekintés → Kattintson a Dokumentáció menüpontra, majd a Tesztkörnyezeti konzolban 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:
- A FedEx-szel fuvaroztat, és a FedEx-webhookot integrálnia kell a rendszerébe.
- FedEx-adatokat használó szoftvermegoldást értékesít vagy nyújt, és nem tanúsítvánnyal rendelkező FedEx Compatible szolgáltató.
- A FedEx rendszerével kompatibilis, 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 árazá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:
- Kattintson a Speciális integrált láthatóság – Ügyfélszám menüpontra, majd a Tovább lehetőségre.
- 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.
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.
Sikeres létrehozás esetén egy megerősítő üzenet jelenik meg:
„Sikeresen hozzáadta a terméket a 'Saját Projekt'-hez.”
3. lépés: 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.
4. lépés: Projekt áttekintése – Webhook konfigurálása
- Navigáljon a Projekt áttekintése oldalra.
- Válassza ki a Webhookok fület.
- Kattintson a + Webhookok konfigurálása gombra 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. Tartalma: Fényképes kézbesítési igazolás (PPOD): Fénykép, amely a pontos kézbesítési helyet mutatja. Aláírt kézbesítési igazolás (SPOD): A címzett aláírásának, nevének, kézbesítési dátumának, időpontjának és helyszínének képét tartalmazza. |
| Kézbesítés becsült ideje | Segít a címzetteknek a tervezésben az alábbiak megadásával: A kézbesítés becsült dátuma (EDD) A kézbesítés becsült idejének időkerete (EDTW) |
| 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: Fuvarozás Tranzit Kézbesítés Rendkívüli esemény a kézbesítés során Egyéni kézbesítési opciók |
| Eseményalapú szűrés | A webhookválaszokra szűri a következőket: Bejövő küldemények Kimenő küldemények Harmadik féltől származó küldemények |
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: Érvényesnek és működőnek kell lennie Szabványos szintaxist kell követnie Nem tartalmazhatja a fedex.com címet vagy annak aldomainjeit Több webhookon keresztül újra felhasználható További részletekért olvassa el az Üzleti szabályok és bevált gyakorlatok szakaszt. |
| 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: 26–100 karakter Legalább 1 nagybetűt, 1 kisbetűt és 1 számjegyet kell tartalmaznia Több webhookon keresztül is újra felhasználható |
| 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 a nyomonkövetési adatok továbbításának módját: Részletes nyomon követés – Minden eseményelőzmény Eseményspecifikus nyomon követés – Csak a legfrissebb esemény |
| 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.
A webhook felhasználói felületén keresztül legfeljebb 100 ügyfélszám adható hozzá.
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. Tekintse át a webhookprojekthez megadott összes információt.
2. Jelölje be a négyzetet a Használati feltételek elfogadásához.
3. Kattintson a Létrehozás gombra 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-nek szabványos szintaktikai formátumot kell követnie (biztonságos HTTPS, nem a fedex.com cím 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.
