Odesílatel FedEx
Požadavek
Abyste se mohli přihlásit do portálu FedEx Developer Portal a vytvořit novou organizaci, musíte mít uživatelské ID FedEx.
Připojte se k organizaci své společnosti a spolupracujte se svým týmem. Pokud vaše společnost organizaci nemá, můžete ji vytvořit.
Připojení ke stávající organizaci
1. Vyžádejte si pozvánku
Požádejte správce své organizace, aby vám poslal pozvánku. Máte 24 hodin, abyste ji přijali. Pokud platnost pozvánky vyprší, požádejte správce, aby ji poslal znovu.
2. Přijměte pozvánku
Přihlaste se pomocí svého stávajícího ID uživatele a hesla. Pokud je vaše ID uživatele přidruženo k jiné organizaci, vytvořte si nové ID.
Vytvoření nové organizace
Když vytvoříte organizaci, stanete se jejím správcem. Jako správce můžete zvát uživatele, aby se k organizaci připojili, přidělovat projekty a uživatelské role a spravovat zákaznické účty pro zasílání.
Další informace o uživatelských rolích uvádějí Pokyny pro správu organizace.
1. Přihlaste se na FedEx Developer Portal.
2. Z nabídky vyberte možnost Moje projekty, poté Vytvořit organizaci.
3. Zadejte následující podrobnosti:
- V poli Pracuji pro společnost, která vyberte možnost Odesílá službou FedEx a potřebuje integrovat rozhraní API FedEx do svých aplikací
- Zadejte název společnosti, web společnosti a název organizace, které váš tým rozpozná, například název společnosti, oddělení, divizi nebo region.
4. Vyberte možnost Vytvořit.
Podrobnosti můžete později aktualizovat nebo přidávat v části Spravovat organizaci v nabídce.
Přidání zákaznického účtu pro zasílání
1. Na dlaždici Přidat zákaznické účty vyberte možnost Přidat zákaznické účty pro zasílání. Pokud nemáte účet FedEx, vyberte možnost Vytvořit účet a založte si nový, případně kontaktujte podporu FedEx.
2. Vyberte možnost + Přidat zákaznický účet.
3. Zadejte své číslo účtu FedEx, přezdívku účtu a fakturační adresu, kterou jste použili při zakládání zákaznického účtu.
4. Přijměte licenční smlouvu s koncovým uživatelem nebo ji přepošlete oprávněnému zástupci ve vaší společnosti.
Přidání fakturačního účtu
1. Vyberte kartu Fakturační účty. Pokud nemáte fakturační účet FedEx, vyberte možnost Otevřít fakturační účet a otevřete si nový nebo kontaktujte podporu FedEx.
2. Vyberte možnost Přidat fakturační účet. Fakturační účty musí mít jako zemi uvedeny USA.
3. Zadejte své číslo účtu FedEx, přezdívku zákaznického účtu a fakturační adresu v USA, kterou jste použili při zakládání zákaznického účtu.
4. Přečtěte si a přijměte licenční smlouvu s koncovým uživatelem.
Pozvání uživatelů v roli správce
1. Z nabídky vyberte možnost Spravovat organizaci a poté kartu Uživatelé .
2. Vyberte možnost + Přidat uživatele.
3. Vyberte zemi nebo oblast a preferovaný jazyk, poté zvolte uživatelskou roli: pozorovatel, přispěvatel nebo správce.
4. (Volitelné) Přiřaďte uživatele k projektu. Uživatele můžete přiřadit kdykoli na stránce Přehled projektu.
5. Zadejte e‑mailové adresy uživatelů a klikněte na tlačítko Pozvat. Pozvat můžete až 20 uživatelů najednou, každý e-mail oddělte čárkou. Platnost pozvánek vyprší za 24 hodin.
Vytvoření projektu API
1. Z nabídky vyberte položku Moje projekty, poté kartu API a možnost + Vytvořit projekt API.
2. Zkontrolujte, co od API potřebujete.
3. Vyberte API, které chcete zahrnout do projektu.
4. Vytvořte název projektu a vyberte země, do kterých plánujete odesílat, abyste získali testovací zákaznický účet. Pro vnitrostátní evropské zásilky potřebujete pro každou zemi samostatný testovací zákaznický účet. Země můžete přidávat nebo odebírat později.
5. Vyberte možnost Nastavení v části Oznámení a nastavte předvolby oznámení.
6. Přečtěte si a přijměte smluvní podmínky.
Vytvořte projekt Advanced Integrated Visibility
Požadavky
- Přehled cen: Předplatitelům je účtován měsíční poplatek na základě počtu sledovacích čísel. Více informací o cenách najdete v Průvodci cenami.
- Nastavení zákaznických účtů: Shipment Visibility Webhook vyžaduje fakturační účet vedený v USA a alespoň jeden zákaznický účet pro zasílání, přičemž tyto dva typy účtů se vzájemně vylučují. Přidávat fakturační účty a zákaznické účty pro zasílání na stránce Správa organizace mohou pouze správci.
1. Vytvořte ve své aplikaci nebo platformě adresu URL místa určení pro příjem zpětných volání. Adresa URL musí:
- Používat protokol HTTPS
- Vylučovat IP prostor dle RFC1918, fedex.com včetně subdomén a IP adres, jako jsou localhost nebo 127.0.0.1
2. Vygenerujte bezpečnostní token pro ověření. Token musí:
- Obsahovat 26–100 znaků, alespoň jedno velké písmeno, alespoň jedno malé písmeno a alespoň jednu číslici
3. Z nabídky vyberte možnost Moje projekty a poté vyberte kartu Advanced Integrated Visibility .
4. Vyberte možnost Vytvořit projekt Advanced Integrated Visibility.
5. Vyberte typ uživatele.
- Odesílatel FedEx: Posílá službou FedEx a potřebuje integrovat rozhraní API FedEx do svých aplikací
- Poskytovatel kompaktního řešení FedEx: Je certifikovaný poskytovatel kompaktního řešení FedEx
- Poskytovatel komplexních služeb FedEx: Prodává nebo poskytuje softwarové řešení využívající technologie FedEx a je ověřený poskytovatel komplexních služeb FedEx.
6. Vyberte typ předplatného. Můžete nastavit předplatné událostí podle čísel zákaznických účtů nebo sledovacích čísel.
7. Potvrďte fakturační účet a vyberte požadované funkce, jako je potvrzení o doručení, odhadované datum doručení, události sledování nebo filtrování podle událostí.
8. Zadejte podrobnosti projektu.
- Zadejte jedinečný a rozpoznatelný název projektu.
- Zadejte URL místa určení a bezpečnostní token, který jste vytvořili.
- Zadejte e-mailovou adresu a preferovaný jazyk pro oznámení o aktualizacích a výpadcích služby Advanced Integrated Visibility.
9. Přijměte licenční smlouvu FedEx Developer Portal a objednávkový formulář a vyberte možnost Vytvořit.
Poznámka: V závislosti na zvoleném typu předplatného mohou být potřeba další kroky. Další informace najdete v dokumentaci k webhooku.
Následujícím postupem ověřte integraci API a potvrďte, že aplikace může odesílat a přijímat testovací data.
Získání testovacích přihlašovacích údajů
1. Z nabídky vyberte možnost Moje projekty, poté Název projektu.
2. Na kartě Klíče API v části Testovací klíč vyhledejte testovací přihlašovací údaje.
3. Přihlaste se a stáhněte kolekci API JSON pomocí tlačítka schématu Stáhnout JSON v horní části stránky dokumentace. Projděte si příklady požadavků na koncové body, které vaše integrace využívá.
4. Požádejte o přístupový token OAuth, který se bude používat u každé transakce API.
Poznámka: Token má platnost jednu hodinu a aplikaci můžete nakonfigurovat tak, aby jej před vypršením platnosti obnovila. Podrobnosti najdete v dokumentaci API Authorization.
5. Z nabídky vyberte možnost Katalog API, vyberte API, se kterým chcete pracovat, a vyberte možnost Dokumentace.
6. Z nabídky vyberte koncový bod.
7. Odešlete vzorové požadavky s použitím testovacích přihlašovacích údajů a testovací URL FedEx a poté ověřte, zda odpovědi odpovídají příkladům v dokumentaci. Podrobnosti najdete v Průvodci virtualizací sandboxu.
8. Spusťte testy se službou Advanced Integrated Visibility, abyste vygenerovali vzorová data a ověřili, že aplikace správně zpracovává informace o sledování.
Poznámka: Testování neověřuje vaši URL pro zpětné volání. Podrobnosti najdete v dokumentaci ke službě Advanced Integrated Visibility.
Přesun projektu do produkční fáze
Před spuštěním v reálném prostředí nakonfigurujte produkční fázi. Klíč můžete přejmenovat, přidat další zákaznické účty po spuštění projektu v reálném prostředí a zkontrolovat vybrané číslo zákaznického účtu při tvorbě projektu. Toto číslo zákaznického účtu přesune projekt do produkční fáze.
Poznámka: Projekty Advanced Integrated Visibility založené na čísle zákaznického účtu nevyžadují aktivaci v produkční fázi.
1. Z nabídky vyberte možnost Moje projekty, poté Název projektu.
2. Vyberte kartu Produkční klíč .
3. Produkční přihlašovací údaje bezpečně načtěte a uložte.
- Zkopírujte produkční klíč API a tajný klíč na bezpečné místo.
- Když si vyžádáte produkční klíč, uložte jej na bezpečném místě, protože se zobrazí pouze jednou. Pokud jej ztratíte, můžete si později vygenerovat nový.
4. Po výběru možnosti Další se zobrazí podrobnosti projektu na kartě Produkční klíč.
Chcete-li přidat další zákaznické účty pro zasílání, vyberte možnost Upravit v horní části tabulky zákaznických účtů pro zasílání.
Kroky ověřování se liší podle regionu
Následující kroky platí pouze pro zákazníky v USA a Kanadě. Pokud žijete mimo tyto země, navštivte stránku Ověření rozhraní API, kde najdete podporu.
Ověření API
Některá API FedEx vyžadují pro použití v produkčním prostředí ověření přepravního štítku. Než začnete, prostudujte si požadavky na ověření API .
1. Z nabídky vyberte možnost Moje projekty, poté Název projektu.
2. Na kartě Klíče API v části Testovací klíč vyhledejte testovací přihlašovací údaje.
3. Po dokončení testování přesuňte projekt do produkční fáze na FedEx Developer Portal, abyste mohli zahájit ověřování.
- Když si vyžádáte produkční klíč, uložte jej na bezpečném místě, protože se zobrazí pouze jednou. Pokud jej ztratíte, můžete si později vygenerovat nový.
4. Na krycím listu přepravních štítků uveďte požadované informace, včetně kontaktních údajů, služeb, které plánujete implementovat, čísla zákaznického účtu a produkčního klíče API.
5. Vytvořte testovací přepravní štítky v testovacím prostředí FedEx a poté je odešlete týmu FedEx pro analýzu čárových kódů k posouzení. Vyhodnocení přepravních štítků může trvat tři pracovní dny.
Osvědčené postupy, jak se vyhnout zpožděním:
- Vytiskněte a naskenujte přepravní štítky při minimálně 600 DPI. Neodesílejte soubory generované přímo z rozhraní API.
- U termotiskáren zadejte typ obrazu, který odpovídá dané tiskárně, například ZPLII pro tiskárny Zebra.
- Pro vzorové přepravní štítky používejte platné adresy odesílatelů a příjemců. Vytvářejte přepravní štítky pouze pro služby, které plánujete používat.
- V případě zásilky FedEx na dobírku přiložte přepravní štítek pro vrácení dobírky.
- U služby FedEx International Express® přiložte pomocný (sekundární) letecký náložný list (AWB).
- U vícekusých zásilek (MPS) odesílejte jeden přepravní štítek pro každou zásilku.
Materiály odešlete pomocí jedné z následujících možností:
- Krycí list přepravních štítků zašlete e-mailem jako soubor PDF na adresu: label@fedex.com.
- Zašlete fyzické přepravní štítky na adresu:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017, USA
Poznámka: U fyzických přepravních štítků se ujistěte, že na nich nejsou žádné viditelné vady, jako jsou inkoustové čáry, nebo poškození. Při tisku přepravní štítky nezvětšujte ani nezmenšujte.
6. Tým FedEx pro analýzu čárových kódů vaše podání zkontroluje a přepravní štítky schválí, nebo zamítne. Pokud jsou přepravní štítky zamítnuty, vyřešte zpětnou vazbu a odešlete je znovu.
7. Po schválení vám tým FedEx pro analýzu čárových kódů pošle e-mail po autorizaci produkčních přihlašovacích údajů pro transakce s přepravními štítky.
Poznámka: Schválení platí vždy jen na konkrétní projekt. Každý nový projekt vyžaduje schválení.
8. Nahraďte testovací URL a přihlašovací údaje produkčními URL a přihlašovacími údaji.
9. Spusťte závěrečný produkční test s ukázkovými daty, abyste se ujistili, že vše funguje podle očekávání.
