Nový projekt - vygenerování Shopify API credentials

petrmindl · leden 28, 2025, 2:46odp.

Jak vygenerovat Shopify API údaje pro Mergado (od 1. ledna 2026)

---

DŮLEŽITÉ instrukce pro napojení

Do pole URLs > App URL
vložte: https://app.mergado.com/
_{Tuto URL adresu musíte vložit do pole App URL při vytváření custom aplikace v Shopify.}

Minimální oprávnění (scopes), která Mergado potřebuje.
Bez těchto oprávnění nebude integrace fungovat.

write_products,read_products,write_markets,read_markets,read_metaobjects

Oprávnění (scopes), pokud chcete využívat také Mergado Marketplaces

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

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

Pro koho je tento návod určen

Tento článek je určen pro:

obchodníky na Shopify, kteří chtějí propojit svůj e‑shop s Mergadem
agentury a vývojáře nastavující integraci Shopify ↔ Mergado pro klienty
kohokoliv, kdo potřebuje získat Shopify API přístupový token

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

Co budete potřebovat

Shopify účet s admin přístupem k e‑shopu
přístup do Shopify Developer Dashboardu

Než začnete: Zkontrolujte nastavení trhů (Markets)

Tento krok je nutný, aby Mergado mohlo importovat produkty pro jednotlivé trhy.

Ještě před vytvářením aplikace doporučujeme zkontrolovat nastavení Markets v administraci Shopify.

Co je potřeba nastavit

Pro každý trh (Market) , ze kterého chcete do Mergada importovat produkty, musí být:

přiřazena doména
přiřazen jazyk
obě hodnoty musí být explicitně přidány do sekce Customized

Nestačí, aby byly pouze zděděné ze sekce Inherited nebo nastavené jako Primary .

Postup v Shopify administraci

Otevřete Shopify administraci
V hlavním levém menu klikněte na Markets
Otevřete konkrétní trh (např. Czechia )
Sjeďte do sekce Inherited
U položky Domain / language klikněte na ikonu +
V modálním okně:

zaškrtněte požadovanou doménu
zaškrtněte požadovaný jazyk

Potvrďte kliknutím na Done
Ověřte, že se Domain / language přesunuly do sekce Customized
Změny potvrďte kliknutím na Save

Pokud Domain / language zůstanou pouze v části Inherited , Shopify API neposkytne data pro daný trh a Mergado nebude moci produkty importovat.

Krok 1: 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

Krok 2: 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.

Krok 3: 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.

3.1 Nastavení URL aplikace a embedování

V sekci URLs najděte pole App URL
Výchozí hodnotu https://example.com nahraďte za:

https://app.mergado.com

Tento krok je nutný pro správnou funkčnost integrace s Mergadem . Pokud zůstane výchozí hodnota, autorizace nebude fungovat správně.

Pod polem App URL zrušte zaškrtnutí volby Embed app in Shopify admin

3.2 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:
- read_products
- write_products
- read_markets
- write_markets
- read_metaobjects
Potvrďte kliknutím na Done

Tato oprávnění jsou nutná, aby Mergado mohlo načítat produkty a data specifická pro jednotlivé trhy.

3.3 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.

Krok 4: 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.

Krok 5: Získejte API přístupové údaje (Client ID a token)

Po instalaci aplikace je potřeba získat dvě hodnoty , které budete používat pro integraci s Mergadem:

Client ID
API přístupový token (Secret)

Postup:

Vraťte se do Shopify Developer Dashboardu
Otevřete svou aplikaci
Přejděte do Settings
V sekci Credentials :

zkopírujte hodnotu Client ID (pole se nachází nad hodnotou Secret)
zkopírujte hodnotu Secret

Client ID slouží k identifikaci aplikace, Secret funguje jako API přístupový token. Pro správnou funkčnost integrace s Mergadem jsou nutné obě hodnoty .

Krok 6: Získejte URL e‑shopu

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

Krok 7: Propojte Shopify s Mergadem

Otevřete Mergado
Vytvořte nový projekt
Jako zdroj dat zvolte Shopify
Vyplňte:
- Shopify URL → vložte URL e-shopu
- Client ID → vložte zkopírovaný Client ID z Shopify Developer Dashboardu
- Client Secret → vložte zkopírovaný Secret
Klikněte na Log in

FAQ – Nejčastější dotazy z podpory

Po zvolení Market se mi nenačítá jazyk. Proč?

Nejčastější příčina je v nastavení sekce Markets v Shopify administraci.

Pokud je Domain / language uveden pouze v sekci Inherited a není přidaný do sekce Customized , Shopify API pro daný trh neposkytne data. V důsledku toho se v Mergadu po výběru Market nenačte jazyk.

Řešení:

Otevřete Shopify admin → Markets
Otevřete konkrétní trh
U položky Domain / language klikněte na +
Vyberte doménu a jazyk
Klikněte na Done a poté Save
Ověřte, že se položka přesunula do sekce Customized
Více info viz sekce: Než začnete: Zkontrolujte nastavení trhů (Markets)

Mergado nenačítá správně hodnotu některých metafield. Proč?

Pokud se u některých metafield zobrazuje správný název (key), ale hodnota (value) je uvedena jako ID (např. ["gid://shopify/Metaobject/94942036012"] ) nebo se zobrazí hláška “Missing required scope” , aplikaci chybí oprávnění pro čtení metaobjektů.

Je potřeba přidat další scope:

read_metaobjects

Postup

Přejděte do Shopify Developer Dashboardu
Otevřete aplikaci vytvořenou pro integraci s Mergadem
V levém menu přejděte na Versions
Klikněte na New version
V sekci Scopes přidejte nový scope read_metaobjects
Potvrďte změny a dokončete novou verzi kliknutím na Release

Po vydání nové verze je nutné napojení znovu autorizovat.

Reautorizace v Mergadu

Otevřete rozšíření Mergado Keychain
Zrušte stávající spojení
Znovu vyplňte autorizační údaje:

Shopify URL
Client ID
Secret

Přihlaste se znovu (Log in)

Po přidání scope a reautorizaci se budou hodnoty metafield načítat správně.