cXML-PunchOut erklärt: Ablauf, Zugangsdaten, Warenkorb | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Zum Inhalt springen](#main-content)

  Fachwissen · cXML cXML-PunchOut erklärt. So liefern Sie Ihren cXML-Katalog in unter einer Stunde.
=================================================================================

 Ihr Kunde kauft über SAP Ariba, Coupa oder Jaggaer ein und verlangt einen cXML-Katalog, über den der Warenkorb aus Ihrem Sortiment als XML-Nachricht in sein System zurückkommt. Diese Seite erklärt Ablauf, Zugangsdaten und Warenkorb-Nachricht – und wie Sie den cXML-PunchOut ohne IT-Projekt liefern: mit eigenem Online-Shop oder ohne.

 [ Kostenlos testen ](https://www.punchcommerce.de/register) [ Ablauf ansehen ](#flow)

30 Tage kostenlos · keine Kreditkarte · jederzeit kündbar

  unterstützte Version cXML 1.2

 Setup ohne IT-Projekt &lt; 1 h

 kostenlos testen 30 Tage

 Was ist cXML

 Commerce eXtensible Markup Language: Geschäftsdokumente als XML
-----------------------------------------------------------------

Kurz gesagt

 cXML ist der PunchOut-Standard von SAP Ariba: Das Beschaffungssystem meldet sich mit Kennungen und SharedSecret direkt bei Ihrem Server an, der Einkäufer kauft im Browser ein, und der Warenkorb geht als XML-Dokument zurück. Die Bestellung folgt nach der Freigabe, auf Wunsch ebenfalls als cXML-Dokument.

 Ein cXML-PunchOut ist ein Verfahren, bei dem ein Einkäufer aus seinem Beschaffungssystem in den [PunchOut-Katalog](https://www.punchcommerce.de/de/punchout-catalog) eines Lieferanten wechselt und den Warenkorb anschließend als XML-Dokument im cXML-Format zurückgibt. cXML steht für Commerce eXtensible Markup Language. Ariba hat den Standard Ende der 1990er-Jahre veröffentlicht, um Kataloge, Bestellungen und weitere Geschäftsdokumente zwischen Einkauf und Lieferanten auszutauschen. Heute gehört Ariba zu SAP. cXML ist das gängige PunchOut-Protokoll von SAP Ariba und wird auch von [PunchOut für Coupa](https://www.punchcommerce.de/de/punchout-coupa), [PunchOut für Jaggaer](https://www.punchcommerce.de/de/punchout-jaggaer) und vielen weiteren Einkaufsplattformen unterstützt. Was ein PunchOut unabhängig vom Protokoll ist, erklären die [Grundlagen zum PunchOut](https://www.punchcommerce.de/de/punchout).

 Ein cXML-PunchOut nutzt zwei Wege. Zuerst sprechen die Systeme direkt miteinander: Das Beschaffungssystem schickt Ihrem Server eine Anfrage mit seinen Zugangsdaten und erhält eine Adresse zurück, unter der die Einkaufssitzung beginnt. Erst danach öffnet sich Ihr Katalog im Browser des Einkäufers; enthält die Anfrage ein SelectedItem, direkt die Artikelseite, was Beschaffungssysteme als [PunchOut Level 2](https://www.punchcommerce.de/de/punchout-level-1-vs-level-2) bezeichnen. Am Ende geht der Warenkorb wieder über den Browser zurück, als vollständiges cXML-Dokument in einem Formularfeld.

 Weil Absender und Empfänger sich bei jeder Anfrage ausweisen, ist cXML strenger als einfachere Verfahren. Jede Seite hat eine eigene Kennung, und ein gemeinsames Kennwort, das SharedSecret, bestätigt die Verbindung. Das macht die Einrichtung etwas aufwendiger, sorgt aber dafür, dass nur das Beschaffungssystem Ihres Kunden eine Sitzung in Ihrem Katalog öffnen kann.

 Viele Konzerne setzen auf cXML, weil derselbe Standard später auch die freigegebene Bestellung als eigenes Dokument, den OrderRequest, an Sie übertragen kann. Für den PunchOut selbst reicht der Austausch, den diese Seite beschreibt. Zur Abgrenzung: Beim [OCI-PunchOut](https://www.punchcommerce.de/de/oci-punchout) laufen Anmeldung und Warenkorb als einfache Formularfelder durch den Browser, ohne direkte Verbindung zwischen den Servern. Alle Unterschiede im Überblick: [OCI vs. cXML](https://www.punchcommerce.de/de/oci-vs-cxml).

### PunchOutSetupRequest und -Response

Die Anfrage des Beschaffungssystems mit Zugangsdaten, Sitzungskennung und Rücksprungadresse. Ihr Server antwortet mit einem Status und der `StartPage`, auf der der Einkäufer landet. Enthält die Anfrage ein `SelectedItem`, springt er direkt auf den Artikel.

### PunchOutOrderMessage

Der Warenkorb als cXML-Dokument: je Position Artikelnummer, Menge, Preis, Beschreibung, Einheit und Warengruppe, dazu der Gesamtbetrag.

### Beschaffungssysteme mit cXML

Eine Auswahl der Systeme, aus denen Ihre Kunden einen cXML-PunchOut starten; verlinkte Systeme haben eine eigene Seite zur Anbindung:

- [PunchOut für SAP Ariba](https://www.punchcommerce.de/de/punchout-sap-ariba)
- [PunchOut für SAP S/4HANA](https://www.punchcommerce.de/de/punchout-sap-s4hana)
- [PunchOut für Onventis](https://www.punchcommerce.de/de/punchout-onventis)
- [PunchOut für Coupa](https://www.punchcommerce.de/de/punchout-coupa)
- [PunchOut für Jaggaer](https://www.punchcommerce.de/de/punchout-jaggaer)
- Oracle Procurement
- Basware
- Synertrade
- Proactis
- GEP SMART
- Workday Procurement
- Medius
- Ivalua

Welches Protokoll weitere Systeme sprechen: [Beschaffungssysteme im Überblick](https://www.punchcommerce.de/de/procurement-systems).

 Ablauf

So läuft ein cXML-PunchOut ab
-----------------------------

Für den Einkäufer ist es ein Klick auf Ihren Katalog. Zwischen den Systemen laufen dabei zwei Nachrichten direkt und eine über den Browser:

1. 1 Beschaffungssystem### PunchOutSetupRequest

    Das Beschaffungssystem schickt Ihrem Server ein cXML-Dokument mit `From`, `To` und `Sender` samt `SharedSecret`, einem `BuyerCookie` für die Sitzung und der `BrowserFormPost`-Adresse für den Rücksprung.
2. 2 Ihr Katalog### Authentifizierung

    Die `To`-Kennung bestimmt Sie als Lieferanten, `From` und `SharedSecret` Ihren Kunden. Passt etwas nicht, antwortet Ihr Server mit einem cXML-Fehlerstatus statt mit einer Sitzung.
3. 3 Ihr Katalog### PunchOutSetupResponse

    Bei Erfolg antwortet Ihr Server mit Status 200 und einer `StartPage`-URL. Das Beschaffungssystem öffnet diese Adresse im Browser des Einkäufers.
4. 4 Einkäufer### Katalog oder Shop

    Der Einkäufer sieht Ihr Sortiment mit seinen Preisen, sucht, vergleicht und legt Artikel in den Warenkorb wie in einem gewöhnlichen Online-Shop.
5. 5 Ihr Katalog### PunchOutOrderMessage

    Beim Übertragen erzeugt Ihr Katalog den Warenkorb als cXML-Dokument und sendet ihn per HTML-Formular über den Browser an die `BrowserFormPost`-Adresse.
6. 6 Beschaffungssystem### Bestellanforderung

    Das Beschaffungssystem ordnet die Nachricht über das `BuyerCookie` der Sitzung zu und legt eine Bestellanforderung an. Nach der Freigabe erhalten Sie die Bestellung.

 Elemente und Zugangsdaten

 Was in Anfrage und Warenkorb steht
------------------------------------

 Ein cXML-PunchOut besteht aus zwei Dokumenten, die Sie kennen sollten: dem `PunchOutSetupRequest`, mit dem die Sitzung beginnt, und der `PunchOutOrderMessage`, die den Warenkorb zurückbringt. Darin steht je Position ein `ItemIn`-Element. Die Spalte „Laut Standard“ zeigt, ob die cXML-DTD, das Schema von cXML, ein Element verlangt oder offenlässt.

 Die Spalte „Befüllt PunchCommerce“ zeigt in der Anfrage, welche Elemente PunchCommerce auswertet, und im Warenkorb, welche es in der Grundeinstellung befüllt. PunchCommerce verlangt immer ein `SharedSecret` im Sender-Credential und schickt den Warenkorb an die Adresse aus `BrowserFormPost`. Verarbeitet werden die Operationen `create` für einen neuen und `edit` für einen bestehenden Warenkorb. In der Grundeinstellung befüllt PunchCommerce alle Pflicht-Elemente sowie `LeadTime` und den Herstellernamen, wenn vorhanden. Die Zuordnung passen Sie je Kunde an.

  cXML-Elemente aus PunchOutSetupRequest und PunchOutOrderMessage mit Einordnung laut cXML-DTD, Befüllung durch PunchCommerce, Beispielwert und Bedeutung   Element Laut Standard Befüllt PunchCommerce Beispiel Bedeutung     `PunchOutSetupRequest`: Anfrage und Zugangsdaten    From  Pflicht befüllt PunchCommerce  Kennung Ihres Kunden, zum Beispiel seine Ariba Network ID.   Pflicht   ja, in der Grundeinstellung   Kennung Ihres Kunden, zum Beispiel seine Ariba Network ID.    To  Pflicht befüllt PunchCommerce  Ihre Kennung als Lieferant, so wie Ihr Kunde sie in seinem System hinterlegt hat.   Pflicht   ja, in der Grundeinstellung   Ihre Kennung als Lieferant, so wie Ihr Kunde sie in seinem System hinterlegt hat.    Sender  Pflicht befüllt PunchCommerce  Absender der Anfrage mit Kennung und Programmname. Läuft die Anfrage über ein Netzwerk wie das Ariba Network, steht hier das Netzwerk.   Pflicht   ja, in der Grundeinstellung   Absender der Anfrage mit Kennung und Programmname. Läuft die Anfrage über ein Netzwerk wie das Ariba Network, steht hier das Netzwerk.    Credential domain + Identity  Pflicht befüllt PunchCommerce  Beispiel: NetworkID Jede Kennung besteht aus einer Domäne wie NetworkID oder DUNS und dem eigentlichen Wert.   Pflicht   ja, in der Grundeinstellung  NetworkID Jede Kennung besteht aus einer Domäne wie NetworkID oder DUNS und dem eigentlichen Wert.    SharedSecret  optional befüllt PunchCommerce  Gemeinsames Kennwort im Sender-Credential. Die DTD lässt alternativ andere Verfahren zu, PunchCommerce verlangt es immer.   optional   ja, in der Grundeinstellung   Gemeinsames Kennwort im Sender-Credential. Die DTD lässt alternativ andere Verfahren zu, PunchCommerce verlangt es immer.    BuyerCookie  Pflicht befüllt PunchCommerce  Sitzungskennung des Beschaffungssystems. Sie muss unverändert im Warenkorb zurückkommen.   Pflicht   ja, in der Grundeinstellung   Sitzungskennung des Beschaffungssystems. Sie muss unverändert im Warenkorb zurückkommen.    BrowserFormPost  optional befüllt PunchCommerce  Adresse, an die der Browser den Warenkorb am Ende sendet.   optional   ja, in der Grundeinstellung   Adresse, an die der Browser den Warenkorb am Ende sendet.    operation  Pflicht befüllt PunchCommerce  Beispiel: create Art der Sitzung: `create` für einen neuen, `edit` für einen bestehenden Warenkorb.   Pflicht   ja, in der Grundeinstellung  create Art der Sitzung: `create` für einen neuen, `edit` für einen bestehenden Warenkorb.     `PunchOutOrderMessage`: Warenkorb    ItemIn quantity  Pflicht befüllt PunchCommerce  Beispiel: 2 Menge der Position.   Pflicht   ja, in der Grundeinstellung  2 Menge der Position.    SupplierPartID  Pflicht befüllt PunchCommerce  Beispiel: 4711-09 Ihre Artikelnummer. Über sie ordnen Sie die spätere Bestellung zu.   Pflicht   ja, in der Grundeinstellung  4711-09 Ihre Artikelnummer. Über sie ordnen Sie die spätere Bestellung zu.    SupplierPartAuxiliaryID  optional  Zusatzschlüssel, wenn die Artikelnummer allein nicht eindeutig ist.   optional   –nein, nur per Zuordnung   Zusatzschlüssel, wenn die Artikelnummer allein nicht eindeutig ist.    UnitPrice / Money currency  Pflicht befüllt PunchCommerce  Beispiel: 12.90 EUR Preis je Einheit mit Währung als ISO-Code.   Pflicht   ja, in der Grundeinstellung  12.90 EUR Preis je Einheit mit Währung als ISO-Code.    Description xml:lang  Pflicht befüllt PunchCommerce  Beispiel: de-DE Artikelbeschreibung mit Sprachkennung, zum Beispiel de-DE.   Pflicht   ja, in der Grundeinstellung  de-DE Artikelbeschreibung mit Sprachkennung, zum Beispiel de-DE.    UnitOfMeasure  Pflicht befüllt PunchCommerce  Beispiel: EA Mengeneinheit nach UN/CEFACT-Empfehlung 20, zum Beispiel EA für Stück.   Pflicht   ja, in der Grundeinstellung  EA Mengeneinheit nach UN/CEFACT-Empfehlung 20, zum Beispiel EA für Stück.    Classification domain  Pflicht befüllt PunchCommerce  Beispiel: UNSPSC 46181504 Warengruppe nach einem Klassifikationsstandard, meist UNSPSC.   Pflicht   ja, in der Grundeinstellung  UNSPSC 46181504 Warengruppe nach einem Klassifikationsstandard, meist UNSPSC.    ManufacturerPartID  optional  Artikelnummer des Herstellers.   optional   –nein, nur per Zuordnung   Artikelnummer des Herstellers.    LeadTime  optional befüllt PunchCommerce  Beispiel: 3 Lieferzeit in Tagen.   optional   ja, in der Grundeinstellung  3 Lieferzeit in Tagen.    Total  Pflicht befüllt PunchCommerce  Gesamtbetrag des Warenkorbs im Kopf der Nachricht.   Pflicht   ja, in der Grundeinstellung   Gesamtbetrag des Warenkorbs im Kopf der Nachricht.

### So sieht eine Warenkorbposition aus

 Ein gekürzter Auszug aus einer `PunchOutOrderMessage`. PunchCommerce sendet das vollständige Dokument Base64-kodiert im Formularfeld `cxml-base64`; die Spezifikation sieht alternativ das Feld `cxml-urlencoded` vor.

 ```

[1]     4711-09

[2]     12.90
        Schutzhandschuh Nitril, Gr. 9
[3]     EA
[4]     46181504
[5]     3

```

1. Ihre Artikelnummer, über die Sie die spätere Bestellung zuordnen.
2. Preis je Einheit, netto, mit Währung als ISO-Code.
3. Mengeneinheit als UN/CEFACT-Code, EA steht für Stück.
4. Warengruppe nach UNSPSC.
5. Lieferzeit in Tagen.

 Umsetzung

So liefern Sie cXML mit PunchCommerce
-------------------------------------

Sie müssen weder das Protokoll selbst umsetzen noch eine Agentur beauftragen. PunchCommerce nimmt den PunchOutSetupRequest entgegen, prüft Kennungen und SharedSecret, beantwortet die Anfrage, zeigt Ihr Sortiment und baut am Ende die PunchOutOrderMessage. Sie entscheiden nur, woher die Artikel kommen. Die Einrichtung dauert in der Regel unter einer Stunde, gehostet wird DSGVO-konform in Deutschland.

 Mit eigenem Online-Shop### Plugin installieren, Kunden anlegen, fertig

Fertige Plugins gibt es für neun Shopsysteme, darunter [PunchOut für Spryker](https://www.punchcommerce.de/de/spryker), [PunchOut für Shopware](https://www.punchcommerce.de/de/punchout-shopware), [PunchOut für Magento](https://www.punchcommerce.de/de/punchout-magento), [PunchOut für Vendure](https://www.punchcommerce.de/de/punchout-vendure), [PunchOut für JTL-Shop](https://www.punchcommerce.de/de/punchout-jtl) und [PunchOut für Medusa](https://www.punchcommerce.de/de/punchout-medusa). Ihr Kunde springt direkt in Ihren bestehenden Shop und sieht dort seine Preise und das Sortiment, das Sie für ihn freigeben. PunchCommerce übernimmt den Rücksprung und übersetzt den Warenkorb in die cXML-Nachricht, die Ihr Kunde erwartet.

PunchCommerce Business: 49 € je Kunde und Monat, zzgl. MwSt.

 [Plugins für Ihr Shopsystem ansehen](https://www.punchcommerce.de/de/integrations)

 Ohne eigenen Online-Shop### Artikel im Hosted Catalog bereitstellen

Sie haben keinen Shop oder wollen ihn nicht anbinden? Dann laden Sie Ihre Artikel als Liste in den Hosted Catalog von PunchCommerce. Ihr Kunde springt in diesen Katalog, wählt aus und überträgt den Warenkorb wie bei einem Shop. Kundenspezifische Sortimente und Preise legen Sie je Kunde fest.

Business plus Add-On Hosted Catalog für 50 € je Kunde und Monat, jeweils zzgl. MwSt.

 [Hosted Catalog ansehen](https://www.punchcommerce.de/de/hosted-catalog)

### Zugangsdaten für Ihren Kunden

- PunchOut-URL, die Sie von PunchCommerce erhalten
- Domain und Identity, die Sie je Kunde festlegen
- SharedSecret, das Sie je Kunde vergeben
- Buyer-Identity, die Ihnen Ihr Kunde nennt
- Ansprechpartner in der IT Ihres Kunden, der die Angaben im Beschaffungssystem hinterlegt
- Warengruppen-Systematik, die Ihr Kunde erwartet

 Sie binden viele Konzernkunden an und brauchen SLA und dedizierte Infrastruktur? Dann vergleicht die [Make-or-Buy-Analyse](https://www.punchcommerce.de/de/punchout-make-or-buy) Eigenentwicklung und PunchCommerce Enterprise über fünf Jahre.

 Welche Daten dabei fließen und wie Sie den Sicherheitsfragebogen Ihres Kunden beantworten, erklärt die Seite [PunchOut-Sicherheit und Datenschutz](https://www.punchcommerce.de/de/punchout-security).

 FAQ

Häufige Fragen zum cXML-PunchOut
--------------------------------

Was Lieferanten vor dem ersten cXML-Katalog wissen wollen: SAP Ariba, Fehlersuche, Test, Zusatzfelder und Kosten.

 ###   Mein Kunde kauft über SAP Ariba. Was ist dort anders? +

 Am Protokoll nichts: SAP Ariba spricht cXML. Ariba-spezifisch sind drei Dinge: Als Kennung dient Ihre Ariba Network ID (ANID), Test- und Produktivkonten sind in Ariba getrennt, und jede veröffentlichte Katalogversion muss Ihr Kunde freigeben, bevor seine Einkäufer sie sehen. Lieferantenkonto, Testkonto und Fehlersuche im Detail: [PunchOut für SAP Ariba](https://www.punchcommerce.de/de/punchout-sap-ariba).

###   Die Anfrage wird abgelehnt. Woran liegt das meistens? +

 Fast immer passen die Zugangsdaten nicht zusammen: eine anders geschriebene Kennung, ein beim Kopieren verändertes SharedSecret oder eine andere Buyer-Identity als vereinbart. In diesen Fällen antwortet PunchCommerce mit cXML-Status 401 und einer Klartext-Meldung im Protokoll des Beschaffungssystems. Prüfen Sie dann To-Kennung, From-Kennung und SharedSecret Zeichen für Zeichen gegen die Werte in PunchCommerce.

###   Mein Kunde nutzt zwei Beschaffungssysteme. Brauche ich einen zweiten Katalog? +

 Nein. Sortiment, Preise und Shop bleiben dieselben. Jede Anbindung bekommt in PunchCommerce eigene Zugangsdaten und bei Bedarf eine eigene Feldzuordnung, weil zwei Systeme selten dieselben Angaben erwarten. Das gilt auch, wenn eines der Systeme OCI und das andere cXML spricht. Für den Einkäufer sieht der Katalog in beiden Fällen gleich aus.

###   Wie teste ich den cXML-PunchOut, bevor mein Kunde ihn nutzt? +

 PunchCommerce enthält einen Simulator, der mit den Zugangsdaten des jeweiligen Kunden einen PunchOutSetupRequest erzeugt und die Rolle des Beschaffungssystems übernimmt. Sie durchlaufen die Sitzung wie ein Einkäufer, übertragen den Warenkorb und sehen anschließend die vollständige PunchOutOrderMessage. So prüfen Sie Artikelnummern, Einheiten und Warengruppen, bevor die IT Ihres Kunden den ersten echten Test startet.

###   Kann ich zusätzliche Angaben wie Kostenstelle oder Vertragsnummer übertragen? +

 Ja. cXML sieht dafür Extrinsic-Elemente vor, frei benannte Zusatzfelder je Position. In PunchCommerce stehen Ihnen fünf solcher Felder zur Verfügung, die Sie je Kunde mit festen Werten oder Daten aus Ihrem Artikelstamm belegen. Welche Namen und Inhalte erwartet werden, gibt Ihr Kunde vor, häufig in einer kurzen Anbindungsspezifikation seines Einkaufs.

###   Was kostet ein cXML-PunchOut mit PunchCommerce? +

 Für den cXML-PunchOut gilt derselbe Preis wie für jedes andere Protokoll: 49 € je angebundenem Kunden und Monat im Tarif Business, zzgl. MwSt. Ob Ihr Kunde über SAP Ariba, Coupa oder Jaggaer anbindet, ändert daran nichts, und einen Aufpreis für cXML gibt es nicht. Ohne eigenen Shop kommt das Add-On Hosted Catalog mit 50 € je Kunde und Monat hinzu, zzgl. MwSt. Die ersten 30 Tage testen Sie kostenlos und ohne Kreditkarte.

  Jetzt starten

 Ihr Kunde wartet auf den cXML-Katalog. Liefern Sie ihn heute.
---------------------------------------------------------------

 49 € je Kunde und Monat, zzgl. MwSt.; ohne eigenen Shop zzgl. Add-On Hosted Catalog, 50 € je Kunde und Monat. Plugin installieren oder Artikel im Hosted Catalog anlegen, Zugangsdaten an Ihren Kunden schicken, fertig.

 [ Kostenlos testen ](https://www.punchcommerce.de/register)30 Tage kostenlos · keine Kreditkarte · jederzeit kündbar

 ![Patrick Dornbusch, Gründer von PunchCommerce](https://www.punchcommerce.de/static/patrick-dornbusch.webp)Patrick Dornbusch

Gründer von PunchCommerce

Lieber erst sprechen? Wir klären in 30 Minuten, welcher Weg zu Ihrem Shop, Ihrem ERP und den Einkaufssystemen Ihrer Kunden passt.

 [ Beratungstermin vereinbaren  (öffnet in neuem Fenster) ](https://account.netzdirektion.de/appointments/punchcommerce)30 Min · remote · mit dem Gründer

 PunchCommerce® ist ein Produkt der [ ![netzdirektion | Gesellschaft für digitale Wertarbeit mbH](https://www.punchcommerce.de/static/netzdirektion-logo.png) (öffnet in neuem Fenster) ](https://netzdirektion.de) ![DEKRA-Siegel: Qualitätsmanagement nach ISO 9001](https://www.punchcommerce.de/static/dekra-netzdirektion-iso-9001.png) **ISO 9001:2015**
zertifiziertes Qualitätsmanagement

 netzdirektion | Gesellschaft für digitale Wertarbeit mbH · © 2020 - 2026
