Dokumentation

Integrationer

Shopify med en anpassad app

Anslut en Shopify-butik till AmICited med en egen anpassad app från Shopify Dev Dashboard i stället för appen i App Store: scopes, Client ID och secret samt begränsningarna.

Det vanliga sättet att ansluta Shopify är FlowHunt-appen i Shopify App Store (se e-handelsbutiker). Om du inte vill ha en offentlig app i din butik, eller om butikens policy blockerar installationer från App Store, kan du ansluta med en anpassad app (custom app) som du själv skapar i Shopify Dev Dashboard.

När den väl är ansluten fungerar en anpassad app precis som en installation från App Store: importofferten, bakåtimporten av ordrar och produkter, Eshop-rapporterna, länkbyggandet och CMS:et.

E-handelsintegrationer finns från planen Pro, och bara arbetsytans administratörer kan ansluta dem.

Innan du börjar#

  • Använd butikens egen Shopify-organisation. Appen måste tillhöra samma Shopify-organisation som butiken. En byrå kan inte använda sin egen app i en kunds butik, så kunden måste skapa appen.
  • Kortbetalning. Arbetsytor som faktureras via Shopify kan inte använda en anpassad app. Byt först planen till kortbetalning.
  • Behörigheter i Shopify. Du måste kunna skapa appar i butikens Dev Dashboard (butiksägaren, eller ett personalkonto som får utveckla appar).

Skapa appen i Shopify#

  1. Öppna apputveckling i Shopify-administrationen

    Klicka på Settings i Shopify-administrationen, sedan på Apps, sedan på Develop apps, och klicka på Build apps in Dev Dashboard. Du kan också gå direkt till Shopify Dev Dashboard och logga in med kontot som äger butiken.

    Startsidan i Shopify-administrationen med Settings i menyn längst ned till vänster
    Settings i Shopify-administrationen med Apps i menyn
    Appinställningarna i Shopify-administrationen med knappen Develop apps
    Sidan för apputveckling med knappen Build apps in Dev Dashboard
  2. Skapa appen

    Öppna Apps i Dev Dashboard och klicka på Create app. Om din organisation redan har appar klickar du på Create app uppe till höger och väljer Create app manually.

    Sidan Apps i Shopify Dev Dashboard
    Länken Create app under Get API credentials i Dev Dashboard
  3. Fyll i appen och dess scopes

    • App name (1): vad som helst som du känner igen, till exempel “AmICited”.
    • App URL (2): https://app.flowhunt.io/. Avmarkera Embed app in Shopify admin; appen har ingen egen vy i Shopify.
    • Allowed redirection URL(s): lämna tomt. AmICited loggar in med appens Client ID och Client secret, så Shopify omdirigerar aldrig tillbaka till den. Lämna Use legacy install flow omarkerad.
    • Scopes (3, under API access): klistra in den här listan. Det är samma scopes som appen i App Store begär, så den anpassade appen får alla AmICited-funktioner utom orderhistorik som är äldre än 60 dagar (se nedan):
    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

    Låt Webhooks API version vara som den är.

    Formuläret Create an app i Dev Dashboard med App name, URL:er, Scopes och Webhooks API version

    Vill du hellre kryssa i rutor än klistra in? Klicka på Select from list ovanför fältet Scopes, sök efter varje scope i listan ovan (1), kryssa i det och klicka på Done (2).

    Länken Select from list ovanför fältet Scopes
    Dialogrutan Select scopes med sökfältet och knappen Done
  4. Skapa appen

    När namn, URL och scopes är ifyllda klickar du på Create app uppe till höger i formuläret (4 i skärmbilden av formuläret ovan). Shopify skapar appen och släpper dess första version.

    Knappen Create app uppe till höger i formuläret Create an app
  5. Kontrollera att versionen är aktiv

    Öppna Versions i appens meny: den första versionen är markerad som Active. Om du ändrar dina scopes senare klickar du på Create version så att ändringen börjar gälla.

    Sidan Versions i Dev Dashboard med den första versionen markerad som Active
  6. Ställ in distributionen på anpassad

    En anpassad app måste begränsas till din egen butik innan den kan installeras där.

    1. Klicka på kortet Distribution (Manage custom install link) i appens Overview. Shopify öppnar Partners Dashboard; om du tillfrågas väljer du det konto du använder för butiken.
    2. Välj Custom distribution (1) och klicka på Select (2). Shopify låter dig inte ändra distributionsmetoden i efterhand.
    3. Under Store domain anger du butikens adress your-store.myshopify.com (1; se Hitta din butiksadress nedan) och klickar på Generate link (2). Allow multi-store install for one Plus organization spelar bara roll om din butik tillhör en Shopify Plus-organisation med flera butiker.
    Appens Overview i Dev Dashboard med kortet Distribution
    Kontoväljaren i Shopify för Partners Dashboard (suddig)
    Sidan Distribution med Custom distribution och knappen Select
    Formuläret Custom distribution med fältet Store domain och knappen Generate link
  7. Installera appen i din butik

    Appen kan inte läsa något förrän den är installerad i butiken.

    1. Öppna appens Overview i Dev Dashboard och klicka på Install app högst upp på kortet Installs. I vissa dashboards heter knappen Test app, som i skärmbilden nedan. Du kan också öppna menyn ⋯ på appens rad i listan Apps och välja Install app.
    2. Välj den butik du vill ansluta.
    3. Granska åtkomsten som appen begär och klicka på Install.
    Appens Overview i Dev Dashboard med knappen Test app under Installs
    Butiksväljaren i Shopify med butiken som appen ska installeras i
    Vyn Update data access i Shopify-administrationen med knappen Install

    Vyn varnar för att “This app hasn’t been reviewed”. Det är väntat: det är din egen app, inte en app från App Store.

  8. Kopiera Client ID och Client secret

    Öppna appens Settings i Dev Dashboard. Under Credentials kopierar du Client ID och Client secret (använd kopieringsknapparna bredvid respektive fält). Behandla din secret som ett lösenord.

    Appens menyval Settings i Dev Dashboard
    Avsnittet Credentials med Client ID (suddigt)
    Avsnittet Credentials med Client secret

Anpassade appar importerar ordrar från de senaste 60 dagarna

Shopify returnerar bara ordrar som är äldre än 60 dagar till appar som har scopet read_all_orders, och Dev Dashboard avvisar det för en anpassad app (“Contains invalid scopes: read_all_orders”). En anslutning med en anpassad app importerar därför ordrar från de senaste 60 dagarna, och Eshop-rapporterna börjar där. Importofferten kan fortfarande erbjuda en längre historik; själva importen stannar ändå vid 60 dagar. Om du behöver hela orderhistoriken ansluter du i stället med appen i App Store.

Anslut den i AmICited#

  1. Hitta din butiksadress

    Öppna Settings i Shopify-administrationen. Butiksadressen (your-store.myshopify.com) visas under butikens namn högst upp i menyn.

    Settings i Shopify-administrationen med myshopify.com-adressen under butikens namn (suddigt)
  2. Öppna Shopify-dialogrutan

    Gå till Data Sources, klicka på Connect Shopify Store under Eshops och klicka sedan på Use a custom app instead (1 i skärmbilden nedan).

  3. Ange butiken och inloggningsuppgifterna

    Ange Store address, Client ID och Client secret (2) och klicka sedan på Connect store (3).

    Shopify-dialogrutan med Use a custom app instead och fälten Store address, Client ID och Client secret
  4. Välj domän och bekräfta importen

    Koppla butiken till en domän och välj hur mycket orderhistorik som ska importeras, precis som vid en installation från App Store. Varje alternativ visar beräknat antal rader och engångskostnad innan du bekräftar.

Ställ sedan in kunddata och butiksinställningar på samma sätt som för vilken butik som helst.

Så skiljer sig en anpassad app#

Varför tillämpas länkarna inte direkt när jag redigerar en produkt?

Anpassade appar får inga webhooks från Shopify, så när du redigerar en produkt eller sida i Shopify tillämpar länkbyggandet inte sina länkar på nytt direkt. De tillämpas igen nästa gång regeln körs.

Vad händer om appen raderas eller avinstalleras?

Anslutningen slutar fungera inom ungefär ett dygn och arbetsytan får en avisering. För att ansluta igen öppnar du samma dialogruta, väljer Update credentials och anger appens nuvarande Client ID och Client secret.

Varför går importen bara 60 dagar bakåt?

Äldre ordrar kräver Shopifys scope read_all_orders, och Dev Dashboard accepterar det inte för en anpassad app. En anslutning med en anpassad app importerar därför ordrar från de senaste 60 dagarna, och nya ordrar fortsätter att komma in därefter. Använd appen i App Store om du vill ha hela historiken.

Kan en byrå använda en app för alla sina kunder?

Nej. Appen måste tillhöra samma Shopify-organisation som butiken, så varje kund skapar sin egen app.

Relaterat#