Vytvoření Shopify napojení pro Mergado Marketplaces

dominika.hrazdirova · říjen 24, 2025, 10:29am

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:

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

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

Varianta B: Přes Shopify administraci

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

b) Vytvořte novou aplikaci

Ujistěte se, že jste v sekci Apps
Klikněte na Create app
Zvolte Start from Dev Dashboard
Zadejte název aplikace (např. Mergado integration)
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í

V sekci Access klikněte na Select scopes
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

Potvrďte kliknutím na Done

e) Publikování (release) verze

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

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

f) Nainstalujte aplikaci do e‑shopu

V levém menu otevřete Home
Vpravo nahoře klikněte na Install app
Vyberte Shopify e‑shop, který chcete propojit s Mergadem
Budete přesměrováni do Shopify administrace
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.