WooCommerce Business Central koppeling

Wat je tussen WooCommerce en Business Central koppelt

WooCommerce vangt de order en toont de catalogus. Business Central beheert artikelen, prijzen, voorraad en de boekhouding. De koppeling verbindt vijf stromen.

Het ordernummer uit WooCommerce, het veld number, gaat naar externalDocumentNumber op de verkooporder in Business Central. Dat veld is 35 tekens lang en is de sleutel waarmee de koppeling een order herkent die hij al heeft aangeboden. De toegang tot WooCommerce loopt via een sleutelpaar dat je aanmaakt onder WooCommerce, Instellingen, Geavanceerd, REST API. Het geheime deel wordt één keer getoond.

Welk systeem is leidend, per gegeven

De btw-regel staat er apart in omdat hij in deze combinatie de meeste centverschillen geeft. WooCommerce zegt per order of prijzen inclusief btw zijn. In Business Central volgt dat uit de klant, en de order neemt het over.

Wat WooCommerce en Business Central anders bewaren

Btw inclusief of exclusief

Een webshop voor consumenten rekent inclusief btw: de order heeft prices_include_tax op true. Per orderregel levert WooCommerce total en total_tax apart, als tekst.

{
  "number": "10482",
  "status": "processing",
  "customer_id": 0,
  "prices_include_tax": true,
  "billing": {
    "company": "",
    "email": "j.devries@example.nl",
    "address_1": "Dorpsstraat 12 A",
    "postcode": "1234 AB",
    "country": "NL"
  },
  "line_items": [
    { "sku": "10482-BL-M", "quantity": 3, "total": "74.38", "total_tax": "15.62" }
  ]
}

De klant heeft 3 stuks van € 30,00 gekocht en € 90,00 betaald. Stuurt de koppeling de prijs exclusief btw op twee decimalen, dan wordt dat 74,38 gedeeld door 3 is € 24,79. Business Central rekent zelf: 3 keer 24,79 is 74,37, plus 21% is € 89,99. Eén cent verschil met de betaling, en het automatisch afletteren stopt op die order.

De oplossing zit in de klant. Een klant met prijzen inclusief btw krijgt € 30,00 als unitPrice en de order komt op € 90,00 uit. Het veld pricesIncludeTax op de verkooporder is alleen-lezen, dus de koppeling kiest bij het aanmaken het juiste klantsjabloon: particulieren inclusief, zakelijke klanten exclusief. WooCommerce heeft daarnaast een instelling om btw per subtotaal af te ronden in plaats van per regel. De koppeling leest die instelling uit, zodat beide kanten op dezelfde manier afronden. Meer hierover in bedragen en btw mappen.

Gastorders en debiteuren

Een WooCommerce-order zonder account heeft customer_id 0. Business Central boekt elke order op een klant met een nummer. De koppeling loopt daarom een vaste volgorde af: het klantnummer uit Business Central als dat bij het account is opgeslagen, dan het e-mailadres, en daarna pas een nieuwe klant.

Bij het aanmaken stuurt WooCommerce naam, bedrijf, adres en land als tweeletterige code. Business Central bewaart de naam in 100 tekens, addressLine1 in 100 en addressLine2 in 50. De boekingsgroepen stuurt WooCommerce niet mee en de customers-resource heeft er geen velden voor. Ze komen uit een sjabloon op de pagina API Setup. Hoe je voorkomt dat één bedrijf drie keer als debiteur ontstaat, staat in dubbele klanten en debiteuren.

Eén voorraadgetal

WooCommerce heeft in de kern één getal per product of variatie: stock_quantity, een geheel getal. Locaties kent het niet. Business Central heeft inventory: een decimaal getal over alle locaties samen, dat pas zakt als de levering is geboekt.

WooCommerce verlaagt zijn eigen getal zodra een order op processing of on-hold komt. Dat geeft een ander probleem dan bij een platform dat zelf reserveert. Business Central heeft 20 stuks. Een order van 4 komt binnen en WooCommerce toont 16. De levering is nog niet geboekt, dus inventory is nog 20. Schrijft de koppeling die 20 terug, dan staan er 4 te veel in de webshop. De koppeling schrijft daarom inventory min het openstaande aantal op verkooporders, quantity min shippedQuantity: 20 min 4 is 16.

Twee details daarbij. Kabel die per meter wordt verkocht heeft in Business Central een voorraad van 12,5. WooCommerce krijgt 12. En bij meer dan één locatie leg je vast welke locaties meetellen voor de webshop; het aantal per locatie komt uit een query die in Business Central als webservice is gepubliceerd.

Variabele producten

Een variabel product in WooCommerce heeft variaties, elk met een eigen sku, prijs en voorraad, onder /products/<id>/variations. Dat past op de itemVariants van Business Central, met één verschil: de variantcode is daar maximaal 10 tekens en heeft geen losse velden voor kleur en maat. De koppeling splitst BL-M in Blauw en M met een vertaaltabel. Een jas met 24 varianten is in WooCommerce 2 verzoeken: het product, en één batch met de 24 variaties. Een batch neemt standaard maximaal 100 objecten aan.

De technische werkelijkheid van deze combinatie

De getallen zijn op 3 oktober 2026 nagelezen in de documentatie van WooCommerce en Microsoft.

De grens ligt bij je hosting. WooCommerce documenteert geen limiet op de REST API, dus de server bepaalt het tempo. 12.000 producten bijwerken in batches van 100 zijn 120 verzoeken. Duurt een batch op jouw hosting bijvoorbeeld 5 seconden, dan is dat 600 seconden: 10 minuten, waarin de winkel dezelfde database gebruikt. De koppeling stuurt daarom alleen gewijzigde voorraad en houdt de batches achter elkaar, niet naast elkaar.

Orders zijn voor Business Central weinig werk. Een order kost twee tot drie verzoeken: de klant zoeken, hem zo nodig aanmaken en de order met regels plaatsen. 400 orders per dag zijn 1.200 verzoeken, tegenover 6.000 per 5 minuten.

Permalinks. De REST API werkt alleen met nette permalinks. Zet iemand de permalinks in WordPress terug op de standaardinstelling, dan bestaat /wp-json/wc/v3/ niet meer en geeft elk verzoek een 404. De koppeling meldt dat direct, omdat het bij elke aanroep misgaat en niet bij één order.

Webhooks via wp-cron. WooCommerce levert webhooks op de achtergrond af via wp-cron, dat meeloopt met paginabezoeken. Op een rustige nacht kan een webhook dus later vertrekken dan de order is geplaatst. De controleronde met modified_after haalt die order hoe dan ook op. De koppeling controleert ook de status van de webhook zelf en zet hem na een storing weer aan.

Velden van plugins. Een btw-nummer, een afleverdatum of een pakketpunt staat in meta_data onder een sleutel die de plugin kiest. Na een update van die plugin kan de sleutel anders heten. De koppeling controleert bij elke order of de verwachte sleutels er zijn. De opzet van de API staat in WooCommerce REST API koppelen.

Wat een standaardkoppeling hier niet doet

Standaardkoppelingen en koppelplatformen voor dit paar documenteren hun eigen grenzen.

• Klantherkenning op e-mailadres. Een gast die met een ander adres bestelt wordt een nieuwe debiteur. Een match op bedrijfsnaam en postcode, of één vaste debiteur voor particulieren, zit er niet in.
• Boekingsgroepen als vaste waarde. De verplichte groepen worden als één standaardwaarde aan elke order toegevoegd. Particulier inclusief btw en zakelijk exclusief btw vragen twee sjablonen.
• Een vast tempo. Een gedocumenteerd tempo is 10 producten per 5 minuten. Voor 1.000 producten is dat 500 minuten, ruim 8 uur.

Een gebouwde koppeling legt deze punten vast op jouw inrichting: de matchvolgorde voor debiteuren, het sjabloon per klanttype en het tempo dat jouw hosting aankan.

Als het misgaat

Een order die blijft falen, bewaart de koppeling met de oorspronkelijke inhoud en biedt hij opnieuw aan zodra de oorzaak is opgelost. Het ordernummer in externalDocumentNumber voorkomt dat een herhaling een tweede verkooporder aanmaakt.

Voor livegang draait de koppeling als dry run: hij leest beide kanten en laat zien wat hij zou schrijven, zonder te schrijven. Wij hosten en bewaken de koppeling en passen hem aan als WooCommerce of Microsoft een interface wijzigt. De systeemkant staat op Business Central koppeling, de platformkant op WooCommerce koppeling, en alle stromen op koppelingen. Verwante combinaties: Magento Business Central koppeling en WooCommerce AFAS koppeling. Vertel welke WooCommerce-plugins en welke Business Central je draait.