SAP Business One koppeling met je webshop: orders, voorraad en klantprijzen via de Service Layer

Wat is SAP Business One en wie gebruikt het?

SAP Business One is het ERP-pakket van SAP voor het mkb: financieel, verkoop, inkoop, voorraad, magazijn en productie in één database per bedrijf. Het wordt verkocht en ingericht door SAP-partners en draait op een eigen server of bij een hostingpartij, op SAP HANA of op Microsoft SQL Server. In Nederland staat het vooral bij groothandels, importeurs en productiebedrijven, vaak als vestiging van een internationale groep.

Voor een koppeling zijn twee dingen bepalend: de database en de versie. Ze bepalen welke API beschikbaar is. Een installatie op SAP HANA heeft de Service Layer. Een installatie op SQL Server heeft hem vanaf versie 10.0 PL01. Daaronder blijven de DI API en de DI Server over.

Wat je met SAP Business One koppelt

SAP Business One is in de meeste koppelingen leidend voor artikelen, voorraad, prijzen en facturen. De webshop is leidend voor de order en voor nieuwe klanten.

Een order gaat in één aanroep naar binnen, met de regels erin. Dit is order 10482 van Bakker Installatie B.V., relatie C10432:

POST /b1s/v2/Orders
Cookie: B1SESSION=PTRzIjYK-weN6-1Lx1; ROUTEID=.node1
Content-Type: application/json

{
  "CardCode": "C10432",
  "NumAtCard": "WEB-10482",
  "DocDate": "2026-10-02",
  "DocDueDate": "2026-10-05",
  "DocumentLines": [
    { "ItemCode": "KB-2210", "Quantity": 12,
      "UnitPrice": 17.08, "VatGroup": "V2" }
  ]
}

SAP antwoordt met 201 Created en twee nummers: DocEntry, de interne sleutel, en DocNum, het ordernummer dat je medewerkers zien. De koppeling bewaart beide naast het webshopordernummer. Een order verwijderen kan niet via de API; een order die vervalt wordt gesloten of geannuleerd. Welke velden per stroom meegaan staat op orders, klanten en verzending.

Hoe SAP Business One data vrijgeeft

Service Layer, DI API of DI Server

SAP Business One heeft drie API's die op dezelfde bedrijfsobjecten werken. De Service Layer is een OData-service over HTTPS, standaard op poort 50000. Het adres is https://{server}:50000/b1s/v1 voor OData versie 3 en /b1s/v2 voor OData versie 4, en alle uitwisseling is JSON. De DI API is gebouwd op Microsoft COM en draait alleen op Windows. De DI Server biedt dezelfde objecten via SOAP.

Nieuwe koppelingen bouwen wij op de Service Layer. SAP noemt zelf wat hij niet kan en de DI API wel: directe SQL via een RecordSet, import en export van XML, en transacties die over meerdere aanroepen lopen. Voor leeswerk dat buiten de standaardentiteiten valt, bestaat sinds 10.0 FP 2011 de entiteit SQLQueries, waarmee een vooraf opgeslagen query via de Service Layer wordt uitgevoerd. De volledige beschrijving staat in SAP's handleiding Working with SAP Business One Service Layer.

Inloggen met een sessie

De Service Layer werkt met een sessie, niet met een token per aanroep. De koppeling stuurt POST /b1s/v2/Login met de bedrijfsdatabase, een gebruikersnaam en een wachtwoord, en krijgt een cookie B1SESSION terug met een SessionTimeout van 30 minuten. Elke volgende aanroep stuurt die cookie mee. Een tweede cookie, ROUTEID, houdt de sessie op dezelfde node van de load balancer.

Na 30 minuten zonder aanroep is de sessie weg en geeft de Service Layer 401 Unauthorized met de melding "Invalid session or session already timeout". SAP noemt inloggen zelf een zware bewerking. De koppeling logt daarom niet per aanroep in, maar hergebruikt de sessie en logt alleen opnieuw in na een 401. De gebruiker waarmee de koppeling inlogt is een gewone SAP-gebruiker; zijn autorisaties bepalen wat de koppeling mag lezen en schrijven.

Pagina's van 20 records

SAP documenteert voor de Service Layer geen limiet in verzoeken per minuut. De doorvoer hangt af van je eigen server en van de paginagrootte.

De rekensom voor een artikelbestand van 15.000 artikelen. Op de standaardpagina van 20 zijn dat 15.000 / 20 = 750 aanroepen, elk met een odata.nextLink naar de volgende pagina. Met Prefer: odata.maxpagesize=500 zijn het er 30. De koppeling vraagt met $select alleen de velden op die de webshop gebruikt en haalt na de eerste volledige ronde alleen artikelen op die sinds de vorige ronde zijn gewijzigd. Hoe je zo'n som zelf maakt staat in doorvoer berekenen.

Webhooks sinds 10.0 FP 2602

Sinds SAP Business One 10.0 FP 2602 verstuurt de Service Layer meldingen bij een gebeurtenis, bijvoorbeeld sap.b1.Orders.Created.v1. Voor orders bestaan de gebeurtenissen aangemaakt, gewijzigd, verwijderd, gesloten, geannuleerd en heropend. De functie staat per bedrijf standaard uit en heeft een extra onderdeel op de server nodig, de Webhook Messenger Service.

De melding bevat standaard alleen de sleutel van het record. Sinds FP 2608 voegt BizObjProps er extra enkelvoudige velden aan toe, bijvoorbeeld CardCode en DocTotal; orderregels en artikelprijzen kunnen er niet in. De koppeling haalt het record daarna op. SAP's handleiding geeft twee regels voor nieuwe pogingen: de instellingentabel noemt standaard 3 pogingen met 2 seconden ertussen, de FAQ tot 5 pogingen na 2, 4, 8, 16 en 32 seconden. In beide gevallen zijn de pogingen binnen ongeveer een minuut voorbij, en een bericht ouder dan 24 uur wordt weggegooid. Een ontvanger die langer dan een minuut onbereikbaar is, mist dus meldingen. Naast de webhooks draait daarom een controleronde op de wijzigingsdatum, en op versies voor FP 2602 is die ronde de enige weg.

Waar het bij SAP Business One op vastloopt

Speciale prijzen per relatie

Een artikel heeft een prijs per prijslijst (ItemPrices), en een relatie hangt aan één prijslijst. Daarbovenop kent SAP Business One speciale prijzen: een prijs of korting voor één artikel bij één relatie, met perioden (DateFrom en Dateto) en per periode een staffel op aantal. De meeste webshops kennen die drie lagen niet in deze vorm.

De koppeling rekent de lagen daarom om naar wat het platform aankan: een prijslijst per klantgroep, een vaste prijs per klant, of een staffelregel. Loopt een periode af, dan vervalt de prijs in de webshop op dezelfde dag. Zie klantspecifieke prijzen en staffelprijzen.

Voorraad per magazijn is drie getallen

Per artikel en magazijn geeft SAP drie waarden: InStock (ligt er), Committed (toegezegd aan klanten) en Ordered (besteld bij leveranciers). Geen van de drie is het getal dat de webshop moet tonen. Ligt er van artikel KB-2210 in magazijn 01 een voorraad van 20, waarvan 4 toegezegd en 10 in bestelling, dan is er 20 - 4 = 16 vrij te verkopen. De 10 in bestelling tellen pas mee als ze binnen zijn.

Welke magazijnen meetellen leg je per koppeling vast. Een showroom of een afkeurmagazijn dat wordt meegeteld, zet te veel voorraad in de webshop. Zie meerdere magazijnen.

Sleutels, adressen en eigen velden

Het adres is het vaakst de plek waar een order blijft hangen: de webshop levert straat, huisnummer en toevoeging los of juist in één regel, en de vervoerder wil ze weer anders. De regels daarvoor staan in adresvelden mappen.

Twee medewerkers en een koppeling die dezelfde order wijzigen, overschrijven elkaar zonder controle. Sinds 10.0 FP 2102 geeft de Service Layer bij orders, leveringen en facturen een ETag mee. De koppeling stuurt die bij een wijziging terug in de header If-Match; is de order intussen gewijzigd, dan weigert SAP de aanroep en haalt de koppeling eerst de nieuwe stand op.

Platformen die we aan SAP Business One koppelen

De koppeling wordt gebouwd op jouw SAP Business One: jouw versie, jouw database, jouw prijslijsten en eigen velden. Per combinatie staat op een eigen pagina wat er specifiek speelt:

• WooCommerce SAP Business One koppeling
• Shopify SAP Business One koppeling
• Magento SAP Business One koppeling

Andere ERP-systemen staan op Business Central koppeling, Exact Globe koppeling en Exact Online koppeling. Het overzicht van alle stromen staat op koppelingen, de ERP-kant in het algemeen op ERP koppeling met je webshop.

Wij bouwen de koppeling voor een vaste prijs, en hosten, draaien en bewaken hem daarna voor een vast bedrag per maand. Voor de livegang draait hij als dry run: je ziet per order welke relatie, prijs en regels in SAP zouden ontstaan, zonder dat er iets wordt aangemaakt. Vertel welke versie en database je draait en welke webshop je hebt, dan hoor je welke API beschikbaar is en welke gegevens daarover kunnen.