WooCommerce koppelen met boekhouding en CRM
Een WooCommerce-koppeling met boekhouding en CRM is betrouwbaar als duidelijk is welk systeem leidend is, welke gebeurtenis de verwerking start en hoe een fout zichtbaar wordt. Een standaardplugin volstaat bij een eenvoudige stroom. Afwijkende processen vragen vaker een platform, middleware of maatwerk.
Zo’n koppeling wisselt webshopgegevens uit, zoals orders, klanten, betalingen, facturen en refunds. Je legt ermee vast welk systeem leidend is, wanneer gegevens worden verwerkt en wie afwijkingen controleert. Dat beperkt dubbele klantrecords, verkeerd verwerkte refunds en verschillen tussen webshop, administratie en CRM.
Wat is een WooCommerce-koppeling met boekhouding en CRM?
WooCommerce registreert wat er in de webshop gebeurt: een klant plaatst een order, kiest een betaalmethode en ontvangt een product of dienst. Een koppeling kan relevante gebeurtenissen doorzetten naar boekhoudsoftware, een CRM of een ander systeem.
Een boekhoudkoppeling gaat over financiële verwerking: orders, facturen, betaalstatus, btw, creditnota’s en refunds. Een CRM-koppeling gaat over de klantrelatie: contactgegevens, orderhistorie en opvolging door verkoop of service. Dat is niet hetzelfde als een bankkoppeling of een volledige ERP-integratie.
Welke gegevens kun je synchroniseren?
Synchroniseer alleen gegevens met een duidelijk doel. De veldnamen in de eerste kolom komen uit de WooCommerce REST API-documentatie voor orders.
| WooCommerce-gegeven | Gebruik in boekhouding | Gebruik in CRM | Bron van waarheid |
|---|---|---|---|
id, number en line_items | Basis voor controle, factuur of verkoopboeking | Aankoopgeschiedenis | WooCommerce |
billing, waaronder naam, adres en email | Contact voor facturatie | Contactrecord en opvolging | CRM of WooCommerce, afhankelijk van waar klanten worden beheerd |
line_items, discount_total en shipping_total | Omzet, korting en verzendkosten | Alleen als verkoop of service die context nodig heeft | WooCommerce voor de webshoporder |
payment_method en date_paid | Of een order als betaald mag worden verwerkt | Context bij een servicevraag | Betaalprovider of boekhouding, afhankelijk van het proces |
tax_lines en line_items.tax_class | Financiële verwerking | Gewoonlijk niet nodig | Boekhouding, met een mapping vanuit WooCommerce |
status refunded en refunds | Correctie van omzet | Signaal voor service | WooCommerce als de refund daar start |
status | Kan het moment van verwerken bepalen | Startpunt voor opvolging | WooCommerce, tenzij een ander systeem de orderstatus leidt |
De WooCommerce REST API is de technische laag waarmee een extern systeem orders kan lezen of bijwerken. Orders staan gedocumenteerd op /wp-json/wc/v3/orders. Dat is niet de WordPress REST API. Het verschil staat verderop bij beheer en authenticatie.
Vier technische opties
Standaardplugin of standaardkoppeling
Passend als je proces binnen de gedocumenteerde mogelijkheden valt. De naam van een koppeling zegt niet dat korting, gastbestellingen, gedeeltelijke refunds en foutmeldingen zijn afgedekt. Controleer die punten in de documentatie van die koppeling.
Automatiseringsplatform
Een platform koppelt gebeurtenissen aan acties. WooCommerce beschrijft daarvoor een Zapier-integratie. Die route past bij overzichtelijke automatiseringen, zoals een CRM-contact na een bestelling. Financiële uitzonderingen vragen extra ontwerp en controle.
Middleware
Middleware staat tussen WooCommerce en de andere systemen. Dat is nuttig bij meerdere applicaties, transformatie van gegevens of centrale foutafhandeling. Je beheert dan wel een extra component.
Maatwerk API-koppeling
Maatwerk is logisch als een standaardroute je proces niet dekt, bijvoorbeeld bij afwijkende prijzen, een eigen CRM-proces of meerdere interne systemen. Dat vraagt eisen, tests en onderhoud. Het is geen standaardinstelling van een plugin.
Kies eerst de bron van waarheid
- Producten en prijzen. Bepaal of WooCommerce, een productinformatiesysteem of een ERP leidend is.
- Klantgegevens. Bepaal of het CRM of WooCommerce de leidende klantkaart heeft.
- Financiële gegevens. Laat de boekhouding leidend zijn voor verwerking en correcties.
- Orderstatus. Leg vast welke status een synchronisatie start. In de WooCommerce-documentatie zijn dat onder meer
pending,processing,on-hold,completed,cancelled,refundedenfailed.
De voorbeelden hieronder zijn geen universeel boekhoudadvies. Laat grootboekrekeningen, btw-tarieven en de vraag waar een factuur ontstaat controleren door de verantwoordelijke administrateur.
Uitgewerkt voorbeeld: WooCommerce, Combidesk en Moneybird
Dit voorbeeld gebruikt een benoemd boekhoudpakket en een benoemde route: Moneybird met de WooCommerce-koppeling van Combidesk. Moneybird schrijft dat Combidesk deze koppeling bouwt op de API van Moneybird, en dat Moneybird de koppeling niet zelf ontwikkelt. Het is geen door LYNX uitgevoerde klantcase.
Hieronder staan drie lagen apart: wat de geraadpleegde documentatie beschrijft, een illustratief ontwerpvoorstel van LYNX voor punten die de documentatie openlaat, en wat configuratie of maatwerk blijft.
Wat Combidesk en Moneybird documenteren
Geraadpleegd op 15 oktober 2026. De Combidesk-pagina toonde geen vaste publicatiedatum, alleen de aanduiding dat de pagina die dag was bijgewerkt.
- Start van de verwerking. Je kiest in Combidesk zelf bij welke orderstatussen een order wordt gesynchroniseerd. De pagina adviseert een status waarin de order niet meer wordt bewerkt. Een vaste verplichte status noemt de handleiding niet. Geannuleerde orders worden niet doorgezet. Een refund wordt gesynchroniseerd bij de status terugbetaling.
- Welke gegevens meegaan. Moneybird beschrijft dat een bestelling een factuur of verkoopboeking wordt, en dat naam, adres en e-mailadres als contact worden overgenomen. De betalingsstatus kan worden doorgegeven. Combidesk laat je daarbij grootboekrekeningen kiezen voor omzet, verzendkosten en overige kosten, btw-tarieven koppelen en optioneel productnummers op factuurregels zetten. Een volledige lijst van WooCommerce-veld naar Moneybird-veld staat niet op de geraadpleegde pagina’s.
- Waar de factuur ontstaat. In Moneybird, als verkoopfactuur of als externe factuur. Die keuze maak je in de koppeling. WooCommerce maakt in deze route niet zelf de Moneybird-factuur. Gebruik je de plugin PDF Invoices & Packing Slips, dan kun je ordernummers of factuurnummers, en een PDF, laten meegaan. Die plugin is een extra configuratie, geen onderdeel van WooCommerce zelf.
- Welke referentie dubbele verwerking tegengaat. Vóór het aanmaken van een verkoopfactuur controleert Combidesk of er al een verkoopfactuur met hetzelfde factuurnummer bestaat. Voor externe facturen controleert Combidesk alleen of er al een vergelijkbare externe factuur bestaat, niet of er al een verkoopfactuur is. Een controle op het WooCommerce-orderveld
idis niet vermeld op de geraadpleegde pagina. - Gedeeltelijke refund. Bij status terugbetaling maakt de koppeling een creditfactuur met een negatief bedrag van die order. De geraadpleegde pagina beschrijft niet hoe een gedeeltelijke refund per
line_items, verzendkosten of korting wordt verdeeld. Dat onderdeel is dus niet gedocumenteerd. Geannuleerde orders worden niet als credit doorgestuurd. Annuleer een order daarom niet als de creditfactuur nog gesynchroniseerd moet worden. - Mislukte API-aanroep. De koppeling synchroniseert standaard elke 60 minuten. Lukt een run niet, dan probeert de volgende run het opnieuw. Houden de problemen aan, dan volgt een e-mail. Logs zijn zichtbaar in het Combidesk-dashboard. Een foutmelding op de WooCommerce-order of een specifiek HTTP-statuscodeverloop is niet vermeld op de geraadpleegde pagina.
- Herverwerking zonder dubbele boeking. Gedocumenteerd is de combinatie van een nieuwe run en de controle op hetzelfde factuurnummer bij verkoopfacturen. Niet gedocumenteerd is wat er gebeurt als een factuur in Moneybird al bestaat, maar de koppeling die nog niet als verwerkt heeft gemarkeerd, of als je externe facturen gebruikt. Die laatste route controleert niet op bestaande verkoopfacturen.
- Controle door een beheerder. In het Combidesk-dashboard via de logs, en in Moneybird via de aangemaakte factuur of creditfactuur. De pagina beschrijft geen aparte WooCommerce-ordernotitie als controlepunt.
Illustratief ontwerpvoorstel van LYNX
Dit is een illustratief ontwerpvoorstel voor de punten die de Combidesk-documentatie openlaat of die je zelf moet kiezen. Het is geen werkinstructie van Combidesk of Moneybird, en geen beschrijving van een uitgevoerde klantkoppeling.
- Start de financiële verwerking pas als de order betaald is, bijvoorbeeld bij WooCommerce-status
processingofcompleted. Laatpendingenfailedniet boekhouden. - Gebruik als eigen referentie het WooCommerce-veld
idvoor de order, en voor een refund het refund-iduitrefunds. Zo is een tweede aflevering van dezelfde gebeurtenis herkenbaar, ook als het factuurnummer nog leeg is. - Maak bij een gedeeltelijke refund alleen een credit voor de terugbetaalde regels en voor verzendkosten als die in de refund zitten. Crediteer niet automatisch de hele oorspronkelijke order.
- Laat een mislukte aanroep zichtbaar zijn met order-
id, tijdstip en uitkomst, zonder een boeking te maken zolang Moneybird de factuur niet heeft bevestigd. - Verwerk opnieuw alleen als er nog geen factuur of credit met die referentie bestaat.
- Laat een beheerder het WooCommerce-
totalen het bedrag in Moneybird naast elkaar zetten, inclusiefdiscount_totalenshipping_total.
Wat configuratie of maatwerk blijft
- De grootboekrekeningen, het factuurprofiel, de workflow en de btw-koppeling per tarief zijn instellingen in Combidesk en Moneybird. Die moet de administrateur inrichten en controleren.
- Een standaarddebiteur voor alle orders, of alleen voor particuliere klanten, is een Combidesk-instelling. De geraadpleegde pagina beschrijft gastbestellingen niet apart.
customer_id0 betekent in WooCommerce een gast. Hoe Combidesk die gast herkent, is niet vermeld. - Regelgewijze verwerking van een gedeeltelijke refund, een eigen idempotentiesleutel op order-
iden een foutmelding in WooCommerce zelf vragen aanvullende configuratie of maatwerk. Ze volgen niet uit de geraadpleegde standaardhandleiding.
Voorbeeldmapping voor deze route
Alleen de WooCommerce-velden zijn overgenomen uit de officiële orderdocumentatie. De doelacties volgen de Combidesk- en Moneybird-pagina’s waar dat zo in de kolom staat. De kolom “controle” noemt een gat als de leverancier het niet documenteert. Dit is geen boekhoudschema.
| WooCommerce-veld of gebeurtenis | Doelactie | Richting | Verantwoordelijk systeem | Controle of uitzondering |
|---|---|---|---|---|
Door jou gekozen status | Verkoopfactuur of externe factuur in Moneybird | WooCommerce naar Moneybird | Combidesk | Alleen de gekozen statussen. Geannuleerde orders worden niet doorgezet. |
billing.first_name, billing.last_name, billing.address_1, billing.email | Contact in Moneybird. Moneybird noemt naam, adres en e-mail. | WooCommerce naar Moneybird | Combidesk | Een standaarddebiteur is optioneel. Gastbestellingen zijn niet apart gedocumenteerd. |
line_items, verzendkosten en overige kosten | Factuurregels op de gekozen grootboekrekeningen | WooCommerce naar Moneybird | Combidesk, na inrichting in Moneybird | Btw-tarieven moeten in beide systemen bestaan. Mist een tarief, dan valt Combidesk terug op een standaardtarief. Laat dit door de administrateur controleren. |
number of een factuurnummer uit PDF Invoices & Packing Slips | Controle of dat factuurnummer al als verkoopfactuur bestaat | WooCommerce naar Moneybird | Combidesk | Gedocumenteerd voor verkoopfacturen. Niet gedocumenteerd als controle op order-id. Externe facturen worden alleen met andere externe facturen vergeleken. |
| Betaalde order, instelling “registreren betaling” | Factuur in Moneybird als betaald markeren | WooCommerce naar Moneybird | Combidesk | Combidesk: alleen als de factuur ook als verzonden is gemarkeerd. |
| Status terugbetaling | Creditfactuur met negatief bedrag | WooCommerce naar Moneybird | Combidesk | Verdeling van een gedeeltelijke refund over regels, korting en verzending is niet vermeld op de geraadpleegde pagina. |
| Mislukte synchronisatie | Opnieuw bij de volgende run; daarna e-mail. Logs in het dashboard. | Combidesk bewaakt de uitwisseling | Combidesk | Zichtbaarheid in WooCommerce zelf is niet vermeld. |
Acceptatietests
Voer deze tests uit in een testomgeving voordat de koppeling live gaat. De gewenste uitkomst volgt de Combidesk-documentatie waar die iets voorschrijft. Waar de documentatie zwijgt, staat het illustratieve ontwerpvoorstel. Dat voorstel moet je zelf nog bevestigen. Het is geen gegarandeerd resultaat van de standaardkoppeling.
| Test | Gewenste uitkomst | Wat je controleert |
|---|---|---|
| Normale betaalde bestelling | Eén verkoopfactuur of externe factuur in Moneybird, alleen als de order een door jou gekozen status heeft. | Status, bedrag, contact en of een tweede run geen tweede verkoopfactuur met hetzelfde factuurnummer maakt. |
| Gastbestelling | Niet apart gedocumenteerd. Ontwerpvoorstel: customer_id 0 levert één contact op billing.email, of boekt op de ingestelde standaarddebiteur, zonder bij elke order een nieuw contact. | Of er een nieuw Moneybird-contact ontstaat en of een tweede gastorder met hetzelfde e-mailadres dat contact hergebruikt. |
| Korting en verzendkosten | Beide komen op de factuur, op de grootboekrekeningen die je voor omzet en verzending hebt gekozen. | discount_total, shipping_total en line_items.total naast de factuurregels en de btw. Laat de administrateur de tarieven beoordelen. |
| Gedeeltelijke refund | Combidesk documenteert een creditfactuur met negatief bedrag bij status terugbetaling, niet de regelverdeling. Ontwerpvoorstel: alleen het terugbetaalde deel, terwijl de oorspronkelijke factuur blijft bestaan. | Refund-id, creditbedrag en of niet de volledige order is gecrediteerd terwijl slechts een deel is terugbetaald. |
| Dubbel ontvangen gebeurtenis | Geen tweede verkoopfactuur met hetzelfde factuurnummer. | Twee runs of een herhaalde aflevering van dezelfde order. Bij externe facturen is die bescherming smaller gedocumenteerd. |
| Tijdelijk onbereikbare API | Geen boeking tijdens de storing. De volgende run probeert opnieuw. Bij aanhoudende problemen volgt een e-mail. Na herstel precies één factuur. | Log in het Combidesk-dashboard, afwezigheid van een factuur tijdens de storing, en één factuur na herstel. |
WooCommerce koppelen aan een CRM
Een CRM-koppeling maakt van een bestelling klantcontext: een contact aanmaken of bijwerken, orderhistorie toevoegen of een opvolgtaak starten. Spreek af welk veld een bestaand contact herkent. E-mail is praktisch, maar niet elke bestelling gebruikt hetzelfde adres. Leg vast welke velden WooCommerce in het CRM mag overschrijven.
De Moneybird-route hierboven is een boekhoudroute, geen CRM-koppeling. Een CRM vraagt een eigen mapping en eigen tests.
Veelvoorkomende problemen
Dubbele klantrecords
Die ontstaan als elke order een nieuw contact krijgt. Definieer een herkenningsregel. In de Combidesk-route kun je een standaarddebiteur gebruiken zodat niet elke order een nieuw Moneybird-contact opent. Of dat voor jouw administratie gewenst is, bepaalt de administrateur.
Ontbrekende of dubbele orders
Een order ontbreekt als de status geen trigger is. Een order kan dubbel lijken als een fout opnieuw wordt uitgevoerd zonder controle op een unieke referentie. Combidesk documenteert die controle voor verkoopfacturen via het factuurnummer.
Refunds die niet financieel terugkomen
Een refund in WooCommerce is pas een financiële correctie als de koppeling een credit aanmaakt. Combidesk doet dat bij status terugbetaling en niet bij annuleren. De verdeling van een gedeeltelijke refund is op de geraadpleegde pagina niet uitgewerkt.
Verkeerde btw- of grootboekmapping
Koppel btw-tarieven en grootboekrekeningen expliciet. Combidesk valt terug op een standaardtarief als een WooCommerce-tarief in Moneybird ontbreekt. Laat de inrichting door de administrateur beoordelen.
Beheer, authenticatie en onderhoud
De WordPress REST API en de WooCommerce REST API zijn niet hetzelfde. De WordPress REST API ontsluit WordPress-gegevens, zoals berichten via /wp-json/wp/v2/. De WooCommerce REST API voegt een eigen namespace toe. Orders staan gedocumenteerd op /wp-json/wc/v3/orders. Een WooCommerce REST API-sleutel is daarom geen WordPress-applicatiewachtwoord.
Combidesk vraagt voor WooCommerce een API key en secret met lees- en schrijfrechten onder WooCommerce, Instellingen, Geavanceerd, REST API. Voor Moneybird zijn eigenaarsrechten nodig. Geef niet meer rechten dan de koppeling gebruikt en verwijder sleutels die niet meer nodig zijn.
Houd na updates van WooCommerce, plugins en de externe software een testorder aan. Een koppeling die nog ingeschakeld lijkt, kan toch orders missen. De logs in het Combidesk-dashboard zijn daarvoor het gedocumenteerde controlepunt van deze route.
Checklist
- Per gegevensstroom is het doel en de bron van waarheid beschreven.
- De startstatus is gekozen en ligt vast.
- Facturen ontstaan in één systeem.
- De unieke referentie en het gedrag bij een tweede aflevering zijn getest.
- Korting, verzendkosten, gastbestellingen en gedeeltelijke refunds zijn getest, inclusief de punten die de leverancier niet documenteert.
- Fouten, logging en herverwerking hebben een eigenaar.
- API-rechten zijn beperkt tot wat de koppeling nodig heeft.
- De administrateur heeft grootboek en btw gecontroleerd.
Bronnen
- WooCommerce REST API, order properties, geraadpleegd op 15 oktober 2026
- Moneybird: WooCommerce koppelen met Moneybird, geraadpleegd op 15 oktober 2026
- Combidesk: installatiehandleiding WooCommerce Moneybird, geraadpleegd op 15 oktober 2026
- WooCommerce: Zapier-integratie, geraadpleegd op 15 oktober 2026
Bespreek je website of online groeikansen met LYNX Media
Heb je een vraag over dit onderwerp, of wil je weten wat er voor jouw site nodig is? Neem contact op.
Neem contact op
