De Mokapen-gids

Shopify

Koppel je Shopify-winkel aan Mokapen om klanten (contacten), producten (met varianten en hoeveelheden) en winkel-orders in het CRM te brengen, en om producten die je in Mokapen aanmaakt of bijwerkt naar Shopify te exporteren wanneer de synchronisatierichting dat toelaat. Zo verenig je e-commerce en verkoopbeheer: stamgegevens, catalogus en aankoopgeschiedenis in dezelfde workspace.

Algemeen overzicht: Integraties. Geïmporteerde orders worden verkooporders in Mokapen (Orders-module), geen pipeline-kansen.

Vereisten

• Actieve Shopify-winkel (URL eindigt op .myshopify.com).
• Toestemming om de Mokapen-app op Shopify te autoriseren (OAuth) met een winkelbeheerdersaccount.
• Een passend Premium-plan voor e-commerce-integraties. Zonder plan opent de koppelknop het upgradescherm; in sommige Shopify-flows kan ook een terugkerende kostenpost gekoppeld aan de app worden aangeboden.
• Mokapen-rechten op contacten, producten en orders in je organisatie (zie Rollen en rechten).
• Toegang tot Integraties (lid/beheerder afhankelijk van white-label en org-rol).

De Shopify-winkel koppelen

1. Gebruikersmenu → Integraties → Shopify.
2. Voer de winkelnaam in (zoals in Shopify Admin; de volledige URL eindigt op myshopify.com). Twijfel je, open het Shopify-dashboard en controleer de adresbalk van de browser.
3. Start autorisatie: je wordt doorgestuurd naar Shopify om rechten te accepteren.
4. Accepteer de gevraagde scopes (lezen/schrijven klanten en producten, orders lezen — zie hieronder).
5. Keer terug naar Mokapen: de winkel staat als gekoppeld. Kom je via de Shopify App Store, kies dan mogelijk de Mokapen-organisatie waarop je de koppeling installeert.

Als je niet accepteert op Shopify, worden er geen gegevens gesynchroniseerd. Na het koppelen registreert Mokapen webhooks op de winkel: updates van klanten, producten en orders kunnen zo realtime binnenkomen, naast de bulksync die je zelf start.

Wat Mokapen van Shopify vraagt

Tijdens OAuth-autorisatie vraagt Mokapen doorgaans:

• read_customers / write_customers — Shopify-klanten lezen (en eventueel schrijven).
• read_products / write_products — producten/varianten lezen en bijwerken.
• read_orders — winkelorders lezen.

Mokapen vervangt niet het Shopify-panel voor checkout, thema's of betalingen: het stemt gegevens af richting (en voor producten, van) het CRM. Trek je de app in op Shopify of verloopt het token, ontkoppel en koppel opnieuw vanuit Mokapen. Shopify vereist ook GDPR-endpoints (data request / redact): Mokapen verwerkt deze via webhook.

Wat wordt gesynchroniseerd

Naar Mokapen (import / webhook)

• Klanten → Contacten — Shopify-stamgegevens komen in het adresboek; bij bedrijfsgegevens kan het bedrijf ook worden aangemaakt/gekoppeld. Webhooks bij aanmaken/bijwerken/verwijderen klant.
• Producten en varianten → Producten — catalogus met varianten; Shopify-variantvoorraad wordt gemapt op het Mokapen-variantaantal (geen apart magazijnmodule).
• Orders → Orders — Shopify-orders worden verkooporders in Mokapen (met regels), geen pipeline-deals. Webhooks bij orderupdates.
• Verlaten checkouts — sync kan een pad omvatten om verlaten Shopify-checkouts te importeren (als orders/gerelateerde data). Dedicated rapporten voor verlaten winkelwagens / e-commerce-analytics op de pagina tonen nog Coming soon: reken ze nog niet als actieve functie.

Naar Shopify (export)

• Producten — met syncrichting «naar Shopify» of «beide» kan Mokapen producten op de winkel exporteren/bijwerken (bulksync en sync-out bij opslaan van een gekoppeld product, als de integratie actief is).
• Uitgaande contacten en orders — ondanks write_customers-scopes geldt de automatische «sync out»-export vandaag in de praktijk voor producten. Ga niet uit van volledige bidirectionele export van contacten of orders: klanten komen vooral van Shopify naar Mokapen (import + webhook). Als marketingtekst «alleen bidirectionele contacten» vermeldt, controleer na het koppelen wat sync in jouw omgeving echt doet.

In de config staat ook diensten, maar er is geen dedicated e-commerce-dienstensync zoals voor producten: gebruik Producten voor de winkelcatalogus.

Instellingen na het koppelen

Op de Shopify-pagina, met de winkel gekoppeld, configureer je doorgaans:

Synchronisatierichting

• Alleen naar Mokapen — gegevens stromen van Shopify naar het CRM.
• Beide — import + export (waar ondersteund; vandaag vooral uitgaande producten).
• Alleen naar Shopify — push van Mokapen naar de winkel (producten).

Entiteiten

Contacten, orders en producten verschijnen als syncscopes (vaak al geselecteerd en niet bewerkbaar in de UI). Historische sync en webhooks dekken deze drie blokken.

Sync delen

Wie de winkel heeft gekoppeld, kan andere leden dezelfde koppeling laten gebruiken (hele organisatie of geselecteerde gebruikers), zodat niet iedereen OAuth hoeft te herhalen.

Duplicaten en conflicten

• Duplicaten vermijden — typische optie: contacten herkennen op e-mail, om duplicaten in het adresboek te vermijden.
• Bij conflict — kies of Shopify of Mokapen wint wanneer hetzelfde record aan beide kanten is gewijzigd.

Automatische vs handmatige sync

Met actieve automatische sync houden updates (en webhooks) gegevens aligned; je kunt nog steeds een handmatige synchronisatie starten voor de eerste historische load. Controleer vóór syncen de vereiste autorisatie voor gegevensverwerking/delen op de pagina.

Aanbevolen flow

1. Koppel de winkel en controleer Gekoppeld account.
2. Stel syncrichting in (voor de meeste gevallen: Alleen naar Mokapen of Beide als je Shopify-producten vanuit Mokapen wilt bijwerken).
3. Configureer duplicaten/conflicten en delen.
4. Autoriseer en start de eerste sync (kan lang duren bij grote catalogi).
5. Controleer in Mokapen: Contacten, Producten (varianten/aantal), Orders.
6. Houd webhooks actief: nieuwe orders en klant-/productupdates komen binnen zonder alles telkens opnieuw te starten.

Ontkoppelen

Via Integraties → Shopify → ontkoppelen. In het modal kies je of je contacten, orders en producten die al in Mokapen zijn geïmporteerd wilt behouden, of ze afhandelt volgens de aangeboden opties. Na ontkoppelen stoppen webhooks met updaten; gegevens in het CRM blijven als je ze hebt behouden. Je kunt de app ook intrekken in het Shopify-panel.

Veelvoorkomende problemen

• Ongeldige winkelnaam — gebruik het *.myshopify.com-subdomein, niet alleen het custom storefront-domein.
• Knop geblokkeerd / upgrade — een passend Premium-plan voor e-commerce is vereist.
• Orders niet in Kansen — dat klopt: ze gaan naar Orders. Open Verkoop → Orders.
• Productaantal — komt van Shopify-variantaantal; geen volledig WMS.
• Winkelwagenrapporten / analytics — tonen ze «Coming soon» op de pagina, dan zijn ze nog niet operationeel.
• Verlopen token / sync gestopt — ontkoppel en koppel opnieuw; controleer of de app niet van Shopify is verwijderd.

Veelgestelde vragen

V: Waar vind ik de winkel-URL?

A: In de adresbalk van het Shopify Admin-dashboard: die eindigt op myshopify.com.

V: Worden Shopify-orders kansen?

A: Nee. In Mokapen worden het verkooporders (met regels). Tekst over «kansen» klopt niet met het huidige gedrag.

V: Kan ik Shopify-producten vanuit Mokapen bijwerken?

A: Ja, met een syncrichting die export omvat en een actieve integratie: producten (varianten) kunnen naar de winkel worden gestuurd/bijgewerkt.

V: Worden contacten ook van Mokapen naar Shopify bijgewerkt?

A: Import en webhooks brengen Shopify-klanten naar het CRM. Automatische contactexport is vandaag niet het hoofdpad (anders dan producten): controleer op je plan/omgeving na het koppelen.

V: Heb ik WooCommerce naast Shopify nodig?

A: Nee: het zijn twee alternatieve e-commerce-integraties. Gebruik Shopify als je winkel op Shopify staat; zie de WooCommerce-gids bij WordPress/Woo.