Shopify csatlakoztatása a Mergado Editorhoz#

Fontos tudnivalók a csatlakoztatáshoz#

Az URLs > App URL mezőbe írd be: https://app.mergado.com/

Ezt az URL-t kell megadnod az App URL mezőben, amikor egyedi alkalmazást hozol létre a Shopifyban.

Minimális jogosultságok (scopes), amelyekre a Mergadónak szüksége van – ezek nélkül az integráció nem működik:

write_products,read_products,write_markets,read_markets,read_metaobjects

Ha a Mergado Marketplaces-t is használni szeretnéd, ezekre a jogosultságokra is szükség van:

read_customers,write_customers,write_orders,read_orders,read_products,read_shipping,write_shipping,write_order_edits,read_order_edits

Ez az útmutató a Shopify hivatalos dokumentációján és az aktuális felhasználói felületen alapul, a Shopify Developer Dashboard segítségével történő alkalmazáslétrehozáshoz.

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

Kinek szól ez az útmutató#

• Shopify kereskedőknek, akik össze akarják kapcsolni a webáruházukat a Mergadóval
• Ügynökségeknek és fejlesztőknek, akik a Shopify ↔ Mergado integrációt állítják be
• Bárkinek, aki Shopify API hozzáférési tokent szeretne szerezni

Saját (custom) API alkalmazást hozol létre egyetlen webáruház számára. Az alkalmazást nem kell közzétenni a Shopify App Store-ban.

Amire szükséged lesz#

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

Mielőtt elkezded: Ellenőrizd a piacok (Markets) beállítását#

Ez a lépés szükséges ahhoz, hogy a Mergado importálhassa az egyes piacok termékeit.

Az alkalmazás létrehozása előtt ellenőrizd a Markets beállítást a Shopify adminisztrációban.

Amit be kell állítani#

Minden piac (Market) esetében, amelyből termékeket szeretnél a Mergadóba importálni:

• hozzá kell rendelni egy domaint
• hozzá kell rendelni egy nyelvet
• mindkét értéknek a Customized szekcióban kell szerepelnie

Nem elég, ha csak az Inherited szekcióból vannak örökölve vagy Primary értékként vannak beállítva.

Lépések a Shopify adminisztrációban#

1. Nyisd meg a Shopify adminisztrációt
2. A bal oldali főmenüben kattints a Markets elemre
3. Nyisd meg az adott piacot (pl. Hungary)
4. Görgess le az Inherited szekcióhoz
5. A Domain / language tételnél kattints a + ikonra
6. A felugró ablakban:
   • jelöld be a kívánt domaint
   • jelöld be a kívánt nyelvet
7. Erősítsd meg a Done gombbal
8. Ellenőrizd, hogy a Domain / language átkerült a Customized szekcióba
9. Mentsd el a Save gombbal

Ha a Domain / language csak az Inherited részben marad, a Shopify API nem ad adatot az adott piachoz, és a Mergado nem tudja importálni a termékeket.

1. lépés – Shopify Developer Dashboard megnyitása#

A Developer Dashboard-ot kétféleképpen érheted 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 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

2. lépés – Új alkalmazás létrehozása#

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

Ezután átirányítanak a Versions fülre.

3. lépés – Alkalmazásverzió létrehozása és jogosultságok beállítása#

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

3.1 App URL és beágyazás beállítása#

1. A URLs szekcióban keresd meg az App URL mezőt
2. 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 Mergado integrációjának helyes működéséhez. Ha az alapértelmezett érték marad, az engedélyezés nem fog működni.

3. Az App URL mező alatt töröld az Embed app in Shopify admin jelölőnégyzetet

3.2 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:
   • read_products
   • write_products
   • read_markets
   • write_markets
   • read_metaobjects
3. Erősítsd meg a Done gombbal

Ezek a jogosultságok szükségesek ahhoz, hogy a Mergado be tudja tölteni a termékeket és a piacokra vonatkozó adatokat.

3.3 Verzió közzététele (Release)#

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

Az alkalmazás verziója most közzé van téve és készen áll a telepítésre.

4. lépés – Alkalmazás telepítése a webáruházba#

1. A bal menüben nyisd meg a Home elemet
2. Jobb felül kattints az Install app gombra
3. Válaszd ki a Shopify webáruházat, amelyet a Mergadóval szeretnél összekapcsolni
4. Átirányítanak a Shopify adminisztrációba
5. A telepítést erősítsd meg az Install gombbal

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

5. lépés – API hozzáférési adatok megszerzése (Client ID és token)#

A telepítés után szükséged lesz két értékre a Mergadóval való összekötéshez:

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 menübe
4. A Credentials szekcióban:
   • másold ki a Client ID értéket (a Secret felett található)
   • másold ki a Secret értéket

A Client ID az alkalmazás azonosítója, a Secret az API hozzáférési token. A Mergado integrációjához mindkét érték szükséges.

6. lépés – Webáruház URL-jének megszerzése#

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

Példa: your-store.myshopify.com

7. lépés – Shopify összekötése a Mergadóval#

1. Nyisd meg a Mergadót
2. Hozz létre egy új projektet
3. Adatforrásként válaszd a Shopify-t
4. Töltsd ki:
   • Shopify URL → a webáruház URL-je
   • Client ID → a Developer Dashboardból kimásolt Client ID
   • Client Secret → a kimásolt Secret érték
5. Kattints a Log in gombra

GYIK#

A Market kiválasztása után nem töltődik be a nyelv. Miért?#

A leggyakoribb ok a Markets szekció beállításában van. Ha a Domain / language csak az Inherited szekcióban szerepel és nincs a Customized szekcióban, a Shopify API nem ad adatot az adott piachoz.

Megoldás:

• Nyisd meg a Shopify admin → Markets menüt
• Nyisd meg az adott piacot
• A Domain / language tételnél kattints a + gombra
• Válaszd ki a domaint és a nyelvet
• Kattints a Done, majd a Save gombra
• Ellenőrizd, hogy a tétel átkerült a Customized szekcióba

A Mergado egyes metafield értékeket nem tölt be helyesen. Miért?#

Ha egyes metafield-eknél a helyes név (key) jelenik meg, de az érték (value) ID-ként látszik (pl. ["gid://shopify/Metaobject/94942036012"]) vagy a „Missing required scope" üzenet jelenik meg, az alkalmazásnak hiányzik a read_metaobjects jogosultsága.

Megoldás:

1. Menj a Shopify Developer Dashboardba
2. Nyisd meg a Mergado integrációhoz létrehozott alkalmazást
3. A bal menüben menj a Versions menüre
4. Kattints a New version gombra
5. A Scopes szekcióban add hozzá a read_metaobjects scope-ot
6. Erősítsd meg és kattints a Release gombra

Az új verzió kiadása után újra kell engedélyezni a csatlakozást:

1. Nyisd meg a Mergado Keychain bővítményt
2. Töröld a meglévő kapcsolatot
3. Töltsd ki újra az adatokat: Shopify URL, Client ID, Secret
4. Jelentkezz be újra (Log in)

A scope hozzáadása és az újraengedélyezés után a metafield értékek helyesen töltődnek be.