Začínáme

Portál FedEx Developer Portal nabízí sadu aplikačních programových rozhraní (API) pro integraci společnosti FedEx do vašich aplikací. Tyto pokyny vám pomohou nastavit organizaci, vytvořit projekt, otestovat integraci, přesunout projekt do produkční fáze a v některých případech ověřit rozhraní API.

Typy uživatelů:

FedEx nabízí integrační služby třem typům uživatelů: odesílatelům FedEx, ověřeným softwarovým řešením (poskytovatelům kompaktního řešení FedEx) a ověřeným poskytovatelům komplexních služeb FedEx.

Odesílatel FedEx:

Společnost, která využívá přepravu přes FedEx a potřebuje integrovat FedEx API do svých vlastních aplikací.

Poskytovatel řešení nebo služeb:

Společnost, která potřebuje integrovat FedEx API za účelem vytvoření řešení, aplikace nebo pluginu, které lze prodávat a/nebo distribuovat externí organizaci, která využívá služby společnosti FedEx.

Poskytovatel kompaktního řešení FedEx: Ověřená společnost se smluvní dohodou prostřednictvím programu FedEx Compatible.
Poskytovatel komplexních služeb FedEx: Ověřená společnost se smluvní dohodou v rámci programu FedEx Integrator Program.

Níže vyberte možnost, která nejlépe vystihuje vaši společnost. Bez ohledu na to, jaký typ uživatele jste, je pro vás připraven průvodní program.

Začínáme.

Which of the following best describes your business?

Select user

EXPAND ALL

1 Vytvoření nebo připojení k organizaci

Pokud vaše společnost nemá organizaci, vytvořte ji. V opačném případě se připojte ke stávající organizaci.

Vytvoření nové organizace

Na navigační liště klikněte na možnost Vytvořit nebo se připojit k organizaci.

Poznámka: Jako tvůrce jste automaticky označeni jako správce organizace.

Správci mohou:

pozvat uživatele, aby se připojili,

přidělovat role uživatelů (např. přispěvatel, pozorovatel) a projekty,

spravovat účty pro zasílání.

Další informace o těchto rolích naleznete v našich Pokynech pro správu organizace.

Pokud jde o typ společnosti, vyberte možnost „Prodává nebo poskytuje softwarové řešení využívající technologie společnosti FedEx a je ověřeným poskytovatelem komplexních služeb FedEx.“

Zadejte název společnosti, adresu URL webových stránek a jedinečný název organizace. Název organizace se může shodovat s názvem vaší společnosti nebo může představovat konkrétní skupinu (oddělení, divize, region, sídlo). Tyto informace jsou nezbytné k ověření vaší žádosti.

Poznámka: Vyberte název organizace, který všichni ostatní uživatelé rozpoznají (např. název společnosti, oddělení, region, sídlo).

Zadejte sídlo vaší společnosti a kde bude vaše softwarové řešení prodáváno nebo distribuováno.

Přidejte fakturační účet a ověřte zákaznický účet

Poznámka: Jako poskytovatel přepravy a logistiky v rámci programu FedEx Integrator Program musíte používat vlastní číslo zákaznického účtu. Nemůžete použít účet FedEx zákazníka.

Zadejte své číslo účtu FedEx. Pokud nemáte existující účet FedEx, otevřete si ho na fedex.com nebo kontaktujte zástupce podpory FedEx .

Zadejte přezdívku účtu a fakturační adresu spojenou se zákaznickým účtem. Vyberte možnost Další.

Poznámka: Fakturační adresa se musí shodovat s našimi záznamy pro tento zákaznický účet. Toto bude výchozí fakturační účet vaší organizace.

Pokud chcete dokončit vytvoření organizace, musíte ověřit svůj zákaznický účet. Vyberte možnost ověření (telefon, který je k dispozici poskytovateli komplexních služeb pouze v USA a Kanadě, e-mail, textová zpráva) a vyberte možnost Další.

Po obdržení zadejte ověřovací kód a vyberte možnost Odeslat.

Přijmout podmínky

Přečtěte si Globální smlouvu s poskytovatelem komplexních služeb a příručku k programu. Zaškrtnutím políček potvrďte, že podmínky přijímáte, a poté vyberte možnost Přijmout.

Zobrazí se potvrzovací obrazovka. V případě potřeby klikněte na možnost Spravovat organizaci a upravte podrobnosti.

Pozvat uživatele

Poznámka: Pozvat uživatele mohou pouze správci.

Vyberte možnost Spravovat organizaci v levém navigačním panelu.

Přejděte na kartu Uživatelé a vyberte možnost Přidat uživatele.

Vyplňte formulář a přiřaďte příslušnou roli novému uživateli/uživatelům: pozorovatel, přispěvatel anebo správce.

Další informace o rolích uživatelů naleznete v Pokynech pro správu organizace.

Přiřaďte uživatele k projektu/projektům (je-li to relevantní) v rozevírací nabídce projektů.

Zadejte e-mailové adresy jednotlivých uživatelů a vyberte možnost Pozvat.

Připojení k existující organizaci

Požádejte o pozvánku: Požádejte správce vaší organizace, aby vám poslal pozvánku. Máte 24 hodin na to, abyste ji přijali, než vyprší. V případě potřeby požádejte správce o opětovné odeslání.

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 již propojeno s jinou organizací, musíte si vytvořit nové.

Vytvoření organizace

Připojte se k existující organizaci

Krok 1: Požádejte správce vaší organizace, aby vám poslal pozvánku.

Pokud vaše společnost již organizaci vytvořila, požádejte správce organizace, aby vás do ní pozval. Pozvánka má platnost 24 hodin. Pokud to v tomto časovém intervalu nestihnete, můžete kdykoli požádat o opětovné zaslání pozvánky.

Krok 2: Přijměte pozvánku.

Chcete‑li pozvánku přijmout, musíte se buď přihlásit pomocí svého stávajícího uživatelského ID a hesla, nebo vytvořit nové, pokud je vaše stávající uživatelské ID již k nějaké organizaci přidruženo.

2 Vytvoření projektu

Vytvořit projekt API

Na stránce Moje projekty otevřete kartu Rozhraní API. Klikněte na tlačítko Vytvořit projekt rozhraní API.

Krok 1: Vyberte rozhraní API, která chcete zahrnout do svého projektu

Zkontrolovat kvóty a limity transakčních sazeb rozhraní API a projít si podrobnosti o ověření rozhraní API.

Krok 2: Konfigurace podrobností o projektu

Dejte svému projektu identifikovatelný název, který je v rámci vaší organizace jedinečný.
Vyberte země, v rámci kterých chcete zasílat zásilky, abychom vám mohli přiřadit testovací účet pro zasílání. Chcete‑li odesílání zásilek testovat vnitrostátně v rámci jedné z evropských zemí, musíte mít pro každou zemi samostatný testovací účet. Země můžete kdykoli přidat/odebrat.
Chcete‑li si nechat zasílat oznámení o nejnovějších aktualizacích rozhraní API a informace související s výpadky, nastavte si předvolby oznámení.

Krok 3: Přečtěte si a přijměte podmínky, včetně licenční smlouvy FedEx Developer Portal

Po přijetí podmínek a kliknutí na tlačítko „Vytvořit“ se zobrazí obrazovka s potvrzením. V rámci nového projektu si pak můžete prohlédnout své testovací pověření.

Vytvoření projektu webhooku

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í účtů: Webhook Advanced Integrated Visibility vyžaduje fakturační účet se sídlem v USA a alespoň jeden přepravní účet, přičemž tyto dva typy účtů se vzájemně vylučují. Pouze správci mohou přidávat fakturační a přepravní účty na stránce Správa organizace.

Vytvoření platné adresy URL (pro zpětné volání) v cílové aplikaci nebo platformě

Vaše cílová adresa URL bude sloužit k přijímání ověřovacích kódů a zpráv, jakož i oznámení o datovém obsahu webhooku společnosti FedEx. Pro zajištění bezpečnosti musí vaše adresa URL používat protokol HTTPS. Vaše adresa URL bude zablokována, pokud zahrnuje:

adresní prostor IP adres RFC1918
doménu fedex.com nebo některou z jejích subdomén
IP adresy v adrese URL (včetně localhost, 127.0.0.1)

Vygenerování tokenu zabezpečení

Tento token zabezpečení lze použít jako tajný klíč k ověřování a validaci informací přenášených mezi vaší organizací a společností FedEx. Váš token zabezpečení musí obsahovat:

Minimální délka 26 znaků a maximální délka 100 znaků
1 velké písmeno
1 malé písmeno
1 číslice

Příklad: Y1F6OiVUQW2JPSElmRE9U0IY5

Po definování adresy URL a tokenu zabezpečení můžete vytvořit projekt webhooku. Na stránce Moje projekty otevřete kartu Webhooky. Klikněte na tlačítko Vytvořit projekt webhooku.

Vyberte typ předplatného

Odesílatelé FedEx mohou svá předplatná přihlásit k číslům účtů nebo sledovacím číslům.

Krok 1: Potvrzení vašeho fakturačního účtu a výběr funkcí

Zkontrolujte uvedený výchozí fakturační účet a potvrďte jej nebo vyberte jiný účet vaší organizace.
Nakonfigurujte svůj projekt výběrem možností jako jsou potvrzení o doručení, odhadovaná doba doručení, sledování událostí a filtrování na základě událostí.

Krok 2: Zadání podrobností o projektu

Dejte svému projektu identifikovatelný název, který je v rámci vaší organizace jedinečný.
Zadejte cílovou adresu URL a údaje o tokenu zabezpečení, které jste vytvořili během ověřování před nastavením (viz kroky výše).
Chcete-li být informováni o nejnovějších aktualizacích webhooku a o všech informacích souvisejících s výpadky, zadejte e-mailovou adresu a preferovaný jazyk.

Krok 3: Přečtení a přijetí podmínek

Jakmile přijmete podmínky včetně licenční smlouvy FedEx Developer Portal a objednávkového formuláře a kliknete na tlačítko „Vytvořit“, zobrazí obrazovka s potvrzením.

V závislosti na zvoleném typu předplatného se mohou objevit další kroky. Podívejte se na dokumentaci a dozvíte se více.

Přejděte na Moje projekty

3 Otestujte integraci

Na stránce Přehled projektu rozhraní API na kartě Testovací klíč načtěte testovací pověření (klíč rozhraní API a tajný klíč) a účty odesílatele.

Krok 1: Požádejte o přístupový token OAuth

Přístupový token OAuth musí být použit u každé transakce rozhraní API. Token je platný pouze hodinu, takže budete muset naprogramovat svou aplikaci tak, aby před vypršením relace token obnovila. Další podrobnosti najdete v Dokumentaci k autorizaci rozhraní API.

Krok 2: Projděte si dokumentaci k rozhraní API

Kliknutím na dokumentaci ke každému z rozhraní API si můžete přečíst obchodní souvislosti a pochopit, jak vybrané rozhraní API používat. Přihlaste se a stáhněte si kolekci JSON API pomocí tlačítka v horní části stránky s dokumentací. Můžete si také projít příklady požadavků na koncový bod, které odpovídají vaší požadované integraci.

Krok 3: Použití sandboxu k testování vzorových transakcí

Kliknutím na požadovaný koncový bod v levé části navigačního panelu přejdete do konkrétního sandboxu. Identifikujte vzorové požadavky, které odpovídají vašemu případu použití, a poté použijte své testovací pověření a testovací adresy URL společnosti FedEx k implementaci výzev koncového bodu, jak je popsáno v příkladových požadavcích. Ověřte, zda přijaté odpovědi na volání rozhraní API odpovídají odpovědím uvedeným v dokumentaci. Další informace o našich zkušenostech s testováním najdete v Průvodci virtualizací Sandboxu.

Testování pomocí webhooků

Testováním můžete získat lepší představu o tom, zda je adresa URL, kterou jste vytvořili, platná. Společnost FedEx může vaši adresu URL identifikovat a vytvořit s ní spojení pro odesílání dat. Testováním lze také získat vzorová testovací data, s jejichž pomocí můžete zkontrolovat a ověřit, zda je vaše aplikace schopna zpracovávat poskytovaná sledovací data. Při testování se však neověřuje vaše adresa URL. Informace o testování adresy URL webhooku najdete v naší dokumentaci k webhookům.

4 Přesun do produkční fáze

Na stránce Přehled projektu otevřete kartu Produkční klíč. Projekty na základě předplatného čísla účtu Advanced Integrated Visibility není třeba přesouvat do produkční fáze.

Krok 1: Konfigurace projektu

Podle potřeby přejmenujte svůj klíč.
Zkontrolujte číslo účtu, které jste vybrali v 1. kroku procesu vytváření projektu. To slouží k přesunu projektu do produkční fáze. Po přesunu projektu do produkční fáze můžete podle potřeby přidat další účty.

Krok 2: Získat klíče projektu

Zkopírujte svůj produkční klíč rozhraní API a tajný produkční klíč se zobrazí na bezpečném místě. Abychom udrželi váš tajný produkční klíč v bezpečí, zobrazíme jej pouze jednou. Pokud jej ztratíte, můžete si vygenerovat nový.

Po získání klíčů projektu a kliknutí na tlačítko Další se na kartě Produkční klíč zobrazí podrobnosti o projektu.

Chcete-li do projektu přidat další účty pro zasílání, klikněte na Upravit v horní části tabulky účtů pro zasílání.

5 Ověřte své rozhraní API

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.

Některá rozhraní API vyžadují pro použití v našem produkčním prostředí ověření přepravního štítku. Zjistěte, zda vaše rozhraní API vyžaduje ověření.

Krok 1: Vytvořte a otestujte FedEx API se svou webovou aplikací

Jakmile dokončíte vývoj své webové aplikace, je načase dokončit testování pomocí testovacího pověření (testovací účet/účty pro zasílání, klíč API a tajný klíč). Váš testovací klíč API a tajný klíč budou zobrazeny na stránce Přehled projektu a lze je zde kdykoli najít.

Krok 2: Přesuňte svůj projekt do produkční fáze

Po testování pomocí rozhraní API FedEx je třeba zahájit proces ověření přesunutím projektu do produkční fáze na portálu FedEx Developer Portal. Po úspěšném dokončení tohoto kroku se vám zobrazí váš produkční klíč API a tajný klíč. Tajný klíč vám bude zobrazen pouze jednou, ale budete jej moci později vygenerovat znovu.

Krok 3: Vyplňte krycí list štítku

Vyplňte všechny položky Krycího listu štítků s využitím příslušných kontaktních údajů a také informací o tom, jaké služby plánujete implementovat. Uveďte své číslo účtu a produkční klíč.

Krok 4: Vygenerujte a zašlete testovací štítky týmu pro analýzu čárových kódů

Vygenerujte testovací štítky v testovacím prostředí FedEx přidruženém k aplikaci a poté testovací štítky odešlete týmu/týmům pro hodnocení štítků FedEx ke schválení. Tým pro analýzu čárových kódů vyžaduje pro vyhodnocení štítků tři pracovní dny.

Abyste se vyhnuli zpoždění při zpracování, dodržujte tyto osvědčené postupy:

Štítky musí být vytištěny a naskenovány v rozlišení alespoň 600 DPI. NEZASÍLEJTE SOUBORY VYGENEROVANÉ POMOCÍ API.
U termálních tiskáren musí být typ obrázku štítku vyžadován v souladu s modelem tiskárny. Příklad: Pro tiskárny Zebra se jedná o typ ZPLII
Při vytváření vzorových štítků pro vyhodnocení použijte informace o adrese odesílatele/příjemce. Vytvářejte pouze vzorové štítky pro konkrétní služby, o které se žádá.
FedEx® štítek Platba při doručení (Dobírka) musí obsahovat také odpovídající hodnotu dobírky. Štítek pro vrácení.
Zásilky FedEx International Express® musí obsahovat také štítek pomocného/sekundárního leteckého nákladního listu (AWB).
Vícekusé zásilky (MPS) musí obsahovat jeden štítek pro každý balík v zásilce.
Krycí list štítků zašlete e-mailem jako soubor PDF na adresu: label@fedex.com.
Fyzické štítky lze zaslat na níže uvedenou adresu:

FedEx Services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017

Pokud naskenované štítky nemají viditelné vady (například čáry procházející čárovým kódem, inkoustové skvrny nebo fyzické poškození), kontrolou projdou a schválení vám bude uděleno. 

Při odesílání fyzických štítků věnujte pozornost kvalitě tisku a náhodnému zvětšení/zmenšení štítků (tj. měřítku). Jsou to dva hlavní důvody, proč štítky procesem hodnocení štítků neprojdou.

Krok 5: Přezkoumejte hodnocení štítků

Tým pro analýzu čárových kódů vyhodnotí předložené testovací štítky a buď je schválí, nebo je odmítne. Tým pro analýzu čárových kódů vás ohledně schválení nebo odmítnutí předložených štítků bude kontaktovat. Pokud jsou štítky schváleny, pokračujte k dalšímu kroku. Pokud jsou štítky odmítnuty, opravte štítky dle pokynů a znovu je odešlete ke schválení.

Krok 6: Povolte aplikaci

Poté, co jsou zkušební štítky během produkční fáze schváleny týmem pro analýzu čárových kódů, tým autorizuje vaše produkční pověření k přenosu identifikované transakce přepravního štítku a prostřednictvím e-mailu vás informuje o úspěšném ověření. Vaše schválení se vztahuje vždy jen na konkrétní projekt.

Krok 7: Nahraďte URL a pověření

Nahraďte testovací URL a testovací pověření produkční URL a produkčními pověřeními. Opětovně otestujte implementaci v produkčním prostředí pomocí zkušebních dat.

EXPAND ALL

1 Kontaktujte společnost FedEx a vytvořte svou organizaci

Požadavek

Váš podnik musí být stávajícím poskytovatelem kompaktního řešení FedEx. Pokud vaše firma není v programu Compatible, změňte výše uvedený výběr na „Poskytovatel nekompaktního řešení“.

Krok 1: Přijetí pozvánky ke vstupu do organizace

Společnost FedEx vytvoří organizaci a poté pozve jednoho člena týmu, aby se k organizaci připojil. Tento uživatel bude pro vaši organizaci určen jako správce.

Krok 2: Přijměte pozvánku

Krok 3: Pozvěte uživatele

Správce může do své organizace pozvat uživatele a přiřadit jim role a projekty. Otevřete kartu „Uživatelé“. Klikněte na tlačítko „Přidat uživatele“.

Vyberte uživatelskou roli: Pozorovatel, Přispěvatel nebo Správce. Více informací o rolích najdete v našich Pokynech pro správu organizace.
Pokud máte nějaké existující projekty, přiřaďte uživateli projekt. Uživatele můžete k projektům přiřadit také na libovolné stránce s přehledem projektů.
Zadejte e-mailové adresy uživatelů, kteří se mají připojit k vaší organizaci pod vybranou rolí.

Pozvat uživatele

2 Výběr produktů pro společnost FedEx za účelem vytvoření projektů

Přejděte do Katalogu rozhraní API, který vám pomůže najít ta správná rozhraní API nebo webhooky pro vaše řešení. Váš konzultant zákaznických technologií FedEx (Customer Technology Consultant) a manažer zodpovědný za kompatibilní řešení vám pomohou vybrat ta správná rozhraní API pro vaše řešení a potřeby.

Krok 1: Vyplnění pracovního listu PIW

Vraťte se do Compatible Provider Community (CPC) a vyplňte pracovní list Product Information Worksheet (PIW).

Krok 2: Kontrola projektů vytvořených společností FedEx

Po schválení pracovního listu PIW společnost FedEx vytvoří vaše projekty. Každá verze každého řešení bude mít samostatný projekt v rámci portálu FedEx Developer Portal.

Krok 3: Zúčastněte se s týmem ukázky rozhraní API

Tým FedEx Compatible spolu s konzultantem FedEx CTC a týmy ověření zorganizují technickou ukázku rozhraní API pro váš tým. Tým FedEx bude diskutovat o ověřování kompatibilních programů, nových funkcích a vlastnostech rozhraní API a bude odpovídat na dotazy.

Přejděte na Moje projekty

3 Otestujte integraci a dokončete ověření

Na stránce Přehled projektu rozhraní API na kartě Testovací klíč načtěte testovací pověření (klíč rozhraní API a tajný klíč).

Krok 1: Vytvoření klíčů zákazníka

K vytvoření klíčů zákazníka použijte rozhraní API pro registraci pověření. Jedná se o neveřejné rozhraní API, které najdete pouze v části rozhraní API v dolní části stránky Přehled projektů API.

Krok 2: Požádejte o přístupový token OAuth

Krok 3: Projděte si dokumentaci k rozhraní API

Krok 4: Použití sandboxu k testování vzorových transakcí

Krok 5: Ověření každého řešení

Po úplném otestování řešení předložte ověřovacímu týmu testovací případy k ověření každého řešení. Společnost FedEx zkontroluje všechny odeslané položky a bude vás informovat, až bude vaše ověření schváleno.

Testování pomocí webhooků

Pokud má vaše organizace přístup k webhooku, může vám testování pomoci získat lepší představu o tom, zda je vytvořená adresa URL platná. Společnost FedEx může vaši adresu URL identifikovat a vytvořit s ní spojení pro odesílání dat. Testováním lze také získat vzorová testovací data, s jejichž pomocí můžete zkontrolovat a ověřit, zda je vaše aplikace schopna zpracovávat poskytovaná sledovací data. Při testování se však neověřuje vaše adresa URL. Informace o testování adresy URL webhooku najdete v naší dokumentaci k webhookům.

4 Vygenerování tajného produkčního klíče

Společnost FedEx poté přesune vaše projekty do produkční fáze. Na stránce Přehled projektu rozhraní API otevřete kartu Produkční klíč. Klikněte na odkaz Generovat tajný klíč ve sloupci Tajný klíč.

Nyní budete moci opětovně otestovat implementaci v produkčním prostředí pomocí zkušebních dat.

EXPAND ALL

1 Vytvoření nebo připojení k organizaci

Vytvořte organizaci, pokud ještě pro vaši společnost žádná neexistuje, nebo se připojte ke stávající organizaci vaší společnosti.

Vytvoření nové organizace

Na navigační liště klikněte na možnost Vytvořit nebo se připojit k organizaci.

Poznámka: Jako tvůrce jste automaticky označeni jako správce organizace.

Správci mohou:

Pozvat uživatele k účasti

přidělovat role uživatelů (např. přispěvatel, pozorovatel) a projekty,

spravovat účty pro zasílání.

Další informace o těchto rolích naleznete v našich Pokynech pro správu organizace.

Pokud jde o typ společnosti, vyberte možnost „Prodává nebo poskytuje softwarové řešení využívající technologie společnosti FedEx a je ověřeným poskytovatelem komplexních služeb FedEx.“

Zadejte název společnosti, adresu URL webových stránek a jedinečný název organizace. Název organizace se může shodovat s názvem vaší společnosti nebo může představovat konkrétní skupinu (oddělení, divize, region, sídlo). Tyto informace jsou nezbytné k ověření vaší žádosti.

Poznámka: Vyberte název organizace, který všichni ostatní uživatelé rozpoznají (např. název společnosti, oddělení, region, sídlo).

Zadejte sídlo vaší společnosti a kde bude vaše softwarové řešení prodáváno nebo distribuováno.

Přidejte fakturační účet a ověřte zákaznický účet

Poznámka: Jako poskytovatel přepravy a logistiky prostřednictvím programu FedEx Integrator Program musíte používat vlastní číslo zákaznického účtu. Nemůžete použít účet FedEx zákazníka.

Zadejte své číslo účtu FedEx. Pokud nemáte existující účet FedEx, otevřete si ho na fedex.com nebo kontaktujte zástupce podpory FedEx .

Zadejte přezdívku účtu a fakturační adresu spojenou se zákaznickým účtem. Vyberte možnost Další.

Poznámka: Fakturační adresa se musí shodovat s našimi záznamy pro tento zákaznický účet. Toto bude výchozí fakturační účet vaší organizace.

Pokud chcete dokončit vytvoření organizace, musíte ověřit svůj zákaznický účet. Vyberte možnost ověření (telefon, který je k dispozici poskytovateli komplexních služeb pouze v USA a Kanadě, e-mail, textová zpráva) a vyberte možnost Další.

Po obdržení zadejte ověřovací kód a vyberte možnost Odeslat.

Přijmout podmínky

Přečtěte si smlouvu společnosti FedEx s poskytovatelem komplexních služeb a příručku k programu. Zaškrtnutím políček potvrďte, že podmínky přijímáte, a poté vyberte možnost Přijmout.

Zobrazí se potvrzovací obrazovka. V případě potřeby klikněte na možnost Spravovat organizaci a upravte podrobnosti.

Pozvat uživatele

Poznámka: Pozvat uživatele mohou pouze správci.

Vyberte možnost Spravovat organizaci v levém navigačním panelu.

Přejděte na kartu Uživatelé a vyberte možnost Přidat uživatele.

Vyplňte formulář a přiřaďte příslušnou roli novému uživateli/uživatelům: pozorovatel, přispěvatel anebo správce.

Další informace o rolích uživatelů naleznete v Pokynech pro správu organizace.

Přiřaďte uživatele k projektu/projektům (je-li to relevantní) v rozevírací nabídce projektů.

Zadejte e-mailové adresy jednotlivých uživatelů a vyberte možnost Pozvat.

Vytvoření organizace

Připojení k existující organizaci

Požádejte o pozvánku: Požádejte správce vaší organizace, aby vám poslal pozvánku. Na přijetí máte 24 hodin, poté vyprší. V případě potřeby požádejte správce o opětovné odeslání.

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 již propojeno s jinou organizací, musíte si vytvořit nové.

2 Vytvoření projektu

Vytvořit projekt API

Přejděte na stránku Moje projekty a vyberte možnost Vytvořit projekt.

Vyplňte pole Název projektu. Doporučený formát názvu je „Projectname_applicationname“. Po dokončení vyberte možnost Další.

Vyberte rozhraní API a nástroj Advanced Integrated Visibility pro váš projekt.

Poznámka: Produkty Advanced Integrated Visibility jsou k dispozici pouze pro americké poskytovatele komplexních služeb FedEx.

Poznámka: Pokud vyberete nějaké 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í fakturace a přijetí podmínek

Přiřaďte fakturační účet ze seznamu zákaznických účtů přidaných k organizaci. Tento krok je nutný pouze v případě, že jste si dříve vybrali placený produkt.

Přijměte smluvní podmínky spojené s produktem.

Potvrzení podrobností

Zkontrolujte vybrané produkty. Ověřte fakturační účet, který jste uvedli.

Zkontrolujte a přijměte licenční smlouvu FedEx Developer Portal.

Kliknutím na možnost Vytvořit vygenerujete projekt a zobrazíte testovací pověření.

Konfigurace nástroje Advanced Integrated Visibility v projektu

Požadavky

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í účtů: Služba Advanced Integrated Visibility vyžaduje fakturační účet se sídlem v USA a alespoň jeden přepravní účet, přičemž tyto dva typy účtů se vzájemně vylučují. Pouze správci mohou přidávat fakturační a přepravní účty na stránce Správa organizace.

Vytvoření platné adresy URL pro zpětné volání v cílové aplikaci nebo platformě – URL vaší aplikace/platformy:

Pro zajištění bezpečnosti musí používat protokol HTTPS.

Nesmí zahrnovat adresní prostor IP adres RFC1918, subdomény fedex.com nebo přímé IP adresy (např. 127.0.0.1).

Vygenerování tokenu zabezpečení

Musí mít 26–100 znaků a musí obsahovat:
- jedno velké písmeno
- jedno malé písmeno
- jednu číslici
Příklad: Y1F6OiVUQW2JPSElmRE9U0IY5

Konfigurace nástroje Advanced Integrated Visibility

Vyberte nástroj Advanced Integrated Visibility. Vyberte možnosti jako jsou potvrzení o doručení, odhadované datum doručení, sledování událostí a filtrování na základě událostí.

Zadejte cílovou adresu URL a token zabezpečení.

Uveďte e-mail pro aktualizace nástroje Advanced Integrated Visibility a oznámení o odstávkách.

Potvrzení podrobností

Zkontrolujte a přijměte licenční smlouvu FedEx Developer Portal a objednávkový formulář.

Pro dokončení nastavení zvolte možnost Vytvořit.

Poznámka: V závislosti na typu vašeho předplatného mohou být vyžadovány další kroky. Podrobnosti naleznete v naší dokumentaci.

Přejděte na Moje projekty

3 Otestujte integraci

Načtení testovacího pověření a zahájení testování.

Projděte si dokumentaci k rozhraní API
- Přečtěte si dokumentaci k rozhraní API, abyste porozuměli různým rozhraním API, která nabízíme, spolu s jejich obchodními souvislostmi a integračními procesy.
- Stáhněte si schéma JSON z příslušné stránky dokumentace k rozhraní API.
- Přečtěte si příklady požadavků na požadované koncové body.
Získání testovacích přihlašovacích údajů

Na stránce Přehled projektu přejděte na kartu Klíče rozhraní API. Váš klíč rozhraní API a tajný klíč jsou uvedeny v záhlaví testovacího klíče.
Projděte si dokumentaci k rozhraní API
- Pro všechny transakce API je vyžadován token OAuth, jehož platnost vyprší za jednu hodinu.
- Vaše aplikace musí obnovit token před vypršením jeho platnosti.
- Další podrobnosti najdete v dokumentaci k API Authorization.
Otestujte transakce rozhraní API v sandboxu
- Přejděte na příslušné rozhraní API v katalogu rozhraní API a vyberte možnost Dokumentace.
- V nabídce vlevo vyberte požadovaný koncový bod rozhraní API.
- Použijte vzorové požadavky, které odpovídají vašemu případu použití.
- Proveďte implementaci volání rozhraní API pomocí testovacích pověření a testovacích adres URL společnosti FedEx.
- Ověřte odpovědi podle dokumentace.
- Další podrobnosti najdete v příručce Virtualizace sandboxu.

Testování nástroje Advanced Integrated Visibility

Testování nástroje Advanced Integrated Visibility ověřuje formát vaší adresy URL a pomáhá vytvořit spojení mezi společností FedEx a vaší aplikací.

Test poskytuje vzorová testovací data pro zpracování informací o sledování.

Poznámka: Při testování se neověřuje vaše adresa URL.

Pro více informací navštivte dokumentaci k nástroji Advanced Integrated Visibility

4 Ověřte své rozhraní API

Ověření je vyžadováno pro přesun rozhraní API do produkční fáze. Úroveň ověření se u jednotlivých rozhraní API liší.

Vývoj a testování rozhraní API společnosti FedEx

Použijte své testovací pověření (klíč API a tajný klíč) ze stránky Přehled projektu.
Identifikujte všechny testovací případy pro regiony/oblasti, kde chcete své řešení a nasadit (viz Základní testovací případy poskytovatele komplexních služeb).
Před spuštěním testovacích případů dokončete registrační transakce pomocí poskytnutých čísel testovacích zákaznických účtů.
Proveďte všechny požadované testovací případy.

Přechod na stránku Přehled projektu.

Vyberte možnost Vyžádat produkční klíče. Společnost FedEx obdrží vaši žádost o produkční klíče a jakmile budou klíče schváleny, budete informováni.

Vyplnění pracovního listu PIW a krycího listu pro ověření

Vyplňte pracovní list Product Information Worksheet (PIW) a krycí list pro ověření poskytovatele komplexních služeb s vašimi kontaktními údaji a plánovanými službami FedEx.

Odeslání výstupů.

Shromážděte a zkomprimujte následující výstupy do souboru .zip, abyste se vyhnuli omezením poskytovatele e-mailové služby. Odešlete na adresu validationmtp@fedex.com.

Požadované výstupy

Vyplněný pracovní list PIW (PDF).
Vyplněný krycí list pro ověření (PDF).

Snímky obrazovky (PDF):

Řešení pro zákazníky zobrazující služby FedEx/zvláštní zacházení

Prohlášení o vyloučení odpovědnosti

Licenční smlouva s koncovým uživatelem (EULA)

Průběh registrace koncového zákazníka

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)

Osvědčené postupy, jak se vyhnout zpožděním

Přepravní štítky musí být vytištěny a naskenovány v minimálním rozlišení 600 DPI.
Přepravní štítky z termální tiskárny musí odpovídat modelu tiskárny (např. ZPLII pro tiskárny Zebra).
Zásilky FedEx International Express® musí obsahovat také přepravní štítek pomocného leteckého náložného listu (AWB).
Vícekusé zásilky (MPS) musí obsahovat jeden přepravní štítek pro každou zásilku.

Hodnocení přepravních štítků

Tým pro ověření vaše podání schválí nebo odmítne.

Pokud je zamítnuto, proveďte opravy a znovu odešlete dle zpětné vazby

Pokud je schváleno, obdržíte e-mail s potvrzením úspěšného ověření. Jakmile obdržíte e-mail, vaše produkční ověření budou autorizovány pro transakce s přepravním štítkem.

Postupujte podle pokynů po ověření

Projděte si a implementujte veškeré požadavky po ověření podle potřeby.

5 Přesun do produkční fáze

Jakmile obdržíte oznámení o schválení vašich produkčních klíčů, najdete je na kartě Přehled projektu.

Zkopírujte a bezpečně uložte produkční klíč API a tajný klíč.
Tajný klíč se zobrazí pouze jednou – pokud jej ztratíte, musíte vygenerovat nový klíč.