Een nieuwe app aanmaken in Shopify voor de Reflex Harmony integratie
De communicatie tussen ReflexBlue en Shopify via Reflex Harmony zal verlopen via een app in Shopify. Een app in Shopify is een plugin die je kunt toevoegen aan je Shopify-webwinkel om extra functies en mogelijkheden te bieden. In dit geval gaat het dus om het toevoegen van integratie mogelijkheden en toegang voor Reflex Harmony. Deze handleiding begeleidt je verder hiermee.
Een Shopify winkel aanmaken
Je kunt deze sectie overslaan als je al een Shopify-winkel hebt aangemaakt.
- Ga naar de Shopify Admin op https://admin.shopify.com/ en log in met je gegevens.
- Maak een ontwikkelwinkel (development store) aan voor ontwikkelingsdoeleinden of een normale winkel. Volg hiervoor de handleiding van Shopify.
Let op: Er zijn bepaalde afwegingen die je moet maken bij het kiezen van een ontwikkelwinkel of een normale winkel in Shopify. Bij een normale winkel zal je bijvoorbeeld eerst moeten betalen voor een Shopify plan om betalingen te kunnen testen. Dit hoeft bij een ontwikkelwinkel niet; daar maak je gebruik van Bogus Gateway. Een ontwikkelwinkel kan later ook omgezet worden naar een normale winkel wanneer je live wil gaan.
Bij een ontwikkelwinkel is de Online Store als Sales channel beveiligd met een wachtwoord en niet voor eenieder toegankelijk. Het wachtwoord voor de webwinkel vind je in Shopify door onder Sales channels -> Online Store de optie Preferences te selecteren. Vervolgens kan je onder Store access het wachtwoord vinden.
De Shopify app aanmaken
Gebruik de volgende stappen om een app aan te maken in Shopify:
- Ga naar het beheergedeelte van je Shopify-winkel.
- Selecteer Settings in de navigatiebalk linksonder.
- Selecteer in het instellingenoverzicht Apps.
- Selecteer in het Apps overzicht de optie Develop apps.
- Selecteer Build apps in Dev Dashboard. Je komt dan terecht in het Dev Dashboard van Shopify.
- Selecteer Apps in de linker navigatiebalk en vervolgens Create app.
- Geef een App name op en selecteer vervolgens Create. Er wordt nu een nieuwe app aangemaakt en je komt in het scherm om een nieuwe versie van de app te maken.
- Volg de onderstaande stappen voor het maken van een nieuwe versie van de app.
De Shopify app openen in Dev Dashboard
- Ga naar het beheergedeelte van je Shopify-winkel.
- Selecteer Settings in de navigatiebalk linksonder.
- Selecteer in het instellingenoverzicht Apps.
- Selecteer in het Apps overzicht de optie Develop apps.
- Selecteer Build apps in Dev Dashboard. Je komt dan terecht in het Dev Dashboard van Shopify.
- Selecteer Apps in de linker navigatiebalk. Je krijgt een overzicht van beschikbare apps.
- Selecteer de app die je hebt aangemaakt voor de integratie.
Een nieuwe versie aanmaken van de Shopify app
-
Open de Shopify app in Dev Dashboard volgens de bovenstaande stappen.
-
In het app detail scherm selecteer je onder Versions de optie New version.
-
Geef de volgende gegevens op:
-
App URL: Vul hier in
https://portal.cloud.reflex-systems.nl/. -
Embed app in Shopify admin: Zet deze optie uit.
-
Webhooks API Version: De versie moet overeenkomen met de versie die door Reflex Harmony wordt gebruikt. Momenteel is dit
2025-10. -
Access: Selecteer Select scopes en geef de volgende scopes op:
write_customers, read_customers, write_products, read_products, write_files, read_files, write_locations, read_locations, write_payment_terms, read_payment_terms, write_order_edits, read_order_edits, write_orders, read_orders, write_fulfillments, read_fulfillments, write_assigned_fulfillment_orders, read_assigned_fulfillment_orders, write_merchant_managed_fulfillment_orders, read_merchant_managed_fulfillment_ordersDeze rechten zijn nodig zodat Reflex Harmony voldoende toegang heeft om gegevens in Shopify te kunnen synchroniseren.
-
-
Selecteer Release om de nieuwe versie aan te maken.
Een distributie methode opgeven voor de Shopify app
Gebruik de volgende stappen om een distributie methode voor de Shopify app op te geven:
- Open de Shopify app in Dev Dashboard volgens de bovenstaande stappen.
- In het app detail scherm selecteer je onder Distribution de optie Select distribution method. Je komt dan in het Distribution scherm.
- Selecteer als distributie methode Custom distribution en vervolgens Select. Bevestig je keuze.
- Geef de domain van je Shopify shop op onder Store domain.
- Zet de optie Allow multi-store install for one Plus organization uit.
- Selecteer Generate link.
De Shopify app installeren
Let op: Je moet eerst een versie gemaakt hebben en een distributie methode hebben opgegeven voordat je de Shopify app kan installeren.
Gebruik de volgende stappen om de app te installeren in Shopify:
- Open de Shopify app in Dev Dashboard volgens de bovenstaande stappen.
- Selecteer Install app om de app in je Shopify-winkel te installeren.
- Selecteer je Shopify shop.
- Selecteer Install om de app te installeren in je shop.
- Navigeer terug naar het Apps scherm in het beheergedeelte van je Shopify-winkel. Onder de tab Installed zie je de geinstalleerde app.
De API credentials van de Shopify app opvragen
Gebruik de volgende stappen om de API credentials van de Shopify app op te vragen:
- Open de Shopify app in Dev Dashboard volgens de bovenstaande stappen.
- Selecteer de app die je gemaakt hebt voor de integratie.
- Selecteer Settings in de linker navigatiebalk.
- Je vindt onder Credentials de volgende gegevens die nodig zijn voor authenticatie met Shopify door Reflex Harmony (via het Reflex Cloud Portal):
- Client ID Gebruik dit als het Client ID voor de integratie in het Reflex Cloud Portal.
- Secret: Gebruik dit als de Client geheim voor de integratie in het Reflex Cloud Portal.