Shopify SAP Business One koppeling

Wat je tussen Shopify en SAP Business One koppelt

Shopify geeft gegevens vrij via de GraphQL Admin API, SAP Business One via de Service Layer, de OData-API op poort 50000. Bij deze combinatie draait het meestal om B2B: relaties met eigen prijzen die in Shopify als bedrijf bestellen.

Een B2B-order in Shopify weet via purchasingEntity voor welk bedrijf en welke locatie hij is geplaatst. Die locatie hoort bij een CardCode in SAP, en zo komt de order op de juiste relatie zonder te zoeken op e-mailadres. Hoe dit in een ERP-koppeling past staat op ERP koppeling met je webshop.

Welk systeem is leidend, per gegeven

Wat Shopify en SAP Business One anders bewaren

Speciale prijzen tegenover catalogi

Een relatie in SAP hangt aan één prijslijst (PriceListNum). Daarboven staan speciale prijzen per artikel en relatie, met perioden (DateFrom, Dateto) en per periode een staffel. Een speciale prijs gaat in SAP voor op alle andere prijzen van die relatie.

Shopify B2B werkt met catalogi. Een catalogus heeft een prijslijst met vaste prijzen per variant en hangt aan een of meer bedrijfslocaties. Heeft een locatie meer dan één catalogus, dan krijgt de koper de laagste prijs. Geef je de locatie van relatie C10432 de groothandelscatalogus van € 9,20 en een eigen catalogus met de afgesproken € 9,60, dan betaalt de klant € 9,20. De koppeling rekent daarom per locatie zelf de prijs uit zoals SAP hem zou rekenen, en geeft de locatie één catalogus: de speciale prijs waar die bestaat, en de prijslijst voor de rest.

Dat kost catalogi. 300 relaties met eigen speciale prijzen zijn 300 catalogi. Onder Plus zijn er 3 actieve catalogi; op Plus 10.000 per winkel en 25 per locatie. Een prijslijst in Shopify heeft geen begin- of einddatum, dus de koppeling zet een periodeprijs op de begindatum in de catalogus en haalt hem op de einddatum weg. Zie klantspecifieke prijzen.

Magazijnen tegenover locaties

Per artikel en magazijn geeft SAP InStock, Committed en Ordered. Een magazijn heeft een WarehouseCode van maximaal 8 tekens. Shopify heeft locaties: 10 op Basic, Grow en Advanced, 200 op Plus. Per locatie houdt Shopify zelf bij wat er aan open orders hangt (committed), en wat er te koop is heet available.

SAP en Shopify trekken dezelfde order dus allebei af, op een ander moment:

De koppeling trekt van InStock het toegezegde aantal af en daarnaast de Shopify-orders die SAP nog niet heeft. Hij schrijft met inventorySetQuantities en geeft sinds API-versie 2026-04 bij elke regel changeFromQuantity mee: de waarde die hij verwacht. Is de voorraad in Shopify intussen veranderd, door een order of een correctie in de winkel, dan weigert Shopify de wijziging en leest de koppeling eerst opnieuw. Zie welke voorraad toon je in je webshop.

Ordernummers en het inkoopordernummer

Een Shopify-order heeft een naam als #1042. Een B2B-order heeft daarnaast het poNumber van de koper. In SAP is NumAtCard het veld waarmee de klant de order herkent, en dat staat op pakbon en factuur. Bij een B2B-order gaat daar het poNumber in. Het Shopify-ordernummer gaat in een eigen veld (U_ShopifyOrder), en daarop zoekt de koppeling voordat hij een order aanmaakt. Een nieuw eigen veld is in de Service Layer pas bereikbaar na een herstart van de Service Layer; die plannen we in bij de inrichting.

De technische werkelijkheid van deze combinatie

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

Voorraad doorgerekend. 4.000 varianten op 3 locaties zijn 12.000 voorraadregels. inventorySetQuantities neemt 250 regels per aanroep: 12.000 / 250 = 48 aanroepen. Uit SAP is het voorraadoverzicht per artikel te lezen met $select op ItemCode en ItemWarehouseInfoCollection: 4.000 artikelen bij 500 per pagina zijn 8 aanroepen. Na de eerste ronde gaan alleen gewijzigde regels mee. Je eigen aantallen reken je door met doorvoer berekenen.

Throttling ziet er anders uit. Een vertraagd verzoek aan Shopify geeft geen 429 maar 200 OK met de fout THROTTLED in het antwoord. Een koppeling die alleen op de statuscode let, ziet dat als gelukt. De koppeling leest de fout en het veld throttleStatus en wacht tot er weer punten zijn. Meer in Shopify API-limieten.

Webhooks aan twee kanten. Shopify probeert een webhook 8 keer in 4 uur en heft het abonnement daarna op. SAP probeert standaard 3 keer met 2 seconden ertussen en gooit een bericht na 24 uur weg. Aan beide kanten draait daarom een controleronde op de wijzigingsdatum, zodat een gemiste melding de volgende ronde alsnog binnenkomt.

Wat een standaardkoppeling hier niet doet

Apps in de Shopify App Store die SAP Business One koppelen, beschrijven wat ze doen. Bij een van die apps stond:

• Artikelen en artikelgroepen, één kant op. Items worden producten en artikelgroepen categorieën, van SAP naar Shopify.
• Geen orders, prijzen of voorraad per locatie in de beschrijving van de app.
• SAP Business One 10.0 op HANA als voorwaarde, met de Service Layer ingericht door je SAP-partner.

Een gebouwde koppeling schrijft orders met inkoopordernummer naar SAP, rekent speciale prijzen per locatie om naar catalogi en houdt de voorraad per magazijn gelijk.

Als het misgaat

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 bedrijfslocatie welke catalogus en welke prijzen er in Shopify zouden komen, en per order welke relatie en regels er in SAP zouden ontstaan, zonder iets te schrijven.

Wij hosten en bewaken de koppeling en passen hem aan als Shopify een nieuwe API-versie uitbrengt of SAP een feature pack. De systeemkant staat op SAP Business One koppeling, de platformkant op Shopify koppeling, en alle stromen op koppelingen. Verwante combinaties: WooCommerce SAP Business One koppeling en Magento SAP Business One koppeling. Vertel welk Shopify-plan en welke SAP-versie je hebt.