Boxpi API

A Globe Pickup Points integrálódik a Boxpivel, a határokon átnyúló logisztikai aggregátorral. Egyetlen API-kapcsolat több mint 60 futárszolgálati szolgáltatást ad 16 európai piacon, anélkül hogy minden nemzeti futárszolgálattal külön szerződést kellene kötnie. Ezzel az integrációval a következőket teheti:

Rendeléseit exportálhatja a Boxpihez közvetlenül a Shopify-ból
Szállítási címkéket nyomtathat közvetlenül a Shopify-ban
Szállíthat csomagautomatákba, csomagpontokba és postákra, vagy az ügyfél címére
Támogatja az utánvétet (COD)
Szinkronizálhatja a kézbesítési állapotokat vissza a Shopify-ba

A Boxpi API integráció aktiválása

A Shopify adminisztrációjában nyissa meg a Globe Pickup Points alkalmazást, és lépjen a Szállítási címkék szekcióba. Adjon hozzá új futárszolgálatot, és válassza a Boxpi lehetőséget.
Adja meg az API kulcs értékét — ezt a Boxpi ügyfélszolgálatától szerezheti be. Az éles és a teszt környezet eltérő API-kulcsot használ.
Válassza ki a Környezet értékét — Éles az éles küldeményekhez, Fejlesztés a Boxpi teszt API-ján történő teszteléshez. Az API kulcsnak a kiválasztott környezethez kell tartoznia.
Igény szerint konfigurálja a teljesítési és címkézési lehetőségeket (Rendelések automatikus teljesítése, Rendelések automatikus megcímkézése nyomkövetési számmal, Egyéni címke az export után, Alapértelmezett súly (kg)).
Rendelje hozzá a Shopify szállítási módszereit azokhoz a Boxpi szolgáltatásokhoz, amelyeket használni szeretne.

Export és címkenyomtatás

A rendelések exportálhatók a Boxpihez és a szállítási címkék nyomtathatók közvetlenül a Shopify-ból, akár tömegesen, akár egyenként. Az általános folyamatról lásd a Szállítási címkék létrehozása oldalt.

Minden rendelés egy Boxpi csomagként kerül regisztrálásra. A végső futárszolgálatnál történő regisztráció aszinkron — a Globe néhány másodpercet vár a nyomkövetési kód kiosztására. Ha az még nem érkezett meg, az export akkor is sikeres, és addig a Boxpi csomagazonosítót használjuk; a kézbesítési állapot ellenőrzése ezt a valódi végső futárszolgálati nyomkövetési számra cseréli, amint az megjelenik.

A Boxpi minden küldeménynél kötelezővé teszi a címzett telefonszámát. Az ilyen adat nélküli rendeléseket a rendszer még az elküldés előtt visszautasítja.

Futárszolgálati szolgáltatások

A Boxpi aggregátor — a végső futárszolgálatot rendelésenként az a szolgáltatás határozza meg, amelyhez a szállítási módot hozzárendeli. A szolgáltatás-azonosítók a CARRIER-SERVICE-COUNTRY mintát követik, például GLS-COURIER-SK, PACKETA-POINT-CZ vagy SPS-POSTOFFICE-SK. A középső rész árulja el, hogyan történik a kézbesítés:

Szolgáltatás	Kézbesítés
COURIER	Az ügyfél címére
POINT	Csomagpontba vagy csomagautomatába
POSTOFFICE	Postára

62 szolgáltatás érhető el Ausztriában, Belgiumban, Bulgáriában, Horvátországban, Csehországban, Franciaországban, Németországban, Görögországban, Magyarországon, Olaszországban, Luxemburgban, Hollandiában, Lengyelországban, Romániában, Szlovákiában és Szlovéniában — köztük a GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT, valamint az osztrák és a szlovák posta.

Csomagátvételi pontok vs. házhozszállítás

POINT / POSTOFFICE szolgáltatások — a célállomást kizárólag az a csomagátvételi pont határozza meg, amelyet az ügyfél a pénztárban kiválasztott; az utcai cím mezőit figyelmen kívül hagyjuk. Ha a rendeléshez nem tartozik csomagátvételi pont, az exportot visszautasítja a rendszer.
COURIER szolgáltatások — az utca, a város és az irányítószám kötelező. A második címsor házszámként kerül elküldésre, ha legfeljebb 10 karakter hosszú, egyébként az utca végéhez fűződik. A rendelésen szereplő megye/régió országon belüli területként kerül továbbításra, amit a román és a bolgár futárszolgálatok megkövetelnek.

A Boxpi a csomagátvételi pontot a saját pontlistái alapján ellenőrzi. Egy közvetlen futárszolgálati integrációból származó pontazonosítók nem egyeznek megbízhatóan a Boxpi azonosítóival, ezért azoknak a szállítási módoknak, amelyeket a Boxpin keresztül exportál, a Boxpi csomagátvételi pontjait kell használniuk a pénztári választóban — lásd a Csomagátvételi pontos futárszolgálatok hozzáadása oldalt.

Utánvét (COD)

A Boxpi támogatja az utánvétet. Az összeg a rendelésből származik, és a rendelés pénznemében kerül elküldésre — a CZK és a HUF egész egységre, a többi pénznem két tizedesjegyre kerekítve. A rendelésnév számjegyekből álló része szolgál az utánvét változó szimbólumaként.

A Boxpi a pénznemet a kiválasztott szolgáltatáshoz méri. Ha az adott pénznemű utánvét nem engedélyezett a hozzárendelt futárszolgálatnál, az exportot visszautasítja a rendszer, és a Boxpi saját hibaüzenete jelenik meg a rendelésen.

Kapcsolja be a Szállítás állapotának automatikus frissítése Shopify-ban, majd az Utánvétes rendelések automatikus megjelölése fizetettként lehetőséget, hogy az utánvétes rendelések a csomag kézbesítése után fizetettként legyenek megjelölve a Shopify-ban.

Kézbesítési állapot

A Boxpi azon futárszolgálatok közé tartozik, amelyeknél a kézbesítési állapot szinkronizálása elérhető. Ha a Szállítás állapotának automatikus frissítése Shopify-ban be van kapcsolva, a Globe lekérdezi a Boxpit, és szinkronban tartja a Shopify teljesítési állapotát, így a rendeléseket állapot szerint szűrheti a Shopify adminisztrációjában:

Állapot a Shopify-ban	Leírás
Nyomon követés hozzáadva	Regisztrálva a Boxpinél vagy a futárszolgálatnál, még nem került fizikai átadásra.
Szállítás alatt	Beérkezett a Boxpi raktárába vagy a futárszolgálathoz, úton van.
Kézbesítés	Házhozszállítás alatt, vagy készen áll az átvételre a ponton.
Sikertelen kézbesítés	A futárszolgálat visszautasította, törölték, elveszett, visszaúton van vagy visszaérkezett.
Kézbesítve	Kézbesítve, vagy kézbesítve a beszedett utánvéttel.

Az opcionális Teljesítés csak a futár általi átvételkor beállítás a Shopify teljesítést addig halasztja, amíg a Boxpi vissza nem igazolja, hogy a csomag fizikailag megérkezett a futárszolgálathoz, ahelyett hogy az exportáláskor jönne létre.

Címkenyomtatás

A Boxpi címkék PDF formátumban jönnek létre, és az alábbi formátumokban nyomtathatók:

Formátum	Pozíciók száma ívenként
A6	1
A4	4 (2×2 egyetlen A4-es íven)

A4 nyomtatásakor kiválaszthatja a kezdőpozíciót (1–4 pozíció) a részben használt címkeívek újrafelhasználásához.

A címkék a Boxpi oldalán aszinkron módon jönnek létre, így címke csak azután létezik, hogy a csomagot regisztrálták a futárszolgálatnál. A Globe automatikusan újrapróbálkozik néhány másodpercig, ha közvetlenül az export után nyomtat.

A visszáru-címkék nem támogatottak ebben az integrációban — a visszaküldéseket a Boxpi portálján kell intézni.

Hibaelhárítás

Probléma	Megoldás
A Boxpi hitelesítés sikertelen	Ellenőrizze az API kulcsot, és győződjön meg arról, hogy megfelel a kiválasztott környezetnek — az éles és a teszt kulcs eltérő.
`Invalid Boxpi carrier ID`	A szállítási mód olyan értékhez van rendelve, amely nem Boxpi szolgáltatás. Rendelje hozzá újra egy `CARRIER-SERVICE-COUNTRY` szolgáltatáshoz.
`Pickup point must be selected for pickup point delivery`	A rendelés POINT vagy POSTOFFICE szolgáltatást használ, de nem tartozik hozzá csomagátvételi pont. Ellenőrizze, hogy az ügyfél kiválasztott-e pontot a pénztárban.
`Recipient phone number is missing`	A Boxpi minden küldeménynél telefonszámot igényel. Adja hozzá a rendeléshez az exportálás előtt.
`Missing required address fields`	A futárszolgáltatásokhoz utca, város és irányítószám szükséges. Egészítse ki a szállítási címet, és exportáljon újra.
A futárszolgálat visszautasította a csomagot	A végső futárszolgálat elutasította a küldeményt — a Globe a futárszolgálat saját hibaüzenetét mutatja. Javítsa az adatokat, és exportálja újra a rendelést.
A címke nem készült el időben	A futárszolgálatnál a regisztráció még folyamatban van. Várjon egy pillanatot, és nyomtasson újra.
A csomagátvételi pontot nem fogadta el	A pontazonosító nem szerepel a Boxpi adott futárszolgálathoz tartozó listájában. Győződjön meg arról, hogy a pénztár ehhez a szállítási módhoz Boxpi csomagátvételi pontokat kínál.

Add Boxpi pickup points to your Shopify store — pricing, demo & setup →