Zum Hauptinhalt springen

Punchout-Katalog: So funktionieren cXML- und OCI-Sitzungen für Lieferanten

Was ein Punchout-Katalog ist, wie eine cXML- oder OCI-Sitzung den Warenkorb zurückgibt und welche Einheiten, Preise und Codes Lieferanten zuerst klären.

Punchout-Katalog: So funktionieren cXML- und OCI-Sitzungen für Lieferanten

Ein Punchout-Katalog ist der Online-Katalog eines Lieferanten, den ein Geschäftskunde direkt aus seinem eigenen Beschaffungssystem öffnet, etwa aus SAP Ariba, Coupa oder SAP SRM. Der Einkäufer klickt auf den Lieferanten, landet auf dessen Website mit seinem Vertragssortiment und seinen Preisen, füllt einen Warenkorb, und dieser Warenkorb geht als Bedarfsanforderung zurück ins Beschaffungssystem, nicht als Bestellung. Freigabe und Bestellung laufen danach nach den Regeln des Einkäufers.

Das Gegenstück ist ein gehosteter Katalog: Der Lieferant lädt eine Datei hoch (CIF, BMEcat oder die Tabellenvorlage des Kunden), und die Produkte liegen im System des Einkäufers. Bei Punchout bleiben die Produktdaten beim Lieferanten. Das passt zu großen oder konfigurierbaren Sortimenten und häufigen Preisänderungen. Beide Wege hängen von denselben Daten ab: Artikelnummern, Einheiten, Preise und Klassifikationscodes, die ein Beschaffungssystem lesen kann, ohne dass jemand sie abtippt.

Punchout oder gehosteter Katalog: Wo liegen die Produktdaten?

Die Wahl hängt vor allem davon ab, wer den Katalog pflegt und wie oft er sich ändert. Bei Punchout speichert das System des Einkäufers nur einen Link und Zugangsdaten; alles, was der Einkäufer sieht, kommt im Moment des Einkaufs von der Website des Lieferanten. Bei einem gehosteten Katalog speichert das System des Einkäufers eine Kopie, die nur so aktuell ist wie der letzte Upload.

Punchout und gehostete Katalogformate im Vergleich

cXML-PunchoutLive-SitzungWebsite des LieferantenVertragspreise im Moment des EinkaufsSAP Ariba, Coupa und andere cXML-Beschaffungssysteme
OCI-PunchoutLive-SitzungWebsite des LieferantenEbenso, zurückgegeben als NEW_ITEM-FelderEinkauf auf SAP-Basis (SRM)
CIF-DateiGehosteter KatalogBeschaffungssystem des EinkäufersFest bis zum nächsten UploadStatische Kataloge in cXML-basierten Systemen
BMEcat-DateiGehosteter Katalog oder DatenaustauschSystem des Einkäufers oder PIM eines GroßhändlersIn der Datei, pro ArtikelAustausch zwischen Hersteller und Großhandel, oft mit ETIM-Merkmalen
Tabellenvorlage des EinkäufersGehosteter KatalogSystem des EinkäufersFest bis zum nächsten UploadKleinere Einkäufer ohne Punchout
Punchout liefert einen Warenkorb zurück; gehostete Formate schicken das ganze Sortiment als Datei, die Preise sind also nur so aktuell wie der letzte Upload.

Viele Lieferanten nutzen beides. Ein Distributor für Elektroteile bietet seinen größten Kunden vielleicht Punchout an, schickt BMEcat-Dateien an Großhändler und füllt eine Tabellenvorlage für eine Kommune aus, die zweimal im Jahr bestellt. Jede Ausgabe liest aus demselben Produktdatensatz. Deshalb zählt das Datenmodell mehr als das Protokoll.

Eine Punchout-Sitzung, Nachricht für Nachricht

Der cXML Getting Started Guide beschreibt Procurement Punchout als interaktive Live-Kataloge auf einer Website: Die Beschaffungsanwendung zeigt statt Produktdetails einen Button, und der Browser des Nutzers öffnet die Seiten des Lieferanten. Die Website des Lieferanten braucht dafür drei Dinge: eine URL, die die Setup-Anfrage annimmt, eine Möglichkeit, den Einkäufer zu erkennen, und einen Checkout-Button, der den Warenkorb zurückschickt, statt eine Zahlung auszulösen.

Eine cXML-Punchout-Sitzung vom Klick bis zur Bestellung

Diagramm wird geladen
Der Lieferant erhält während der Sitzung selbst nie eine Bestellung; die Bestellung kommt erst nach der Freigabe durch den Einkäufer.
  1. Setup-Anfrage. Das Beschaffungssystem sendet einen PunchOutSetupRequest mit den Zugangsdaten des Einkäufers und einem gemeinsamen Geheimnis (Shared Secret), dazu einen BuyerCookie und eine BrowserFormPost-URL, an die der Warenkorb zurückgehen soll.
  2. Setup-Antwort. Der Lieferant prüft die Zugangsdaten und antwortet mit einer StartPage-URL, meist einem sitzungsbezogenen Login-Link zu seinem Katalog.
  3. Einkauf. Der Einkäufer stöbert im Vertragssortiment, konfiguriert Produkte und füllt einen Warenkorb auf der Website des Lieferanten.
  4. Rückgabe des Warenkorbs. Beim Checkout sendet die Website eine PunchOutOrderMessage als verstecktes Formularfeld an die BrowserFormPost-URL. Jede Position ist ein ItemIn mit Artikelnummer, Preis, Beschreibung, Mengeneinheit und Klassifikation.
  5. Freigabe. Der Warenkorb wird zur Bedarfsanforderung und durchläuft den Freigabe-Workflow des Einkäufers. Bestellt ist noch nichts.
  6. Bestellung. Nach der Freigabe sendet das Beschaffungssystem einen OrderRequest an den Lieferanten. Das ist die eigentliche Bestellung, die er ausliefern muss.

Der cXML Reference Guide definiert im Attribut operation drei Sitzungstypen: create, edit und inspect. Mit edit kann ein Einkäufer einen früher zurückgegebenen Warenkorb wieder öffnen, inspect zeigt ihn schreibgeschützt an. Der Lieferant kann in SupplierPartAuxiliaryID eine eigene Referenz ablegen, etwa eine Angebotsnummer, und das Beschaffungssystem gibt sie in späteren Sitzungen und in der Bestellung wieder mit.

cXML oder OCI: zwei Protokolle für denselben Ablauf

cXML (Commerce XML) ist das Protokoll hinter dem Punchout von SAP Ariba und Coupa. Setup-Anfrage und zurückgegebener Warenkorb sind XML-Dokumente, und dieselbe Dokumentfamilie deckt Bestellungen, Auftragsbestätigungen, Lieferavise und Rechnungen ab. Deshalb bitten Einkäufer mit cXML-Systemen einen Punchout-Lieferanten oft, auch cXML-Bestellungen anzunehmen.

OCI (das Open Catalog Interface von SAP) ist einfacher. Das System des Einkäufers öffnet die URL des Lieferanten mit Login-Parametern und einer HOOK_URL, der Rücksprungadresse für den Warenkorb. Der Warenkorb kommt als HTML-Formular mit nummerierten Feldern zurück. Die technischen Informationen von Unite zu OCI nennen die Felder, die automatisch übertragen werden: 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 und NEW_ITEM-LEADTIME in Tagen. Dort steht auch, dass OCI-Felder in der Regel nach 255 Zeichen abgeschnitten werden.

Das empfangende SAP-System kann strenger sein. Im OCI-Feldmapping von 2BA für SAP SRM fasst NEW_ITEM-DESCRIPTION 40 Zeichen, NEW_ITEM-UNIT 3 und NEW_ITEM-MATGROUP, die Warengruppe des Einkäufers, 10. Ein Webshop-Titel mit 90 Zeichen kommt in der Bedarfsanforderung nur mit seinen ersten 40 an. Ein Lieferant braucht also einen Kurznamen, der für genau dieses Feld geschrieben ist.

Punchout Level 1 und Level 2

Bei einem Level-1-Punchout zeigt der Katalog des Einkäufers einen einzigen Eintrag für den Lieferanten. Der Einkäufer klickt darauf, landet auf der Startseite des Lieferanten und sucht dort wie in jedem Webshop. SAPs Schulung zu Punchout-Katalogen weist darauf hin, dass auch Level 1 eine kleine statische Indexdatei braucht, meist eine einzige kommagetrennte Zeile, die ins SAP Business Network hochgeladen wird. Dieses Level ist am einfachsten einzurichten, aber der Einkäufer muss vorher wissen, welcher Lieferant den Artikel führt.

Bei einem Level-2-Punchout lädt der Lieferant einen CIF-ähnlichen Index mit einer Zeile pro SKU hoch. Die Katalogsuche des Einkäufers zeigt diese Artikel dann wie einen gehosteten Katalog, und ein Klick springt per Punchout direkt zu diesem Artikel oder dieser Kategorie auf der Website des Lieferanten. Enthält der Index Preise, weist SAP darauf hin, dass der aktuelle Preis auf der Website des Lieferanten abweichen kann; maßgeblich bleibt also die Live-Sitzung. Der Index ist eine weitere Datei, die mit der Live-Website synchron bleiben muss. Frag deshalb jeden Einkäufer, welches Level sein Setup erwartet.

Welche Produktdaten ein Punchout-Warenkorb zurückbringt

Das Einkaufsteam des Kunden sieht die Produktseite des Lieferanten nach dem Checkout nie wieder. Was in der Bedarfsanforderung, der Freigabe-Mail und der Bestellung landet, sind eine Handvoll Felder, und jedes muss für sich verständlich sein. Das Beispiel unten verfolgt ein fiktives Produkt, einen schwarzen Kabelbinder im Beutel zu 100 Stück, durch beide Protokolle.

Ein Kabelbinder im Punchout-Warenkorb

Artikelnummer des LieferantenART-88401SupplierPartIDNEW_ITEM-VENDORMAT oder EXT_PRODUCT_ID
KurznameKabelbinder 4,8 x 300 mm schwarzDescription / ShortNameNEW_ITEM-DESCRIPTION
LangbeschreibungUV-beständiger Kabelbinder aus Polyamid 6.6 zum Bündeln im AußenbereichBeschreibungstextNEW_ITEM-LONGTEXT
MengeneinheitStück (EA oder PCE, aus der Liste des Einkäufers)UnitOfMeasureNEW_ITEM-UNIT
Preis und Preiseinheit12,40 EUR pro 100 StückUnitPrice + PriceBasisQuantityNEW_ITEM-PRICE + NEW_ITEM-PRICEUNIT
KlassifikationUNSPSC- oder ECLASS-CodeClassification domainNEW_ITEM-MATGROUP (Warengruppe des Einkäufers)
Hersteller und HerstellerartikelnummerMarkenname, HerstellerartikelnummerManufacturerName, ManufacturerPartIDEigenes NEW_ITEM-Feld
Lieferzeit3 TageLeadTime (Tage)NEW_ITEM-LEADTIME (Tage)
8 von 8 Zeilen
Fiktives Beispiel: Der Preis gilt pro Beutel mit 100 Stück. Der Warenkorb muss diese Preiseinheit mitliefern, sonst liest das System des Einkäufers 12,40 EUR pro Stück.

Drei Felder verursachen die meisten fehlgeschlagenen oder verwirrenden Warenkörbe:

  • Mengeneinheiten. Die Schritte zur cXML-Lieferantenanbindung von Coupa raten Einkäufern, die Mengeneinheiten des Lieferanten vorab anzufordern, weil ein Warenkorb mit einer Einheit, die es in Coupa nicht gibt, nicht übernommen wird. Ordne jede Verkaufseinheit auf deiner Website (Stück, Beutel, Karton, Meter, Rolle) vor dem Go-live den Codes zu, die der jeweilige Einkäufer verwendet.
  • Preiseinheit. Ein Preis pro 100 Stück oder pro Meter muss zusammen mit seiner Menge übertragen werden. cXML hat dafür PriceBasisQuantity, OCI hat NEW_ITEM-PRICEUNIT. Fehlt sie, zeigt die Bedarfsanforderung einen 100-mal zu hohen Preis oder eine 100-mal zu kleine Menge.
  • Klassifikation. Einkäufer werten ihre Ausgaben nach Kategorien aus. Deshalb trägt der Warenkorb einen Code, in cXML etwa einen UNSPSC-Commodity-Code, in OCI die eigene Warengruppe des Einkäufers. Manche Industriekunden nutzen stattdessen ECLASS. Frag jeden Einkäufer, welches System und welche Version er erwartet.

Verpackungsgrößen, Mindestbestellmengen und Lieferzeiten tauchen später ebenfalls auf, wenn ein Einkäufer deinen Warenkorb mit dem Angebot eines anderen Lieferanten vergleicht. Der Leitfaden zur Angebotsanfrage listet die Felder, die Einkäufer brauchen, um Angebote fair zu vergleichen.

Gehostete Katalogdateien: CIF und BMEcat

Wenn ein Einkäufer für deinen Account kein Punchout unterstützt oder jeden Artikel in seinem eigenen System durchsuchbar haben will, schickst du stattdessen eine Datei. Der cXML Getting Started Guide zeigt ein Beispiel für CIF 3.0: einen Header mit CIF_I_V3.0, CODEFORMAT: UNSPSC, der Währung und der Anzahl der Artikel, danach eine kommagetrennte Zeile pro Artikel mit Lieferanten-ID, Artikelnummer, Beschreibung, Klassifikationscode, Preis und Einheit (EA). Die Klassifikationsspalte ist nicht optional; der Header legt fest, welches Codesystem sie verwendet.

BMEcat ist ein XML-Standard für den Austausch von Katalogdaten im B2B, gepflegt vom Bundesverband Materialwirtschaft, Einkauf und Logistik (BME); seine BMEcat-Seite nennt 2005.2 als aktuelle Version. Ein BMEcat-Artikel enthält Bestelleinheit, Inhaltseinheit, Preisangaben und Bilder, und sein Merkmalsblock kann das Produkt nach einer Klassifikation wie ETIM beschreiben, mit ETIM-Codes für jedes Merkmal, jeden Wert und jede Einheit. Ein Großhändler, der mit ETIM arbeitet, kann diese Merkmale als strukturierte Attribute in sein eigenes System übernehmen, ohne jedes einzeln zuzuordnen.

Eine BMEcat-Datei mit eigener ETIM-Klassifikation: Die Merkmale kommen als Attribute an, und nur einfache Felder wie SKU, Name und Preis müssen zugeordnet werden.

Gehostete Dateien und Punchout schließen sich nicht aus. Ein Level-2-Punchout-Index ist selbst ein kleiner gehosteter Katalog, und viele Einkäufer, die zum Bestellen per Punchout einkaufen, wollen für ihre Category Manager trotzdem eine vollständige Katalogdatei. Wenn du auch über B2B-Marktplätze verkaufst, wandern dieselben Artikeldaten auch dorthin; der Leitfaden zum B2B-Marktplatz beschreibt, was diese Kanäle verlangen.

Braucht dein Unternehmen Punchout?

Punchout ist ein Vertriebskanal zu Einkaufsabteilungen. Die Frage ist also, ob deine Kunden danach fragen. Ein kurzer Test:

  • Du brauchst es wahrscheinlich, wenn große Kunden über SAP Ariba, Coupa oder SAP einkaufen und dir sagen, dass Lieferanten ohne Kataloganbindung ihren Status als bevorzugter Lieferant verlieren, oder wenn dein Sortiment groß oder konfigurierbar ist oder sich die Preise oft ändern.
  • Eine gehostete Datei reicht, wenn ein Kunde ein stabiles Sortiment von einigen hundert Artikeln ein paarmal im Jahr bestellt oder nur einen Upload als CIF, BMEcat oder Tabelle verlangt.
  • Noch keins von beiden, wenn Kunden per E-Mail oder über deinen B2B-Webshop bestellen und niemand danach gefragt hat. Bring zuerst deine Artikeldaten in Ordnung; das Protokoll kann folgen.

Die meisten Webshop-Plattformen sprechen von Haus aus weder cXML noch OCI. Lieferanten ergänzen Punchout meist über eine App, eine Erweiterung oder einen Punchout-Integrationsdienst, der zwischen den Beschaffungssystemen und dem Shop sitzt. Für Shopify gibt es im Shopify App Store mehrere Apps, die cXML- oder OCI-Punchout ergänzen, und einige davon arbeiten mit den B2B-Firmenkatalogen, die im Leitfaden zu Shopify B2B beschrieben sind. Egal welchen Weg du wählst: Der Dienst liest Produkte, Preise und Einheiten aus deinem Shop, und Lücken in den Shopdaten werden zu Lücken in der Bedarfsanforderung jedes Einkäufers.

Einen Einkäufer anbinden: Zugangsdaten, Test und Produktion

Jeder Punchout-Kunde ist ein kleines Projekt für sich. Die Anbindungsschritte von Coupa nennen eine typische Reihenfolge: Der Einkäufer bestätigt, dass du Punchout und cXML unterstützt, führt ein Scoping-Gespräch, schickt einen Lieferantenfragebogen, sammelt deine cXML-Zugangsdaten und richtet Punchout erst ein, wenn dein Lieferantendatensatz und dein Vertrag in seinem System angelegt sind. Getestet wird zuerst mit Testzugangsdaten; für die Produktion nutzt du einen separaten Satz, den du bereitstellst.

Auf deiner Seite heißt das drei Dinge pro Einkäufer:

  • Identität und Shared Secret. Die Domain und Identität, die der Einkäufer in der Setup-Anfrage sendet, und das vereinbarte Shared Secret, damit deine Website weiß, welchen Account, welches Sortiment und welche Preisliste sie zeigen soll.
  • Sortiment und Preise. Welche Produkte dieser Einkäufer sehen darf und zu welchen Vertragspreisen. Listenpreise in einer Vertragssitzung machen den Sinn von Punchout zunichte.
  • Codelisten. Die Mengeneinheiten des Einkäufers, sein Klassifikationssystem und alle zusätzlichen Felder, die er zurückbekommen will, etwa eine Kostenstelle oder eine Vertragsnummer.

Plane die erste Testbestellung als kompletten Durchlauf: Setup, Warenkorb, Freigabe und die Bestellung, die in deinem Auftragssystem ankommt. Die meisten Probleme zeigen sich erst im letzten Schritt, wenn die Bestellposition zu einem Artikel passen muss, den du liefern kannst.

Sieben Datenchecks für den Punchout-Katalog, bevor der erste Einkäufer sich verbindet

Checks für einen startklaren Punchout-Katalog

0 von 7 erledigt0%

Punchout und Katalogdateien aus einem Produktdatensatz

WISEPIM ist keine Punchout-Plattform: Es hat keinen cXML- oder OCI-Endpunkt und empfängt weder Warenkörbe noch Bestellungen. Was es tut: Es hält die Artikeldaten, aus denen Punchout und gehostete Kataloge lesen, vollständig und konsistent. Feed Hub exportiert BMEcat-2005-Dateien mit ETIM-Merkmalsblöcken, Bestelleinheiten und einem Preis pro Artikel, für Produkte, deren Produktfamilie mit einer ETIM-Klasse verknüpft ist, und sein XML-Import liest die BMEcat-Datei eines Lieferanten mit bereits zugeordneten ETIM-Merkmalen ein. Die Produktklassifikation ordnet Produktfamilien ETIM-Klassen und GS1-GPC-Bricks zu; ein UNSPSC- oder ECLASS-Code kann in einem normalen Attribut liegen und an jeden Kanal gehen, der ihn zuordnet.

Der Punchout-Dienst deines Webshops liest dann Kurznamen, Einheiten, Preise und Codes, die einmal an einer Stelle geprüft wurden, statt bei jeder Anbindung pro Einkäufer korrigiert zu werden.

Diego Nijboer

CTO und Mitgründer von WISEPIM. Ich baue AI-gestützte Lösungen, die das Produktdatenmanagement für E-Commerce-Unternehmen verändern. Über 10 Jahre Erfahrung im Lösen komplexer technischer Herausforderungen im E-Commerce und bei PIM-Systemen.

Häufig gestellte Fragen

Noch Fragen?

Keine passende Antwort gefunden? Melde dich bei unserem Team.

Support kontaktieren

Punchout bedeutet, dass ein Einkäufer sein Beschaffungssystem verlässt (daraus „aussteigt“), um auf der Website eines Lieferanten einzukaufen, und dann mit dem Warenkorb zurückkehrt. Der Warenkorb kommt im Beschaffungssystem als Bedarfsanforderung an, durchläuft die interne Freigabe und wird erst dann zur Bestellung, die an den Lieferanten geht. Der Einkäufer bekommt den vollständigen, aktuellen Katalog des Lieferanten, ohne dass der Lieferant jeden Artikel ins System des Einkäufers hochladen muss.

Ein Punchout-Katalog ist eine Art von E-Procurement-Katalog. Die andere Art ist ein gehosteter oder statischer Katalog, bei dem der Lieferant eine Datei wie CIF oder BMEcat hochlädt und die Produkte im Beschaffungssystem des Einkäufers gespeichert werden. Bei Punchout bleiben die Produkte auf der Website des Lieferanten, und nur die Auswahl des Einkäufers wird zurückgeschickt.

In der Praxis ja. Der Einkäufer kauft auf einer Website ein, die der Lieferant kontrolliert. Du brauchst also einen B2B-Shop oder eine Katalog-Website, die den Einkäufer erkennt, seine Vertragspreise zeigt und den Warenkorb im cXML- oder OCI-Format zurückgibt. Lieferanten ohne eine solche Website starten oft mit gehosteten Katalogdateien und ergänzen Punchout, sobald genug Kunden danach fragen.

Die meisten großen Beschaffungssuiten. SAP Ariba und Coupa nutzen cXML-Punchout, SAP-Systeme wie SAP SRM das Open Catalog Interface (OCI). Jeder Einkäufer richtet die Verbindung auf seiner Seite mit Zugangsdaten ein, die du bereitstellst, und viele erwarten, dass du auch Bestellungen elektronisch annimmst und Rechnungen elektronisch versendest.

Das ist das cXML-Dokument, das die Website eines Lieferanten an das Beschaffungssystem zurückschickt, wenn der Einkäufer zur Kasse geht. Es führt jede Warenkorbposition als ItemIn mit Lieferanten-Artikelnummer, Stückpreis, Beschreibung, Mengeneinheit, Klassifikation und optionaler Lieferzeit. Die Website sendet es als verstecktes Formularfeld an die URL, die das Beschaffungssystem zu Beginn der Sitzung übergeben hat.

Weiter entdecken

Handverlesene nächste Schritte, um tiefer einzusteigen.

Bessere Produktdaten, bessere Ergebnisse.Mehr Umsatz erzielen.

4,7