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

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 Keychain kapcsolatod a Shopify adminisztrációban lévő egyedi alkalmazás segítségével, elég az alkalmazásnál módosítani a jogosultságok listáját (lásd alább).

Ez az útmutató a Shopify hivatalos dokumentációján alapul az alkalmazások Shopify Developer Dashboard segítségével történő létrehozásához.

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.

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.

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á:

• write_products
• read_products
• read_markets

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 Shopify Mergado Keychainben történő csatlakoztatásához a következőkre van szükséged:

• Shopify URL:

  • Nyisd meg a csatlakoztatott Webáruházad Shopify adminisztrációját
  • A bal oldali menüben nyisd meg a Home részt
  • A Domains szekcióban másold ki a Webáruház URL-jét
  • Példa: your-store.myshopify.com

• Shopify API hozzáférési kulcs:

  • Menj vissza a Shopify Developer Dashboardba
  • Nyisd meg az alkalmazásodat
  • Menj a Settings részbe
  • A Credentials szekcióban másold ki a Secret értéket, és illeszd be a Mergado Keychainbe

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

Menj a Megrendelések → Aktiváció szekcióba a Mergado Marketplaces-ben, kattints a Shopify ikonra, és mentsd a változtatásokat. A szinkronizációt bármikor szüneteltetheted. A megrendelések 5 percenként szinkronizálódnak.

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

Kész! :tada: 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.

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

A Shopify Developer Dashboardban nyisd meg az alkalmazásodat, menj a Settings részbe, és a Credentials szekcióban másold ki a Secret értéket. Ezt illeszd be a Mergado Keychainbe.

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

A Mergado Marketplaces-ben menj a Megrendelések → Aktiváció szekcióba, kattints a Shopify ikonra, é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.