Poskytovatel komplexních služeb 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 vyprší platnost pozvánky, 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 ID uživatele spojeno s jinou organizací, vytvořte 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 fakturační účty.
Další informace o uživatelských rolích uvádějí Pokyny pro správu organizace.
1. Na navigační liště vyberte možnost Vytvoření organizace a připojení k organizaci.
2. Zadejte následující podrobnosti:
- V poli Pracuji pro společnost, která vyberte možnost Prodává nebo poskytuje softwarové řešení využívající technologie FedEx a chce se zaregistrovat jako ověřený poskytovatel komplexních služeb FedEx.
- 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.
- Zadejte oficiální e-mail, který obsahuje doménu společnosti, zemi nebo oblast, kde je společnost registrovaná, a země a oblasti, kde prodáváte nebo distribuujete své softwarové řešení.
3. Vyberte možnost Další.
Podrobnosti můžete později aktualizovat nebo přidávat v části Spravovat organizaci v nabídce.
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.
Poznámka: Použijte své číslo zákaznického účtu; nemůže to být číslo účtu FedEx zákazníka.
2. Vyberte možnost Přidat fakturační účet.
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.
Poznámka: Fakturační adresa se musí shodovat s adresou, kterou jste použili při nastavování zákaznického účtu. Tento zákaznický účet se stane výchozím fakturačním účtem vaší organizace.
4. Vyberte možnost ověření.
- Telefonní hovory jsou dostupné pouze poskytovatelům komplexních služeb v USA a Kanadě.
5. Zadejte obdržený ověřovací kód a vyberte možnost Odeslat.
6. Přečtěte si a přijměte Dohodu společnosti FedEx s poskytovatelem komplexních služeb.
Pozvání uživatelů v roli správce
1. Přejděte do části Spravovat organizaci a vyberte kartu Uživatelé .
2. Vyberte možnost + Přidat uživatele.
3. Zadejte následující podrobnosti:
- Země nebo oblast
- Preferovaný jazyk
4. Vyberte uživatelskou roli (Pozorovatel, Přispěvatel nebo Správce).
5. (Volitelné) Přiřaďte uživatele k projektu.
- Uživatele můžete přiřadit kdykoli na stránce Přehled projektu.
6. 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. Pozvánka má platnost 24 hodin.
Vytvoření projektu
1. Z nabídky přejděte do části Moje projekty a vyberte možnost + Vytvořit projekt.
2. Zadejte Název projektu.
- Doporučený formát názvu je Názevprojektu_názevaplikace. Po dokončení vyberte možnost Další.
3. Vyberte rozhraní API a produkty Advanced Integrated Visibility, které chcete do projektu zahrnou.
- Produkty Advanced Integrated Visibility jsou dostupné pouze poskytovatelům komplexních služeb FedEx se sídlem v USA.
- Pokud vyberete placené produkty, budete požádáni o přiřazení fakturačního účtu k projektu a přijetí požadovaných podmínek.
Přiřazení fakturačního účtu
Poznámka: To je vyžadováno pouze v případě, že vyberete placený produkt.
1. Přiřaďte fakturační účet ze seznamu zákaznických účtů přidaných k organizaci. Fakturační účty musí mít jako zemi uvedeny USA.
2. Přijměte licenční smlouvu FedEx Developer Portal a objednávkový formulář a vyberte možnost Vytvořit.
Konfigurace nástroje Advanced Integrated Visibility v projektu
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 objednávkovém formuláři.
- 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. Podrobnosti 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.
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. 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.
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.
Chcete-li přesunout svá API do produkční fáze, musí být ověřena. Úroveň ověření se u jednotlivých API liší. Než začnete, prostudujte sipož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. Identifikujte testovací případy pro regiony nebo území, kde plánujete řešení nasadit. Podrobnosti najdete v části Základní testovací případy poskytovatele komplexních služeb.
4. Před spuštěním testovacích případů dokončete registrační transakce s použitím testovacích čísel zákaznických účtů.
5. Dokončete všechny požadované testovací případy.
6. Do pracovního listu Product Information Worksheet (PIW) kontaktní údaje a vámi zvolené služby FedEx.
7. Vyplňte krycí list pro ověření poskytovatele komplexních služeb.
Odeslání výstupů
Veškeré požadované materiály zašlete na adresu validationmtp@fedex.com.
1. Připravte si následující výstupy:
- Vyplněný pracovní list PIW (PDF)
- Vyplněný krycí list pro ověření (PDF)
- Transakce registrace koncových zákazníků s vícefaktorovým ověřováním (JSON)
- Naskenované přepravní štítky pro všechny příslušné testovací případy (PDF/PNG)
- Transakce odeslání pro tři formáty přepravních štítků (PDF, PNG a ZPL (JSON)) pro příslušná rozhraní API pro zásilky a ceny
- Snímky obrazovky (PDF) zachycující:
- Řešení pro zákazníky zobrazující služby FedEx a zvláštní zacházení
- Prohlášení o zřeknutí se práv
- Licenční smlouva s koncovým uživatelem (EULA)
- Průběh registrace koncového zákazníka
2. Zkomprimujte všechny soubory do jednoho souboru .zip, abyste se vyhnuli omezením poskytovatelů e-mailu.
3. Pošlete soubor .zip e-mailem týmu ověření.
Osvědčené postupy, jak se vyhnout zpožděním
Chcete-li zkrátit dobu kontroly, dodržujte tyto pokyny:
- 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.
- 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) přiložte přepravní štítek pro každou zásilku.
Hodnocení přepravních štítků
Tým ověření zkontroluje odeslané položky.
- V případě zamítnutí vyřešte zpětnou vazbu a výstupy znovu odešlete.
- V případě schválení obdržíte e-mail s potvrzením. Po schválení budou vaše produkční přihlašovací údaje autorizované pro transakce přepravních štítků.
1. Z nabídky vyberte možnost Moje projekty, poté Název projektu.
2. V části API zkopírujte a bezpečně ulože produkční klíč API a tajný klíč.
Poznámka: Uložte tajný klíč na bezpečné místo, protože se zobrazí pouze jednou. Pokud jej ztratíte, můžete si později vygenerovat nový.
