UPS API

A Globe Pickup Points integrálódik a UPS-szel, a világszintű csomagszállítóval, lehetővé téve a rendelések exportálását és a szállítási címkék nyomtatását közvetlenül a Shopify-ból. Ezzel az integrációval a következőket teheti:

Rendeléseit exportálhatja a UPS-hez közvetlenül a Shopify-ból
Szállítási címkéket nyomtathat közvetlenül a Shopify-ban
15 UPS belföldi, európai és világszintű szolgáltatással szállíthat
Nemzetközi csomagokat küldhet a Shopify termékeiből automatikusan létrehozott vámadatokkal

A UPS áruházanként, kérésre kapcsolható be. Ha nem látja a UPS-t a futárszolgálatok listájában, vegye fel a kapcsolatot a Globe támogatással, és bekapcsoljuk az áruházában.

A UPS 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 UPS lehetőséget.
Adja meg a Számlaszám értékét — a UPS feladói számlaszámát, amely a UPS számlázási fiókjának adatai között látható.
Töltse ki a feladó adatait: Feladó neve, Feladó utca, Feladó város, Feladó irányítószám, Feladó ország és Feladó telefonszám. A Feladó e-mail opcionális.
A Feladó állam/tartomány egy állam- vagy tartománykód (például NY, CA). Az Egyesült Államokból vagy Kanadából történő feladásnál kötelező, máshol üresen hagyható.
Kattintson a UPS fiók csatlakoztatása gombra. Megnyílik egy UPS ablak, ahol bejelentkezik a UPS hitelesítő adataival, és engedélyezi a Globe hozzáférését. Miután visszatér, a kapcsolat tárolódik, és a hozzáférési token automatikusan frissül — sehol nem kell API kulcsot vagy jelszót megadnia.
Igény szerint konfigurálja a teljesítési és címkézési lehetőségeket.
Rendelje hozzá a Shopify szállítási módszereit azokhoz a UPS szolgáltatásokhoz, amelyek a fiókján elérhetők.

A UPS fiókot bármikor leválaszthatja ugyanezen a képernyőn; az exportálás mindaddig blokkolva marad, amíg újra nem csatlakoztatja.

Export és címkenyomtatás

A rendelések exportálhatók a UPS-hez é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. Magáról a címkézési folyamatról lásd a Szállítási címkék létrehozása oldalt.

Minden küldemény kap egy UPS nyomkövetési számot, a címke képe pedig a rendeléssel együtt tárolódik, így később újranyomtatható anélkül, hogy ismét a UPS-hez kellene fordulni. Ha a Globe már nem rendelkezik a tárolt képpel, azt a nyomkövetési szám alapján a UPS címke-helyreállító szolgáltatásából kéri vissza. A csomagok a https://www.ups.com/track?tracknum=<nyomkövetési szám> címen követhetők.

Szolgáltatástípusok

Egy rendelés exportálásakor válassza ki azt a szolgáltatást, amely megfelel a UPS szerződésének:

Kód	Szolgáltatás	Tipikus felhasználás
03	UPS Ground	Belföldi közúti (US)
11	UPS Standard	Közúti kézbesítés Európán belül
01	UPS Next Day Air	Belföldi másnapi légi
02	UPS 2nd Day Air	Belföldi kétnapos légi
12	UPS 3 Day Select	Belföldi háromnapos légi
13	UPS Next Day Air Saver	Belföldi másnapi, nap végéig
14	UPS Next Day Air Early	Belföldi másnapi, kora reggel
59	UPS 2nd Day Air A.M.	Belföldi kétnapos, délelőtti kézbesítés
07	UPS Worldwide Express	Nemzetközi expressz
08	UPS Worldwide Expedited	Nemzetközi, garantált napra
54	UPS Worldwide Express Plus	Nemzetközi, kora reggel
65	UPS Worldwide Saver	Nemzetközi expressz, nap végéig
96	UPS Worldwide Express Freight	Nemzetközi raklapos áruszállítás
71	UPS Worldwide Economy DDU	Gazdaságos, vám nélkül fizetve
72	UPS Worldwide Economy DDP	Gazdaságos, vámmal fizetve

Nem minden szolgáltatás érhető el minden fiókon és minden feladási országból — a UPS visszautasítja azt a küldeményt, amely olyan szolgáltatást használ, amelyre a fiókjának nincs szerződése.

Csak házhoz- és céges kézbesítés

A Globe-ban létrehozott UPS címkék mindig az ügyfél otthoni vagy céges címére szólnak, amelyet a Shopify rendelésből veszünk. A UPS Access Point helyszínekre történő kézbesítés nem támogatott — a pénztárban kiválasztott csomagátvételi pont nem kerül továbbításra a UPS felé, és a csomagot a szállítási címre kézbesítik. Ne rendeljen csomagátvételi pontos szállítási módot UPS szolgáltatáshoz. A visszáru-címkék szintén nem támogatottak.

Speciális küldeménybeállítások

Ezeket a lehetőségeket küldeményenként állítja be az export párbeszédpanelen. Nem a futárszolgálat beállításai — a UPS futárszolgálati fiókban nincs hely az alapértékeik tárolására, ezért állítsa be azokon a küldeményeken, amelyeknél szükségesek.

Lehetőség	Leírás
Csomagolás típusa	Saját csomagolás (alapértelmezett), UPS levél, Tubus, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box
Tartalom leírása	A címkére nyomtatott és a vámokmányokon használt küldeményleírás. Alapértelmezés: `Goods`.
HS kód	Az adott küldemény vámokmányain használt HS kód, ha a terméknek nincs HS kódja a Shopify-ban.

Vám és nemzetközi küldemények

A vámokmányok (kereskedelmi számla) automatikusan hozzáadódnak, ha a feladó országa és a célország eltér, és a küldemény nem EU-n belüli mozgás. A Globe a számlát a rendelés tételeiből építi fel:

Terméknév, mennyiség, egységár és SKU
HS kód a termék Shopify készlettételéből, visszaesve az adott küldeményhez az export párbeszédpanelen megadott HS kód értékre
Származási ország a termék Shopify készlettételéből, visszaesve a feladó országára
Tételsúly a Shopify-ból, a küldemény súlyegységére konvertálva

A számla száma a Shopify rendelésszám, az export oka SALE, a pénznem pedig a rendelés pénzneme. A súlyok kilogrammban kerülnek elküldésre, kivéve az Egyesült Államokban, Puerto Ricóban és az Amerikai Virgin-szigeteken lévő feladóknál, ahol fontot használunk.

Utánvét (COD)

A UPS a Globe-ban nem támogatja az utánvétet. A rendszer nem küld utánvét összeget a UPS-nek, így a UPS-hez exportált utánvétes rendelés normál, előre fizetett csomagként kerül feladásra, és kézbesítéskor nem szednek be pénzt. Ilyen rendelésekhez használjon utánvétet támogató futárszolgálatot, vagy exportálás előtt váltson az ügyfélnél előre fizetett fizetési módra.

Kézbesítési állapot

A UPS integráció nem szinkronizálja vissza a kézbesítési állapotokat a Shopify-ba. A nyomkövetési szám és a nyomkövetési link továbbra is a teljesítéshez kerül (ha az automatikus teljesítés be van kapcsolva), így a kézbesítés előrehaladása követhető a ups.com oldalon.

Címkenyomtatás

A UPS 4×6 hüvelykes címkeképet ad vissza, amelyet a Globe PDF-be konvertál, és nyomtatáshoz álló tájolásba forgat. Az alábbi formátumok érhetők el:

Formátum	Pozíciók száma ívenként
A6	1
A6 A4-en	4

Ha A6 címkéket nyomtat A4-re, kiválaszthatja a kezdőpozíciót az íven (1–4 pozíció) a részben használt ívek újrafelhasználásához.

Hibaelhárítás

Probléma	Megoldás
A UPS fiók nincs csatlakoztatva	Nyissa meg a futárszolgálat beállításait, és kattintson a UPS fiók csatlakoztatása gombra a UPS bejelentkezés befejezéséhez.
A UPS hitelesítés sikertelen — a token lejárhatott	A tárolt UPS engedélyt nem sikerült megújítani. Válassza le, majd csatlakoztassa újra a UPS fiókot.
Érvénytelen vagy lejárt munkamenet a csatlakoztatás közben	A UPS bejelentkezést 10 percen belül be kell fejezni. Zárja be az ablakot, és indítsa újra a csatlakoztatást.
A küldemény létrehozása UPS üzenettel meghiúsult	Az üzenet közvetlenül a UPS-től érkezik. Leggyakrabban a szolgáltatás nincs engedélyezve a fiókján, a címzett címe hiányos, vagy a számlaszám nem egyezik a feladó címével.
Hiányzó vagy érvénytelen állam/tartomány	Az egyesült államokbeli és kanadai feladóknak és címzetteknek érvényes állam- vagy tartománykód szükséges. Töltse ki a Feladó állam/tartomány mezőt, és ellenőrizze az ügyfél címét.
Nem sikerült címkéket lekérni a UPS-től	A tárolt címkekép hiányzik, és a címke-helyreállítás sem sikerült. Ellenőrizze, hogy a küldeménynek van-e nyomkövetési száma, és hogy a UPS fiók még csatlakoztatva van-e.
Az utánvétes rendelést pénzbeszedés nélkül kézbesítették	Ez a várt működés — a Globe UPS küldeményei soha nem utánvétesek. Lásd fent az Utánvét (COD) szakaszt.

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