Een Shopify webwinkel koppelen

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: shop url
  • 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.

Leveringsopties toevoegen

Wanneer er een verkooporder met een gespecifieerde leveringsoptie binnenkomt in de applicatie, wordt er een koerier gezocht met een gelijkaardige naam die een verzendmethode aanbiedt die ingeschakeld is voor de winkel waaronder het order gemaakt werd. Indien er zo'n koerier gevonden werd, zal deze gebruikt worden als voorkeurskoerier voor dat verkooporder. Leveringsopties kunnen toegevoegd worden in Shopify door de volgende stappen te volgen:

• Keer terug naar 'Shopify'
• Klik onderaan links op het tandwiel 'Settings'
• Klik op 'Shipping and delivery'
• Open de 'General shipping rates'
• Maak een of meerdere 'shipping zones' aan
• Gebruik de namen van de koeriers die je wenst te gebruiken als 'shipping rates' in de 'shipping zones'