Dokumentace

Integrace

Shopify s vlastní aplikací

Připojte obchod Shopify k AmICited pomocí vlastní aplikace ze Shopify Dev Dashboard místo aplikace z App Store: oprávnění (scopes), Client ID a secret a omezení.

Obvyklý způsob připojení Shopify je aplikace FlowHunt ze Shopify App Store (viz e-shopy). Pokud ve svém obchodě nechcete veřejnou aplikaci nebo pravidla vašeho obchodu instalace z App Store nepovolují, můžete se připojit pomocí vlastní aplikace (custom app), kterou si sami vytvoříte ve Shopify Dev Dashboard.

Po připojení funguje vlastní aplikace stejně jako instalace z App Store: nabídka importu, zpětný import objednávek a produktů, reporty Eshop, budování odkazů i CMS.

Integrace e-shopů jsou dostupné od tarifu Pro a připojovat je mohou jen administrátoři workspace.

Než začnete#

  • Použijte vlastní organizaci Shopify daného obchodu. Aplikace musí patřit do stejné organizace Shopify jako obchod. Agentura nemůže na obchodě klienta použít vlastní aplikaci, aplikaci proto musí vytvořit klient.
  • Platba kartou. Workspace účtované přes Shopify nemohou vlastní aplikaci používat. Nejprve převeďte tarif na platbu kartou.
  • Oprávnění v Shopify. Musíte mít možnost vytvářet aplikace v Dev Dashboard obchodu (vlastník obchodu nebo účet zaměstnance s oprávněním vyvíjet aplikace).

Vytvoření aplikace v Shopify#

  1. Otevřete vývoj aplikací v administraci Shopify

    V administraci Shopify klikněte na Settings, poté na Apps, pak na Develop apps a klikněte na Build apps in Dev Dashboard. Můžete také přejít přímo do Shopify Dev Dashboard a přihlásit se účtem, kterému obchod patří.

    Úvodní stránka administrace Shopify s položkou Settings v levém dolním menu
    Settings v administraci Shopify s položkou Apps v menu
    Nastavení Apps v administraci Shopify s tlačítkem Develop apps
    Stránka vývoje aplikací s tlačítkem Build apps in Dev Dashboard
  2. Vytvořte aplikaci

    V Dev Dashboard otevřete Apps a klikněte na Create app. Pokud už vaše organizace nějaké aplikace má, klikněte na Create app vpravo nahoře a zvolte Create app manually.

    Stránka Apps ve Shopify Dev Dashboard
    Odkaz Create app pod Get API credentials v Dev Dashboard
  3. Vyplňte údaje aplikace a její oprávnění

    • App name (1): cokoli, co poznáte, například „AmICited“.
    • App URL (2): https://app.flowhunt.io/. Zrušte zaškrtnutí Embed app in Shopify admin; aplikace nemá v Shopify žádnou vlastní obrazovku.
    • Allowed redirection URL(s): nechte prázdné. AmICited se přihlašuje pomocí Client ID a Client secret aplikace, takže Shopify na něj nikdy nepřesměrovává. Políčko Use legacy install flow nechte nezaškrtnuté.
    • Scopes (3, pod API access): vložte tento seznam. Jde o stejná oprávnění, o která žádá aplikace z App Store, takže vlastní aplikace získá všechny funkce AmICited kromě historie objednávek starší než 60 dní (viz níže):
    text
    read_orders,write_orders,read_products,write_products,read_customers,write_customers,read_inventory,write_inventory,read_locations,write_price_rules,read_content,write_content,read_themes,write_themes,read_locales

    Webhooks API version ponechte beze změny.

    Formulář Create an app v Dev Dashboard s poli App name, URL, Scopes a Webhooks API version

    Raději zaškrtáváte políčka než vkládáte text? Klikněte na Select from list nad polem Scopes, vyhledejte v seznamu každé z výše uvedených oprávnění (1), zaškrtněte ho a klikněte na Done (2).

    Odkaz Select from list nad polem Scopes
    Dialog Select scopes s vyhledávacím polem a tlačítkem Done
  4. Vytvořte aplikaci

    Jakmile máte vyplněný název, URL a oprávnění, klikněte na Create app vpravo nahoře ve formuláři (4 na snímku formuláře výše). Shopify aplikaci vytvoří a vydá její první verzi.

    Tlačítko Create app vpravo nahoře ve formuláři Create an app
  5. Zkontrolujte, že je verze aktivní

    V menu aplikace otevřete Versions: první verze je označena jako Active. Pokud později oprávnění změníte, klikněte na Create version, aby se změna projevila.

    Stránka Versions v Dev Dashboard s první verzí označenou jako Active
  6. Nastavte distribuci na vlastní

    Vlastní aplikaci je nutné omezit na váš obchod, teprve pak ji do něj můžete nainstalovat.

    1. V Overview aplikace klikněte na kartu Distribution (Manage custom install link). Shopify otevře Partners Dashboard; pokud se zeptá, vyberte účet, který pro obchod používáte.
    2. Vyberte Custom distribution (1) a klikněte na Select (2). Způsob distribuce už Shopify později změnit nedovolí.
    3. Do pole Store domain zadejte adresu obchodu your-store.myshopify.com (1; viz Zjistěte adresu svého obchodu níže) a klikněte na Generate link (2). Volba Allow multi-store install for one Plus organization má význam jen tehdy, když váš obchod patří do organizace Shopify Plus s více obchody.
    Overview aplikace v Dev Dashboard s kartou Distribution
    Výběr účtu Shopify pro Partners Dashboard (rozmazané)
    Stránka Distribution s volbou Custom distribution a tlačítkem Select
    Formulář Custom distribution s polem Store domain a tlačítkem Generate link
  7. Nainstalujte aplikaci do svého obchodu

    Dokud aplikace není v obchodě nainstalovaná, nemůže nic číst.

    1. V Dev Dashboard otevřete Overview aplikace a klikněte na Install app v horní části karty Installs. V některých verzích dashboardu má toto tlačítko popisek Test app, jako na snímku níže. Můžete také otevřít menu ⋯ na řádku aplikace v seznamu Apps a zvolit Install app.
    2. Vyberte obchod, který chcete připojit.
    3. Zkontrolujte přístup, o který aplikace žádá, a klikněte na Install.
    Overview aplikace v Dev Dashboard s tlačítkem Test app pod Installs
    Výběr obchodu Shopify, do kterého se aplikace nainstaluje
    Obrazovka Update data access v administraci Shopify s tlačítkem Install

    Obrazovka upozorňuje, že „This app hasn’t been reviewed“. To je v pořádku: jde o vaši vlastní aplikaci, ne o aplikaci z App Store.

  8. Zkopírujte Client ID a Client secret

    V Dev Dashboard otevřete Settings aplikace. V sekci Credentials zkopírujte Client ID a Client secret (použijte tlačítka pro kopírování vedle jednotlivých polí). Se secretem zacházejte jako s heslem.

    Položka Settings aplikace v menu Dev Dashboard
    Sekce Credentials s Client ID (rozmazané)
    Sekce Credentials s Client secret

Vlastní aplikace importují objednávky za posledních 60 dní

Objednávky starší než 60 dní vrací Shopify jen aplikacím s oprávněním read_all_orders a Dev Dashboard ho u vlastní aplikace odmítne („Contains invalid scopes: read_all_orders“). Připojení přes vlastní aplikaci proto importuje objednávky za posledních 60 dní a od tohoto data začínají i reporty Eshop. Nabídka importu může stále nabízet delší historii; samotný import však končí na 60 dnech. Pokud potřebujete celou historii objednávek, připojte se raději přes aplikaci z App Store.

Připojení v AmICited#

  1. Zjistěte adresu svého obchodu

    V administraci Shopify otevřete Settings. Adresa obchodu (your-store.myshopify.com) se zobrazuje pod názvem obchodu v horní části menu.

    Settings v administraci Shopify s adresou myshopify.com pod názvem obchodu (rozmazané)
  2. Otevřete dialog Shopify

    Přejděte do Data Sources, pod Eshops klikněte na Connect Shopify Store a poté na Use a custom app instead (1 na snímku níže).

  3. Zadejte obchod a přihlašovací údaje

    Zadejte Store address, Client ID a Client secret (2) a klikněte na Connect store (3).

    Dialog Shopify s volbou Use a custom app instead a poli Store address, Client ID a Client secret
  4. Zvolte doménu a potvrďte import

    Přiřaďte obchod k doméně a zvolte, kolik historie objednávek importovat, stejně jako u instalace z App Store. Každá možnost před potvrzením ukazuje předpokládaný počet řádků a jednorázový náklad.

Poté nastavte data o zákaznících a nastavení obchodu stejně jako u kteréhokoli jiného obchodu.

Čím se vlastní aplikace liší#

Proč se odkazy po úpravě produktu nepoužijí hned znovu?

Vlastní aplikace nedostávají webhooky Shopify, takže úprava produktu nebo stránky v Shopify nevyvolá okamžité opětovné použití odkazů z budování odkazů. Odkazy se znovu použijí při příštím spuštění pravidla.

Co se stane, když je aplikace smazána nebo odinstalována?

Připojení přestane fungovat přibližně do jednoho dne a workspace obdrží upozornění. Pro opětovné připojení otevřete stejný dialog, zvolte Update credentials a zadejte aktuální Client ID a Client secret aplikace.

Proč import sahá jen 60 dní zpět?

Starší objednávky vyžadují oprávnění Shopify read_all_orders a Dev Dashboard ho u vlastní aplikace nepřijme. Připojení přes vlastní aplikaci proto importuje objednávky za posledních 60 dní a nové objednávky pak přibývají průběžně. Pro celou historii použijte aplikaci z App Store.

Může agentura použít jednu aplikaci pro všechny své klienty?

Ne. Aplikace musí patřit do stejné organizace Shopify jako obchod, takže každý klient si vytváří vlastní aplikaci.

Související#