Koppel je winkel om product- en bestelintegratie mogelijk te maken. Je autoriseert de koppeling in Shopify en controleert daarna de status in Composerie voordat je verdergaat met de installatie.
Shopify is de winkel die je vandaag in Composerie koppelt. De stap Koppelen richt zich op Shopify, zodat je de app vanaf een scherm van Shopify zelf kunt installeren en de installatie kunt afronden zonder te hoeven kiezen tussen onafgemaakte kanalen.
De productiekoppeling van Composerie gebruikt de gehoste installatie en winkelkiezer van Shopify. In het dashboard wordt geen alternatief met een zelf ingetypt domein aangeboden. Keurt Shopify de installatie niet goed, dan houdt Composerie de winkel ontkoppeld, zodat een gedeeltelijke installatie er nooit gezond uit kan zien.
De koppeling starten
Je start de koppeling vanuit de stap Koppelen in de onboarding. Heb je de onboarding al afgerond, dan bereik je dezelfde flow later via Integraties in de zijbalk.
Open de stap Koppelen
Tijdens de onboarding is Koppelen stap 2 van 4. De bovenbalk zegt “Stap 2 van 4 · Winkel”. De kop is “Koppel je Shopify-winkel”. Heb je Composerie via de Shopify App Store geïnstalleerd, dan is je winkel al gekoppeld en wordt dit scherm overgeslagen. Je ziet de Shopify-kaart met een knop “Doorgaan met Shopify”.
Ga verder naar Shopify
Klik op “Doorgaan met Shopify”. Composerie stuurt je naar de installatieflow van Shopify, waar je de winkel selecteert die je wilt koppelen. Je typt in Composerie geen myshopify.com-domein in.
Bekijk de gevraagde toegang
Klap voordat je verdergaat “Waar we toegang toe krijgen” open op de stap Koppelen. Er staat één duidelijke regel per groep rechten:
- je producten en varianten lezen
- gepersonaliseerde producten maken en na controle bijwerken
- binnenkomende bestellingen lezen, inclusief naam, e-mailadres en verzendadres van de koper
- fulfillmentverzoeken, fulfillments en tracking afhandelen
- varianten die een provider afhandelt toewijzen aan de fulfillmentlocatie van Composerie
- controleren of de app-embed en het blok in je thema zijn ingeschakeld
- de prijzen van add-ons die klanten kiezen toepassen in hun winkelwagen
- een checkoutregel toevoegen die de checkout tegenhoudt als een personalisatie ontbreekt of de prijs van een add-on niet te controleren is
- een webpixel toevoegen voor customizer-analyses, alleen met toestemming van de klant
Keur de app goed in Shopify
Bevestig op het eigen scherm van Shopify de winkel en bekijk het definitieve verzoek om rechten. Keur de installatie goed om terug te keren naar Composerie.
De rechten bekijken die je geeft
De regels onder “Waar we toegang toe krijgen” vatten een langere lijst Shopify-scopes samen. Wat Composerie echt vraagt is: je producten, voorraad en publicaties lezen en schrijven, je locaties lezen, je bestellingen lezen (daar komen de naam, het e-mailadres en het verzendadres van de koper vandaan), je thema’s lezen, fulfillment en fulfillmentopdrachten lezen en schrijven, en cart transforms, checkoutvalidaties en een webpixel schrijven, wat ook toegang tot klantgebeurtenissen vereist. Composerie vraagt geen toegang tot je klantgegevens.
Elk heeft een taak. Met producten, voorraad en publicaties kan Composerie je catalogus synchroniseren en de gepersonaliseerde producten publiceren die je maakt. Met bestellingen kan het werk naar je printprovider sturen. Thematoegang is alleen-lezen: zo controleert Composerie of het customizerblok op zijn plek staat, het is geen toestemming om je thema te bewerken. Fulfillmenttoegang brengt bestellingen door naar de druk, de cart transform draagt een gepersonaliseerde regel en de add-onprijzen ervan naar de checkout, en de checkoutvalidatie stopt een bestelling waarvan de personalisatie ontbreekt of de add-onprijs niet te controleren is. De installatie zelf staat stap voor stap in de Shopify-app installeren.
Keur het verzoek om af te ronden goed op het eigen scherm van Shopify. Daar geef je toegang, en dat doe je maar één keer tijdens de installatie. Composerie toont een voorbeeld van de rechten voordat je het dashboard verlaat, terwijl Shopify het definitieve goedkeuringsscherm blijft.
Controleren of de winkel is gekoppeld
Nadat Shopify heeft goedgekeurd, keer je terug naar Composerie en is de koppeling klaar. De integratiepagina toont de winkelnaam en het domein, de status Actief en een koppelingscontrole In orde.
Klik op “Doorgaan” om verder te gaan. De volgende stap is de customizer inschakelen in je thema, zodat klanten kunnen beginnen met personaliseren.
Is de koppeling mislukt, dan zie je op de stap Koppelen een foutmelding in plaats van een groen vinkje. Je kunt het opnieuw proberen vanaf dezelfde stap. De meest voorkomende oorzaak is goedkeuren met de verkeerde winkel of Shopify sluiten voordat je goedkeurt.
Moet ik mijn myshopify.com-domein intypen?
Nee. Ga verder naar Shopify en selecteer de winkel in de eigen installatieflow van Shopify.
Kan ik meer dan één winkel koppelen?
Ja. Koppel nu je eerste winkel en voeg er later meer toe vanuit het dashboard.
Hoelang blijft de koppeling bestaan?
Controleer de huidige status van de integratie. Het kan nodig zijn om de toegang opnieuw te koppelen. De eerste goedkeuring garandeert niet dat de autorisatie nooit meer aandacht nodig heeft.
Volgende stap: schakel de customizer in je thema in, zodat klanten je producten kunnen personaliseren.