Shopify kapcsolat létrehozása a Mergado Marketplaces-hez#

Ez a lépésről lépésre szóló útmutató bemutatja, hogyan hozz létre egy Shopify alkalmazást, állítsd be a szükséges API-jogosultságokat, és kapcsold össze a Shopify webáruházadat a Mergado Marketplaces-szel a megrendelések szinkronizálásához.

Ha szeretnéd használni a Shopify megrendelésimportot, először létre kell hoznod a Shopify kapcsolatot a Mergado Keychainben.

ℹ️ Ha már van Mergado API-kapcsolatod a Shopify adminisztrációban lévő „egyedi alkalmazás" segítségével a Mergado Keychainben, elég az alkalmazásnál módosítani a jogosultságok listáját a Shopify-ban (lásd alább).

Ez az útmutató szigorúan a Shopify hivatalos dokumentációján és az alkalmazások létrehozásakor aktuálisan elérhető felhasználói felületen alapul, a Shopify Developer Dashboard használatával.

Hivatalos forrás: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Egy egyedi (custom) API alkalmazást hozol létre egy konkrét webáruházhoz. Az alkalmazást nem szükséges közzétenni a Shopify App Store-ban.

Mire lesz szükséged?#

• Shopify-fiók admin hozzáféréssel a webáruházhoz
• hozzáférés a Shopify Developer Dashboardhoz

1. Alkalmazás létrehozása a Shopify-ban#

Ahhoz, hogy a Mergado Marketplaces API hozzáférjen a Shopify fiókodhoz, létre kell hoznod egy alkalmazást a szükséges jogosultságokkal.

a) Nyisd meg a Shopify Developer Dashboardot#

A Shopify Developer Dashboardba kétféleképpen juthatsz el:

A variáns: Közvetlen hozzáférés

1. Nyisd meg a https://dev.shopify.com/ oldalt
2. Jelentkezz be a Shopify fiókoddal
3. A bal oldali menüben nyisd meg az Apps szekciót

B variáns: A Shopify adminisztráción keresztül

1. Nyisd meg a webáruházad Shopify adminisztrációját
2. Menj a Settings → Apps menübe
3. Kattints a Develop apps gombra
4. Kattints a Build apps in Dev Dashboard gombra

b) Hozz létre egy új alkalmazást#

1. Győződj meg róla, hogy az Apps szekcióban vagy
2. Kattints a Create app gombra
3. Válaszd a Start from Dev Dashboard lehetőséget
4. Add meg az alkalmazás nevét (pl. Mergado integration)
5. Kattints a Create gombra

Az alkalmazás létrehozása után a Versions fülre leszel átirányítva.

c) Hozd létre az alkalmazás verzióját és állítsd be a jogosultságokat (scopes)#

Minden alkalmazásnak rendelkeznie kell legalább egy verzióval, hogy telepíthető legyen a webáruházba.

Az alkalmazás URL-jének és beágyazásának beállítása

• Az URLs szekcióban keresd meg az App URL mezőt
• Az alapértelmezett https://example.com értéket cseréld le erre:

https://app.mergado.com

Ez a lépés szükséges a Mergadóval való integráció megfelelő működéséhez. Ha az alapértelmezett érték marad, az engedélyezés nem fog megfelelően működni.

• Az App URL mező alatt vedd ki a pipát az Embed app in Shopify admin lehetőségnél

d) Hozzáférési jogosultságok beállítása#

1. Az Access szekcióban kattints a Select scopes gombra
2. A felugró ablakban keresd meg és jelöld be:

A Mergado Marketplaces-hez szükséges jogosultságok:

• read_customers + write_customers
• write_orders + read_orders
• read_products
• read_shipping + write_shipping
• write_order_edits + read_order_edits

Ha API-n keresztül is szeretnél termékeket importálni a Mergadóba, add hozzá:

• read_products
• write_products
• read_markets
• write_markets
• read_metaobjects

A termékek Mergadóba való importálásáról bővebben ebben a cikkben olvashatsz.

3. Erősítsd meg a Done gombra kattintva

e) Verzió kiadása (release)#

1. Görgess lejjebb az oldalon
2. Kattints a Release gombra
3. A megerősítő ablakban a verzió nevét üresen hagyhatod
4. Erősítsd meg a Release gombra kattintva

Az alkalmazás verziója most már kiadva van és készen áll a telepítésre.

f) Telepítsd az alkalmazást a webáruházba#

1. A bal oldali menüben nyisd meg a Home részt
2. Jobb felül kattints az Install app gombra
3. Válaszd ki a Shopify webáruházat, amelyet össze szeretnél kapcsolni a Mergadóval
4. Át leszel irányítva a Shopify adminisztrációba
5. A telepítést erősítsd meg az Install gombra kattintva

Az alkalmazás most már telepítve van a webáruházban.

2. Shopify kapcsolat a Mergado Keychainben#

a) Szerezd meg az API hozzáférési adatokat (Client ID és token)#

Az alkalmazás telepítése után két értékre lesz szükséged a Mergadóval való integrációhoz:

1. Client ID
2. API hozzáférési token (Secret)

Lépések:

1. Menj vissza a Shopify Developer Dashboardba
2. Nyisd meg az alkalmazásodat
3. Menj a Settings részbe
4. A Credentials szekcióban:
   • másold ki a Client ID értékét (ez a mező a Secret felett található)
   • másold ki a Secret értékét

A Client ID az alkalmazást azonosítja, a Secret az API hozzáférési tokenként működik. A Mergadóval való integráció megfelelő működéséhez mindkét értékre szükség van.

b) Szerezd meg a webáruház URL-jét#

1. Nyisd meg a csatlakoztatott webáruházad Shopify adminisztrációját
2. A bal oldali menüben nyisd meg a Home részt
3. A Domains szekcióban másold ki a webáruház URL-jét

Példa:

your-store.myshopify.com

c) Kapcsold össze a Shopify-t a Mergadóval#

1. Nyisd meg a Mergado Keychain-t
2. Töltsd ki a következő mezőket:
   • Shopify URL → illeszd be a webáruház URL-jét
   • Client ID → illeszd be a Shopify Developer Dashboardból kimásolt Client ID értékét
   • Client Secret → illeszd be a kimásolt Secret értékét
3. Kattints a Bejelentkezés gombra

3. Megrendelések aktiválása a Mergado Marketplaces-ben#

Menj a Mergado Marketplaces Kapcsolat szekciójába, a Shopify melletti “Megrendelések szinkronizálása” gombbal aktiváld a megrendeléseket, és mentsd a változtatásokat. A szinkronizációt az aktiválás oldalán bármikor szüneteltetheted. A megrendelések 5 percenként szinkronizálódnak.

ℹ️ A rendszer nem szinkronizál visszamenőlegesen – az aktiválás előtti megrendelések nem kerülnek át.

Kész! 🎉 Mostantól a megrendelések rendszeresen szinkronizálódnak a marketplace-eid és a Shopify között.

GYIK#

Milyen jogosultságok szükségesek a Shopify alkalmazáshoz?#

A Mergado Marketplaces-hez a következők szükségesek: read_customers + write_customers, write_orders + read_orders, read_products, read_shipping + write_shipping, write_order_edits + read_order_edits. Ha termékeket is szeretnél importálni a Mergadóba, add hozzá: read_products, write_products, read_markets, write_markets, read_metaobjects.

Hol találom a Shopify API hozzáférési adatokat?#

A Shopify Developer Dashboardban nyisd meg az alkalmazásodat, menj a Settings részbe, és a Credentials szekcióban másold ki a Client ID és a Secret értékét. Mindkét értékre szükség van a Mergado Keychainben való csatlakozáshoz.

Hogyan aktiválom a megrendelések szinkronizálását?#

A Mergado Marketplaces-ben menj a Kapcsolat szekciójába, a Shopify melletti “Megrendelések szinkronizálása” gombbal aktiváld a megrendeléseket, és mentsd a változtatásokat. A megrendelések 5 percenként szinkronizálódnak.

Közzé kell tennem az alkalmazást a Shopify App Store-ban?#

Nem, egy egyedi (custom) API alkalmazást hozol létre a konkrét webáruházadhoz. Közzétételre nincs szükség.