Naar hoofdinhoud

Punchout catalogus: zo werken cXML en OCI voor leveranciers

Wat een punchout catalogus is, hoe een cXML- of OCI-sessie een winkelwagen terugstuurt en welke eenheden, prijzen en codes leveranciers eerst regelen.

Punchout catalogus: zo werken cXML en OCI voor leveranciers

Een punchout catalogus is de online catalogus van een leverancier die een zakelijke inkoper opent vanuit zijn eigen inkoopsysteem, zoals SAP Ariba, Coupa of SAP SRM. De inkoper klikt op de leverancier, komt op diens site terecht met zijn contractassortiment en contractprijzen, vult een winkelwagen en die winkelwagen gaat terug naar het inkoopsysteem als inkoopaanvraag, niet als bestelling. Goedkeuring en inkooporder volgen daarna via de regels van de inkoper zelf.

Het alternatief is een gehoste catalogus: de leverancier levert een bestand aan (CIF, BMEcat of het Excel-sjabloon van de klant) en de producten staan in het systeem van de inkoper. Bij punchout blijft de productdata bij de leverancier. Dat past bij grote of configureerbare assortimenten en prijzen die vaak wijzigen. Beide routes hangen af van hetzelfde: artikelnummers, eenheden, prijzen en classificatiecodes die een inkoopsysteem kan lezen zonder dat iemand ze overtypt.

Punchout of gehoste catalogus: waar staat de productdata?

De keuze draait vooral om wie de catalogus onderhoudt en hoe vaak die verandert. Bij punchout bewaart het systeem van de inkoper alleen een link en inloggegevens; alles wat de inkoper ziet, komt op het moment van winkelen van de site van de leverancier. Bij een gehoste catalogus bewaart het systeem van de inkoper een kopie, die zo actueel is als de laatste upload.

Punchout en gehoste catalogusformaten vergeleken

cXML-punchoutLive sessieWebsite van de leverancierContractprijzen op het moment van winkelenSAP Ariba, Coupa en andere cXML-inkoopsystemen
OCI-punchoutLive sessieWebsite van de leverancierIdem, teruggestuurd als NEW_ITEM-veldenInkoop in SAP (SRM)
CIF-bestandGehoste catalogusInkoopsysteem van de klantVast tot de volgende uploadStatische catalogi in cXML-systemen
BMEcat-bestandGehoste catalogus of data-uitwisselingSysteem van de klant of PIM van de groothandelIn het bestand, per artikelUitwisseling fabrikant naar groothandel, vaak met ETIM-kenmerken
Excel-sjabloon van de klantGehoste catalogusSysteem van de klantVast tot de volgende uploadKleinere inkopers zonder punchout
Punchout stuurt een winkelwagen terug; gehoste formaten leveren het hele assortiment als bestand, dus prijzen zijn zo vers als de laatste upload.

Veel leveranciers doen allebei. Een distributeur van elektrotechnische artikelen biedt punchout aan zijn grootste klanten, stuurt BMEcat-bestanden naar groothandels en vult een Excel-sjabloon in voor een gemeente die twee keer per jaar bestelt. Elke output leest uit hetzelfde productrecord. Daarom is het datamodel belangrijker dan het protocol.

Een punchout-sessie, bericht voor bericht

De cXML Getting Started-gids beschrijft procurement punchout als live, interactieve catalogi op een website: het inkoopsysteem toont een knop in plaats van productdetails, en de browser van de gebruiker opent de pagina's van de leverancier. De site van de leverancier heeft drie dingen nodig: een URL die het setupverzoek aanneemt, een manier om de inkoper te herkennen en een afrekenknop die de winkelwagen terugstuurt in plaats van een betaling te starten.

Een cXML-punchoutsessie van klik tot inkooporder

Diagram laden
De leverancier ontvangt tijdens de sessie zelf geen bestelling; de inkooporder komt pas na goedkeuring bij de inkoper.
  1. Setupverzoek. Het inkoopsysteem stuurt een PunchOutSetupRequest met de inloggegevens van de inkoper en een shared secret, plus een BuyerCookie en een BrowserFormPost-URL waar de winkelwagen naartoe moet.
  2. Setupantwoord. De leverancier controleert de gegevens en antwoordt met een StartPage-URL, meestal een inloglink naar de catalogus die alleen voor deze sessie geldt.
  3. Winkelen. De inkoper bekijkt het contractassortiment, configureert producten en vult een winkelwagen op de site van de leverancier.
  4. Winkelwagen terug. Bij het afrekenen post de site een PunchOutOrderMessage als verborgen formulierveld naar de BrowserFormPost-URL. Elke regel is een ItemIn met artikelnummer, prijs, omschrijving, eenheid en classificatie.
  5. Goedkeuring. De winkelwagen wordt een inkoopaanvraag en doorloopt de goedkeuringsflow van de klant. Er is nog niets besteld.
  6. Inkooporder. Na goedkeuring stuurt het inkoopsysteem een OrderRequest naar de leverancier: dat is de echte bestelling.

De cXML Reference Guide kent drie soorten sessies in het attribuut operation: create, edit en inspect. Met edit opent een inkoper een eerder teruggestuurde winkelwagen opnieuw, met inspect bekijkt hij die alleen. De leverancier kan een eigen referentie, zoals een offertenummer, opslaan in SupplierPartAuxiliaryID; het inkoopsysteem geeft die terug in latere sessies en in de inkooporder.

cXML of OCI: twee protocollen voor dezelfde rondgang

cXML (commerce XML) is het protocol achter punchout in SAP Ariba en Coupa. Het setupverzoek en de teruggestuurde winkelwagen zijn XML-documenten, en dezelfde familie documenten dekt inkooporders, orderbevestigingen, verzendberichten en facturen. Daarom vragen inkopers op cXML-systemen een punchout-leverancier vaak om ook cXML-inkooporders te verwerken.

OCI (het Open Catalog Interface van SAP) is eenvoudiger. Het systeem van de inkoper opent de URL van de leverancier met inlogparameters en een HOOK_URL, het retouradres voor de winkelwagen. De winkelwagen komt terug als HTML-formulier met genummerde velden. De technische OCI-informatie van Unite noemt de velden die automatisch meegaan: NEW_ITEM-EXT_PRODUCT_ID, NEW_ITEM-PRICE, NEW_ITEM-PRICEUNIT, NEW_ITEM-QUANTITY, NEW_ITEM-UNIT, NEW_ITEM-DESCRIPTION, NEW_ITEM-LONGTEXT, NEW_ITEM-CURRENCY en NEW_ITEM-LEADTIME in dagen. OCI-velden worden volgens Unite in het algemeen afgekapt op 255 tekens.

Het ontvangende SAP-systeem kan strenger zijn. In de OCI-veldmapping van 2BA voor SAP SRM bevat NEW_ITEM-DESCRIPTION 40 tekens, NEW_ITEM-UNIT 3 en NEW_ITEM-MATGROUP, de materiaalgroep van de inkoper, 10. Een webshoptitel van 90 tekens komt dus als de eerste 40 tekens in de inkoopaanvraag terecht. Een leverancier heeft daarom een korte naam nodig die voor dat veld geschreven is.

Punchout level 1 en level 2

Bij level 1 toont de catalogus van de inkoper één ingang voor de leverancier. De inkoper klikt erop, komt op de homepage van de leverancier en zoekt daar zoals in elke webshop. Volgens de SAP-training over punchout-catalogi is ook voor level 1 een klein statisch indexbestand nodig, meestal één kommagescheiden regel, dat je uploadt naar het SAP Business Network. Dit level is het makkelijkst op te zetten, maar de inkoper moet vooraf weten welke leverancier het artikel verkoopt.

Bij level 2 uploadt de leverancier een index in CIF-stijl met een regel per SKU. De zoekfunctie in de catalogus van de inkoper toont die artikelen dan als een gehoste catalogus, en één klik brengt de inkoper direct naar dat artikel of die categorie op de site van de leverancier. Staan er prijzen in de index, dan kan de actuele prijs op de site van de leverancier volgens SAP afwijken; de prijs in de live sessie is dus de prijs die telt. De index is weer een bestand dat gelijk moet blijven met de live site, dus vraag elke klant welk level zijn inkoopomgeving verwacht.

Welke productdata een punchout-winkelwagen meeneemt

Na het afrekenen ziet de inkoopafdeling de productpagina van de leverancier niet meer. In de aanvraag, de goedkeuringsmail en de inkooporder staan alleen een paar velden, en elk veld moet op zichzelf duidelijk zijn. Het voorbeeld hieronder volgt één illustratief product, een zwarte kabelbinder in zakken van 100, door beide protocollen.

Eén kabelbinder in een punchout-winkelwagen

Artikelnummer leverancierART-88401SupplierPartIDNEW_ITEM-VENDORMAT of EXT_PRODUCT_ID
Korte naamKabelbinder 4,8 x 300 mm zwartDescription / ShortNameNEW_ITEM-DESCRIPTION
Lange omschrijvingUV-bestendige kabelbinder van polyamide 6.6 voor buitengebruikOmschrijvingstekstNEW_ITEM-LONGTEXT
EenheidStuk (EA of PCE, uit de lijst van de inkoper)UnitOfMeasureNEW_ITEM-UNIT
Prijs en prijsbasisEUR 12,40 per 100 stuksUnitPrice + PriceBasisQuantityNEW_ITEM-PRICE + NEW_ITEM-PRICEUNIT
ClassificatieUNSPSC- of ECLASS-codeClassification domainNEW_ITEM-MATGROUP (groep van de inkoper)
Fabrikant en fabrikantnummerMerknaam, artikelnummer fabrikantManufacturerName, ManufacturerPartIDEigen NEW_ITEM-veld
Levertijd3 dagenLeadTime (dagen)NEW_ITEM-LEADTIME (dagen)
8 van 8 rijen
Illustratief voorbeeld: de prijs geldt per zak van 100, dus de winkelwagen moet die prijsbasis meesturen, anders leest het systeem van de inkoper 12,40 euro per stuk.

Drie velden veroorzaken de meeste mislukte of verwarrende winkelwagens:

  • Eenheden. In de cXML-stappen voor leveranciers van Coupa staat dat inkopers vooraf de eenheden van de leverancier moeten opvragen, omdat een winkelwagen met een eenheid die niet in Coupa bestaat niet binnenkomt. Koppel elke verkoopeenheid op je site (stuk, zak, doos, meter, rol) vóór livegang aan de codes die elke klant gebruikt.
  • Prijsbasis. Een prijs per 100 of per meter moet samen met die hoeveelheid reizen. cXML heeft daarvoor PriceBasisQuantity, OCI heeft NEW_ITEM-PRICEUNIT. Zonder die waarde toont de aanvraag een prijs die 100 keer te hoog is of een hoeveelheid die 100 keer te laag is.
  • Classificatie. Inkopers rapporteren uitgaven per categorie, dus de winkelwagen bevat een code, zoals een UNSPSC-code in cXML of de eigen materiaalgroep van de klant in OCI. Sommige technische inkopers gebruiken ECLASS. Vraag elke klant welk systeem en welke versie hij verwacht.

Verpakkingseenheden, minimale afnames en levertijden komen ook terug wanneer een inkoper jouw winkelwagen vergelijkt met de offerte van een andere leverancier. De gids over de offerteaanvraag somt de velden op die inkopers nodig hebben om aanbiedingen eerlijk te vergelijken.

Gehoste catalogusbestanden: CIF en BMEcat

Ondersteunt een klant geen punchout voor jouw account, of wil hij elk artikel in zijn eigen systeem kunnen vinden, dan stuur je een bestand. De cXML Getting Started-gids toont een CIF 3.0-voorbeeld: een kop met CIF_I_V3.0, CODEFORMAT: UNSPSC, de valuta en het aantal artikelen, daarna per artikel één regel met kommagescheiden velden: leveranciers-ID, artikelnummer, omschrijving, classificatiecode, prijs en eenheid (EA). De classificatiekolom is niet optioneel; de kop zegt welk codesysteem erin staat.

BMEcat is een XML-standaard voor de uitwisseling van catalogusdata in B2B, beheerd door de Duitse inkopersvereniging BME; op de BMEcat-pagina staat 2005.2 als actuele versie. Een BMEcat-artikel bevat de besteleenheid, inhoudseenheid, prijsgegevens en afbeeldingen, en het kenmerkenblok kan het product beschrijven volgens een classificatie als ETIM, met ETIM-codes voor elk kenmerk, elke waarde en elke eenheid. Een groothandel die met ETIM werkt, kan die kenmerken als gestructureerde attributen in zijn eigen systeem opnemen zonder elk kenmerk apart te mappen.

Een BMEcat-bestand met eigen ETIM-classificatie: de kenmerken komen als attributen binnen, alleen losse velden als SKU, naam en prijs moet je mappen.

Gehoste bestanden en punchout sluiten elkaar niet uit. Een level 2-index is zelf een kleine gehoste catalogus, en veel klanten die via punchout bestellen, willen voor hun categoriemanagers toch een volledig catalogusbestand. Verkoop je ook via B2B-marktplaatsen, dan reist dezelfde artikeldata daar ook naartoe; de gids over de B2B-marktplaats beschrijft wat die kanalen vragen.

Heeft jouw bedrijf punchout nodig?

Punchout is een verkoopkanaal naar inkoopafdelingen, dus de vraag is of je klanten erom vragen. Een korte toets:

  • Waarschijnlijk wel als grote klanten inkopen via SAP Ariba, Coupa of SAP en aangeven dat leveranciers zonder cataloguskoppeling hun voorkeursstatus verliezen, of als je assortiment groot of configureerbaar is of vaak van prijs verandert.
  • Een gehost bestand volstaat als een klant een stabiel assortiment van een paar honderd artikelen een paar keer per jaar bestelt, of alleen om een CIF-, BMEcat- of Excel-upload vraagt.
  • Nog geen van beide als klanten per mail of via je B2B-webshop bestellen en niemand erom vraagt. Maak eerst je artikeldata op orde; het protocol komt later.

De meeste webshopplatforms spreken standaard geen cXML of OCI. Leveranciers voegen punchout meestal toe via een app, extensie of punchout-integratiedienst die tussen de inkoopsystemen en de shop zit. Voor Shopify bieden meerdere apps in de Shopify App Store cXML- of OCI-punchout, en sommige werken vanuit de B2B-bedrijfscatalogi uit de gids over Shopify B2B. Welke route je ook kiest, die dienst leest producten, prijzen en eenheden uit je shop. Gaten in de shopdata worden zo gaten in de inkoopaanvraag van elke klant.

Eén klant aansluiten: inloggegevens, test en productie

Elke punchout-klant is een klein project op zich. De stappen van Coupa geven een gangbare volgorde: de klant bevestigt dat je punchout en cXML ondersteunt, plant een scopinggesprek, stuurt een leveranciersvragenlijst, verzamelt je cXML-inloggegevens en richt punchout pas in als jouw leveranciersrecord en contract in zijn systeem bestaan. Testen gebeurt eerst met testgegevens; productie gebruikt een aparte set die jij aanlevert.

Aan jouw kant betekent dat per klant drie dingen:

  • Identiteit en secret. Het domein en de identiteit die de klant in het setupverzoek meestuurt, plus het afgesproken shared secret, zodat je site weet welk account, assortiment en welke prijslijst hij moet tonen.
  • Assortiment en prijzen. Welke producten deze klant mag zien en tegen welke contractprijzen. Lijstprijzen in een contractsessie maken punchout zinloos.
  • Codelijsten. De eenheden van de klant, zijn classificatiesysteem en eventuele extra velden die terug moeten, zoals een kostenplaats of contractnummer.

Plan de eerste testorder als volledige rondgang: setup, winkelwagen, goedkeuring en de inkooporder die in jouw ordersysteem binnenkomt. De meeste problemen zie je pas bij die laatste stap, wanneer de orderregel moet kloppen met een artikel dat je kunt leveren.

Zeven datachecks voordat de eerste inkoper via punchout koppelt

Checks voor een punchout catalogus

0 van 7 klaar0%

Punchout en catalogusbestanden uit één productrecord

WISEPIM is geen punchout-platform: het heeft geen cXML- of OCI-endpoint en ontvangt geen winkelwagens of inkooporders. Wat het wel doet, is de artikeldata waaruit punchout en gehoste catalogi lezen compleet en consistent houden. Feed Hub exporteert BMEcat 2005-bestanden met ETIM-kenmerkblokken, besteleenheden en één prijs per artikel, voor producten waarvan de productfamilie aan een ETIM-klasse gekoppeld is, en de XML-import leest de BMEcat van een leverancier in met de ETIM-kenmerken er al aan. Met productclassificatie koppel je productfamilies aan ETIM-klassen en GS1 GPC-bricks; een UNSPSC- of ECLASS-code kan in een gewoon attribuut staan en meegaan naar elk kanaal dat dat attribuut mapt.

De punchout-dienst op je webshop leest dan korte namen, eenheden, prijzen en codes die één keer en op één plek gecontroleerd zijn, in plaats van dat je ze bij elke nieuwe klant opnieuw rechtzet.

Diego Nijboer

CTO and Co-Founder at WISEPIM, building AI-powered solutions that transform product data management for e-commerce businesses. Over 10 years of experience solving complex technical challenges in e-commerce and PIM systems.

Veelgestelde vragen

Nog vragen?

Kan je het antwoord niet vinden? Neem contact op met ons team.

Contact opnemen

Punchout betekent dat een inkoper zijn inkoopsysteem even verlaat om op de website van een leverancier te winkelen en daarna met de winkelwagen terugkomt. Die winkelwagen komt binnen als inkoopaanvraag, doorloopt de interne goedkeuring en wordt pas daarna een inkooporder naar de leverancier. De inkoper ziet zo de volledige, actuele catalogus zonder dat de leverancier elk artikel in het systeem van de klant hoeft te uploaden.

Een punchout catalogus is één soort e-procurement catalogus. De andere soort is een gehoste of statische catalogus: de leverancier levert een bestand aan, zoals CIF of BMEcat, en de producten staan in het inkoopsysteem van de klant. Bij punchout blijven de producten op de website van de leverancier en gaat alleen de selectie van de inkoper terug.

In de praktijk wel. De inkoper winkelt op een website die jij beheert, dus je hebt een B2B-shop of catalogussite nodig die de inkoper herkent, zijn contractprijzen toont en de winkelwagen in cXML- of OCI-formaat terugstuurt. Leveranciers zonder zo'n site beginnen vaak met gehoste catalogusbestanden en voegen punchout toe zodra genoeg klanten erom vragen.

De meeste grote inkoopsuites. SAP Ariba en Coupa gebruiken cXML-punchout, SAP-systemen zoals SAP SRM gebruiken het Open Catalog Interface (OCI). Elke klant richt de koppeling aan zijn kant in met inloggegevens die jij aanlevert, en veel klanten verwachten dat je ook inkooporders en facturen elektronisch verwerkt.

Dat is het cXML-document dat de website van de leverancier terugstuurt naar het inkoopsysteem wanneer de inkoper afrekent. Elke regel uit de winkelwagen staat erin als ItemIn, met artikelnummer, stukprijs, omschrijving, eenheid, classificatie en eventueel levertijd. De website post het als verborgen formulierveld naar de URL die het inkoopsysteem aan het begin van de sessie meegaf.

Verder ontdekken

Zorgvuldig gekozen vervolgstappen om dieper te gaan.

Betere productdata, betere resultaten.Verkoop meer producten.

4,7