A Speciális integrált láthatóság webhookok típusai
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 rendeltetési URL-címre az adott FedEx-ügyfélszám(ok)hoz tartozó küldemények esetén.
Létrehozhat egy Speciális integrált láthatóság webhookprojektet a FedEx Developer Portalon, majd összekapcsolhatja egy vagy több FedEx ügyfélszámmal vagy FedEx fuvarlevélszámmal a választott előfizetési típus alapján.
Navigáljon ide:
SPECIÁLIS INTEGRÁLT LÁTHATÓSÁG ÜGYFÉLSZÁM ALAPÚ ELŐFIZETÉS vagy SPECIÁLIS INTEGRÁLT LÁTHATÓSÁG FUVARLEVÉLSZÁM ALAPÚ ELŐFIZETÉS , az adott Speciális integrált láthatóság webhook létrehozásának lépéseinek megtekintéséhez.
A FedEx Speciális integrált láthatóság áttekintése
A FedEx-ügyfelek előfizethetnek egy ügyfélszámra vagy fuvarlevélszámra, hogy szinte valós időben kapják meg a fuvarozás közbeni küldeményeseményeket, a címke létrehozásától a csomagok kézbesítési visszaigazolásáig, beleértve a képes kézbesítési igazolást is.
Előfizetési típusok
A FedEx ügyfelei a következő lehetőségekkel fizethetnek elő a Speciális integrált láthatóságra:
- Ügyfélszám alapú – Regisztráljon egy FedEx-ügyfélszámot, hogy frissítéseket kaphasson az ügyfélfiókhoz tartozó küldeményekről.
- Fuvarlevélszám alapján – Regisztráljon egy FedEx-fuvarlevélszámot, hogy API-végpontokon keresztül aktuális információkat kaphasson a megadott fuvarlevélszámokhoz társított küldeményekről.
Megjegyzés: Az előfizetés kiszámlázásához jelenleg egyesült államokbeli 9 számjegyű FedEx-ügyfélszámra van szükség, és az ügyfeleknek a fuvarlevélszámok darabszáma alapján havi díjat kell fizetniük. A Speciális integrált láthatóság árazásáról bővebben a Speciális integrált láthatóság áttekintése árképzési útmutatójában olvashat.
Ügyfélszámmal történő előfizetés esetén az előfizetésekhez jelenleg 9 számjegyű, amerikai székhelyű fuvarozási FedEx-ügyfélfiókok szükségesek.
Az alábbi táblázatban az ügyfélszám alapú előfizetése és a Speciális integrált láthatóság fuvarlevélszám alapú előfizetése jellemzőiről kaphat információt
| Jellemzők | Ügyfélszám alapú előfizetés | Fuvarlevélszámhoz alapú előfizetés |
|---|---|---|
| Válasz | Biztonságos adatok = Személyazonosításra alkalmas adatok (PII), Feladó és címzett adatai, SPOD CDO-k (Kényelmes kézbesítési opciók)/válaszok | Névtelen adatok (beleértve a küldeményt, a szállítás közbeni frissítéseket, kivéve a PII-adatokat – személyazonosításra alkalmas információk/válaszok) |
| Kapcsolás | Társítás ügyfélszám alapján = Az összes kapcsolódó fuvarlevélszám egyszerre történő társítása | Fuvarlevélszámok társítása |
| Tulajdonos | Az ügyfélszámoknak a felhasználó tulajdonában kell lenniük | A fuvarlevélszámoknak nem kell a felhasználó tulajdonában lenniük |
| Szűrés | Lehetőséget ad az események szűrésére bejövő, kimenő és harmadik féltől származó küldemények szerint |
Nem lehet szűrni az eseményeket |
| Integráció | Az ügyfélszámok társítása a felhasználói felületen keresztül | A fuvarlevélszámok társítása API-végponton keresztül |
| Korlátozás | Akár 100 ügyfélszámot is hozzáadhat | Kérésenként 1000 fuvarlevélszámot adhat hozzá |
| Megfelelő felhasználási eset | Első félnek számító ügyfelek – Ha az ügyfél birtokolja az ügyfélszámokat | Harmadik félnek számító ügyfelek – Ha az ügyfél rendelkezik fuvarlevélszámokkal, amelyek az 1. félnek számító ügyfelekhez tartoznak |
FedEx Integrált láthatóság – Funkciók összehasonlítása előfizetési típusok szerint
| Funkció / adatelem | Fuvarlevélszámhoz alapú előfizetés | Ügyfélszám alapú előfizetés | Megjegyzések |
|---|---|---|---|
| SPOD (Aláírt kézbesítési igazolás) | Nem érhető el | Elérhető (konfiguráció szükséges) | Aláíráskép TIFF formátumban, az adattartalommal kézbesítve |
| PPOD (Képes kézbesítési visszaigazolás) | Elérhető (konfiguráció szükséges) | Elérhető (konfiguráció szükséges) | JPEG-kép a kézbesítési helyről, base64 kódolással |
| PPODA (Kézbesítési kísérlet képes visszaigazolása) | Elérhető (konfiguráció szükséges) | Elérhető (konfiguráció szükséges) | A kézbesítési kísérletekhez JPEG-kép mellékelve |
| GPS-koordináták (gpsPodCoordinates) | Nem érhető el | Rendelkezésre áll | Maszkolva a nyomon követésen alapuló előfizetésekben |
| Kapcsolattartási adatok (név, telefonszám, vállalat) | Maszkolt | Rendelkezésre áll | Feladó, címzett, küldeményfeladási hely, rendeltetési hely, vámbróker stb. esetén |
| Utca és irányítószám | Maszkolt | Rendelkezésre áll | a streetLines és a postalCode maszkolása kerül a nyomon követésen alapuló adattartalmakban |
| Ügyfélszámlaszámok | Maszkolt | Rendelkezésre áll | Tartalmazza a fizető fél, a feladó és a címzett ügyfélszám-értékeit |
| Csomag pénzügyei (pl. declaredValue, codAmount) | Maszkolt | Rendelkezésre áll | A vám, az utánvét és a bejelentett értékek maszkolva |
| Érdeklődés és visszaküldés részletei (Érdeklődési kódok, visszaküldés okai) | Maszkolt | Rendelkezésre áll | A teljes körű adatok csak az ügyfélszám alapú előfizetők számára jelennek meg |
| Árucikk- és tartalmi adatok | Maszkolt | Rendelkezésre áll | Tartalmazza a részkódokat, leírásokat, mennyiségeket |
| Alkalmazotti azonosító (pl. rendezvényszemélyzet) | Maszkolt | Nem érhető el | Mindkét esetben adatvédelmi okokból maszkolva |
| Eseményértesítések és EDD/EDTW | Rendelkezésre áll | Rendelkezésre áll | Kézbesítés becsült dátuma/ideje funkció mindkét esetben támogatott |
| Több csomagból álló küldemény (MPS) | Rendelkezésre áll | Rendelkezésre áll | További nyomonkövetési információkkal |
| Kézbesítés becsült idejének bizalmi és kockázati pontszámai | Rendelkezésre áll | Rendelkezésre áll | Csak a prémium szint részeként |
Maszkolt adatmezők fuvarlevélszám alapú Speciális integrált láthatóság előfizetéséhez
Összegzés
Amikor az ügyfelek a küldeménykövetési frissítésekre a Speciális integrált láthatóság fuvarlevélszám alapú előfizetés helyett a Speciális integrált láthatóság ügyfélszám alapú előfizetés használatával fizetnek elő, bizonyos adatmezők maszkolásra kerülnek az ügyfelek adatainak védelme és az adatbiztonsági irányelveknek való megfelelés érdekében.
Ez a maszkolás biztosítja, hogy az érzékeny információkhoz – például a személyes elérhetőségi adatokhoz, címekhez és pénzügyi értékekhez – csak az arra jogosultak férjenek hozzá. A Speciális integrált láthatóság fuvarlevélszám alapú előfizetést használó ügyfelek az alábbiakban felsorolt maszkolt mezőknél „XXXXX” értéket fognak látni, annak ellenére, hogy ezek az adatok a Speciális integrált láthatóság fuvarlevélszám alapú előfizetésen keresztül elérhetőek lehetnek.
A maszkolás következményei a következők:
- Korlátozott rálátás a küldeményfeladási/rendeltetési hely adataira és az érintett felekre.
- Személyes azonosítók (pl. nevek, telefonszámok) és pénzügyi vagy vámügyi adatok hiánya.
- A jogvédett vagy érzékeny küldeményinformációk kidolgozott védelme a biztonság és a jogszabályi megfelelés érdekében.
Azoknak az ügyfeleknek, akiknek operatív vagy üzleti felhasználási céllal szükségük van ezeknek a maszkolt mezőknek a hozzáférésére, ajánlatos az ügyfélszámukkal előfizetniük.
MASZKOLT adatpontok fuvarlevélszám alapú Speciális integrált láthatóság előfizetésben:
Események beolvasása
- scanEvent/location/locationContactAndAddress/address/streetLines
- scanEvent/location/locationContactAndAddress/contact/phoneNumber
- scanEvent/location/locationContactAndAddress/contact/companyName
- scanEvent/location/locationContactAndAddress/contact/personName
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
- scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName
Feladó adatai
- trackResult/shipperInfo/contactAndAddress/address/postalCode
- trackResult/shipperInfo/contactAndAddress/address/streetLines
- trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
- trackResult/shipperInfo/contactAndAddress/contact/companyName
- trackResult/shipperInfo/contactAndAddress/contact/personName
- trackResult/shipperInfo/account/value
Címzett adatai
- trackResult/recipientInfo/contactAndAddress/address/postalCode
- trackResult/recipientInfo/contactAndAddress/address/streetLines
- trackResult/recipientInfo/account/value
- trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
- trackResult/recipientInfo/contactAndAddress/contact/companyName
- trackResultecipientInfo/contactAndAddress/contact/personName
Küldeményfeladási és rendeltetési hely
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode
Kézbesítési és címmódosítási részletek
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName
Vámbróker adatai
- trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
- trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
- trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
- trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
- trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode
Csomag és pénzügyi részletek
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Érdeklődés és árucikk-információ
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Csomag tartalma és visszaküldés oka
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Számlázási adatok
- trackResult/billToParties/[Array]/billToParty/accountNumber
Ügyfeleket érintő előnyök:
- Növelheti a címzettek bizalmát azzal, hogy proaktív módon értesítést küld a szállítás során a kézbesítés becsült dátumával és az időablak változásaival kapcsolatban.
- Csökkentheti a WISMO-hívások („Hol van a rendelésem?”), valamint a kézbesítéssel kapcsolatos viták ügyfélszolgálati költségeit FedEx képes kézbesítési igazolás felmutatásával.
- Javíthatja az ügyfélélményt a küldemény állapotáról szóló, közel valós idejű értesítések nyújtásával.
- Növelheti a működési hatékonyságot azzal, hogy valós idejű push-értesítéseken keresztül aktuális információkat kap a küldeményekről, ahelyett, hogy folyamatosan le kellene kérdeznie az egyes küldemények aktuális nyomonkövetési állapotát.
Funkciók és nyomonkövetési események
Nyomonkövetési események
Ez a funkció lehetővé teszi a küldemények állapotának nyomon követését, és proaktívan értesíti az ügyfeleket a küldemény életciklusának különböző aktuális információiról. Lehetőséget biztosít az ügyfelek számára, hogy kiválaszthassák, hogy a fuvarozási folyamat mely szakaszáról/mely eseményekről szeretnének értesítést/riasztást kapni. A következő fuvarozási események érhetők el:
- Fuvarozás: Ez az opció akkor küld értesítést, amikor a kiválasztott fuvarozási esemény bekövetkezik. Például: címke létrehozva, csomagfelvétel, stb.
- Tranzitban: Ez az opció értesítést nyújt a küldeménytovábbítási eseményekről. Például: „Tranzitban”, „A tételt a kézbesítési irodában tartják”, stb.
- Kézbesítés: Ez az opció értesítést nyújt a küldeménykézbesítési eseményekről. Például: kiadva kézbesítésre, kézbesítve, stb.
- Rendkívüli események: Ez az opció értesítést küld, ha rendkívüli esemény következik be a kézbesítés során. Például: késedelmes vámkezelés, stb.
- Kényelmes kézbesítési lehetőségek: Válassza ezt a lehetőséget, ha értesítést szeretne kapni bizonyos személyre szabott nyomonkövetési eseményekről. Például: kirendeltségen tartási kérelem elfogadva.
A rendelkezésre álló, küldeményesemény-opciókkal kapcsolatos további információkért tekintse meg a Speciális integrált láthatóság nyomonkövetési eseményei állapotkódjai és állapotai táblázatot.
Kézbesítési igazolás
Ez a funkció azt jelzi, hogy a megrendelés sikeresen megérkezett a rendeltetési helyére. Ide tartozik:
- Képes kézbesítési visszaigazolás (PPOD): A képes kézbesítési igazolás lehetővé teszi az ügyfelek számára, hogy egy fényképet kapjanak, amely megjeleníti a csomag pontos helyét, amint azt a címükre kézbesítették.
A Speciális integrált láthatóság base64 formátumban küldi a képes kézbesítési visszaigazolás képeit a JSON formátumú adattartalomban. Ezt követően a képeket JPEG-formátumba lehet konvertálni.
Megjegyzés:
- A képes kézbesítési igazolás az Amerikai Egyesült Államokban, Kanadában, Puerto Ricóban, Hongkongban, Új-Zélandon, az Egyesült Királyságban és Írországban érhető el.
- A képes kézbesítési igazolás csak a FedEx Ground, a FedEx Express, valamint a lakossági csomagok/cím(ek) esetében érhető el.
- A képes kézbesítési igazolás akkor érhető el a jogosult küldemények esetén, ha aláírt kézbesítési igazolás nem szükséges. A képes kézbesítési igazolás és az aláírt kézbesítési igazolás nem érhető el együtt.
- A képes kézbesítési igazolás elérhető olyan, nem közvetlenül az ügyfélnek átadott kézbesítések esetén, ahol aláírás nem szükséges (pl. közvetlenül az ügyfélnek adják át a kézbesítés során).
- A PPOD 14000 és 33000 bájt közötti képméretet támogat (320 x 240 felbontású képre alkalmazható).
- Fényképes kézbesítési igazolás (PPODA): A PPODA lehetővé teszi az ügyfelek számára, hogy képet kapjanak arról a pontos helyről, ahová a csomag kézbesítendő, abban az esetben, ha a kézbesítést nem lehet teljesíteni. A Speciális integrált láthatóság base64 formátumban küldi a képes kézbesítési visszaigazolás képeit a JSON formátumú adattartalomban. Ezt követően a képeket JPEG-formátumba lehet konvertálni.
- A PPODA az Egyesült Államokban és Puerto Ricóban érhető el.
- A PPODA csak FedEx Ground, FedEx Express és lakossági és kereskedelmi csomagok/cím(ek) esetében érhető el.
- A PPODA-kép a következő lehet:
- PPODA-fénykép az ajtón lévő ajtócímkéről.
- A kézbesítési pont akadályáról készült fénykép (pl. zárt kapu).
- PPOD-kép az állomáson kézbesített csomagokról.
- A PPODA 14000 és 33000 bájt közötti képméretet támogat (320 x 240 felbontás esetén)
- Aláírt kézbesítési igazolás (SPOD): Az aláírt kézbesítési igazolás lehetővé teszi az ügyfelek számára, hogy megkapják a címzett aláírásának képét, valamint a nevét és a kézbesítés dátumát, időpontját és helyét. Az SPOD-információ kép helyett bájttömbként jelenik meg. A bájttömb egy base64-kódolású karakterlánc, amelyet dekódolni kell, hogy megkapjuk a végső aláírásképet PNG-formátumban
- SPOD nem érhető el a fuvarlevélszám alapú Speciális integrált láthatóság előfizetéséhez.
- Az aláírt kézbesítési igazolás képének mérete 4000 és 6000 bájt között lesz (400x95 felbontású képre alkalmazható).
- Az aláírt kézbesítési igazolás képének mérete 5000 és 8000 bájt között lesz (230x150 felbontású képre alkalmazható).
- GPS kézbesítési igazolás (GPSPOD):
- A GPS kézbesítési igazolás lehetővé teszi az ügyfelek számára, hogy megkapják a kézbesítési hely földrajzi koordinátáit.
Megjegyzés: A GPSPOD alapértelmezés szerint elérhető a Speciális integrált láthatóság ügyfélszám alapú előfizetéséhez.
- A GPS kézbesítési igazolás lehetővé teszi az ügyfelek számára, hogy megkapják a kézbesítési hely földrajzi koordinátáit.
Kézbesítés becsült dátumával és kézbesítési idősávval kapcsolatos események
Ez a funkció segít a küldemények címzettjeinek az időbeosztásuk megtervezésében azáltal, hogy megadja a küldemények kézbesítésének dátumát és/vagy időintervallumát. Ide tartozik:
- A kézbesítés becsült dátuma (EDD): Ez az opció megadja a küldemény címzettnek történő kézbesítésének becsült időpontját. Például: 20XX. november 20.
- A kézbesítés becsült idejének időkerete (EDTW): Ez a lehetőség egy becsült időablakot biztosít a címzett számára a küldemény kézbesítésére a tényleges kézbesítés napján. Például: 14:00–18:00.
Eseményalapú szűrés
Ez a funkció lehetővé teszi az ügyfelek számára, hogy webhookprojektjeiket a küldemények számlázási módja alapján szervezzék. Az alábbi lehetőségek érhetők el:
- Bejövő: ezt a lehetőséget olyan küldemények esetén válassza, amelyeket Önnek kézbesítenek, és amelyekért Ön, mint címzett fizet.
- Kimenő: ezt a lehetőséget olyan küldemények esetén válassza, amelyeket Ön, mint feladó fog feladni, és amelyekért Ön, mint feladó fizet.
- Harmadik fél: válassza ezt a lehetőséget olyan bejövő és kimenő küldeményekhez, amelyeket Önnek, mint fizető harmadik félnek számláznak ki.
Megjegyzés: az Ön FedEx ügyfélszámát használják majd a küldemény számlázásához vagy kifizetéséhez. Harmadik fél fizető esetében Ön nem feltétlenül a feladó vagy a címzett, de a díjakat az Ön FedEx ügyfélszámára számlázzák ki.
Újrapróbálási szabályzat
Ez a funkció megakadályozza, hogy a FedEx elküldje a nyomonkövetési eseményadatokat ügyféloldali probléma esetén. A FedEx őrzi az adatokat, és 5 perces időközönként 3 újraküldési kísérletet tesz.
Amennyiben a FedEx nem kap sikeres választ az előre meghatározott időtartamon belül, akkor a FedEx leállítja az adott esemény ismételt kézbesítését. Az ügyfél azonban manuálisan is kérheti az elmúlt 7 napban elmulasztott események lekérdezését a Speciális integrált láthatóság webhookprojek részletei oldalon található „ÚJRAPRÓBÁLKOZÁS” gombbal.
Az újrapróbálási szabályokkal kapcsolatos további információkért olvassa el az Újrapróbálási mechanizmus című szakaszt.
