Spring GDS API

Globe Pickup Points integruje se Spring GDS, přeshraničním konsolidátorem, který vaše zásilky předává místním dopravcům pro poslední míli, jako jsou PostNL, Royal Mail, DPD, Hermes, Colis Privé nebo Packeta. S touto integrací můžete:

Exportovat objednávky do Spring GDS přímo ze Shopify
Doručovat do 49 cílových zemí pomocí 34 služeb
Tisknout přepravní štítky přímo v Shopify
Odesílat kompletní celní data (HS kódy, země původu, DDP/DDU) u mezinárodních zásilek

Aktivace integrace Spring GDS 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 Spring GDS.
Zadejte API klíč — najdete ho ve svém účtu Spring GDS.
Vyplňte údaje o odesílateli použité na každém štítku: Název odesílatele, Název firmy odesílatele (volitelné), Ulice odesílatele, Město odesílatele, PSČ odesílatele, Země odesílatele, Telefon odesílatele a Email odesílatele.
Pokud odesíláte do zahraničí, doplňte své celní identifikátory. Všechny jsou volitelné:
- DIČ odesílatele — vaše daňové identifikační číslo. Pro Norsko použijte VOEC, pro Švýcarsko UID, pro Singapur GST.
- EORI číslo odesílatele — používá se v celním řešení Spring Clear.
- IOSS číslo odesílatele — používá se v řešení Spring Clear IOSS+ a Union OSS.
- GB EORI číslo odesílatele — začíná GB, povinné pro DDP zásilky do Velké Británie přes Spring Clear.
Zvolte Tracking URL odesílanou zákazníkům v e-mailu o odeslání: Spring GDS Tracking nebo Tracking koncového dopravce.
Podle potřeby nakonfigurujte možnosti plnění a označování objednávek.
Namapujte vaše Shopify dopravní metody na služby Spring GDS, které máte se Spring sjednané.

Export a tisk štítků

Objednávky lze exportovat do Spring GDS a tisknout přepravní štítky přímo ze Shopify, ať už hromadně nebo jednotlivě. Kompletní postup najdete v průvodci Vytváření přepravních štítků.

Každá exportovaná zásilka obdrží sledovací číslo Spring GDS. Podle nastavení Tracking URL se plnění vytvářejí buď se stránkou pro sledování Spring GDS, nebo s odkazem pro sledování koncového dopravce, kterého Spring pro danou zásilku vrátí.

Typy služeb

Spring GDS nabízí 34 služeb. Vyberte tu, která odpovídá vaší smlouvě se Spring a cílové zemi — kompletní seznam je k dispozici v dialogu exportu a v mapování dopravních metod.

Skupina služeb	Příklady
Síť Spring	Spring Tracked (TRCK), Spring Signature (SIGN), Spring Untracked (UNTR)
Spring Collect	Spring Collect (CLLCT) — jediná služba na výdejní místo
PostNL	Packet Tracked / Registered / Non Tracked, Parcel EU, GlobalPack EMS a UPU, EPG, varianty Benelux s podpisem i bez
Royal Mail	Tracked 24 a Tracked 48, s podpisem i bez
Partneři pro poslední míli	DPD DE, Hermes, Colis Privé, Italian Post Crono a Crono Express, Sending Mainland a Islands, Spring Com Standard a Express, Packeta, Austrian Post Eurodis, Express

Výdejní místa vs. doručení na adresu

Spring Collect (CLLCT) je jediná služba Spring GDS, která doručuje na výdejní místo. Když je objednávka exportována s touto službou, Globe k ní připojí ID místa PUDO, které zákazník vybral při objednávce. Všechny ostatní služby doručují na doručovací adresu zákazníka.

Pokud objednávka exportovaná jako Spring Collect nemá vybrané výdejní místo, žádné místo PUDO se se zásilkou neodešle. Použijte místo toho službu s doručením na adresu, nebo zajistěte, aby zákazník při objednávce místo vybral.

Clo a poplatky

Spring GDS je přeshraniční dopravce, takže Globe posílá se zásilkou vždy celní prohlášení. Produktové položky nesou HS kód a zemi původu z vašich skladových položek v Shopify; tam, kde chybí, se použije HS kód zadaný pro danou zásilku při exportu a vaše země odesílatele.

Sekce Clo a poplatky u účtu dopravce řídí:

Nastavení	Účinek
DDP země	Destinace odesílané jako DDP (Delivered Duty Paid). Všechny ostatní se odesílají jako DDU.
Posílat hodnoty bez DPH pro země	U těchto destinací se hodnoty objednávky a dopravy odesílají bez DPH.
Země s preferenčním původem	Přidá ke každé produktové položce příznak preferenčního původu. Vyžadováno pro Velkou Británii podle Dohody o obchodu a spolupráci mezi EU a UK.
Typ deklarace	Prodej zboží (výchozí), Dokumenty, Dárek, Vrácené zboží nebo Obchodní vzorek.

Další dvě hodnoty vůbec nejsou nastavením dopravce — HS kód (6–10 číslic, přepsaný HS kódy na úrovni produktu ze Shopify, pokud jsou k dispozici) a Popis obsahu (například Goods nebo Clothing) jsou pokročilé možnosti, které vyplňujete u jednotlivé zásilky v dialogu exportu.

Testovací režim

Každý účet dopravce Spring GDS má zaškrtávací pole Testovací režim. Když je zapnuté, vytváření zásilek i načítání štítků směřuje do testovacího prostředí Spring GDS místo do produkce. Než začnete odesílat reálné objednávky, vypněte jej — testovací zásilky se neexpedují.

Dobírka (COD)

Spring GDS nepodporuje dobírku. Se zásilkou se neodesílá žádná částka dobírky, bez ohledu na platební metodu objednávky. Pokud dobírku potřebujete, použijte pro takové objednávky jiného dopravce.

Stav doručení

Synchronizace stavů doručení není u Spring GDS k dispozici — není součástí obousměrné synchronizace stavů doručení, kterou mají dopravci jako Zásilkovna, PPL, DPD nebo GLS, takže se stavy zásilek nezapisují zpět do Shopify. Sledovací číslo a odkaz pro sledování se k plnění připojují i tak a další aktualizace stavu přicházejí ze sledování v Shopify nebo z portálu Spring GDS.

Štítky pro vrácení u Spring GDS rovněž podporovány nejsou.

Tisk štítků

Spring GDS vrací štítky v PDF, které Globe umí tisknout ve dvou formátech:

Formát	Počet pozic na archu
A6	1
A6 na A4	4

Při tisku A6 na A4 můžete vybrat počáteční pozici (1–4) a opakovaně tak použít částečně použité archy.

Řešení problémů

Problém	Řešení
API klíč Spring GDS není nastaven	Účet dopravce nemá API klíč. Doplňte jej v nastavení dopravce — je vyžadován i pro tisk.
Fatální chyba ze Spring GDS	Spring zásilku odmítl. Zpráva vrácená Springem se zobrazí u neúspěšné objednávky — nejčastěji jde o neplatný kód služby pro danou destinaci nebo chybějící celní data.
Nebylo vráceno žádné sledovací číslo	Zásilka byla přijata, ale Spring nevrátil sledovací číslo. Exportujte objednávku znovu a zkontrolujte, že je služba na vašem účtu Spring povolená.
Nepodařilo se získat žádné štítky	Štítek pro dané sledovací číslo ještě není k dispozici. Chvíli počkejte a tiskněte znovu.
Spring Collect exportován bez výdejního místa	Objednávka nemá vybrané výdejní místo z objednávky. Zvolte službu s doručením na adresu, nebo nechte zákazníka místo vybrat.
Testovací zásilky nikdy nedorazí	U účtu dopravce je stále zapnutý Testovací režim. Pro produkční odesílání jej vypněte.

Přidejte výdejní místa Spring GDS do svého Shopify obchodu — ceny, demo a nastavení →