Vytvoření Shopify napojení pro Mergado Marketplaces#

Pokud si přejete využívat import objednávek pro Shopify, je nutné si nejprve vytvořit napojení na Shopify v Mergado Keychain.

Pokud již máte v Mergado Keychain napojení na Mergado přes API prostřednictvím “vlastní aplikace” v Shopify administraci, stačí si u dané aplikace v Shopify upravit seznam oprávnění viz níže.

Tento návod striktně vychází z oficiální dokumentace Shopify a aktuálního uživatelského rozhraní pro vytváření aplikací pomocí Shopify Developer Dashboardu.

Oficiální zdroje: https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard

Vytváříte vlastní (custom) API aplikaci pro jeden konkrétní e‑shop. Aplikaci není potřeba publikovat do Shopify App Store.

1. Vytvoření aplikace v Shopify#

Aby mělo Mergado Marketplaces API přístup k vašemu Shopify účtu, je nutné si vytvořit aplikaci s potřebnými oprávněními:

a) Otevřete Shopify Developer Dashboard#

Do Shopify Developer Dashboardu se můžete dostat dvěma způsoby:

Varianta A: Přímý přístup

1. Otevřete https://dev.shopify.com/
2. Přihlaste se pomocí svého Shopify účtu
3. V levém menu otevřete sekci Apps

Varianta B: Přes Shopify administraci

1. Otevřete Shopify administraci svého e‑shopu
2. Přejděte do Settings → Apps
3. Klikněte na Develop apps
4. Klikněte na Build apps in Dev Dashboard

b) Vytvořte novou aplikaci#

1. Ujistěte se, že jste v sekci Apps
2. Klikněte na Create app
3. Zvolte Start from Dev Dashboard
4. Zadejte název aplikace (např. Mergado integration)
5. Klikněte na Create

Po vytvoření aplikace budete přesměrováni na záložku Versions.

c) Vytvořte verzi aplikace a nastavte oprávnění (scopes)#

Každá aplikace musí mít alespoň jednu verzi, aby ji bylo možné nainstalovat do e‑shopu.

d) Nastavení přístupových oprávnění#

1. V sekci Access klikněte na Select scopes
2. V modálním okně vyhledejte a zaškrtněte:

Potřebná oprávnění pro Mergado Marketplaces:

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

A pokud si chcete přes API také importovat produkty do Mergada, tak přidejte:

• write_products
• read_products
• read_markets

3. Potvrďte kliknutím na Done

e) Publikování (release) verze#

1. Sjeďte níže na stránce
2. Klikněte na Release
3. V potvrzovacím okně můžete název verze ponechat prázdný
4. Potvrďte kliknutím na Release

Verze aplikace je nyní publikovaná a připravená k instalaci.

f) Nainstalujte aplikaci do e‑shopu#

1. V levém menu otevřete Home
2. Vpravo nahoře klikněte na Install app
3. Vyberte Shopify e‑shop, který chcete propojit s Mergadem
4. Budete přesměrováni do Shopify administrace
5. Instalaci potvrďte kliknutím na Install

Aplikace je nyní nainstalována v e‑shopu.

2. Napojení Shopify v Mergado Keychain#

Pro připojení Shopify v Mergado Keychain je potřeba:

• Shopify URL:

  • Otevřete Shopify administraci připojeného e‑shopu
  • V levém menu otevřete Home
  • V sekci Domains zkopírujte URL e‑shopu
  • Příklad: your-store.myshopify.com

• Přístupový klíč k Shopify API:

  • Vraťte se do Shopify Developer Dashboardu
  • Otevřete svou aplikaci
  • Přejděte do Settings
  • V sekci Credentials zkopírujte hodnotu Secret a vložte ji do Mergado Keychain

3. Aktivace objednávek v Mergado Marketplaces#

Přejděte do sekce Objednávky > Aktivace v Mergado Marketplaces, klikněte na ikonku Shopify a změny uložte. Synchronizaci můžete na stránce aktivace kdykoliv jednoduše pozastavit. Objednávky se synchronizují každých 5 minut.

ℹ️ Systém správy objednávek nesynchronizuje zpětně. Nemusíte se tedy bát, že by spuštěním byl váš systém zaplaven všemi předchozími objednávkami.

Hotovo! 🎉 Od teď už se objednávky budou pravidelně přenášet mezi vašimi marketplaces a Shopify.