SHOPIFY × OCI / SAP
OCI punchout voor Shopify (SAP SRM, S/4HANA)
Veel Europese inkooporganisaties draaien OCI. Koppel je Shopify-catalogus met HOOK_URL-roundtrips, contractprijzen en de custom NEW_ITEM-velden die het ERP van je klant eist.
HOOK_URL=https://buyer-erp.example.com/oci/return
USERNAME=shop_user
PASSWORD=***
OCI_VERSION=4.0
returntarget=_parent
<form method="post" action="{HOOK_URL}">
<input name="NEW_ITEM-DESCRIPTION[1]" value="Nitrile gloves, box of 100">
<input name="NEW_ITEM-VENDORMAT[1]" value="SKU-4711">
<input name="NEW_ITEM-QUANTITY[1]" value="50">
<input name="NEW_ITEM-UNIT[1]" value="BX">
<input name="NEW_ITEM-PRICE[1]" value="25.00">
<input name="NEW_ITEM-CURRENCY[1]" value="USD">
<input name="NEW_ITEM-MATGROUP[1]" value="46181504">
</form>cXML krijgt de aandacht, maar een fors deel van de Europese inkoop, vooral in de DACH-regio, draait op SAP's Open Catalog Interface. OCI is ouder en simpeler: het ERP roept je catalogus-URL aan met een HOOK_URL als retouradres, de inkoper winkelt, en de winkelwagen gaat terug als NEW_ITEM-formuliervelden.
Simpel is waar de problemen zich verstoppen. Elk ERP spreekt zijn eigen velddialect: ISO-eenheden, materiaalgroepen, MATNR leeg of gevuld, en de custom NEW_ITEM-extensies die bepalen of een winkelwagen netjes een bestelaanvraag wordt of op een supportstapel belandt. PunchRelay mapt velden per klant, in plaats van de verwachtingen van één SAP-systeem hard te coderen.
Geen enkele punchout-leverancier dekt Shopify plus OCI vandaag serieus af. Draaien je klanten SAP SRM of S/4HANA en draait je shop op Shopify, dan is deze pagina voor jou.
Werkt met
- SAP Ariba
- Coupa
- Jaggaer
- Oracle Procurement
- Workday
- SAP SRM
- Unimarket
- PO-bevestiging
- <150ms
- protocollen, cXML + OCI
- 2
- cXML-documenten, volledige roundtrip
- 4
- contractprijzen uit Shopify B2B-catalogi
- 100%
Zo werkt het met OCI
- 01
Het ERP roept je OCI-URL aan
SAP SRM, S/4HANA of een ander OCI-systeem opent je PunchRelay-URL via HTTP GET of formulier-POST, met HOOK_URL, USERNAME, PASSWORD en OCI_VERSION. Wij valideren de credentials en starten een sessie gekoppeld aan de Shopify B2B company location van de klant.
- 02
De inkoper winkelt tegen contractprijzen
De inkoper werkt in je Shopify-shop met de catalogus en prijslijst van zijn company location. Contractprijzen komen uit Shopify B2B, dezelfde bron als voor al je andere kanalen.
- 03
De winkelwagen terug als NEW_ITEM-velden
PunchRelay rendert het zelfversturende retourformulier naar de HOOK_URL: NEW_ITEM-DESCRIPTION, VENDORMAT, QUANTITY, ISO-eenheden, PRICE, MATGROUP, geïndexeerd per regel, plus de custom velden die het ERP eist.
- 04
De bestelaanvraag loopt in het ERP
De overgedragen winkelwagen wordt in SAP een winkelwagen of bestelaanvraag en doorloopt daar de goedkeuring. OCI verplaatst alleen de winkelwagen. De inkooporder is een aparte stap, op voorwaarden van de klant.
- 05
De PO komt terug via het kanaal dat het ERP kan
Kan het systeem van je klant cXML OrderRequest sturen, en veel SAP-installaties kunnen dat, dan ontstaat de Shopify-order automatisch, bevestigd binnen 150 ms. Kan het dat niet, dan is de overgedragen winkelwagen in PunchRelay één klik verwijderd van een Shopify draft order.
Gebouwd voor de IT-checklist van je klant
NEW_ITEM-mapping per klant
ISO-eenheden, MATGROUP-taxonomieën, EXT_PRODUCT_ID, maatwerkvelden: elke OCI-klant krijgt exact de veldenset die zijn ERP eist, gemapt vanuit je Shopify-productdata.
Hoeveelheidsregels vóór de overdracht
Minima, maxima en verpakkingseenheden draaien in de winkelwagen, vóór de NEW_ITEM-post vertrekt. Winkelwagens komen direct boekbaar aan in het ERP.
Volledige sessielogs, twee richtingen
Setup-calls en NEW_ITEM-posts worden ruw gelogd. Wil het SAP-team van je klant weten wat er verstuurd is, dan stuur je de echte payload door, veld voor veld.
OCI punchout, vraag en antwoord
- Wat is OCI?
- SAP's Open Catalog Interface, de punchout-standaard van de SAP-wereld en nog altijd de default in de Duitstalige inkoop. Het ERP opent je catalogus met een HOOK_URL als retouradres, en de winkelwagen reist terug als NEW_ITEM-formuliervelden. In de praktijk draaien versies 4.0 en 5.0.
- GET of POST? Welke OCI-versies?
- Allebei. OCI-setupcalls komen binnen als HTTP GET of formulier-POST met USERNAME, PASSWORD, HOOK_URL en OCI_VERSION. PunchRelay ondersteunt de dialecten van 4.0 en 5.0 en de returntarget-eigenaardigheden ertussenin.
- Kunnen jullie custom NEW_ITEM-velden mappen?
- Ja, per klant. Sommige ERP's eisen NEW_ITEM-EXT_PRODUCT_ID, een specifieke MATGROUP-indeling of eigen velden voordat een winkelwagen netjes wordt geboekt. PunchRelay mapt Shopify-productdata op exact de veldenset die het ERP van die klant eist, per koppeling, zonder maatwerkcode.
- Hoe komen inkooporders terug in Shopify?
- OCI draagt winkelwagens over, geen inkooporders. Het eerlijke antwoord hangt dus af van het ERP van de klant. Kan het cXML OrderRequest sturen, dan wordt de PO automatisch een Shopify-order. Kan het dat niet, dan maakt één klik van de overgedragen winkelwagen-sessie een Shopify draft order, met prijzen en aantallen al gelijk.
- Welke ERP's dekken jullie?
- SAP SRM en S/4HANA zijn de kern. Onventis en andere OCI-sprekende inkoopplatformen lopen over dezelfde interface. Kan het systeem van je klant een OCI-catalogus-URL aanroepen, dan kan het een Shopify-shop op PunchRelay aanroepen.
- Ondersteunen jullie ook cXML?
- Ja, beide protocollen in één app. In de praktijk heeft een Europese leverancier vaak één klant op SAP OCI en de volgende op Ariba of Coupa met cXML, en daar zou je shop niets van moeten merken.
Vraag early access aan
We onboarden een kleine groep Shopify B2B-merchants en bouwen hun eerste koppelingen samen met ze. Laat weten waar we je kunnen bereiken.