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.

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 jouw Shopify url
    • 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 ‘unshipped’.
  • 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.