Shopify met een eigen app

Normaal koppel je Shopify met de FlowHunt-app uit de Shopify App Store (zie webshops). Wil je geen openbare app in je webshop, of blokkeert het beleid van je webshop installaties uit de App Store, dan kun je koppelen met een eigen app (custom app) die je zelf aanmaakt in het Shopify Dev Dashboard.

Eenmaal gekoppeld werkt een eigen app hetzelfde als een installatie uit de App Store: de importofferte, het inladen van historische bestellingen en producten, de Eshop-rapporten, link building en het CMS.

Ecommerce-integraties zijn beschikbaar vanaf het Pro-abonnement en alleen workspacebeheerders kunnen ze koppelen.

Voordat je begint#

• Gebruik de eigen Shopify-organisatie van de webshop. De app moet bij dezelfde Shopify-organisatie horen als de webshop. Een bureau kan zijn eigen app niet gebruiken voor de webshop van een klant; de klant moet de app zelf aanmaken.
• Betaling per creditcard. Workspaces die via Shopify worden gefactureerd, kunnen geen eigen app gebruiken. Zet het abonnement eerst om naar betaling per creditcard.
• Shopify-rechten. Je moet apps kunnen aanmaken in het Dev Dashboard van de webshop (als eigenaar van de webshop, of met een medewerkersaccount dat apps mag ontwikkelen).

De app aanmaken in Shopify#

1. Open App development in het Shopify-beheer

   Klik in het Shopify-beheer op Settings, dan op Apps, dan op Develop apps en klik op Build apps in Dev Dashboard. Je kunt ook rechtstreeks naar het Shopify Dev Dashboard gaan en inloggen met het account dat eigenaar is van de webshop.

   

   

   

   

2. Maak de app aan

   Open in het Dev Dashboard Apps en klik op Create app. Heeft je organisatie al apps, klik dan rechtsboven op Create app en kies Create app manually.

   

   

3. Vul de app en de scopes in

   • App name (1): iets wat je herkent, bijvoorbeeld “AmICited”.
   • App URL (2): https://app.flowhunt.io/. Vink Embed app in Shopify admin uit; de app heeft geen eigen scherm in Shopify.
   • Allowed redirection URL(s): laat leeg. AmICited logt in met de Client ID en het Client secret van de app, dus Shopify stuurt nooit terug. Laat Use legacy install flow uitgevinkt.
   • Scopes (3, onder API access): plak deze lijst. Dit zijn de scopes die de App Store-app vraagt, zodat de eigen app elke AmICited-functie krijgt, behalve bestelgeschiedenis ouder dan 60 dagen (zie hieronder):

   textKopiëren

   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

   Laat Webhooks API version zoals het is.

   

   Vink je liever vakjes aan dan te plakken? Klik op Select from list boven het veld Scopes, zoek elke scope uit de lijst hierboven op (1), vink hem aan en klik op Done (2).

   

   

4. Maak de app aan

   Als de naam, URL en scopes zijn ingevuld, klik je rechtsboven in het formulier op Create app (4 in de schermafbeelding van het formulier hierboven). Shopify maakt de app aan en brengt de eerste versie uit.

   

5. Controleer of de versie actief is

   Open Versions in het app-menu: de eerste versie is gemarkeerd als Active. Pas je later de scopes aan, klik dan op Create version zodat de wijziging van kracht wordt.

   

6. Kies aangepaste distributie

   Een eigen app moet eerst tot je eigen webshop worden beperkt voordat je hem daar kunt installeren.

   1. Klik in de Overview van de app op de kaart Distribution (Manage custom install link). Shopify opent het Partners Dashboard; kies het account dat je voor de webshop gebruikt als daarom wordt gevraagd.
   2. Selecteer Custom distribution (1) en klik op Select (2). Shopify laat je de distributiemethode daarna niet meer wijzigen.
   3. Voer onder Store domain het your-store.myshopify.com-adres van je webshop in (1; zie Zoek het adres van je webshop hieronder) en klik op Generate link (2). Allow multi-store install for one Plus organization is alleen van belang als je webshop bij een Shopify Plus-organisatie met meerdere webshops hoort.

   

   

   

   

7. Installeer de app in je webshop

   De app kan niets lezen totdat hij in de webshop is geïnstalleerd.

   1. Open de Overview van de app in het Dev Dashboard en klik op Install app bovenaan de kaart Installs. In sommige dashboards heet deze knop Test app, zoals in de schermafbeelding hieronder. Je kunt ook het menu ⋯ openen in de rij van de app in de lijst Apps en Install app kiezen.
   2. Kies de webshop die je wilt koppelen.
   3. Bekijk de toegang die de app vraagt en klik op Install.

   

   

   

   Het scherm waarschuwt dat “This app hasn’t been reviewed”. Dat is te verwachten: het is je eigen app, niet een uit de App Store.

8. Kopieer de Client ID en het Client secret

   Open de Settings van de app in het Dev Dashboard. Kopieer onder Credentials de Client ID en het Client secret (gebruik de kopieerknoppen naast elk veld). Behandel het secret als een wachtwoord.

   

   

   

Koppelen in AmICited#

1. Zoek het adres van je webshop

   Open Settings in het Shopify-beheer. Het adres van de webshop (your-store.myshopify.com) staat onder de naam van de webshop bovenaan het menu.

   

2. Open het Shopify-dialoogvenster

   Ga naar Data Sources, klik onder Eshops op Connect Shopify Store en klik daarna op Use a custom app instead (1 in de schermafbeelding hieronder).

3. Voer de webshop en de inloggegevens in

   Voer het Store address, de Client ID en het Client secret in (2) en klik op Connect store (3).

   

4. Kies het domein en bevestig de import

   Koppel de webshop aan een domein en kies hoeveel bestelgeschiedenis je wilt importeren, net als bij een installatie uit de App Store. Bij elke optie zie je het verwachte aantal rijen en de eenmalige kosten voordat je bevestigt.

Stel daarna klantgegevens en winkelinstellingen in, op dezelfde manier als voor elke webshop.

Waarin een eigen app verschilt#

Gerelateerd#