# 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. _Updated: 2026-09-17 · Source: https://ruit.es/nl/docs/je-shopify-winkel-koppelen/_ 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. > **Waarschuwing:** Sinds 2026 worden nieuwe apps **alleen nog in het Dev Dashboard aangemaakt**. Ga je naar Instellingen, > Apps en verkoopkanalen, dan staat daar geen formulier meer: alleen een kaart die je erheen stuurt. De > apps die je eerder in het paneel hebt gemaakt, blijven werken, en hun sleutels staan op hun tabblad > met inloggegevens. ## 1. Open het Dev Dashboard Ga naar [dev.shopify.com](https://dev.shopify.com) met hetzelfde account waarmee je je winkel beheert. Je ziet de lijst met apps van je organisatie en rechtsboven `Create app`. _Schermafbeelding: De lijst met apps van het Dev Dashboard van Shopify, met de zoekbalk op naam en rechtsboven de knop om een app te maken_ 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. _Schermafbeelding: Het scherm om een app te maken in het Dev Dashboard, met het naamveld en de knop om te maken_ 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_publications ``` Er 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. _Schermafbeelding: Het veld `Scopes` van het Dev Dashboard met de acht rechten erin geplakt als een lijst gescheiden door komma's_ 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 | > **Waarschuwing:** De eerste zes worden bij het koppelen gecontroleerd, dus als er een ontbreekt merk je het meteen. > **Die twee voor publicaties worden niet gecontroleerd**, en dat is de valkuil: de koppeling lukt, het > product wordt aangemaakt, en het verschijnt niet in je winkel omdat niemand het op het verkoopkanaal > gepubliceerd heeft. Zet ze er nu bij en je bespaart je de terugreis. ## 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. _Schermafbeelding: Het venster dat het publiceren van een nieuwe versie van de app bevestigt, met de optionele velden voor naam en bericht_ 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. _Schermafbeelding: Het overzicht van de app in het Dev Dashboard, met de actieve versie en de knop om de app te installeren_ Het overzicht, met de versie al gepubliceerd en de knop om te installeren. _Schermafbeelding: Het installatiescherm binnen het paneel van de winkel, met de rechten die de app vraagt en de knoppen om te annuleren en 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. > **Opmerking:** Zonder deze stap bestaan de sleutels wel, maar geven ze nergens toegang toe, en weigert RUIT de > koppeling met de mededeling dat de app niet in de winkel geïnstalleerd is. ## 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. > **Waarschuwing:** RUIT wil het paar **`Client ID` plus `Client Secret`**, en verder niets. Kopieer niet de sleutel voor > automatisering van het Dev Dashboard, en in een oude app ook niet de toegangssleutel die met `shpat_` > begint. Met die twee sleutels geeft RUIT zijn eigen toegang uit, die elke dag verloopt en zichzelf > vernieuwt, dus we bewaren nooit een vaste sleutel van je winkel. ## 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](https://ruit.es/docs/importar-desde-un-marketplace/) 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. - [Verkopen op WooCommerce met RUIT](https://ruit.es/docs/vender-en-woocommerce/) - [Verkopen op PrestaShop met RUIT](https://ruit.es/docs/vender-en-prestashop/)