ShippyPro API
A Globe Pickup Points integrálódik a ShippyPróval, azzal a több futárszolgálatot kezelő szállítási platformmal, amelyen keresztül azokkal a futárszolgálati szerződésekkel szállíthat, amelyeket a saját ShippyPro-fiókjában már csatlakoztatott. Ezzel az integrációval a következőket teheti:
- Rendeléseit exportálhatja a ShippyPróba közvetlenül a Shopify-ból
- Szállítási címkéket nyomtathat közvetlenül a Shopify-ban
- Szállíthat csomagátvételi pontokba vagy az ügyfél címére, a választott futárszolgálati szolgáltatástól függően
- Támogatja az utánvétet (COD) és a vámáru-nyilatkozatokat (CN22) a határokon átnyúló küldeményeknél
A rendelések 33 célországba exportálhatók — az EU, az Egyesült Királyság, Svájc, Norvégia, az Egyesült Államok, Kanada és Ausztrália.
A ShippyPro API integráció aktiválása
Szekció neve “A ShippyPro 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 ShippyPro lehetőséget.
- Adja meg az API kulcs értékét — ezt a ShippyPro fiókjában találja. Ez az egyetlen kötelező hitelesítő adat.
- Kattintson a Fetch carriers gombra. A Globe ellenőrzi a kulcsot, és letölti a ShippyPro-fiókjához csatlakoztatott összes futárszolgálatot és szolgáltatást, hogy hozzárendelhesse őket a Shopify szállítási módjaihoz.
- Töltse ki a címkére nyomtatott feladói adatokat: Feladó neve, Feladó cég neve, Feladó utca, Feladó város, Feladó irányítószám, Feladó ország (kétbetűs kód, például
CZ,SK,HU), Feladó telefonszám és Feladó e-mail. - 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 és Egyéni címke az export után.
- Rendelje hozzá a Shopify szállítási módszereit a letöltött futárszolgálati szolgáltatásokhoz.
A Globe-ban nincs külön ShippyPro sandbox — a megadott API kulccsal valódi küldemények jönnek létre a fiókján.
Export és címkenyomtatás
Szekció neve “Export és címkenyomtatás”A rendelések exportálhatók a ShippyPróba é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. A teljes folyamatról lásd a Szállítási címkék létrehozása oldalt.
Minden export egyetlen hívásban létrehozza a küldeményt, és visszaad egy nyomkövetési számot és egy címkét, így a címkék azonnal nyomtathatók. A Shopify rendelésneve küldeményhivatkozásként és megjegyzésként kerül elküldésre. Az export után a nyomkövetési szám a teljesítés nyomon követésére szolgál — a ShippyPro által jelentett futárszolgálat kerül be a Shopify-ba nyomon követő szolgáltatóként.
Futárszolgálatok és szolgáltatások
Szekció neve “Futárszolgálatok és szolgáltatások”A ShippyPrónak nincs saját hálózata. A futárszolgálatok, a szolgáltatások és a díjszabások az Ön ShippyPro-fiókjából származnak, így az exportáláskor látott lista pontosan az, amit ott csatlakoztatott. Ha új futárszolgálatot ad hozzá a ShippyPróban, kattintson újra a Fetch carriers gombra a Globe futárszolgálati beállításaiban, hogy behúzza azt.
Ha a fiókja nem ad vissza futárszolgálat-listát (például amikor a ShippyPro API átmenetileg nem érhető el), a Globe visszaesik a kézi bevitelre, és lehetővé teszi, hogy a futárszolgálat definícióját JSON formátumban illessze be. A várt formátumot a Copy sample gombbal kaphatja meg.
Csomagátvételi pontok vs. házhozszállítás
Szekció neve “Csomagátvételi pontok vs. házhozszállítás”- Ha a rendeléshez a pénztárban kiválasztott csomagátvételi pont tartozik, és csomagátvételi pontos szolgáltatással exportálja, a Globe futárszolgálati opcióként elküldi a pont azonosítóját a ShippyPrónak, így a csomag ahhoz a ponthoz kerül.
- Azok a szolgáltatások, amelyek neve házhozszállításra utal, mindig az ügyfél szállítási címére szállítanak, még akkor is, ha a rendeléshez pont tartozik.
Maguk a csomagátvételi pontok bármely, a pénztárban használt szolgáltatótól származhatnak, vagy a ShippyPro PUDO szolgáltatótól, amely élőben kérdezi le a ShippyPro-fiókjában lévő futárszolgálatok csomagátvételi pontjait. Lásd a Csomagátvételi pontos futárszolgálatok hozzáadása oldalt.
Exportáláskor a Globe Type selection mismatch figyelmeztetést jelenít meg, ha a kiválasztott ShippyPro futárszolgálat nem tűnik annak a futárszolgálatnak, amelyhez a rendelésen szereplő csomagátvételi pont tartozik — például egy Packeta pont GLS szolgáltatással exportálva. Az exportot ez nem blokkolja, ezért a folytatás előtt tekintse át a figyelmeztetést.
Csomagsúly és -méretek
Szekció neve “Csomagsúly és -méretek”A ShippyPro valódi súlyt igényel. A Globe soha nem talál ki súlyt: ha a rendeléshez nincs beállítva súly a Shopify-ban, az exportot visszautasítja a rendszer. Adja meg a termékek súlyát a Shopify-ban, és exportáljon újra.
A csomagméretek opcionálisak. A Csomag hossza (cm), Csomag szélessége (cm) és Csomag magassága (cm) speciális lehetőségek, nem futárszolgálati beállítások, és ha nincs érték megadva, mindegyik méretnél 1 cm kerül elküldésre. Ha a kiválasztott futárszolgálati szolgáltatás biztosítási lehetőséget kínál, a küldemény a rendelés végösszegére lesz biztosítva.
A határokon átnyúló küldeményeknél a Globe a rendelés tételeiből építi fel a CN22 nyilatkozatot — leírás, mennyiség, egységérték, súly, HS kód és származási ország a termék készlettételéből. Ahol a termékadatok hiányosak, ezek a futárszolgálati beállítások töltik ki a hézagokat:
| Beállítás | Mire szolgál |
|---|---|
| Feladó ország | Származási ország, ha egy terméknek nincs ilyen adata |
| Contents type | A CN22 nyomtatványon feltüntetett árutípus (Merchandise, Gift, Documents, Commercial Sample, Returned Goods) |
| DDP országok | Azok a célországok, amelyekbe DDP feltételekkel szállít (a vámokat Ön fizeti); az összes többi célország DDU-ként kerül elküldésre |
A Tartalom leírása (a küldemény tartalmának leírása, alapértelmezetten Goods) és a HS kód (az a vámtarifakód, amelyet akkor használunk, ha a terméknek nincs ilyenje) nem futárszolgálati beállítások — ezek speciális lehetőségek, amelyeket küldeményenként tölt ki az export párbeszédpanelen.
Utánvét (COD)
Szekció neve “Utánvét (COD)”A ShippyPro támogatja az utánvétet. Ha a rendelésen beszedendő összeg maradt, a Globe elküldi az utánvét összegét a rendelés pénznemével együtt, a ShippyPro pedig továbbadja azt a végső futárszolgálatnak. Azok a rendelések, amelyeknél nincs beszedendő összeg, normál küldeményként kerülnek exportálásra. Az, hogy az utánvét ténylegesen elérhető-e — és milyen pénznemekben —, a ShippyPro-fiókjában a kiválasztott szolgáltatás mögött álló futárszolgálati szerződéstől függ.
Kézbesítési állapot
Szekció neve “Kézbesítési állapot”A kézbesítési állapot szinkronizálása a ShippyPrónál nem érhető el — a csomagállapotok nem íródnak vissza a Shopify-ba, így az előrehaladást a ShippyPróban vagy a végső futárszolgálat nyomkövetési oldalán kell követni. A nyomkövetési szám és a nyomkövetési link továbbra is a teljesítéshez kerül. A visszáru-címkék szintén nem támogatottak; ezeket közvetlenül a ShippyPróban hozza létre.
Címkenyomtatás
Szekció neve “Címkenyomtatás”A címkéket a Globe a nyomtatáskor kéri le a ShippyPrótól a kiválasztott méretben, és a köteg összes címkéjét egyetlen többoldalas PDF-be fűzi:
| Formátum | Leírás |
|---|---|
| A6 | 10,5 × 14,8 cm méretben megjelenített címke |
| A4 (4 db) | 21 × 29,7 cm méretben megjelenített címke |
Mivel a címkét maga a ShippyPro állítja elő, az oldalon látható pontos elrendezés a végső futárszolgálat saját címkesablonjából származik. A címkék bármikor újranyomtathatók — a Globe minden küldeményhez friss letöltési URL-t kér le, és visszaesik az exportáláskor tárolt címke-URL-re.
Hibaelhárítás
Szekció neve “Hibaelhárítás”| Probléma | Megoldás |
|---|---|
| ”Invalid API key — please check your ShippyPro credentials” | A ShippyPro visszautasította a kulcsot. Másolja ki újra a ShippyPro fiókjából, és mentse a futárszolgálatot. |
| ”ShippyPro API key is not configured” | Az API kulcs mező üres a futárszolgálati fiókon. Töltse ki, és mentsen. |
| ”No carriers configured. Use the ‘Fetch carriers’ button” | A futárszolgálat-listát még soha nem töltötték le. Nyissa meg a futárszolgálat beállításait, és kattintson a Fetch carriers gombra. |
| ”Please select a carrier before exporting.” | A rendeléshez választott szolgáltatás nem szerepel a letöltött listában — általában akkor, ha a lista megváltozott. Töltse le újra a futárszolgálatokat, és rendelje hozzá ismét a szállítási módot. |
| ”Order has no weight set.” | A ShippyPro nem nulla súlyt igényel. Adja meg a termékek súlyát a Shopify-ban, majd exportáljon újra. |
| Az exportot futárszolgálati hibaüzenettel utasították vissza | A ShippyPro továbbadja a végső futárszolgálat ellenőrzési hibáját a javasolt megoldással együtt — jellemzően hiányos cím, nem támogatott célország, vagy a fiókján nem engedélyezett szolgáltatás. |
| A csomag a csomagátvételi pont helyett a címre lett feladva | A futárszolgálati szolgáltatáshoz nincs tárolva csomagátvételi pontos lehetőség. Kattintson újra a Fetch carriers gombra a futárszolgálati opciók frissítéséhez, majd exportáljon újra. |
| ”Could not retrieve label for order …” | Sem a friss címke-URL-t, sem a tároltat nem sikerült letölteni. Várjon egy pillanatot, és nyomtassa ki újra a köteget; ha továbbra sem sikerül, exportálja újra a rendelést. |