Inhoud
Om een Shopify webwinkel te koppelen heb je drie ‘sleutels’ (keys) nodig. Een API sleutel, een geheime API “access token” en een geheime webhook sleutel.
Opgelet
Shopify's manier om externe software te integreren werd gewijzigd. De "private apps" van vroeger werden vervangen door "custom apps". Ook de manier waarop die geconfigureerd moeten worden werd gewijzigd.
API sleutels aanmaken
De API verbinding zorgt ervoor dat Webship kan communiceren met jouw Shopify webwinkel. Denk aan het opvragen van orders en product informatie, aanpassen van order statussen, enzoverder. Hieronder geven we het stappenplan weer om een Shopify webwinkel te koppelen aan Webship Online.
- Log in op je Shopify account
-
Klik op ‘Apps’ in het Shopify Menu
- Klik onderaan op ‘App and sales channel settings’
-
Klik rechtsboven op ‘Develop apps’
-
Klik ‘Create an app’
-
Geef de nieuwe app de naam “Webship Online”
-
Klik ‘Configure Admin API scopes’ aan
-
Check alle vinkjes bij onderstaande toegangsrechten, en sla helemaal onderaan de pagina op
- write_assigned_fulfillment_orders
- read_assigned_fulfillment_orders
- write_fulfillments
- read_fulfillments
- write_inventory
- read_inventory
- read_locations
- write_merchant_managed_fulfillment_orders
- read_merchant_managed_fulfillment_orders
- write_order_edits
- read_order_edits
- write_orders
- read_orders
- write_products
- read_products
- write_third_party_fulfillment_orders
- read_third_party_fulfillment_orders
-
Klik ‘API Credentials’ aan
-
Klik ‘Install app’ en klik nogmaals op ‘Install’ wanneer Shopify om bevestiging vraagt
- Open Webship Online in een nieuw tabblad of nieuw venster
- Navigeer naar ‘Winkels’ en voeg een nieuwe winkel toe
- Geef de winkel een naam en kies voor ‘Online winkel’, kies daarna voor ‘Shopify’
- Vul onder ‘API configuratie’ de twee gegenereerde sleutels in en de initiële ‘myshopify.com’ url van jouw shop.
Deze url kan teruggevonden worden door uw huidige url in te voeren in whatsmyshopifyurl.- URL: https://my-shop.myshopify.com/
- Sleutel: De API key bij nummer 1 in onderstaande afbeelding
- Geheim: De Access Token bij nummer 2 in onderstaande afbeelding
Webhooks toevoegen
De webhooks zorgen ervoor dat Shopify onmiddellijk (realtime) onze applicatie op de hoogte brengt van eventuele wijzigingen op orderniveau. Zonder webhooks zal Webship Online op vaste tijdstippen de wijzigingen ontvangen en niet in realtime.
Eerste webhook: bijgewerkte bestelling
- Keer terug naar ‘Shopify’ voor het ophalen van de derde en laatste sleutel
- Klik onderaan links op het tandwiel ‘Settings’
- Klik op ‘notifications’
- Scroll naar onder op de pagina en kies voor ‘Create webhook’
- Vul de velden in als volgt:
- Event: Order update
- Format: JSON
- URL: https://app.webship.online/webhooks/shopify
- Webhook API version: latest
- Klik ‘Save webhook’
- Na het opslaan ontvang je de derde key “All your webhooks will be signed with: XXXXXXXXXXXXXXXXXXXXXX”
- Kopieer die key en schakel terug over naar Webship Online
- Vul onder ‘Webhooks configuratie’ deze sleutel in onder ‘Geheim’ en uw Shopify domeinnaam bij ‘Oorsprong’:
- Bepaal welke orders je wenst binnen te halen in Webship Online aan de hand van de statusfilter of een geavanceerde filter. De meest gebruikte instelling is betalingsstatus ‘paid’ en fulfilment status ‘null’.
- Sla deze configuratie op in Webship Online
Tweede webhook: aangemaakte bestelling
- Keer terug naar ‘Shopify’
- Klik onderaan links op het tandwiel ‘Settings’
- Klik op ‘notifications’
- Scroll naar onder op de pagina en kies voor ‘Create webhook’
- Vul de velden in als volgt:
- Event: Order creation
- Format: JSON
- URL: https://app.webship.online/webhooks/shopify
- Webhook API version: latest
- Klik ‘Save webhook’
Klaar! Je bestellingen zullen weldra binnenkomen in Webship Online.