WooCommerce Odoo koppeling

Wat je tussen WooCommerce en Odoo koppelt

Odoo is bij deze combinatie het ERP: artikelen, varianten, voorraad, inkoop en facturen staan daar. WooCommerce levert de order en de nieuwe klant. Aan de WooCommerce-kant loopt alles over de REST API v3, aan de Odoo-kant over de JSON-2 API vanaf Odoo 19 of XML-RPC op oudere versies.

Een WooCommerce-order heeft 8 statussen: pending, processing, on-hold, completed, cancelled, refunded, failed en trash. Een verkooporder in Odoo heeft er 4: draft, sent, sale en cancel. De koppeling zet een order pas door als hij in WooCommerce op processing staat, dus betaald. Een order op pending is een afgebroken checkout en hoort niet als offerte in Odoo. Hoe statussen tussen systemen worden vertaald staat in orderstatussen mappen.

Welk systeem is leidend, per gegeven

Wat WooCommerce en Odoo anders bewaren

Btw inclusief: per order tegenover per btw-code

WooCommerce legt op de order vast of de prijzen inclusief btw zijn ingevoerd, in prices_include_tax. In Odoo is dat een eigenschap van de btw-code: het veld Included in Price op account.tax, met als standaard de instelling van het bedrijf, en die staat bij een nieuw bedrijf op exclusief. Stuurt een koppeling de inclusieve prijs van een B2C-shop naar een exclusieve btw-code, dan rekent Odoo er nog eens 21% bovenop. Een order van € 248,04 wordt dan € 300,13.

De koppeling stuurt daarom de bedragen exclusief btw uit de WooCommerce-regel, subtotal en total, met de btw apart in subtotal_tax en total_tax, en kiest per tarief een exclusieve btw-code. Met dp=4 komen die bedragen in 4 decimalen, zodat er onderweg niets wordt afgerond. Zie bedragen en btw mappen.

Afronding per regel of per tarief

Ook met de juiste btw-code kunnen de totalen een cent verschillen. WooCommerce rondt btw standaard per regel af; de optie om op subtotaal af te ronden staat uit. Odoo rondt standaard per btw-tarief over de hele order af (Round per Tax). Drie regels van € 4,99, € 2,49 en € 7,99 inclusief 21%:

WooCommerce, per regel:  0,87 + 0,43 + 1,39          = 2,69 btw
Odoo, per tarief:        0,86603 + 0,43215 + 1,38669 = 2,68487 -> 2,68 btw
verschil                                              = 0,01

Een cent verschil tussen het WooCommerce-totaal en amount_total in Odoo blokkeert het automatisch afletteren van de betaling. Er zijn twee oplossingen: Odoo op Round per Line zetten, of WooCommerce laten afronden op subtotaal. Welke het wordt, bepaal je met je boekhouder. De koppeling vergelijkt na elke order de twee totalen en zet een afwijking op de controlelijst.

Kortingscodes en verzendkosten

WooCommerce verdeelt een kortingscode over de regels: subtotal is het bedrag voor de korting, total het bedrag erna, en de code zelf staat in coupon_lines. Een orderregel in Odoo heeft voor korting alleen discount, een percentage met standaard 2 decimalen. Een vaste korting van € 50 op een regel van € 2.049,60 is 2,4395%, dat wordt 2,44%, en dat geeft € 1.999,59 in plaats van € 1.999,60. De koppeling zet de korting daarom als eigen regel met een negatief bedrag op een kortingsartikel.

Verzendkosten staan in WooCommerce in shipping_lines, los van de productregels. In Odoo is verzending een regel met een verzendartikel en is_delivery, uit de module Delivery. Toeslagen uit fee_lines, zoals een betaaltoeslag, worden een regel met een eigen artikel.

Variaties en varianten

In Odoo bepaalt elk kenmerk zelf of het varianten maakt, met Variant Creation: Instantly, Dynamically of Never. Instantly maakt alle combinaties direct aan als product.product. Bij Dynamically bestaat een variant pas als hij op een order staat, dus vindt de koppeling voor een nieuwe combinatie nog geen default_code. Never maakt geen variant: zo'n waarde, bijvoorbeeld een gravering, gaat als product_no_variant_attribute_value_ids op de orderregel. Alleen kenmerken op Instantly worden variaties in WooCommerce. Zie varianten.

Factuur- en afleveradres

WooCommerce bewaart billing en shipping als twee adresblokken op de order. Odoo werkt met één klant en contacten eronder, elk met een type: contact, invoice, delivery of other. Een verkooporder heeft partner_invoice_id en partner_shipping_id. Het afleveradres bepaalt in Odoo ook de fiscale positie, en die kan btw-codes vervangen, bijvoorbeeld bij levering naar het buitenland. De koppeling zet de afwijkende afleveradressen als delivery-contact onder de klant en controleert welke fiscale positie Odoo kiest. Hoe huisnummers worden gesplitst staat op Odoo koppeling.

De technische werkelijkheid van deze combinatie

Nagelezen op 3 oktober 2026 in de documentatie van Odoo en de WooCommerce REST API.

Voorraad naar variaties kost per hoofdproduct. WooCommerce schrijft variaties in batches per hoofdproduct: products/<id>/variations/batch. Een shop met 2.000 tassen in elk 6 kleuren heeft 12.000 variaties. Wijzigen er op een dag 900 voorraadstanden, verdeeld over 400 tassen, dan is dat aan de Odoo-kant 1 search_read op stock.quant met een limit van 1.000, en aan de WooCommerce-kant 400 verzoeken. Zouden het 900 enkelvoudige producten zijn, dan waren het er 9. De koppeling schrijft per ronde alleen de hoofdproducten met een gewijzigde variatie.

Voorraad als geheel getal. Odoo rekent in de eenheid van het artikel en geeft free_qty als decimaal getal; stock_quantity in WooCommerce is een geheel getal. 12,5 meter wordt 12 in de shop.

Twee aanroepen per order. create maakt een offerte, action_confirm een verkooporder, en elk is een eigen transactie. Faalt de bevestiging, dan staat er een offerte met het WooCommerce-nummer in client_order_ref. De koppeling zoekt bij elke nieuwe poging eerst op dat veld en bevestigt de bestaande offerte in plaats van een tweede aan te maken.

Wat een standaardkoppeling hier niet doet

Kant-en-klare koppelingen voor WooCommerce en Odoo zijn er in twee soorten, en elk heeft een grens die in de documentatie van Odoo staat:

• Een module in Odoo. Odoo Online is volgens Odoo niet te combineren met eigen modules of modules uit de Apps Store. Een connectormodule werkt daar dus niet, en op Odoo.sh of een eigen server moet hij bij elke major versie mee, ook als een veld zoals tax_id in Odoo 19 tax_ids wordt.
• Inloggen met gebruikersnaam en wachtwoord. Koppelplatformen vragen voor Odoo een gebruikersnaam, wachtwoord, URL en databasenaam: de inlog van XML-RPC. Die verdwijnt in Odoo 22 en op Odoo Online in versie 21.1. Op JSON-2 is het een API-sleutel die bij een gewone gebruiker na 90 dagen verloopt.
• Een vaste veldenset. Btw-codes, fiscale posities, kortings- en verzendartikelen en de kenmerken van je varianten verschillen per database; een vaste mapping kent alleen de standaard.

Een gebouwde koppeling gebruikt de btw-codes, artikelen en kenmerken van jouw database, ververst de API-sleutel voor hij verloopt en controleert de totalen van elke order.

Als het misgaat

Een order die blijft falen bewaart de koppeling met de oorspronkelijke inhoud, en hij biedt hem opnieuw aan zodra de oorzaak is opgelost. Voor livegang draait hij als dry run: je ziet per order welke klant, regels, btw-codes en totalen er in Odoo zouden ontstaan, zonder dat er iets wordt aangemaakt.

Wij hosten en bewaken de koppeling en passen hem aan bij een upgrade van Odoo of WooCommerce. De systeemkant staat op Odoo koppeling, de platformkant op WooCommerce koppeling, en alle stromen op koppelingen. Verwante combinaties: WooCommerce Business Central koppeling, WooCommerce AFAS koppeling en WooCommerce Exact Online koppeling. Vertel welke Odoo-versie en welke plugins je shop gebruikt.