Typy webhooků Advanced Integrated Visibility
Webhook Advanced Integrated Visibility umožňuje společnosti FedEx odesílat téměř v reálném čase zabezpečená data o událostech sledování na cílovou adresu URL pro zásilky spojené s konkrétními čísly zákaznických účtů FedEx.
Můžete vytvořit projekt webhooku Advanced Integrated Visibility na portálu FedEx Developer Portal a pak jej přiřadit k jednomu nebo více číslům zákaznického účtu FedEx nebo sledovacím číslům zásilky FedEx podle zvoleného typu předplatného.
Přejít na:
PŘEDPLATNÉ ČÍSLA ZÁKAZNICKÉHO ÚČTU ADVANCED INTEGRATED VISIBILITY nebo PŘEDPLATNÉ SLEDOVACÍHO ČÍSLA ADVANCED INTEGRATED VISIBILITY , kde naleznete kroky k vytvoření příslušného webhooku pro Advanced Integrated Visibility.
Přehled služby
FedEx Advanced Integrated Visibility
Zákazníci společnosti FedEx se mohou přihlásit k odběru čísla účtu nebo sledovacího čísla a dostávat téměř v reálném čase informace o událostech týkajících se přepravovaných zásilek, od vytvoření štítku až po potvrzení o doručení zásilek, včetně obrazového potvrzení o doručení.
Typy předplatného
Zákazníci FedEx se mohou přihlásit k odběru služby Advanced Integrated Visibility následujícími způsoby:
- Podle čísla účtu – Přihlaste se k odběru čísla účtu FedEx a dostávejte aktuální informace o zásilkách přidružených k danému účtu.
- Podle sledovacího čísla – Přihlaste se k odběru čísla účtu FedEx a dostávejte aktuální informace o zásilkách přidružených k zadaným sledovacím číslům prostřednictvím koncových bodů rozhraní API.
Poznámka: Předplatná v současné době k fakturaci vyžadují devítimístné číslo účtu FedEx v USA a zákazníkům je účtován měsíční poplatek na základě počtu sledovacích čísel. Pro více informací o cenách služby Advanced Integrated Visibility se podívejte na Průvodce cenami služby Advanced Integrated Visibility.
Pokud se přihlásíte k odběru na základě čísla zákaznického účtu, předplatné v současné době vyžaduje 9místné přepravní účty FedEx se sídlem v USA.
Následující tabulka vám poskytne informace o funkcích předplatného podle čísla zákaznického účtu a předplatného Advanced Integrated Visibility podle sledovacího čísla
| Katalog | Předplatné podle čísla zákaznického účtu | Předplatné podle sledovacího čísla |
|---|---|---|
| Odpověď | Zabezpečená data = osobně identifikovatelné informace, údaje o odesílateli a příjemci, SPOD, dobírka (možnost pohodlného doručení) / odpověď | Anonymní data (zahrnuje zásilky, aktualizace během přepravy s výjimkou PII – osobně identifikovatelné informace/odpovědi) |
| Přidružení | Přidružení číslem účtu = přidružení všech propojených sledovacích čísel najednou | Přidružení sledovacích čísel |
| Vlastnictví | Čísla účtů musí vlastnit sám uživatel | Sledovací čísla uživatel vlastnit nemusí |
| Filtrování | Disponuje možností filtrovat události podle importních nebo exportních zásilek a zásilek třetích stran |
Nelze filtrovat události |
| Integrace | Přidružení čísel účtů probíhá prostřednictvím uživatelského rozhraní | Přidružení sledovacích čísel probíhá prostřednictvím koncového bodu rozhraní API |
| Omezení | Přidat lze až 100 čísel účtů | V rámci jednoho požadavku lze přidat až 1000 sledovacích čísel |
| Vhodný příklad použití | Zákazníci společnosti FedEx – Pokud zákazník vlastní čísla účtů | Zákazníci třetích stran – Pokud má zákazník sledovací čísla patřící zákazníkům společnosti FedEx |
FedEx Integrated Visibility – Porovnání funkcí podle typu předplatného
| Funkce / Datový prvek | Předplatné podle sledovacího čísla | Předplatné podle čísla zákaznického účtu | Poznámky |
|---|---|---|---|
| SPOD (Podepsané potvrzení o doručení) | Není k dispozici | Dostupné (vyžaduje konfiguraci) | Obrázek podpisu ve formátu TIFF zaslaný v datové zprávě |
| PPOD (Obrazové potvrzení o doručení) | Dostupné (vyžaduje konfiguraci) | Dostupné (vyžaduje konfiguraci) | JPEG obrázek místa doručení, kódovaný v base64 |
| PPODA (Obrazové potvrzení o pokusu o doručení) | Dostupné (vyžaduje konfiguraci) | Dostupné (vyžaduje konfiguraci) | Pro pokusy o doručení je poskytnut obrázek ve formátu JPEG |
| GPS souřadnice (gpsPodCoordinates) | Není k dispozici | K dispozici | Skryto v předplatných založených na sledování |
| Kontaktní údaje (jméno, telefon, společnost) | Skryto | K dispozici | U odesílatele, příjemce, původu, cíle, zprostředkovatele atd. |
| Ulice a poštovní směrovací číslo (PSČ) | Skryto | K dispozici | streetLines a postalCode jsou skryty v datech založených na sledování (tracking-based payloads) |
| Čísla účtů | Skryto | K dispozici | Zahrnuje hodnoty billTo účtů odesílatele a příjemce |
| Finanční údaje balíku (např. declaredValue, codAmount) | Skryto | K dispozici | Celní, dobírkové (COD) a deklarované hodnoty jsou skryty |
| Podrobnosti o dotazech a vrácení (kódy dotazů, důvody vrácení) | Skryto | K dispozici | Úplné detaily jsou k dispozici pouze pro odběratele s účtem |
| Údaje o zboží a obsahu | Skryto | K dispozici | Obsahuje kódy součástek, jejich popisy a počty kusů |
| ID zaměstnance (např. pracovník události) | Skryto | Není k dispozici | Z důvodu ochrany soukromí jsou údaje v obou případech skryty |
| Oznámení o událostech a EDD/EDTW (Odhadované datum a časové okno doručení) | K dispozici | K dispozici | Funkce odhadu data a času doručení jsou dostupné v obou případech |
| Zásilka s více balíky (MPS – Multi-Parcel Shipment) | K dispozici | K dispozici | Včetně dalších sledovacích údajů |
| Hodnota důvěryhodnosti odhadovaného doručení a riziková skóre | K dispozici | K dispozici | Pouze jako součást prémiové úrovně |
Skrytá datová pole pro předplatné Advanced Integrated Visibility podle sledovacího čísla
Shrnutí
Když se zákazníci přihlásí k odběru aktualizací sledování zásilek pomocí předplatného služby Advanced Integrated Visibility podle sledovacího čísla místo předplatného služby Advanced Integrated Visibility podle čísla účtu, jsou některá datová pole skryta pro zachování soukromí zákazníků a v souladu s politikami zabezpečení dat.
Toto skrytí zajišťuje, že citlivé informace, jako jsou osobní kontaktní údaje, adresy a finanční hodnoty, jsou přístupné pouze oprávněným osobám. Zákazníkům využívajícím předplatné služby Advanced Integrated Visibility podle sledovacího čísla se u níže uvedených maskovaných polí zobrazí ‘XXXXX’, i když tato data mohou být dostupná prostřednictvím předplatného Advanced Integrated Visibility podle sledovacího čísla.
Důsledky tohoto skrytí zahrnují:
- Omezená viditelnost informací o původu/destinaci a zúčastněných stranách.
- Absence osobních identifikátorů (např. jména, telefonní čísla) a finančních či celních údajů.
- Navržená ochrana důvěrných nebo citlivých informací o zásilkách pro zajištění bezpečnosti a souladu s předpisy.
Zákazníkům, kteří potřebují přístup k těmto skrytým polím pro provozní nebo obchodní účely, se doporučuje přihlásit se prostřednictvím svého čísla účtu.
Datové body, které jsou SKRYTY v předplatném služby Advanced Integrated Visibility podle sledovacího čísla:
Skenovat události
- 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
Informace o odesílateli
- 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
Informace o příjemci
- 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
Místo původu a místo určení
- 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
Podrobnosti o doručení a změně adresy
- 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
Informace o celním brokerovi
- 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
Podrobnosti o zásilce a financích
- trackResult/packageDetail/customsValue/value
- trackResult/packageDetail/declaredValue/value
- trackResult/packageDetail/originalTransportationCharge/value
- trackResult/codDetail/codAmount/value
Informace o komoditě
- trackResult/inquiries/[Array]/categoryCode
- trackResult/inquiries/[Array]/code
- trackResult/inquiries/[Array]/createTime
- trackResult/inquiries/[Array]/statusCode
- trackResult/commodityInfo/[Array]/description
- trackResult/commodityInfo/[Array]/code
Package Contents & Return Reason
- trackResult/contents/[Array]/partNumber
- trackResult/contents/[Array]/partCode
- trackResult/contents/[Array]/description
- trackResult/contents/[Array]/quantity
- trackResult/returnReason/[Array]/code
- trackResult/returnReason/[Array]/description
Fakturační údaje
- trackResult/billToParties/[Array]/billToParty/accountNumber
Výhody pro zákazníky:
- Zvyšte důvěru příjemců pomocí proaktivních oznámení o změnách předpokládaného data doručení a odhadované doby doručení v den doručení.
- Snižte náklady na zákaznickou podporu v případě hovorů týkajících se stavu objednávky a množství námitek k doručení díky obrazovému potvrzení o doručení společnosti FedEx.
- Zlepšete spokojenost zákazníků díky oznámením o stavu zásilek téměř v reálném čase.
- Zvyšte provozní efektivitu tím, že budete téměř v reálném čase dostávat oznámení push s aktuálními informacemi o zásilkách namísto neustálého dotazování na aktuální informace o sledování jednotlivých zásilek.
Funkce a události sledování
Události sledování
Tato funkce umožňuje sledovat stav zásilek a proaktivně upozorňovat zákazníky na různé aktualizace v životním cyklu zásilky. Poskytuje zákazníkům možnost zvolit si konkrétní fázi procesu přepravy nebo události, o kterých chtějí dostávat oznámení/upozornění. K dispozici jsou následující události týkající se přepravy:
- Odeslání: Tato možnost poskytuje oznámení, když dojde k vybrané události týkající se zásilky. Příklad: vytvořen štítek, vyzvednuto atd.
- V přepravě: Tato možnost poskytuje oznámení o událostech týkajících se přepravy zásilky. Příklad: v přepravě, položka uložena na provozovně v místě dodání atd.
- Doručení: Tato možnost poskytuje oznámení o událostech týkajících se doručení zásilky. Příklad: k doručení, doručeno atd.
- Výjimky: Tato možnost poskytuje oznámení o výjimkách při doručení. Příklad: zpoždění při proclení atd.
- Možnosti pohodlného doručení: Tuto možnost vyberte, pokud chcete dostávat oznámení o některých personalizovaných událostech sledování. Příklad: požadavek na uložení na pobočce byl přijat.
Pro více informací o dostupných možnostech událostí zásilek se podívejte na tabulku Kódy stavů a stavy pro události sledování služby Advanced Integrated Visibility.
Potvrzení o doručení
Tato funkce slouží k potvrzení, že objednávka úspěšně dorazila na místo určení. Patří sem:
- Obrazové potvrzení o doručení (PPOD): PPOD umožňuje zákazníkům obdržet fotografii s přesnou polohou zásilky, jakmile je doručena až k nim domů.
Funkce Advanced Integrated Visibility poskytuje obrázky PPOD v datové části JSON ve formátu Base64. Obrázky lze následně převést do formátu JPEG.
Poznámka:
- PPOD je k dispozici v USA, v Kanadě, v Portoriku, v Hongkongu, na Novém Zélandu, ve Spojeném království a v Irsku.
- PPOD je k dispozici pouze pro služby FedEx Ground a FedEx Express a zásilky na adresu místa bydliště.
- PPOD je k dispozici pro způsobilé zásilky, u kterých není vyžadováno SPOD. PPOD a SPOD nejsou k dispozici společně.
- PPOD je k dispozici pro zásilky, u kterých není vyžadován podpis a které nejsou předávány přímo zákazníkovi (např. předávány přímo zákazníkovi při doručení).
- PPOD podporuje obrázky o velikosti 14 000–33 000 bajtů (platí pro obrázky s rozlišením 320×240 pixelů).
- Obrazové potvrzení o pokusu o doručení (PPODA): PPODA umožňuje zákazníkům získat obrázek přesného místa, kam má být zásilka doručena, v případě, že doručení nelze dokončit. Funkce Advanced Integrated Visibility poskytuje obrázky PPOD v datové části JSON ve formátu Base64. Obrázky lze následně převést do formátu JPEG.
- PPODA je k dispozici v USA a Portoriku.
- PPODA je k dispozici pouze pro služby FedEx Ground a FedEx Express a zásilky na adresu místa bydliště / komerční zásilky.
- Obrazové potvrzení PPODA může představovat:
- PPODA fotografie jmenovky na dveřích.
- Fotografie překážky v místě doručení (např. zamčená brána).
- PPOD fotografie balíčků doručených na zastávku.
- PPOD podporuje obrázky o velikosti 14 000–33 000 bajtů (platí pro obrázky s rozlišením 320×240 pixelů)
- Podepsané potvrzení o doručení (SPOD): SPOD umožňuje zákazníkům obdržet obrázek podpisu příjemce a také jeho jméno, datum, čas a místo doručení. Informace SPOD se místo obrázku zobrazí jako pole bajtů. Pole bajtů je kódovaný řetězec base64, který je třeba dekódovat, abyste získali konečný obrázek podpisu ve formátu PNG
- SPOD není dostupný pro předplatné Advanced Integrated Visibility podle sledovacího čísla.
- Velikost obrázku SPOD bude 4000–6000 bajtů (platí pro obrázky s rozlišením 400×95 pixelů).
- Velikost obrázku SPOD bude 5000–8000 bajtů (platí pro obrázky s rozlišením 230×150 pixelů).
- GPS potvrzení o doručení (GPSPOD):
- GPS potvrzení o doručení umožňuje zákazníkům získat zeměpisné souřadnice místa doručení.
Poznámka: GPSPOD je k dispozici ve výchozím nastavení pro předplatné Advanced Integrated Visibility podle čísla účtu.
- GPS potvrzení o doručení umožňuje zákazníkům získat zeměpisné souřadnice místa doručení.
Události týkající se předpokládaného data doručení a odhadované doby doručení
Tato funkce pomáhá příjemcům zásilek s plánováním tím, že poskytuje datum a/nebo časové rozmezí doručení zásilky. Patří sem:
- Předpokládané datum doručení (EDD): Tato možnost poskytuje příjemci předpokládané datum doručení zásilky. Příklad: 20. listopadu 20XX.
- Odhadovaná doba doručení (EDTW): Tato možnost poskytuje příjemci odhadovanou dobu doručení zásilky v den jejího doručení. Příklad: 14:00–18:00.
Filtrování podle události
Tato funkce umožňuje zákazníkům organizovat své projekty webhooků na základě způsobů fakturace zásilek. Dostupné možnosti:
- Příchozí: Tuto možnost vyberte pro zásilky, které vám budou doručeny a za které zaplatíte vy jako příjemce.
- Odchozí: Tuto možnost vyberte pro zásilky, které budou vámi odeslány a za které zaplatíte vy jako odesílatel.
- Třetí strana: Tuto možnost vyberte pro příchozí a odchozí zásilky, které jsou fakturovány vám jako plátci třetí strany.
Poznámka: K fakturaci nebo úhradě zásilek bude použito vaše číslo účtu FedEx. V případě plátce třetí strany nemusíte být odesílatelem ani příjemcem, ale poplatky budou fakturovány na vaše číslo účtu FedEx.
Zásady opakování
Tato funkce brání společnosti FedEx v odesílání dat událostí sledování v případě problému na straně klienta. Společnost FedEx data pozdrží a pokusí se je odeslat znovu během 3 opakovaných pokusů v intervalu 5 minut.
Pokud společnost FedEx neobdrží úspěšnou odpověď během předdefinovaného časového období, zastaví opětovné doručování dané události. Zákazník si však může vyžádat zmeškané události za posledních 7 dnů manuálním tlačítkem „RETRY" na stránce podrobností projektu webhooku Advanced Integrated Visibility.
Další informace o zásadách opakování najdete v části Mechanismus opakování.
Response