WooCommerce SAP Business One koppeling

Wat je tussen WooCommerce en SAP Business One koppelt

WooCommerce geeft gegevens vrij via de REST API v3, SAP Business One via de Service Layer, de OData-API op poort 50000. SAP is leidend voor artikelen, voorraad en prijzen, WooCommerce voor de order.

Een order gaat naar SAP als hij in WooCommerce op processing staat. Het WooCommerce-nummer gaat in NumAtCard, het referentieveld van de klant, en SAP geeft DocEntry en DocNum terug. De koppeling bewaart alle drie. Hoe dit past in een koppeling met een ERP staat op ERP koppeling met je webshop.

Welk systeem is leidend, per gegeven

Wat WooCommerce en SAP Business One anders bewaren

Gastorders tegenover een verplichte CardCode

Een order in SAP Business One hangt altijd aan een relatie: CardCode is verplicht, maximaal 15 tekens. WooCommerce staat bestellen zonder account toe, en dan heeft de order customer_id 0. De koppeling zoekt daarom eerst op e-mailadres (EmailAddress in SAP) en bij een zakelijke klant op btw-nummer, dat in SAP in FederalTaxID staat, 32 tekens. Vindt hij niets, dan gebeurt een van twee dingen, die je vooraf kiest: een nieuwe relatie, of de order op een vaste verzamelrelatie met het adres op de order zelf.

Een nieuwe relatie en de order gaan in één change set van de Service Layer. SAP voert zo'n change set als geheel uit of helemaal niet. Mislukt de order, dan staat er dus ook geen losse relatie zonder order in SAP. Zie dubbele klanten en debiteuren.

Het adres op de order

WooCommerce levert address_1 en address_2 als vrije regels, zonder huisnummerveld. Het adres op een SAP-order kent wel losse velden: ShipToStreet, ShipToStreetNo, ShipToZipCode en ShipToCountry. Op de adressen van een relatie documenteert SAP het veld StreetNo daarentegen als "For Brazil only". De koppeling splitst daarom op het huisnummer voor het orderadres, en houdt bij een nieuwe relatie de vorm aan die je bestaande relaties al hebben. Zie adresvelden mappen.

Voorraad: meerdere magazijnen, één geheel getal

Per artikel en magazijn geeft SAP InStock, Committed en Ordered, als decimaal getal. WooCommerce heeft één stock_quantity per product of variatie, een geheel getal, zonder magazijn. De koppeling telt per artikel de magazijnen op die meedoen en trekt daar het toegezegde aantal af:

(20 - 4) + 7,5 = 23,5. Dat wordt naar beneden afgerond op 23, omdat WooCommerce geen halve stuks kent. De showroom blijft buiten de som. Welke magazijnen meetellen leg je per koppeling vast.

Prijzen per relatie

Een relatie in SAP hangt aan één prijslijst (PriceListNum), en daarbovenop kunnen speciale prijzen per artikel en relatie staan, met perioden en staffels. De REST API van WooCommerce kent alleen regular_price en sale_price per product: een prijs per klant bestaat er niet. De basisprijs uit één SAP-prijslijst gaat naar regular_price. Klantprijzen lopen via een B2B-plugin, en de koppeling schrijft naar de velden van die plugin. Zie klantspecifieke prijzen.

De technische werkelijkheid van deze combinatie

Nagelezen op 3 oktober 2026 in de documentatie van WooCommerce en de handleiding Working with SAP Business One Service Layer.

Artikelen doorgerekend. 6.000 artikelen uit SAP lezen is bij de standaardpagina van 20 records 6.000 / 20 = 300 aanroepen. Met Prefer: odata.maxpagesize=500 zijn het er 12. Naar WooCommerce zijn 6.000 voorraadgetallen 6.000 / 100 = 60 batchverzoeken. Na de eerste ronde gaan alleen gewijzigde artikelen mee. Je eigen aantallen reken je door met doorvoer berekenen.

Twee kanten die elk iets laten liggen. WooCommerce verstuurt webhooks via WP-Cron, dat alleen draait als er een pagina wordt geladen, en schakelt een webhook uit na 5 mislukte afleveringen op rij. SAP houdt een sessie 30 minuten vast; daarna geeft de volgende aanroep 401. De koppeling logt dan opnieuw in en herhaalt de aanroep, en haalt naast de webhooks elk kwartier orders op met modified_after, zodat een order die geen webhook kreeg toch aankomt.

Wat een standaardkoppeling hier niet doet

Plugins die WooCommerce aan SAP Business One koppelen, beschrijven hun eigen grenzen. Bij een plugin in de WordPress-pluginbibliotheek stond:

• De SKU moet gelijk zijn aan de ItemCode. Een product met een andere SKU wordt niet gekoppeld.
• Eén prijslijst voor de hele winkel. Prijzen per relatie of per klantgroep vallen erbuiten.
• Voorraad als som van de gekozen magazijnen, als één getal per SKU.
• Producten moeten al in WooCommerce bestaan; aanmaken vanuit SAP en orders naar SAP zitten pas in de betaalde versie.
• Elk uur op zijn snelst in de gratis versie, via WP-Cron.

Een gebouwde koppeling legt per magazijn, per prijslijst en per soort klant vast wat er gebeurt, en schrijft orders, relaties en annuleringen naar SAP.

Als het misgaat

Voordat de koppeling een order schrijft, zoekt hij of er al een order met dezelfde NumAtCard bestaat, zodat een time-out halverwege geen tweede order oplevert. Een order die blijft falen wordt met de oorspronkelijke inhoud bewaard en gaat opnieuw mee zodra de oorzaak is opgelost. Voor livegang draait de koppeling als dry run: per order welke relatie, welke regels en welke btw-groep er in SAP zouden ontstaan, zonder iets aan te maken.

Wij hosten en bewaken de koppeling en passen hem aan als SAP of WooCommerce iets wijzigt. De systeemkant staat op SAP Business One koppeling, de platformkant op WooCommerce koppeling, en alle stromen op koppelingen. Verwante combinaties: Shopify SAP Business One koppeling en Magento SAP Business One koppeling. Vertel welke SAP-versie en welke B2B-plugin je gebruikt.