Webshop

Shopify koppelen aan Winstwaker met een custom app

Shopify-winkel koppelen via custom app: winkeldomein, Client ID, Client secret, scopes read_orders en read_all_orders, plus app_not_installed-fix.

Geplaatst 2026-06-26 · Bijgewerkt 2026-07-15

Sinds 1 januari 2026 kun je in Shopify niet meer simpelweg een access token kopiëren uit de admin. Custom apps maak je via het Shopify Dev Dashboard, en de koppeling verloopt met een Client ID en een Client secret. Klinkt ingewikkelder dan het is — in een paar minuten staat je winkel gekoppeld aan Winstwaker.

Je hebt drie dingen nodig: je winkeldomein (het .myshopify.com-adres), een Client ID en een Client secret. Winstwaker gebruikt die om server-to-server een Admin API-toegangstoken op te halen. Geen App Store, geen app-review.

Shopify-koppeling in Integraties

Stap 1 — Maak een custom app aan

  1. Ga in je Shopify-admin naar Instellingen → Apps en verkoopkanalen.
  2. Klik rechtsboven op Apps ontwikkelen en daarna op Build apps in Dev Dashboard.
  3. Klik op Create app, geef de app een herkenbare naam (bijvoorbeeld Winstwaker) en maak hem aan.

Stap 2 — Zet de juiste rechten (scopes)

Open in de app Access → Scopes en zet minimaal deze rechten aan:

  • read_orders — je bestellingen.
  • read_all_orders — complete boekjaren en oudere orders. Sla deze niet over als je je hele administratie wilt ophalen; zonder dit recht zie je alleen recente orders.
  • read_products — product- en SKU-namen (optioneel, maar handig voor nette boekingen).

Winstwaker leest alleen; er worden nooit gegevens naar je winkel geschreven.

Stap 3 — Release en installeer de app

  1. Klik op Release om de versie te activeren.
  2. Open de app en klik rechtsboven op Install app.

Deze tweede klik is de stap die het vaakst wordt vergeten. Zonder installeren mislukt de koppeling met de melding app_not_installed — zelfs als je Client ID en Secret helemaal kloppen.

Stap 4 — Kopieer je gegevens

  1. Open in de app Settings → Credentials.
  2. Kopieer de Client ID.
  3. Onthul en kopieer het Client secret.

Je winkeldomein vind je onder Instellingen → Domeinen: het is het .myshopify.com-adres dat als Primary staat gemarkeerd (bijvoorbeeld jouwwinkel.myshopify.com). Vul in Winstwaker dat volledige adres in — niet alleen jouwwinkel zonder .myshopify.com, en niet je eigen .nl-domein.

Stap 5 — Koppel in Winstwaker

Ga in Winstwaker naar Integraties, klik op de Shopify-kaart en vul in:

  • Shop-domein — bijvoorbeeld jouwwinkel.myshopify.com
  • Client ID — de zojuist gekopieerde Client ID
  • Client secret — het Client secret

Klik op Test connection om te controleren of alles klopt, en daarna op Save connection. Winstwaker haalt vervolgens automatisch je orderhistorie op en ververst het Admin API-token zelf (Shopify-tokens verlopen elke 24 uur).

Problemen oplossen

  • app_not_installed — Open de app in het Dev Dashboard en klik op Install app.
  • Alleen recente orders — Voeg de scope read_all_orders toe, klik op Release en synchroniseer opnieuw.
  • Ongeldig domein — Gebruik het .myshopify.com-adres uit Instellingen → Domeinen (het Primary-domein), niet je eigen .nl-domein.

Liever niet zelf klussen? Stuur je Shopify-gegevens veilig naar je vaste aanspreekpunt bij Winstwaker, dan koppelen wij het voor je.

Meer lezen

Veelgestelde vragen

Heb ik een betaalde Shopify-app of de App Store nodig?
Nee. Je maakt zelf een custom app aan in je eigen Shopify-admin. Daar haalt Winstwaker met een Client ID en Client secret veilig een Admin API-toegangstoken op. Er komt geen App Store-installatie of app-review aan te pas.
Waarom krijg ik de melding app_not_installed?
Dan is de custom app wel aangemaakt en vrijgegeven, maar nog niet geïnstalleerd op je winkel. Open de app in het Dev Dashboard en klik rechtsboven op 'Install app'. Daarna lukt de koppeling met dezelfde Client ID en Secret wel.
Welke gegevens leest Winstwaker uit Shopify?
Alleen je orders, retouren, btw-regels, landen en betaalstatussen — uitsluitend lezen, nooit schrijven. Winstwaker bewaart je Client secret en het token versleuteld.
Ik zie alleen recente bestellingen, niet mijn hele boekjaar.
Dan mist je custom app de scope read_all_orders. Zet die er in Shopify onder Access → Scopes bij, klik op Release en synchroniseer opnieuw.

Facturen en debiteuren zonder gedoe?

Neem contact op. We laten zien hoe Factuurhub, koppelingen en debiteuren voor jou werken.