fbpx

Webship Online

Een Shopify webwinkel koppelen

Je bent hier
< Terug

Om een Shopify webwinkel te koppelen heb je drie ‘sleutels’ (keys) nodig. Een API sleutel, een geheime API sleutel en een geheime webhook sleutel.

Je gaat als volgt te werk:

API sleutels aanmaken

De API connectie zorgt ervoor dat Webship kan communiceren met jouw Shopify webwinkel. Denk aan het opvragen van orders en product informatie, aanpassen van order statussen, …

  • Log in op je Shopify account
  • Navigeer in de linkermenu naar ‘Apps’
  • Klik helemaal onderaan de pagina op de tekstlink ‘manage private apps’
  • Druk op de knop ‘Create a new private app’
  • Vul de velden als volgt in:
    • Private app name: Webship Online
    • Emergency developer email: support@webship.online
  • Alle toestemmingen (Permissions) mogen de status ‘Read access’ krijgen
  • Webhook API version: latest
  • Klik op ‘Save’
  • Je ontvangt de eerste twee keys die je nodig hebt in onze app: de ‘API key’ en ‘Password’ (=geheime sleutel)
  • 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

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

  1. Keer terug naar ‘Shopify’ voor het ophalen van de derde en laatste sleutel
  2. Klik onderaan links op het tandwiel ‘Settings’
  3. Klik op ‘notifications’
  4. Scroll naar onder op de pagina en kies voor ‘Create webhook’
  5. Vul de velden in als volgt:
    • Event: Order update
    • Format: JSON
    • URL: https://app.webship.online/webhooks/shopify
    • Webhook API version: latest
  6. 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’.
  1. Klik rechtsboven op ‘Opslaan’ in Webship Online

Tweede webhook: aangemaakte bestelling

  1. Keer terug naar ‘Shopify’
  2. Klik onderaan links op het tandwiel ‘Settings’
  3. Klik op ‘notifications’
  4. Scroll naar onder op de pagina en kies voor ‘Create webhook’
  5. Vul de velden in als volgt:
    • Event: Order creation
    • Format: JSON
    • URL: https://app.webship.online/webhooks/shopify
    • Webhook API version: latest
  6. Klik ‘Save webhook’

Klaar! Je bestellingen zullen weldra binnenkomen in Webship Online.