Nastavení dopravce FedEx

Pro koho: správce firmy, která posílá zásilky přes FedEx. FedEx vypnul staré napojení (Web Services) a Depoto posílá zásilky přes jeho nové rozhraní; přístupy k němu si vyplníte sami v profilu dopravce.

Než začnete

• Založte si projekt na FedEx Developer Portal (developer.fedex.com). Z něj potřebujete API Key, Secret Key a devítimístné číslo účtu FedEx. Starý „Meter number“ už potřeba není.
• Pokud vám FedEx vydal Track API jako samostatný projekt, mějte i jeho API Key a Secret Key. Bez nich Depoto sleduje zásilky hlavním klíčem.
• U zásilek mimo EU si připravte EORI firmy a rozhodněte, kdo platí clo (DAP platí příjemce, DDP odesílatel).
• Přihlaste se do klientské aplikace jako správce.

Jak FedEx nastavit

1. Přejděte do Nastavení → Dopravci a otevřete řádek dopravce Fedex (nebo přidejte nového dopravce typu Fedex).
2. Pole Pokladna nechte prázdné, pokud má FedEx platit pro všechny pokladny. Má-li každý e-shop posílat přes jiný účet FedEx, založte pro každou pokladnu vlastní řádek.
3. Zaškrtněte Aktivní.
4. V části Produkční data vyplňte clientId (API Key z FedEx portálu), clientSecret (Secret Key) a accountNumber (9místné číslo účtu). Číslo účtu se zadává po číslicích do devíti políček; vložení ze schránky vyplní všechna. Číslo s jiným počtem číslic aplikace odmítne hláškou „Číslo účtu musí mít přesně 9 číslic.“
5. Track API (samostatný projekt) vyplňte jen tehdy, když vám FedEx vydal Track API jako samostatný projekt. Vyplňují se obě pole, nebo žádné. Bez nich jede sledování hlavním klíčem.
6. Testovací data (Sandbox a Track API sandbox) nechte prázdná; slouží jen pro zkoušky proti testovacímu prostředí FedEx.
7. V poli termsOfSale zvolte, kdo platí clo: DAP – clo platí příjemce (výchozí) nebo DDP – clo platí odesílatel.
8. Do pole eori zadejte EORI firmy (jde do údajů odesílatele u zásilek s celní deklarací). DIČ odesílatele se bere z nastavení firmy.
9. Do pole productDesc zadejte obecný popis zboží na štítek, nejvýše 50 znaků.
10. Klikněte na Uložit. Nastavení API je buď celé prázdné, nebo musí mít vyplněné clientId, clientSecret a accountNumber; jinak aplikace neuloží a označí chybějící pole.

Otestujte spojení

1. Po uložení klikněte u nadpisu Nastavení API na Otestovat spojení s dopravcem. Test pracuje s uloženým nastavením; s neuloženými změnami aplikace test nespustí a vyzve vás k uložení.
2. Depoto si u FedExu vyžádá přístupový token (ověří API Key a Secret Key) a pak založí zkušební zásilku, kterou hned stornuje; tím se ověří i číslo účtu a nastavení zásilky.
3. Výsledek se zobrazí nad formulářem: „Spojení s dopravcem funguje.“ s číslem testovací zásilky, nebo „Test spojení s dopravcem selhal.“ s důvodem od FedExu a případně seznamem chybějících nastavení. Pokud se zkušební zásilku nepodařilo stornovat, hláška uvede její číslo; stornujte ji v portálu FedEx.
4. Další test je možný až po krátké prodlevě; aplikace vám řekne, za kolik sekund.

Odesílatel a adresa svozu

• Odkud zásilka odchází, určuje adresa svozu: nejdřív adresa svozu nastavená u pokladny, pak u skladu, a když není ani jedna, adresa firmy. Neúplná adresa svozu (bez ulice, města, PSČ nebo země) se nepoužije a zásilka jde z adresy firmy.
• Podle země adresy svozu a země příjemce se rozhoduje, zda zásilka potřebuje celní deklaraci.
• Jméno odesílatele na štítku je název e-shopu nastavený u pokladny (název na štítku); když chybí, obchodní jméno firmy. Telefon a e-mail se berou z adresy svozu a chybějící údaje doplní firma.
• Adresu svozu u pokladny nebo skladu nastavuje podpora Depota; pokud máte sídlo jinde než sklad, napište nám, odkud zásilky fyzicky odcházejí.

Clo u zásilek mimo EU

• Depoto posílá FedExu u každé položky zásilky název, počet kusů, hodnotu řádku po slevě a hmotnost řádku (hmotnost produktu krát počet kusů).
• Položka s nulovou cenou (zboží zdarma) se proclívá v prodejní ceně produktu. Položka, která nemá cenu v objednávce ani prodejní cenu na produktu, skončí srozumitelnou chybou před odesláním. U zboží zdarma do zahraničí proto mějte na produktu vyplněnou prodejní cenu.
• HS kód položky se bere z pole HS kód na kartě produktu a země původu z pole Země původu. Když je pole prázdné, údaj v deklaraci chybí; před první zásilkou mimo EU obě pole vyplňte. Oba sloupce jsou i v šabloně pro hromadný import produktů.
• Kdo platí clo, určuje pole termsOfSale v profilu dopravce (DAP nebo DDP).

Kdy vznikne štítek a jak sledovat zásilku

1. Depoto vytvoří zásilku u FedExu při odeslání prvního balíku objednávky; vícekusová objednávka se posílá jako jedna zásilka.
2. Číslo zásilky od FedExu se uloží k balíku jako Kód balíku a štítek otevřete v detailu objednávky u balíku.
3. Pravidelná kontrola stavů zásilek FedEx dosud nenačítá; stav zásilky sledujte podle Kódu balíku přímo u FedExu.

Štítky z jiného systému (například ERP)

• Číslo zásilky vždy dodá FedEx ve chvíli, kdy zásilku vytvoří Depoto; číslo vytvořené jinde Depoto převzít neumí.
• Když je dopravce Fedex v Nastavení → Dopravci aktivní, Depoto při odeslání balíku vytvoří vlastní zásilku. Pokud štítky tisknete z jiného systému, nechte dopravce Fedex v Depotu neaktivní, jinak u FedExu vzniknou dvě zásilky na jednu objednávku.

Časté otázky

Při odeslání balíku se objeví „Chybí přístupy k FedEx REST API (clientId, clientSecret).“ V profilu dopravce Fedex nejsou vyplněna pole Produkčních dat. Doplňte je a spusťte test spojení.

Test hlásí „Neúplné přístupy k FedEx Track API“. Je vyplněno jen jedno ze dvou polí Track API. Vyplňte obě, nebo obě vymažte.

FedEx ukazuje, že zásilka odešla z jiné adresy. Zkontrolujte adresu svozu u pokladny nebo skladu a adresu firmy v nastavení firmy.

Na štítku je jiné jméno odesílatele, než čekáme. Upravte název na štítku v nastavení pokladny.

Můžeme mít více účtů FedEx? Ano, pro každou pokladnu vlastní řádek dopravce Fedex s vlastními přístupy.

Související články

• Jak funguje napojení na dopravce a tisk štítků
• Chyba dopravce při odeslání balíku: co hláška znamená a co dělat
• Proč objednávka zůstává ve stavu „Předáno dopravci“
• Hmotnost a rozměry produktů: k čemu v Depotu slouží
• Import produktů ze souboru