Boxpi API

Globe Pickup Points integruje s Boxpi, přeshraničním logistickým agregátorem. Jedno API připojení vám dá více než 60 služeb dopravců v 16 evropských zemích, aniž byste museli uzavírat samostatnou smlouvu s každým národním dopravcem. S touto integrací můžete:

Exportovat objednávky do Boxpi přímo ze Shopify
Tisknout přepravní štítky přímo v Shopify
Doručovat do balíkomatů, na pobočky dopravců a na pošty, nebo na adresu zákazníka
Podporovat dobírku (COD)
Synchronizovat stavy doručení zpět do Shopify

Aktivace integrace Boxpi 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 Boxpi.
Zadejte API klíč — získáte ho od zákaznické podpory Boxpi. Produkční a testovací prostředí mají různé API klíče.
Vyberte Prostředí — Produkce pro ostré zásilky, Vývoj pro testování proti testovacímu API Boxpi. API klíč musí patřit k prostředí, které vyberete.
Podle potřeby nakonfigurujte možnosti plnění a označování objednávek (Automaticky splnit objednávky, Automaticky označit objednávky číslem sledování, Vlastní tag po exportu, Výchozí hmotnost (kg)).
Namapujte vaše Shopify dopravní metody na služby Boxpi, které chcete používat.

Export a tisk štítků

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

Každá objednávka se registruje jako jeden balík Boxpi. Registrace u koncového dopravce je asynchronní — Globe několik sekund čeká, než se přidělí sledovací kód. Pokud ještě nedorazil, export přesto uspěje a mezitím se použije ID balíku Boxpi; kontrola stavu doručení jej nahradí skutečným sledovacím číslem koncového dopravce, jakmile se objeví.

Boxpi vyžaduje u každé zásilky telefonní číslo příjemce. Objednávky bez něj jsou zamítnuty ještě před odesláním.

Služby dopravců

Boxpi je agregátor — koncový dopravce se u každé objednávky určuje podle služby, na kterou dopravní metodu namapujete. ID služeb mají tvar CARRIER-SERVICE-COUNTRY, například GLS-COURIER-SK, PACKETA-POINT-CZ nebo SPS-POSTOFFICE-SK. Prostřední část říká, jak se zásilka doručuje:

Služba	Doručení
COURIER	Na adresu zákazníka
POINT	Na pobočku dopravce nebo do balíkomatu
POSTOFFICE	Na poštu

K dispozici je 62 služeb v Rakousku, Belgii, Bulharsku, Chorvatsku, Česku, Francii, Německu, Řecku, Maďarsku, Itálii, Lucembursku, Nizozemsku, Polsku, Rumunsku, na Slovensku a ve Slovinsku — včetně GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT a rakouské a slovenské pošty.

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

Služby POINT / POSTOFFICE — cíl je určen výhradně výdejním místem, které zákazník vybral při objednávce; pole s adresou ulice se ignorují. Pokud objednávka výdejní místo nemá, export se zamítne.
Služby COURIER — ulice, město a PSČ jsou povinné. Druhý řádek adresy se odesílá jako číslo popisné, pokud má 10 znaků nebo méně, jinak se připojí k ulici. Kraj / region z objednávky se předává jako oblast v zemi, kterou rumunští a bulharští kurýři vyžadují.

Boxpi ověřuje výdejní místo proti vlastním seznamům míst. ID míst z přímé integrace dopravce se s ID Boxpi spolehlivě neshodují, takže dopravní metody exportované přes Boxpi musí ve výběru při objednávce používat výdejní místa Boxpi — viz Přidání výdejních míst.

Dobírka (COD)

Boxpi podporuje dobírku. Částka se přebírá z objednávky a odesílá se v měně objednávky — CZK a HUF se zaokrouhlují na celé jednotky, ostatní měny na dvě desetinná místa. Jako variabilní symbol dobírky se používá číselná část názvu objednávky.

Boxpi ověřuje měnu proti vybrané službě. Pokud dobírka v dané měně není u dopravce, kterého jste namapovali, povolena, export se zamítne a u objednávky se zobrazí vlastní chybová zpráva Boxpi.

Zapněte Automaticky aktualizovat doručení v Shopify a poté Automaticky označit objednávky s dobírkou jako zaplacené, aby se dobírkové objednávky v Shopify označily jako zaplacené, jakmile je zásilka doručena.

Stav doručení

Boxpi je jedním z dopravců, u kterých je synchronizace stavů doručení k dispozici. Se zapnutou volbou Automaticky aktualizovat doručení v Shopify se Globe dotazuje Boxpi a udržuje stav plnění v Shopify aktuální, takže můžete objednávky filtrovat podle stavu přímo v Shopify administraci:

Stav v Shopify	Popis
Přidáno sledování	Zaregistrováno u Boxpi nebo dopravce, dosud fyzicky nepředáno.
V přepravě	Přijato ve skladu Boxpi nebo dopravcem, na cestě.
Doručování	V doručování na adresu, nebo připraveno k vyzvednutí na výdejním místě.
Neúspěšné doručení	Odmítnuto dopravcem, zrušeno, ztraceno, vrací se nebo vráceno.
Doručeno	Doručeno, nebo doručeno s vybranou dobírkou.

Volitelné nastavení Splnit objednávku až při předání dopravci odloží plnění v Shopify, dokud Boxpi nepotvrdí, že zásilka fyzicky dorazila k dopravci, místo aby se plnění vytvořilo hned při exportu.

Tisk štítků

Štítky Boxpi se generují jako PDF a lze je tisknout v následujících formátech:

Formát	Počet pozic na archu
A6	1
A4	4 (2×2 na jednom archu A4)

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

Štítky se na straně Boxpi vytvářejí asynchronně, takže štítek existuje až ve chvíli, kdy je balík zaregistrován u dopravce. Pokud tisknete ihned po exportu, Globe to několik sekund automaticky opakuje.

Štítky pro vrácení tato integrace nepodporuje — vratky je nutné řešit v portálu Boxpi.

Řešení problémů

Problém	Řešení
Ověření Boxpi selhalo	Zkontrolujte API klíč a ujistěte se, že odpovídá vybranému prostředí — produkční a testovací klíče se liší.
`Invalid Boxpi carrier ID`	Dopravní metoda je namapovaná na hodnotu, která není službou Boxpi. Namapujte ji znovu na službu ve tvaru `CARRIER-SERVICE-COUNTRY`.
`Pickup point must be selected for pickup point delivery`	Objednávka používá službu POINT nebo POSTOFFICE, ale nemá výdejní místo. Zkontrolujte, že jej zákazník při objednávce vybral.
`Recipient phone number is missing`	Boxpi vyžaduje telefonní číslo u každé zásilky. Před exportem jej k objednávce doplňte.
`Missing required address fields`	Kurýrní služby potřebují ulici, město a PSČ. Doplňte doručovací adresu a exportujte znovu.
Balík zamítnut dopravcem	Koncový dopravce zásilku odmítl — Globe zobrazí jeho vlastní chybu. Opravte data a objednávku exportujte znovu.
Štítek nebyl včas připraven	Registrace u dopravce stále probíhá. Chvíli počkejte a tiskněte znovu.
Výdejní místo nebylo přijato	ID místa v seznamu Boxpi pro daného dopravce neexistuje. Ujistěte se, že checkout u této dopravní metody nabízí výdejní místa Boxpi.

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