UPS API
Globe Pickup Points integruje s UPS, celosvětovým balíkovým dopravcem, což umožňuje export objednávek a tisk přepravních štítků přímo ze Shopify. S touto integrací můžete:
- Exportovat objednávky do UPS přímo ze Shopify
- Tisknout přepravní štítky přímo v Shopify
- Odesílat 15 vnitrostátních, evropských i celosvětových služeb UPS
- Odesílat mezinárodní zásilky s celními daty generovanými automaticky z vašich Shopify produktů
UPS zapínáme jednotlivým obchodům na vyžádání. Pokud UPS v seznamu dopravců nevidíte, kontaktujte podporu Globe a my jej pro váš obchod zapneme.
Aktivace integrace UPS API
Sekce “Aktivace integrace UPS API”- Ve vaší Shopify administraci otevřete Globe Pickup Points a přejděte do sekce Přepravní štítky. Přidejte nového dopravce a vyberte UPS.
- Zadejte Číslo účtu — vaše odesílací číslo účtu UPS, které najdete v detailech svého fakturačního účtu UPS.
- Vyplňte údaje o odesílateli: Název odesílatele, Ulice odesílatele, Město odesílatele, PSČ odesílatele, Země odesílatele a Telefon odesílatele. Email odesílatele je volitelný.
- Stát/provincie odesílatele je kód státu nebo provincie (například
NY,CA). Je povinný při odesílání ze Spojených států nebo Kanady, jinde jej lze nechat prázdný. - Klikněte na Připojit UPS účet. Otevře se okno UPS, kde se přihlásíte svými přihlašovacími údaji UPS a autorizujete Globe. Po návratu se připojení uloží a přístupový token se obnovuje automaticky — nikde nemusíte zadávat API klíč ani heslo.
- Podle potřeby nakonfigurujte možnosti plnění a označování objednávek.
- Namapujte vaše Shopify dopravní metody na služby UPS, které máte na účtu.
Účet UPS můžete kdykoli odpojit ze stejné obrazovky; export je pak blokován, dokud jej znovu nepřipojíte.
Export a tisk štítků
Sekce “Export a tisk štítků”Objednávky lze exportovat do UPS a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě. Samotný postup tvorby štítků najdete v průvodci Vytváření přepravních štítků.
Každá zásilka obdrží sledovací číslo UPS a obrázek štítku se ukládá k objednávce, takže jej lze později znovu vytisknout bez dalšího volání UPS. Pokud Globe uložený obrázek už nemá, načte jej zpět ze služby UPS pro obnovu štítků podle sledovacího čísla. Zásilky se sledují na adrese https://www.ups.com/track?tracknum=<sledovací číslo>.
Typy služeb
Sekce “Typy služeb”Při exportu objednávky vyberte službu odpovídající vaší smlouvě s UPS:
| Kód | Služba | Typické použití |
|---|---|---|
| 03 | UPS Ground | Vnitrostátní pozemní přeprava (USA) |
| 11 | UPS Standard | Silniční doručení v rámci Evropy |
| 01 | UPS Next Day Air | Vnitrostátní letecky do druhého dne |
| 02 | UPS 2nd Day Air | Vnitrostátní letecky do dvou dnů |
| 12 | UPS 3 Day Select | Vnitrostátní letecky do tří dnů |
| 13 | UPS Next Day Air Saver | Vnitrostátní do druhého dne, do konce dne |
| 14 | UPS Next Day Air Early | Vnitrostátní do druhého dne, brzy ráno |
| 59 | UPS 2nd Day Air A.M. | Vnitrostátní do dvou dnů, doručení dopoledne |
| 07 | UPS Worldwide Express | Mezinárodní expres |
| 08 | UPS Worldwide Expedited | Mezinárodní, s garantovaným dnem |
| 54 | UPS Worldwide Express Plus | Mezinárodní, brzy ráno |
| 65 | UPS Worldwide Saver | Mezinárodní expres, do konce dne |
| 96 | UPS Worldwide Express Freight | Mezinárodní paletová přeprava |
| 71 | UPS Worldwide Economy DDU | Ekonomická, clo neplaceno |
| 72 | UPS Worldwide Economy DDP | Ekonomická, clo placeno |
Ne každá služba je dostupná na každém účtu a z každé země odeslání — UPS zamítne zásilku se službou, kterou nemáte na účtu sjednanou.
Pouze doručení na adresu a do firem
Sekce “Pouze doručení na adresu a do firem”Štítky UPS vytvořené v Globe jsou vždy adresované na domácí nebo firemní adresu zákazníka převzatou ze Shopify objednávky. Doručení na místa UPS Access Point není podporováno — výdejní místo vybrané při objednávce se do UPS nepředává a zásilka bude doručena na doručovací adresu. Nemapujte dopravní metodu s výdejními místy na službu UPS. Podporovány nejsou ani štítky pro vrácení.
Rozšířené možnosti zásilky
Sekce “Rozšířené možnosti zásilky”Tyto možnosti se nastavují u jednotlivé zásilky v dialogu exportu. Nejsou to nastavení dopravce — účet dopravce UPS nemá kam pro ně uložit výchozí hodnoty, takže je nastavte u zásilek, které je potřebují.
| Možnost | Popis |
|---|---|
| Typ balení | Vlastní balení (výchozí), UPS dopis, Tubus, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box |
| Popis obsahu | Popis zásilky tištěný na štítku a používaný na celních formulářích. Výchozí hodnota je Goods. |
| HS kód | HS kód použitý na celních formulářích dané zásilky, pokud produkt nemá HS kód v Shopify. |
Clo a mezinárodní zásilky
Sekce “Clo a mezinárodní zásilky”Celní formuláře (obchodní faktura) se přidávají automaticky, když se země odesílatele a cílová země liší a nejde o přesun v rámci EU. Globe sestavuje fakturu z položek objednávky:
- Název produktu, množství, jednotková cena a SKU
- HS kód ze skladové položky produktu v Shopify, záložně z HS kódu zadaného pro danou zásilku v dialogu exportu
- Země původu ze skladové položky produktu v Shopify, záložně ze země odesílatele
- Hmotnost položky ze Shopify, převedená na jednotku hmotnosti zásilky
Číslem faktury je číslo objednávky v Shopify, důvodem vývozu je SALE a měnou je měna objednávky. Hmotnosti se odesílají v kilogramech, kromě odesílatelů ze Spojených států, Portorika a Amerických Panenských ostrovů, kde se používají libry.
Dobírka (COD)
Sekce “Dobírka (COD)”UPS v Globe nepodporuje dobírku. Do UPS se neodesílá žádná částka dobírky, takže dobírková objednávka exportovaná do UPS jde jako běžná předplacená zásilka a při doručení se nevybírají žádné peníze. Pro takové objednávky použijte dopravce, který dobírku podporuje, nebo zákazníka před exportem převeďte na předplacenou platební metodu.
Stav doručení
Sekce “Stav doručení”Integrace UPS nesynchronizuje stavy doručení zpět do Shopify. Sledovací číslo a odkaz pro sledování se k plnění připojují i tak (pokud je zapnuté automatické plnění), takže průběh doručení lze sledovat na ups.com.
Tisk štítků
Sekce “Tisk štítků”UPS vrací obrázek štítku 4×6 palců, který Globe převádí do PDF a pro tisk otáčí na výšku. K dispozici jsou následující formáty:
| Formát | Počet pozic na archu |
|---|---|
| A6 | 1 |
| A6 na A4 | 4 |
Při tisku štítků A6 na A4 můžete vybrat počáteční pozici na archu (pozice 1–4) a opakovaně tak použít částečně použité archy.
Řešení problémů
Sekce “Řešení problémů”| Problém | Řešení |
|---|---|
| UPS účet není připojen | Otevřete nastavení dopravce a klikněte na Připojit UPS účet pro dokončení přihlášení k UPS. |
| Ověření UPS selhalo — token mohl vypršet | Uloženou autorizaci UPS se nepodařilo obnovit. Odpojte a znovu připojte UPS účet. |
| Neplatná nebo vypršelá relace během připojování | Přihlášení k UPS je nutné dokončit do 10 minut. Zavřete okno a spusťte připojení znovu. |
| Vytvoření zásilky selhalo se zprávou od UPS | Zpráva přichází přímo od UPS. Nejčastěji není služba povolená na vašem účtu, adresa příjemce je neúplná, nebo číslo účtu neodpovídá adrese odesílatele. |
| Chybějící nebo neplatný stát/provincie | Odesílatelé i příjemci v USA a Kanadě potřebují platný kód státu nebo provincie. Vyplňte Stát/provincie odesílatele a zkontrolujte adresu zákazníka. |
| Z UPS se nepodařilo získat žádné štítky | Uložený obrázek štítku chybí a obnova štítku selhala. Zkontrolujte, že zásilka má sledovací číslo a že je UPS účet stále připojený. |
| Dobírková objednávka doručena bez výběru peněz | Očekávané chování — zásilky UPS v Globe nikdy nejsou na dobírku. Viz Dobírka (COD) výše. |