Toptrans API

Globe integruje s Toptrans, českým a slovenským dopravcem pro balíky i palety, a umožňuje bezproblémový export objednávek a tisk přepravních štítků přímo ze Shopify. S touto integrací můžete:

Exportovat objednávky do portálu Toptrans ZP2
Tisknout přepravní štítky přímo v Shopify
Podporovat dobírku (COD) v CZK a EUR

Aktivace integrace Toptrans 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 Toptrans.
Zadejte uživatelské jméno a heslo — stejné přihlašovací údaje, které používáte pro přihlášení do Toptrans ZP2.
Pokud používáte dobírku, zadejte číslo bankovního účtu ve formátu 123456789/0800.
Nakonfigurujte možnosti plnění a označování objednávek podle potřeby.
Namapujte vaše Shopify dopravní metody na odpovídající typ urgence přepravy Toptrans.

Export a tisk štítků

Objednávky lze exportovat do Toptrans a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě.

Režim konceptu vs. automatické odeslání

Ve výchozím nastavení jsou objednávky uloženy jako koncepty v ZP2. To vám umožňuje je před odesláním zkontrolovat a upravit přímo v Toptrans. Pokud povolíte možnost Automatické odeslání v nastavení dopravce, objednávky jsou po exportu ihned odeslány do Toptrans TOPIS — štítky jsou generovány a dostupné k tisku okamžitě.

Typy služeb

Při exportu objednávky vyberte urgenci přepravy odpovídající vaší dohodě s Toptrans:

Typ	Popis
Standard	Standardní doručení
TopTime	Doručení s garantovaným časem
Top Privat	Doručení na soukromou adresu
Top Express	Expresní doručení
Rozvoz po avizaci	Doručení po předchozím avízu
Osobní odběr	Osobní odběr na depu Toptrans

Rozšířené možnosti zásilky

Následující možnosti lze nastavit při exportu jednotlivé zásilky. Výchozí hodnoty lze nakonfigurovat v nastavení dopravního účtu.

Možnost	Popis
Typ obalu	Typ balení (např. karton, paleta, pneumatiky). Výchozí hodnota: Karton.
Avízo příjemci	Zavolat příjemci před doručením pro sjednání termínu.
Počet europalet	Počet europalet k vyzvednutí od příjemce (0 = žádná).
Nadrozměr	Označit zásilku jako nadrozměrnou.

Dobírka (COD)

Toptrans podporuje dobírku pouze v CZK a EUR. Číslo bankovního účtu nastavte v nastavení dopravce ve formátu 123456789/0800. Pokud je objednávka v nepodporované měně s dobírkou, export bude zamítnut — objednávku bude nutné zpracovat ručně nebo použít jiný způsob platby.

Tisk štítků

Štítky se tisknou na papír formátu A4. Při tisku lze zvolit počáteční pozici na archu (pozice 1–14), což umožňuje opakované použití částečně použitých archů se štítky.

Řešení problémů

Problém	Řešení
Chyba ověření	Zkontrolujte, zda uživatelské jméno a heslo odpovídají přihlašovacím údajům do Toptrans ZP2.
Dobírka zamítnuta — nepodporovaná měna	Podporovány jsou pouze CZK a EUR. Zkontrolujte, zda měna objednávky odpovídá nastavení COD.
Objednávka odeslána místo uložení jako koncept	Ověřte, že je v nastavení dopravce vypnuto Automatické odeslání.