cXML – Übersicht
cXML (Commerce XML) ist ein XML-basiertes Protokoll für elektronische Beschaffungsprozesse. Es ist der Standard für SAP Ariba, Coupa, Jaggaer und viele weitere Procurement-Plattformen weltweit.
Der AgiqonConnector unterstützt cXML Punchout Level 1 und Level 2.
Wie funktioniert cXML Punchout?
Ein cXML-Punchout-Vorgang läuft in vier Phasen ab:
Phase 1 — PunchOutSetupRequest
Das Procurement-System sendet ein XML-Dokument per HTTP-POST an die Login-URL des Shops. Dieses Dokument enthält Absender-Identität, Authentifizierungsdaten und die Rückgabe-URL (BrowserFormPost-URL).
<cXML>
<Header>
<From><Credential domain="DUNS"><Identity>123456789</Identity></Credential></From>
<Sender>
<Credential domain="DUNS">
<Identity>123456789</Identity>
<SharedSecret>geheim</SharedSecret>
</Credential>
</Sender>
</Header>
<Request>
<PunchOutSetupRequest operation="create">
<BuyerCookie>SESSION_COOKIE</BuyerCookie>
<BrowserFormPost>
<URL>https://procurement.firma.de/return</URL>
</BrowserFormPost>
</PunchOutSetupRequest>
</Request>
</cXML>
Phase 2 — PunchOutSetupResponse
Der Connector validiert die Anfrage und antwortet mit einer Session-URL, über die der Käufer den Shop aufruft:
<cXML>
<Response>
<Status code="200" text="OK"/>
<PunchOutSetupResponse>
<StartPage>
<URL>https://shop.example.com/session/start?token=abc123</URL>
</StartPage>
</PunchOutSetupResponse>
</Response>
</cXML>
Phase 3 — Einkaufen
Der Käufer öffnet die Session-URL und shoppt wie gewohnt. Statt des Checkouts sieht er einen „Übertragen"-Button.
Phase 4 — PunchOutOrderMessage
Beim Transfer sendet der Connector eine PunchOutOrderMessage als XML per POST an die Rückgabe-URL. Das Procurement-System erhält alle Artikeldaten und verarbeitet sie intern weiter.
Punchout Level 1 vs. Level 2
| Level 1 | Level 2 | |
|---|---|---|
| Warenkorb | Wird einmalig komplett übertragen | Einzelne Positionen können bearbeitet werden |
| Kommunikation | Einmaliger POST nach Transfer | Bidirektionaler Austausch möglich |
| Typische Systeme | Standard-Ariba, Coupa | Ariba Level 2, erweiterte Systeme |
| Konfiguration | Standard | „Punchout Level 2" im Tab Allgemein aktivieren |
Login-URL
https://shop.example.com/AgiqonCxmlEntry/login/{system-id}
Die {system-id} ist die ID des cXML-Systems aus der Admin-Übersicht (AgiqonConnector → cXML-Systeme, Spalte „ID").