Přehled
Webhook Advanced Integrated Visibility umožňuje společnosti FedEx odesílat údaje o sledování zásilek v téměř reálném čase a zabezpečeně na zadanou cílovou URL adresu pro zásilky spojené s jedním nebo více čísly zákaznických účtů FedEx. Pro přístup k této funkci si můžete vytvořit projekt webhooků prostřednictvím portálu FedEx Developer Portal.
Navigační cesty
Na stránku pro vytváření webhooků se můžete dostat jedním z následujících způsobů:
- Přes Moje projekty: Levý navigační panel → záložka Webhooky → +VYTVOŘIT projekt Webhook
- Prostřednictvím katalogu API:
- Levý navigační panel → Katalog API
- Vyhledat nebo filtrovat podle služby Advanced Integrated Visibility
- Přehled → Klikněte na Dokumentace → V konzoli Sandbox klikněte na +VYTVOŘIT PROJEKT
- Dokumenty → Klikněte na možnost + VYTVOŘIT webhook
Kroky vytvoření webhooku
Krok 1: Vyberte typ společnosti
Klikněte na +VYTVOŘIT PROJEKT a z rozbalovací nabídky vyberte typ společnosti:
- Odesílá zásilky se společností FedEx a potřebuje integrovat webhook společnosti FedEx do svého systému.
- Prodává nebo poskytuje softwarové řešení využívající data společnosti FedEx a není certifikovaným poskytovatelem kompaktního řešení FedEx.
- Má certifikaci poskytovatele kompaktního řešení FedEx.
Poznámka: V současnosti není řešení FedEx Advanced Integrated Visibility webhook dostupné pro tuto možnost. Pokud jako člen programu FedEx Compatible chcete získat přístup k rozhraní API Basic Integrated Visibility nebo jiným řešením integrace FedEx, obraťte se na svého správce programu. Pokud nevíte, kdo je správcem vašeho kanálu, obraťte se na správce vaší společnosti.
Poté vyberte jako typ předplatného možnost Předplatné služby Advanced Integrated Visibility podle čísla účtu.
Vytvoření předplatného Advanced Integrated Visibility podle čísla zákaznického účtu
Proces vytváření zahrnuje čtyři klíčové kroky:
Krok 1: Aktivace předplatného služby Advanced Integrated Visibility podle čísla účtu
Tento krok je řízen správcem společnosti FedEx nebo zástupcem společnosti FedEx na žádost externích zákazníků.
- Dokument MNDA: Správce společnosti FedEx nebo zástupce společnosti FedEx získá vzájemnou smlouvu o mlčenlivosti (MNDA) spolu s hromadným seznamem čísel zákaznických účtů první strany / odesílatele.
Poznámka: Při tomto nahrávání jsou povolena duplicitní čísla účtů, která jsou přiřazena k jiným organizacím.
- V příslušných případech bude na úrovni organizace povolena funkce Vlastní ceny.
Poznámka: Tato funkce není součástí July Experience.
Krok 2: + Vytvořit projekt
Na stránce Vybrat produkt(y):
- Klikněte na Advanced Integrated Visibility – číslo zákaznického účtu a poté klikněte na Další.
- Vyberte fakturační účty, přijměte platební podmínky a klikněte na Další.
Je nutné přidat alespoň jeden fakturační účet.
Na stránce Potvrdit údaje:
- Zkontrolujte informace o projektu.
- Přijměte Smluvní podmínky.
- Pokud platí Vlastní ceny, související dokument se zobrazí automaticky.
Při úspěšném vytvoření se zobrazí potvrzovací zpráva:
„Produkt jste úspěšně přidali do složky ‚Můj projekt‘.“
Krok 3: Přehled projektu – Proces aktivace klíče API
- Na stránce Přehled projektu , na kartě Klíče API v sekci Rozhraní API , se produkční stav předplatného zpočátku zobrazí jako „Deaktivováno“.
- Správce společnosti FedEx nebo její zástupce produkt na požádání aktivuje.
- Po povolení bude karta Produkční klíč přístupná a produkční stav se aktualizuje na „Čeká se na potvrzení“.
- Po konečné aktivaci správcem nebo zástupcem společnosti FedEx se produkční stav projeví jako „Povoleno“.
Krok 4: Přehled projektu – Konfigurace webhooku
- Přejděte na stránku Přehled projektu .
- Vyberte kartu Webhooky.
- Klikněte na tlačítko + Konfigurovat webhooky pro zahájení konfigurace webhooků. Budete přesměrováni na kartu Webhooky.
Popisy funkcí
| Název pole | Popis |
|---|---|
| Potvrzení o doručení | Potvrzuje úspěšné doručení zásilky. Zahrnuje: Potvrzení o doručení zásilky ve formě fotografie (PPOD): Poskytuje fotografii zobrazující přesné místo doručení. Podepsané potvrzení o doručení (SPOD): Poskytuje snímek podpisu příjemce, jeho jméno, datum, čas a místo doručení. |
| Předpokládané doručení | Pomáhá příjemcům plánovat poskytnutím následujících údajů: Předpokládané datum doručení (EDD) Odhadovaná doba doručení (EDTW) |
| Události sledování | Umožňuje výběr jedné nebo více kategorií událostí pro příjem oznámení: Odeslat Na cestě Doručení Výjimky při doručení Vlastní možnosti doručení |
| Filtrování podle události | Filtruje odpovědi webhooku tak, aby zahrnovaly: Importní zásilky Exportní zásilky Zásilky třetích stran |
2. Na stránce Zadat údaje zadejte následující informace:
| Název pole | Popis |
|---|---|
| Název projektu webhooku | Jedinečný, neprázdný název pro váš webhookový projekt. Navrhovaný název se vyplní automaticky, lze jej však upravit. Tento název se nesmí opakovat v žádném jiném webhooku. |
| Adresa URL místa určení | Zabezpečený HTTPS koncový bod, na který bude společnost FedEx odesílat údaje o sledování zásilek. Požadavky: Musí být platné a funkční Musí odpovídat standardizované syntaxi Nesmí zahrnovat fedex.com nebo její subdomény Lze opakovaně použít ve více webhoocích Další podrobnosti najdete v části Obchodní pravidla a osvědčené postupy. |
| Token zabezpečení | Sdílený tajný klíč používaný k ověřování a validaci odpovědí webhooků prostřednictvím HMAC. Požadavky: 26–100 znaků Musí obsahovat alespoň 1 velké písmeno, 1 malé písmeno a 1 číslici Lze jej opakovaně použít ve více webhoocích |
| Jazyk datového obsahu (země) | V rozevíracím seznamu vyberte preferovaný jazyk pro překlad dat sledování. |
| Typ sledování | Zvolte způsob doručování dat sledování: Podrobné sledování – Úplná historie událostí Sledování konkrétních událostí – Pouze nejnovější událost |
| E-mailová adresa | Zadejte platnou e-mailovou adresu, na kterou chcete dostávat oznámení. |
| Jazyk e-mailu (země) | Vyberte preferovaný jazyk pro e‑mailová oznámení. Poznámka: Podporovány jsou pouze americké jazykové varianty (např. en-US, es-US). |
Krok 3: Výběr účtů pro zasílání
Na stránce Výběr účtů pro zasílání:
Vyberte jedno nebo více čísel zákaznických účtů FedEx, která přiřadíte ke svému projektu webhooku.
Důležité poznámky:
Zobrazí se pouze zákaznické účty, které ještě nejsou přiřazeny k jiným webhookům.
Abyste mohli pokračovat, musíte přiřadit alespoň jeden zákaznický účet.
Prostřednictvím uživatelského rozhraní webhooku lze přidat maximálně 100 účtů.
Chcete-li propojit více než 100 účtů, použijte rozhraní API webhooků.
Obraťte se na zákaznickou podporu nebo helpdesk společnosti FedEx a požádejte o přístup k rozhraní API.
Krok 4: Potvrdit údaje a vytvořit
Na stránce Potvrdit údaje:
1. Zkontrolujte všechny zadané informace pro projekt webhook.
2. Zaškrtněte políčko pro přijetí smluvních podmínek.
3. Klikněte na Vytvořit a dokončete nastavení webhooku.
Po úspěšném odeslání bude webhook vytvořen se systémem vygenerovaným ID předplatného a bude nastaven do stavu Aktivní.
Pravidla ověřování
Obecné požadavky:
Název webhooku musí být jedinečný.Cílová URL musí odpovídat standardizovanému syntaktickému formátu (zabezpečené HTTPS, bez domény fedex.com nebo jejích subdomén).Všechna povinná pole musí být vyplněna – žádné povinné pole nesmí zůstat prázdné.
K webhooku musí být přiřazeno alespoň jedno platné číslo zákaznického účtu FedEx.
Úspěšné ověření:
Pokud se webhook podaří vytvořit, zákazník obdrží potvrzovací zprávu:
<<Webhook name>> byl úspěšně vytvořen. Změny se mohou projevit až po 10 minutách.
Neúspěšné ověření:
Pokud společnost FedEx obdrží od cílové adresy URL jinou odpověď než HTTP 200 (OK) nebo 202 (Přijato), bude ověření webhooku považováno za neúspěšné.
