Speciális integrált láthatóság webhook beállítása
Á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 Portalon 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 FedExszel 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ás nem érhető el ehhez az opcióhoz. 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ág ü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
Ez a folyamat négy fő lépésből áll:
- Projekt konfigurálása
- Adja meg a projekt részleteit
- Válasszon fuvarozási ügyfélszámokat
- Erősítse meg a részleteket és fogadja el a feltételeket
1. lépés: Konfigurálja a projektet
A Webhook konfigurálása lapon:
- Számlázási ügyfélszám:
- Tekintse át az alapértelmezett számlázási ügyfélszámot.
- A módosításhoz:
- Kattintson a SZÁMLÁZÁSI ÜGYFÉLSZÁM HOZZÁADÁSA A SZERVEZETHEZ lehetőségre (ha csak egy ügyfélszám létezik), vagy
- Kattintson a MÁSIK SZÁMLÁZÁSI ÜGYFÉLSZÁM KIVÁLASZTÁSA lehetőségre (ha több ügyfélszám is létezik).
Megjegyzés: USA-beli számlázási ügyfélszámra van szükség. Az árképzéssel kapcsolatos részletekért tekintse meg a Speciális integrált láthatóság áttekintése árképzési útmutatóját.
Funkció kiválasztása:
- Válassza ki az engedélyezni kívánt funkciókat, majd kattintson a Tovább gombra.
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. Fényképes kézbesítési igazolás (PPODA): A kézbesítés pontos helyét ábrázoló fényképet biztosít. Aláírt kézbesítési igazolás (SPOD): A címzett aláírásának, nevének, a kézbesítés dátumának, időpontjának és helyének képét biztosítja. |
| Kézbesítés becsült ideje | Segít a címzetteknek a tervezésben a következők megadásával: 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álaszokban szűri a következőket: Bejövő küldemények Kimenő küldemények Harmadik féltől származó küldemények |
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ő. Ez a név nem ismételhető meg más webhookokban. |
| Cél-URL-cím | A biztonságos HTTPS-végpont, ahová a FedEx kü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 webhelyet 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 Tartalmaznia kell legalább 1 nagybetűt, 1 kisbetűt és 1 numerikus karaktert Több webhookon keresztül ú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 – Összes eseményelőzmény Eseményspecifikus nyomon követés – Csak a legfrissebb esemény |
| E-mail-cím | Értesítések fogadásához adjon meg érvényes e-mail-címet. |
| 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 társítani kíván a webhookprojektjéhez.
Fontos megjegyzések:
- Csak azok az ügyfélszámok jelennek meg, amelyek még nincsenek más webhookokhoz társítva.
- A folytatáshoz legalább egy ügyfélszámot társítania kell.
- Legfeljebb 100 ügyfélszám adható hozzá a webhook felhasználói felületén keresztül.
- 100-nál több ü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álathoz, hogy API-hozzáférést kérjen.
4. lépés: A részletek megerősítése és létrehozás
A Részletek megerősítése oldalon:
1. Tekintse át az összes információt, amelyet megadott a webhookprojekthez.
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 a rendszer által generált előfizetési azonosítóval, és aktív státuszba 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 a fedex.com vagy annak aldomainjei).
- Minden kötelező mezőt ki kell tölteni – egyetlen kötelező mezőt sem szabad üresen hagyni.
- Legalább egy érvényes FedEx fuvarozási ügyfélszámot hozzá kell rendelni a webhookhoz.
Sikeres ellenőrzés:
Ha a webhook sikeresen létrejött, az ügyfél visszaigazoló üzenetet kap róla:
<<Webhook name>> 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 200-as (OK) vagy 202-es (Elfogadva) HTTP-választól eltérő választ kap a cél URL-címről, a webhookellenőrzés sikertelennek minősül.
