Pracovní postupy API a Advanced Integrated Visibility
Níže uvedený obrázek znázorňuje, jak jsou data události přijímána v případě požadavku rozhraní API a pomocí webhooku 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ě |
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