OCI of cXML: de twee PunchOut-protocollen naast elkaar

Het korte antwoord

Je kiest het niet zelf: het inkoopsysteem van je klant bepaalt het protocol. SAP SRM gebruikt OCI. Coupa en SAP Ariba gebruiken cXML. AFAS en Elari, voorheen Spend Cloud, gebruiken OCI voor de winkelmand en sturen de order daarna als cXML.

Het verschil zit in hoe ver elk protocol reikt. OCI is een specificatie van SAP voor de sessie en de winkelmand. De laatste versie, 5.0, dateert van 2012, en na de winkelmand houdt hij op. cXML beschrijft de sessie en ook alles wat daarna komt: inkooporder, orderbevestiging, verzendbericht en factuur. De cXML-referentie wordt bijgehouden door SAP; versie 1.2.071 is van 14 augustus 2026. Voor een leverancier betekent dat: met OCI bouw je een sessie, met cXML een sessie en een orderadres met vier soorten berichten.

OCI en cXML naast elkaar

De stappen van de sessie zijn bij beide gelijk: de inkoper klikt in zijn inkoopsysteem op jouw webshop, is ingelogd, vult een winkelmand en neemt hem mee terug. Bij beide is die winkelmand nog geen order. De cXML-referentie noemt hem met zoveel woorden een offerte. Het hele verloop staat op OCI en PunchOut.

Eén regel in beide formaten

Bakker Installatie B.V. bestelt 500 kabelbinders van 200 mm, artikel 30377, voor 3,75 per 100 stuks. In OCI:

<input type="hidden" name="NEW_ITEM-DESCRIPTION[3]" value="Kabelbinder 200 mm zwart">
<input type="hidden" name="NEW_ITEM-QUANTITY[3]" value="500">
<input type="hidden" name="NEW_ITEM-UNIT[3]" value="PCE">
<input type="hidden" name="NEW_ITEM-PRICE[3]" value="3.75">
<input type="hidden" name="NEW_ITEM-PRICEUNIT[3]" value="100">
<input type="hidden" name="NEW_ITEM-CURRENCY[3]" value="EUR">
<input type="hidden" name="NEW_ITEM-VENDORMAT[3]" value="30377">

In cXML, als deel van de PunchOutOrderMessage:

<ItemIn quantity="500">
  <ItemID><SupplierPartID>30377</SupplierPartID></ItemID>
  <ItemDetail>
    <UnitPrice><Money currency="EUR">3.75</Money></UnitPrice>
    <Description xml:lang="nl">Kabelbinder 200 mm zwart</Description>
    <UnitOfMeasure>EA</UnitOfMeasure>
    <PriceBasisQuantity quantity="100" conversionFactor="1">
      <UnitOfMeasure>EA</UnitOfMeasure></PriceBasisQuantity>
    <Classification domain="UNSPSC">(UNSPSC-code)</Classification>
  </ItemDetail>
</ItemIn>

In beide gevallen is het regelbedrag 500 / 100 × 3,75 = 18,75. Zonder prijseenheid gaat het in OCI mis: per stuk kost de kabelbinder 0,0375, het prijsveld heeft 3 decimalen, dus wordt het 0.038 en de regel 500 × 0,038 = 19,00. In cXML doet PriceBasisQuantity hetzelfde werk als NEW_ITEM-PRICEUNIT. Of het inkoopsysteem van je klant dat element leest, test je; anders verkoop je per zak van 100.

Drie dingen veranderen onderweg. De eenheid gaat van de ISO-code PCE naar de UN/CEFACT-code EA. Er komt een Classification bij, die cXML verplicht stelt en die in OCI een optioneel veld is. En de omschrijving heeft andere grenzen: NEW_ITEM-DESCRIPTION is 40 tekens, de cXML-Description heeft geen vaste lengte, maar het optionele ShortName erin is maximaal 50 tekens, met 30 als aanbeveling.

Waar OCI stopt

• Bij de winkelmand. Er is geen order, geen bevestiging en geen factuur in de specificatie. Elk inkoopsysteem kiest zelf hoe de order komt: AFAS en Elari met cXML, andere met een pdf per e-mail.
• Bij btw. De specificatie heeft geen btw-veld. AFAS leest het percentage uit NEW_ITEM-CUST_FIELD1, Elari uit NEW_ITEM-VATPERCENTAGE. Per klant leg je vast welk veld het wordt.
• Bij de inlog. Gebruikersnaam en wachtwoord gaan via de browser van de inkoper. Bij GET staan ze in de URL en daarmee in de toegangslog van de webshop.
• Bij fouten. Een winkelmand die het inkoopsysteem afwijst, geeft geen statuscode aan de webshop. Bij AFAS houdt één regel die niet klopt de hele overdracht tegen, en dat ziet alleen de inkoper.
• Bij de tekenset. Het inkoopsysteem geeft bijvoorbeeld iso-8859-1 op. Een webshop die UTF-8 terugstuurt, levert "geïsoleerd" af als "geïsoleerd". Zie tekencodering en UTF-8.

Waar cXML stopt

• Bij de eisen per regel. Elke ItemIn moet SupplierPartID, UnitPrice, Description, UnitOfMeasure en Classification hebben. Een webshop zonder UNSPSC-codes of met eenheden als "stuk" moet die eerst vertalen; zie eenheden en verpakkingen.
• Bij het netwerk. Via SAP Business Network zet het netwerk zichzelf in Sender. Een webshop die de klant zoekt op Sender en niet op From, antwoordt dan 401.
• Bij de pogingen. Op een 5xx beveelt de referentie 10 nieuwe pogingen aan, een keer per uur. Een orderadres dat langer dan 10 uur onbereikbaar is, mist de order. Een herhaling heeft dezelfde payloadID; wie daar niet op controleert, maakt de order twee keer aan.
• Bij de catalogus. Een cXML-catalogus uploaden mag tot 4 MB; groter geeft status 468.

Wat elk vraagt in onderhoud

AFAS en Elari zijn een voorbeeld van het onderhoud bij OCI. AFAS noemt voor zijn standaarddefinitie 12 velden en leest van NEW_ITEM-VENDORMAT 30 tekens; Elari leest er standaard 8 en vraagt btw in een veld dat SAP niet kent. Dezelfde webshop stuurt voor twee klanten dus twee verschillende winkelmanden.

Wat betekent dit voor je koppeling?

Voor je webshop is het verschil kleiner dan het lijkt: de inlog, de sessie met de prijzen van de klant en de knop die de winkelmand terugstuurt, zijn voor beide protocollen gelijk. Het werk zit in de velden per klant en, bij cXML, in het orderadres en de berichten die daarna komen.

Wij bouwen beide op je bestaande webshop en zetten de order die volgt in je ERP. Het hele verloop staat op OCI en PunchOut, de cXML-berichten één voor één op PunchOut koppeling. Vertel welk inkoopsysteem je klant gebruikt.