Naar de hoofdinhoud

Webhooks voor Shopify-bestellingen instellen

Geschreven door Lars van ChannelDock

Koppel eerst je Shopify-winkel

ChannelDock herkent een webhook aan het winkel-domein .myshopify.com. Als de winkel nog niet als verkoopkanaal in ChannelDock is verbonden, wordt de webhook geweigerd met No API!. Koppel de winkel onder My Channels voordat je verdergaat.

Het webhook-eindpunt

Veld

Waarde

URL

https://channeldock.com/portal/webhook/shopify/orders

Evenement / onderwerp

Order creation

Formaat

JSON

API-versie

Latest (leave the Shopify default)

Kopieer de URL precies — geen afsluitende slash. ChannelDock koppelt de binnenkomende oproep automatisch aan je verbonden winkel via de X-Shopify-Shop-Domain-header.

Stappen in Shopify-beheer

1 Open je Shopify-admin

Ga naar admin.shopify.com en log in op de winkel die je aan ChannelDock hebt gekoppeld.


2 Ga naar Settings → Notifications

Klik op Settings (linksonder), daarna op Notifications.


3 Open de sectie Webhooks

Op de pagina Notifications klik je op Webhooks (bijna onderaan). Klik daarna op Create webhook.

4 Configureer de webhook

Vul het dialoogvenster precies zo in:

Instelling

Kies

Evenement

Order creation

Formaat

JSON

URL

https://channeldock.com/portal/webhook/shopify/orders

Webhook API-versie

Leave as default

5 Opslaan

Klik op Save. Shopify stuurt nu elke nieuwe bestelling naar ChannelDock zodra deze binnenkomt.


Optioneel: voeg meer gebeurtenissen toe

Dezelfde URL accepteert andere order events. Herhaal stap 4 voor elk event dat je wilt, met dezelfde URL en het JSON-formaat.

Order creation

Aanbevolen. Importeert nieuwe bestellingen direct. Dit is het enige event dat je nodig hebt voor realtime-import.

Order payment

Optioneel. Handig als je alleen wilt handelen op bestellingen zodra ze als betaald zijn gemarkeerd.


Controleer of het werkt

  1. Plaats een testbestelling in je Shopify-winkel (of gebruik Shopify's Send test notification-knop naast de webhook).

  2. Na een ogenblik zou de bestelling in ChannelDock onder je bestellingen moeten verschijnen.

Probleemoplossing

Je ziet

Wat het betekent / oplossing

No API!

De winkel is niet verbonden in ChannelDock, of de URL daar komt niet overeen met het .myshopify.com-domein van de winkel. Verbind opnieuw onder My Channels.

Webhook mislukt / non-200 in Shopify

Controleer of de URL exact is (geen afsluitende slash, https) en dat het formaat JSON is.

Bestelling verschijnt niet

ChannelDock slaat bestellingen over die het al heeft. Gebruik een gloednieuwe testbestelling om de import te bevestigen.

Webhooks vullen de reguliere ChannelDock-synchronisatie aan — ze vervangen deze niet. Als er ooit een webhook wordt gemist, pikt de normale geplande synchronisatie de bestelling alsnog op.

Dit artikel is automatisch vertaald uit het Engels.

Was dit een antwoord op uw vraag?