Je Shopify-winkel koppelen aan RUIT
Tutorial om Shopify te koppelen: de app maken in het Dev Dashboard, de acht rechten plakken, haar installeren en de twee sleutels in RUIT zetten.
In deze tutorial koppel je je Shopify-winkel aan RUIT. Het zijn twee delen: eerst maak je een app aan binnen je eigen winkel, en daarna zet je haar twee sleutels in RUIT. Het duurt vijf minuten en je doet het maar één keer.
Je hebt nodig dat je eigenaar van de winkel bent, of dat je het recht hebt om apps te ontwikkelen als je teamlid bent. Elke winkel voldoet, ook een ontwikkelwinkel. RUIT vraagt je op geen enkel moment je wachtwoord van Shopify: de rechten bepaal jij, en je kunt ze intrekken wanneer je wilt.
1. Open het Dev Dashboard
Ga naar dev.shopify.com met hetzelfde account waarmee je je winkel
beheert. Je ziet de lijst met apps van je organisatie en rechtsboven Create app.
De lijst met apps. Is dit je eerste keer, dan is hij leeg en zie je een opdracht voor de terminal:
negeer die, hij is voor wie apps programmeert. De knop die je zoekt is Create app.
2. Maak de app en geef haar een naam
Druk op Create app, typ een naam die je herkent en bevestig. De naam is alleen voor jou.
Elke naam voldoet. In de figuren van deze gids heet hij RUIT.
3. Plak de acht rechten
Shopify laat je achter op het scherm van de versie. Zoek het onderdeel API access en plak in het
veld Scopes deze lijst precies zo:
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_publications,write_publicationsEr is ook een knop om ze één voor één aan te vinken in een eindeloze lijst, maar de lijst plakken gaat sneller en dan vergeet je er geen. De overige velden laat je zoals ze staan.
De acht rechten in één keer geplakt. Onder het veld staat een keuzelijst met vakjes die hetzelfde doet, één voor één.
| Recht | Verplicht? | Waarvoor |
|---|---|---|
read_products en write_products | Ja | Producten importeren, publiceren en bewerken |
read_inventory en write_inventory | Ja | De voorraad gelijk houden |
read_locations | Ja | Weten in welk magazijn die voorraad geschreven moet worden |
read_orders | Ja | Meteen van verkopen horen. Zonder dit recht wordt de koppeling geweigerd |
read_publications en write_publications | Sterk aangeraden | Dat het product in je winkel te zien is en niet alleen in het paneel |
4. Publiceer de versie
Druk rechtsboven op Release en bevestig in het venster dat opengaat. De naam en het bericht waar
het om vraagt, zijn optioneel.
Deze stap wordt het vaakst vergeten. Zonder de versie te publiceren bestaan de sleutels van stap 6 nog niet.
5. Installeer de app in je winkel
Ga terug naar het overzicht van de app en druk op Install app. Kies je winkel en bevestig op het
scherm met de rechten.
Het overzicht, met de versie al gepubliceerd en de knop om te installeren.
Shopify waarschuwt dat de app hun beoordeling niet doorlopen heeft. Dat is normaal bij een privé-app die je in je eigen organisatie hebt gemaakt: niemand anders dan jij kan haar installeren, en de rechten zijn die welke je zojuist bepaald hebt.
6. Kopieer de Client ID en de Client Secret
In de instellingen van de app, bij het onderdeel met de inloggegevens, staan de twee waarden. Het geheim is verborgen tot je op het oogje drukt.
7. Koppel de winkel in RUIT
Ga naar Instellingen → Accounts, druk op Account verbinden en kies Shopify. Er worden je drie dingen gevraagd:
| Veld | Wat je erin plakt |
|---|---|
| URL van de winkel | Het domein dat op .myshopify.com eindigt |
Client ID | Die uit stap 6 |
Client Secret | Die uit stap 6 |
Het adres is het domein dat op .myshopify.com eindigt, niet het domein waarmee je naar buiten toe
verkoopt. RUIT is verdraagzaam bij het kopiëren en plakken: het accepteert ook het adres van het
beheerpaneel.
Video nog niet opgenomen: Een Shopify-winkel koppelen
Wat je hebt bereikt
Je Shopify-winkel is aan RUIT gekoppeld met sleutels die van jou zijn en die je kunt intrekken wanneer je wilt. Vanaf hier kun je de producten importeren die je al hebt, die uit je voorraad publiceren, en RUIT hoort van elke verkoop zodra hij plaatsvindt.
Volgende stap: importeren vanaf een marktplaats om op te halen wat je in die winkel al verkoopt.
Als iets niet klopt
- De koppeling mislukt met de melding dat er rechten ontbreken. De fout noemt welke. Ga terug naar stap 3, plak de hele lijst in een nieuwe versie van de app en publiceer haar; de rechten reizen met de versie mee, dus ze aanpassen zonder te publiceren verandert niets.
- Het product wordt aangemaakt maar is niet te zien in de winkel. Je mist de twee rechten voor publicaties. Dat zijn de rechten die bij het koppelen niet gecontroleerd worden.
- De koppeling mislukt met de melding dat de app niet geïnstalleerd is. Je hebt stap 5 overgeslagen, of je hebt de app in een andere winkel geïnstalleerd.
- Je had een app van vóór 2026. Die blijft geldig. Haar sleutels staan op haar tabblad met inloggegevens binnen het paneel van de winkel, niet in het Dev Dashboard.
- De voorraad van een product raakt op. RUIT archiveert het product in Shopify in plaats van het te verwijderen, zodat de geschiedenis en het adres van het product behouden blijven.
Heeft dit artikel geholpen?
Bedankt voor het doorgeven.