Shopify csatlakoztatása

Megjegyzés: a félkövér angol feliratok a megfelelő kezelőelemeket jelölik. A kiválasztott nyelvtől függően ezek fordítva is megjelenhetnek.

A Shopify-kapcsolat rendeléseket, visszatérítéseket, fizetéseket és teljesítési adatokat importál. A támogatott készletmozgások a Belső készletmozgások nézetben is megjelenhetnek.

Mielőtt elkezded

Hozzáférésre van szükséged az üzlet Shopify-adminisztrációjához, valamint alkalmazások létrehozására és telepítésére jogosító engedélyre. Ha ezek a lehetőségek hiányoznak, kérj segítséget az üzlet tulajdonosától.

Az alkalmazást az üzlettel azonos Shopify-szervezetben kell létrehozni. Ha ügynökség végzi a beállítást, az üzlet tulajdonosának szervezetét használja. Az ügynökségi fiókon keresztüli hozzáférés önmagában nem elegendő.

A Shopify-ban nyisd meg a Settings → Domains oldalt, és másold ki a pontos *.myshopify.com domaint, például example.myshopify.com. Az előtagokat és a számokat is tartsd meg.

A Shopify-alkalmazás létrehozása és telepítése

Ha már van megfelelő alkalmazásod, nyisd meg, és ellenőrizd a jogosultságait és a telepítését.

1. Nyisd meg a Shopify Dev Dashboardot, és válaszd ki az üzletet tulajdonló szervezetet.
2. Válaszd az Apps → Create app → Start from Dev Dashboard lehetőséget. Adj felismerhető nevet, például „Balta Labs kapcsolat”, majd válaszd a Create gombot.
3. A Versions részen állítsd be a Scopes nevű hozzáférési jogosultságokat: read_orders a rendelésekhez, read_locations a helyszínekhez. A 60 napnál régebbi rendelésekhez add hozzá a read_all_orders jogosultságot. Ha a Shopify App URL címet kér, használhatod az alapértelmezett https://shopify.dev/apps/default-app-home címet.
4. A Release gombbal tedd elérhetővé a beállításokat a telepítéshez.
5. Nyisd meg az alkalmazás áttekintését, és az Installs részen válaszd az Install app lehetőséget. Jelöld ki a megfelelő üzletet, ellenőrizd a kért hozzáférést, és a Shopify-ban erősítsd meg az Install gombbal. Az alkalmazás létrehozása önmagában még nem kapcsolja össze az üzlettel.
6. Ugyanebben az alkalmazásban nyisd meg a Settings → Credentials oldalt, és másold ki a Client ID és Client secret értékeket. A secretet kezeld bizalmasan.

Raktári áthelyezések importálásához add hozzá a read_inventory, read_inventory_transfers és read_inventory_shipments jogosultságokat is. Ezek külön szükségesek; az alapvető kapcsolatteszt nem ellenőrzi őket. Jogosultságmódosítás után add ki a frissített verziót, és hagyd jóvá az új hozzáférést az üzletben, amikor a Shopify kéri.

A Shopify alkalmazásbeállítási útmutatója részletesen bemutatja a képernyőket.

Az üzlet hozzáadása a Balta Labsban

1. Nyisd meg a Settings → Connections → Add account → Shopify oldalt.
2. Adj meg egy opcionális Connection name nevet, a pontos Shop domain címet, valamint a telepített alkalmazás Client ID és Client secret értékeit.
3. Válaszd a Save credentials, majd a kapcsolat kártyáján a Test gombot.
4. Sikeres teszt után az Explore segítségével ellenőrizd a megadott jogosultságokat. Történeti importhoz nézd meg a régebbi rendelések elérését is.
5. Válaszd a Start import gombot. Ha a Test & start import felirat látható, az import előtt automatikusan ellenőrizzük a kapcsolatot. A folyamat állapota a kapcsolat alatt jelenik meg.

Minden üzletet külön adj hozzá. A hozzáférési adatok mentése még nem igazolja a kapcsolatot: a Connected felirat sikeres teszt után jelenik meg.

Gyakori problémák

A Shopify szerint az alkalmazás nincs telepítve

A Dev Dashboardban nyisd meg azt az alkalmazást, amelyből a megadott hozzáférési adatok származnak. Telepítsd a mentett domainhez tartozó üzletre, és ellenőrizd, hogy megjelenik-e az üzlet telepített alkalmazásai között. Egy másik üzletre végzett telepítés nem elegendő. Térj vissza a Balta Labsba, és válaszd újra a Test gombot.

A Shopify elutasítja a hozzáférési adatokat

Mindkét értéket ugyanannak a telepített alkalmazásnak a Settings → Credentials oldaláról másold ki. Az Admin API hozzáférési token és a Storefront-token nem helyettesíti a Client secret értéket. Javítsd az adatokat a Manage segítségével, mentsd, majd tesztelj újra. Az üresen hagyott hozzáférési mezők megtartják a mentett értéküket.

Az üzlet nem található vagy nem választható ki

A Shopify Settings → Domains oldaláról másold ki a domaint; ne az üzlet nevéből találd ki, és ne a nyilvános weboldal címét add meg. Ha telepítéskor nem látható az üzlet, ellenőrizd a kiválasztott szervezetet, és kérd meg a tulajdonost a hozzáférésed ellenőrzésére. A Shopify kapcsolódási feltételei ismertetik a szervezeti korlátozást.

A teszt sikeres, de rendelések vagy áthelyezések hiányoznak

A teszt azt igazolja, hogy az üzlet elérhető a megadott adatokkal. Az Explore alatt ellenőrizd a szükséges jogosultságokat. A régebbi rendelésekhez a read_all_orders és a read_orders együtt szükséges; az áthelyezésekhez a fent felsorolt további készletjogosultságok kellenek. Add ki és a Shopify-ban hagyd jóvá a módosításokat, majd tesztelj és importálj újra. A Shopify jogosultsági útmutatója ismerteti az esetleges további jóváhagyásokat.

A kapcsolat sikertelen, és az import nem indítható

A Test és a Manage továbbra is elérhető. Javítsd a telepítést vagy a beállításokat, majd tesztelj újra. Sikeres teszt után ismét elérhető az import és az újrapróbálkozás. Ha a változatlan beállítás korábban működött, várj egy kicsit, majd próbáld újra a Test gombot: lehet, hogy a Shopify átmenetileg nem érhető el.