Shopify koppelen aan APIcenter

Je koppelt Shopify aan APIcenter met een custom app in je eigen Shopify-winkel. APIcenter gebruikt daarmee de GraphQL Admin API van Shopify. Je doet dit één keer. Daarna gebruik je Shopify in al je integraties.

Wat je nodig hebt

• Een Shopify-winkel.
• Een custom app in die winkel, met toegang tot de Admin API.
• De gegevens van die app die APIcenter vraagt bij het koppelen. Welke velden dat zijn, zie je in het koppelscherm.

Een custom app maken in Shopify

Shopify heeft twee soorten custom apps. Welke je gebruikt, hangt af van wanneer de app is gemaakt:

• Nieuwe custom apps maak je in het Dev Dashboard. In je Shopify-beheer ga je naar Settings > Apps > Develop apps en kies je Build apps in Dev Dashboard. Klik daar op Create app. Maak een versie van de app, vul onder Access de scopes in en klik op Release. Installeer de app daarna in je winkel. Een token voor de API kopieer je niet uit het Shopify-beheer: een ontwikkelaar haalt het op met de client credentials grant, met het client ID en de client secret van de app. Zo'n token verloopt na 24 uur.
• Oudere custom apps zijn gemaakt in het Shopify-beheer vóór 1 januari 2026. Die werken nog en je beheert ze daar. Het token van zo'n app zie je maar één keer, op het moment dat je het aanmaakt. Ben je het kwijt, dan moet je de app in je winkel deïnstalleren en opnieuw installeren om een nieuw token te krijgen. Verwijder de app zelf niet: een nieuwe custom app in het Shopify-beheer kun je niet meer maken.

Shopify legt dit uit op Installing and setting up apps en About apps. Heb je hulp nodig bij het maken van een custom app? Dan kan een Shopify Partner of een ontwikkelaar dit voor je doen.

Welke rechten de app nodig heeft

Geef de app toegang (scopes) voor de gegevens van de flows die je gebruikt. Dit volgt uit de aanvragen die APIcenter naar Shopify stuurt:

• Klanten ophalen of versturen: read_customers en write_customers.
• Producten, collecties en metafields van producten: read_products en write_products.
• Voorraad en locaties: read_inventory, write_inventory en read_locations.
• Een nieuw product publiceren in het verkoopkanaal Online Store: read_publications en write_publications.
• Bestellingen en terugbetalingen: read_orders en write_orders.
• Conceptbestellingen: read_draft_orders en write_draft_orders.
• Verzendingen: toegang tot fulfillment orders, bijvoorbeeld read_merchant_managed_fulfillment_orders en write_merchant_managed_fulfillment_orders.
• Kortingen uit de flow Verkoopprijzen naar Shopify sturen: write_discounts.

Je hoeft alleen de rechten te geven voor de flows die je gebruikt. Alle scopes staan in de Shopify-documentatie over access scopes.

Let op: met read_orders of write_orders krijgt een app alleen toegang tot bestellingen van de afgelopen 60 dagen. Wil je oudere bestellingen ophalen? Dan heeft de app ook read_all_orders nodig. Voor apps die je in het Dev Dashboard onder je eigen organisatie maakt, hoef je hiervoor geen goedkeuring van Shopify te vragen.

Zo koppel je Shopify in APIcenter

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Shopify.
2. Vul de velden in die APIcenter voor Shopify toont en klik op Opslaan.
3. Klik op Testverbinding. Zie je dat de verbinding goed is, dan is Shopify klaar voor gebruik.

APIcenter stuurt alle aanvragen naar het adres van je winkel, met de versie van de Admin API en /graphql.json. De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Bij de verbindingsinstellingen staat Authentication Method, met de keuzes Legacy en Custom. De standaardkeuze is Legacy. Zie Shopify verbindings- en integratie-instellingen.

Als het niet lukt

• Mislukt de test of geeft Shopify een fout over toegang? Controleer of de app is geïnstalleerd, of het token nog geldig is en of alle rechten zijn gegeven. Zie Shopify: veelvoorkomende fouten en Verbinding of inloggen mislukt.
• Heb je een nieuw token gemaakt? Werk de gegevens van de Shopify-verbinding in APIcenter dan bij.

Volgende stappen

Maak een integratie met Shopify en controleer de instellingen. Zie Shopify verbindings- en integratie-instellingen.