Ako zaistiť napojenie e-shopovej platformy Shopify na Mergado Editor#

Ako vygenerovať Shopify API údaje pre Mergado (od 1. januára 2026)?#

Dôležité inštrukcie pre napojenie#

  1. Do poľa URLs > App URL vložte: https://app.mergado.com/ 💡Túto URL adresu musíte vložiť do poľa App URL pri vytváraní custom aplikácie v Shopify.

  2. Minimálne oprávnenia (scopes), ktoré Mergado potrebuje. ⚠️ Bez týchto oprávnení nebude integrácia fungovať.

write_products,read_products,write_markets,read_markets,read_metaobjects
  1. Oprávnenia (scopes), ak chcete využívať tiež 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 striktne vychádza z oficiálnej dokumentácie Shopify a aktuálneho užívateľského rozhrania pre vytváranie aplikácií pomocou Shopify Developer Dashboardu.

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

Pre koho je tento návod určený?#

Tento článok je určený pre:

  • obchodníkov na Shopify, ktorí chcú prepojiť svoj e‑shop s Mergadom
  • agentúry a vývojárov nastavujúcich integráciu Shopify ↔ Mergado pre klientov
  • kohokoľvek, kto potrebuje získať Shopify API prístupový token

Vytvárate vlastnú (custom) API aplikáciu pre jeden konkrétny e‑shop. Aplikáciu nie je potrebné publikovať do Shopify App Store.

Čo budete potrebovať?#

  • Shopify účet s admin prístupom k e‑shopu
  • prístup do Shopify Developer Dashboardu

Než začnete: Skontrolujte nastavenie trhov (Markets)#

⚠️ Tento krok je nutný, aby Mergado mohlo importovať produkty pre jednotlivé trhy.

Ešte pred vytváraním aplikácie odporúčame skontrolovať nastavenie Markets v administrácii Shopify.

Čo je potrebné nastaviť#

Pre každý trh (Market) , z ktorého chcete do Mergada importovať produkty, musí byť:

  • priradená doména
  • priradený jazyk
  • obe hodnoty musia byť explicitne pridané do sekcie Customized

Nestačí, aby boli iba zdedené zo sekcie Inherited alebo nastavené ako Primary .

Postup v Shopify administrácii#

  1. Otvorte Shopify administráciu
  2. V hlavnom ľavom menu kliknite na Markets
  3. Otvorte konkrétny trh (napr. Czechia )
  4. Prejdite do sekcie Inherited
  5. U položky Domain / language kliknite na ikonu +
  6. V modálnom okne:
  • zaškrtnite požadovanú doménu
  • zaškrtnite požadovaný jazyk
  1. Potvrďte kliknutím na Done
  2. Overte, že sa Domain / language presunuli do sekcie Customized
  3. Zmeny potvrďte kliknutím na Save :warning:

Ak Domain / language zostanú iba v časti Inherited , Shopify API neposkytne dáta pre daný trh a Mergado nebude môcť produkty importovať.

Krok 1: Otvorte Shopify Developer Dashboard#

Do Shopify Developer Dashboardu sa môžete dostať dvoma spôsobmi:

Varianta A: Priamy prístup#

  1. Otvorte https://dev.shopify.com/
  2. Prihláste sa pomocou svojho Shopify účtu
  3. V ľavom menu otvorte sekciu Apps

Varianta B: Cez Shopify administráciu#

  1. Otvorte Shopify administráciu svojho e‑shopu
  2. Prejdite do Settings → Apps
  3. Kliknite na Develop apps
  4. Kliknite na Build apps in Dev Dashboard

Krok 2: Vytvorte novú aplikáciu#

  1. Uistite sa, že ste v sekcii Apps
  2. Kliknite na Create app
  3. Zvoľte Start from Dev Dashboard
  4. Zadajte názov aplikácie (napr. Mergado integration)
  5. Kliknite na Create

Po vytvorení aplikácie budete presmerovaní na záložku Versions.

Krok 3: Vytvorte verziu aplikácie a nastavte oprávnenia (scopes)#

Každá aplikácia musí mať aspoň jednu verziu, aby ju bolo možné nainštalovať do e‑shopu.

3.1 Nastavenie URL aplikácie a embedovania#

  1. V sekcii URLs nájdite pole App URL
  2. Východiskovú hodnotu https://example.com nahraďte za:
https://app.mergado.com

Tento krok je nutný pre správnu funkčnosť integrácie s Mergadom . Ak zostane východisková hodnota, autorizácia nebude fungovať správne.

  1. Pod poľom App URL zrušte zaškrtnutie voľby Embed app in Shopify admin

3.2 Nastavenie prístupových oprávnení#

  1. V sekcii Access kliknite na Select scopes
  2. V modálnom okne vyhľadajte a zaškrtnite:
    • read_products
    • write_products
    • read_markets
    • write_markets
    • read_metaobjects
  3. Potvrďte kliknutím na Done

Tieto oprávnenia sú nutné, aby Mergado mohlo načítavať produkty a dáta špecifické pre jednotlivé trhy.

3.3 Publikovanie (Release) verzie#

  1. Prejdite nižšie na stránke
  2. Kliknite na Release
  3. V potvrdzovacom okne môžete názov verzie ponechať prázdny
  4. Potvrďte kliknutím na Release

Verzia aplikácie je teraz publikovaná a pripravená na inštaláciu.

Krok 4: Nainštalujte aplikáciu do e‑shopu#

  1. V ľavom menu otvorte Home
  2. Vpravo nahore kliknite na Install app
  3. Vyberte Shopify e‑shop, ktorý chcete prepojiť s Mergadom
  4. Budete presmerovaní do Shopify administrácie
  5. Inštaláciu potvrďte kliknutím na Install

Aplikácia je teraz nainštalovaná v e‑shope.

Krok 5: Získajte API prístupové údaje (Client ID a token)#

Po inštalácii aplikácie je potrebné získať dve hodnoty , ktoré budete používať pre integráciu s Mergadom:

  1. Client ID
  2. API prístupový token (Secret)

Postup:

  1. Vráťte sa do Shopify Developer Dashboardu
  2. Otvorte svoju aplikáciu
  3. Prejdite do Settings
  4. V sekcii Credentials :
  • skopírujte hodnotu Client ID (pole sa nachádza nad hodnotou Secret)
  • skopírujte hodnotu Secret

Client ID slúži na identifikáciu aplikácie, Secret funguje ako API prístupový token. Pre správnu funkčnosť integrácie s Mergadom sú nutné obe hodnoty .

Krok 6: Získajte URL e‑shopu#

  1. Otvorte Shopify administráciu pripojeného e‑shopu
  2. V ľavom menu otvorte Home
  3. V sekcii Domains skopírujte URL e‑shopu

Príklad:

your-store.myshopify.com

Krok 7: Prepojte Shopify s Mergadom#

  1. Otvorte Mergado
  2. Vytvorte nový projekt
  3. Ako zdroj dát zvoľte Shopify
  4. Vyplňte:
    • Shopify URL → vložte URL e-shopu
    • Client ID → vložte skopírovaný Client ID zo Shopify Developer Dashboardu
    • Client Secret → vložte skopírovaný Secret
  5. Kliknite na Log in

FAQ#

Po zvolení Market sa mi nenačítava jazyk. Prečo?#

Najčastejšia príčina je v nastavení sekcie Markets v Shopify administrácii.

Ak je Domain / language uvedený iba v sekcii Inherited a nie je pridaný do sekcie Customized , Shopify API pre daný trh neposkytne dáta. V dôsledku toho sa v Mergade po výbere Market nenačíta jazyk.

Riešenie:

  • Otvorte Shopify admin → Markets
  • Otvorte konkrétny trh
  • U položky Domain / language kliknite na +
  • Vyberte doménu a jazyk
  • Kliknite na Done a potom Save
  • Overte, že sa položka presunula do sekcie Customized
  • Viac info viď sekcia: Než začnete: Skontrolujte nastavenie trhov (Markets)

Mergado nenačítava správne hodnotu niektorých metafield. Prečo?#

Ak sa u niektorých metafield zobrazuje správny názov (key), ale hodnota (value) je uvedená ako ID (napr. ["gid://shopify/Metaobject/94942036012"] ) alebo sa zobrazí hláška “Missing required scope” , aplikácii chýba oprávnenie na čítanie metaobjektov.

Je potrebné pridať ďalší scope:

read_metaobjects

Postup:

  1. Prejdite do Shopify Developer Dashboardu
  2. Otvorte aplikáciu vytvorenú pre integráciu s Mergadom
  3. V ľavom menu prejdite na Versions
  4. Kliknite na New version
  5. V sekcii Scopes pridajte nový scope read_metaobjects
  6. Potvrďte zmeny a dokončite novú verziu kliknutím na Release

Po vydaní novej verzie je nutné napojenie znovu autorizovať.

Reautorizácia v Mergade:

  1. Otvorte rozšírenie Mergado Keychain
  2. Zrušte existujúce spojenie
  3. Znovu vyplňte autorizačné údaje:
  • Shopify URL
  • Client ID
  • Secret
  1. Prihláste sa znovu (Log in)

Po pridaní scope a reautorizácii sa budú hodnoty metafield načítavať správne.

Súvisiace články

Bol tento článok užitočný?