De Mokapen-gids

WooCommerce

Koppel je WooCommerce-winkel (WordPress) aan Mokapen om klanten (contacten), producten (met variaties en voorraad) en winkel-orders in het CRM te brengen, en om producten die je in Mokapen aanmaakt of bijwerkt naar WooCommerce te exporteren wanneer de synchronisatierichting dat toelaat. Zelfde doel als Shopify: e-commerce en verkoopbeheer in dezelfde workspace.

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

Vereisten

• WordPress-site met actieve WooCommerce, bereikbaar via HTTPS.
• Toestemming om Mokapen te autoriseren via de WC Auth-flow (WordPress / WooCommerce-beheerder).
• Een passend Premium-plan voor e-commerce-integraties. Zonder plan opent de koppelknop het upgradescherm.
• 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 WooCommerce-winkel koppelen

1. Gebruikersmenu → Integraties → WooCommerce.
2. Voer het webadres van de winkel in (site-URL, bijv. https://yourdomain.com). Je vindt het in de adresbalk in de WordPress-backend / WooCommerce-storefront.
3. Start autorisatie: je wordt doorgestuurd naar WordPress/WooCommerce naar de WC Auth-pagina (/wc-auth/v1/authorize) met read_write-scope.
4. Accepteer het genereren van API-sleutels voor Mokapen (consumer key / secret worden versleuteld opgeslagen in Mokapen — er is geen handmatig «plak API-sleutel»-formulier).
5. Keer terug naar Mokapen: de winkel is gekoppeld. Mokapen registreert WooCommerce-webhooks (/wp-json/wc/v3/webhooks) voor realtime updates.

Als je de autorisatie niet accepteert, worden er geen gegevens gesynchroniseerd. De URL moet geldig en HTTPS zijn: anders faalt validatie.

Wat Mokapen van WooCommerce vraagt

De WC Auth-flow geeft Mokapen lees-/schrijftoegang tot de WooCommerce REST API's die nodig zijn voor klanten, producten (en variaties), orders en webhooks. Mokapen vervangt niet het WooCommerce/WordPress-panel voor thema's, betalingen of plugins: het stemt gegevens af richting (en voor producten, van) het CRM.

Trek je sleutels in of verwijder je autorisatie aan WordPress-kant, ontkoppel en koppel opnieuw vanuit Mokapen.

Wat wordt gesynchroniseerd

Naar Mokapen (import / webhook)

• Klanten → Contacten — WooCommerce-klanten in het adresboek (en bedrijf als data dat toelaat). Updates ook via webhook.
• Producten en variaties → Producten — catalogus met variaties; WooCommerce-voorraad (stock_quantity) wordt gemapt op Mokapen-variantaantal.
• Orders → Orders — WooCommerce-orders worden verkooporders in Mokapen (met regels), geen pipeline-deals. Webhooks bij updates.
• Verlaten winkelwagens / rapporten — marketingvermeldingen of «Coming soon» in de UI zijn geen actieve winkelwagenrapport-import zoals andere flows: reken ze niet als complete functie als ze nog coming soon tonen op de pagina.

Naar WooCommerce (export)

• Producten — met syncrichting «naar WooCommerce» of «beide» kan Mokapen producten op de winkel exporteren/bijwerken (bulksync en sync-out bij productopslaan, als de integratie actief is).
• Uitgaande contacten en orders — zoals bij Shopify geldt de automatische «sync out»-export vandaag in de praktijk voor producten. Klanten komen vooral van WooCommerce naar Mokapen (import + webhook). Ga niet uit van volledige bidirectionele contactexport alleen omdat commerciële tekst dat suggereert: controleer na het koppelen.

Config toont ook diensten, maar er is geen dedicated dienstensync: gebruik Producten voor de winkelcatalogus.

Instellingen na het koppelen

Op de WooCommerce-pagina, met de winkel gekoppeld:

Synchronisatierichting

• Alleen naar Mokapen — WooCommerce → CRM.
• Beide — import + export (waar ondersteund; vandaag vooral uitgaande producten).
• Alleen naar WooCommerce — Mokapen → winkel (producten).

Entiteiten

Contacten, orders en producten zijn de syncscopes (vaak vooraf geselecteerd en niet bewerkbaar in de UI).

Sync delen

Wie heeft gekoppeld, kan de koppeling delen met de hele organisatie of geselecteerde gebruikers.

Duplicaten en conflicten

• Duplicaten vermijden — typisch contactherkenning op e-mail.
• Bij conflict — WooCommerce of Mokapen wint.

Privacy (WooCommerce)

Anders dan Shopify vind je op de WooCommerce-pagina mogelijk ook privacy- en medewerker/stakeholder-instellingen over zichtbaarheid van gesynchroniseerde data in de org. Stel ze in als het team niet alle geïmporteerde catalogus/klanten hetzelfde moet zien.

Automatische vs handmatige sync

Schakel automatische sync in voor doorlopende updates (samen met webhooks); gebruik handmatige sync voor de historische load. Controleer de gegevens-autorisatie op de pagina vóór syncen.

Aanbevolen flow

1. Controleer HTTPS en up-to-date WooCommerce op de site.
2. Koppel de winkel via Integraties → WooCommerce en rond WC Auth af.
3. Stel syncrichting, duplicaten, conflicten, privacy (indien aanwezig) en delen in.
4. Autoriseer en start de eerste sync.
5. Controleer Contacten, Producten (variaties/voorraad), Orders in Mokapen.
6. Houd webhooks actief voor nieuwe events zonder alles telkens opnieuw te starten.

Ontkoppelen

Via Integraties → WooCommerce → ontkoppelen. In het modal kies je of je contacten, orders en producten die al in Mokapen zijn geïmporteerd wilt behouden. Na ontkoppelen updaten webhooks niet meer; CRM-data blijft als je die hebt behouden. Je kunt sleutels/autorisaties ook intrekken in het WordPress-panel.

Veelvoorkomende problemen

• Ongeldige URL / geen HTTPS — gebruik het volledige site-adres met https://.
• Autorisatie mislukt — een WordPress-beheerder is vereist; controleer of WooCommerce en REST-permalinks werken (firewall/beveiligingsplugins kunnen WC Auth of webhooks blokkeren).
• Knop geblokkeerd / upgrade — een passend Premium-plan voor e-commerce is vereist.
• Orders niet in Kansen — dat klopt: ze gaan naar Orders (Verkoop → Orders).
• Voorraad / aantal — komt van variatie-stock_quantity; geen volledig WMS.
• Webhooks komen niet aan — de site moet vanaf internet bereikbaar zijn; lokale of basic-auth-omgevingen ontvangen vaak geen WooCommerce-meldingen.

Veelgestelde vragen

V: Moet ik API-sleutels handmatig genereren in WooCommerce?

A: Nee. Gebruik de WC Auth-flow vanaf de Mokapen Integraties-pagina: sleutels worden aangemaakt en opgeslagen bij terugkeer van autorisatie.

V: Worden WooCommerce-orders kansen?

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

V: Kan ik WooCommerce-producten vanuit Mokapen bijwerken?

A: Ja, met een syncrichting die export omvat en een actieve integratie.

V: Verschil met Shopify?

A: Zelfde datamodel (contacten, producten, orders) en dezelfde e-commerce Premium-logica. De koppeling verschilt: Shopify gebruikt OAuth op de Shopify-app; WooCommerce gebruikt WC Auth op je WordPress-site-URL. Zie ook de Shopify-gids.

V: Is HTTPS verplicht?

A: Ja. Zonder HTTPS zijn koppeling en webhooks niet betrouwbaar (en URL-validatie kan falen).