cXML – Übersicht

cXML (Commerce XML) ist ein XML-basiertes Protokoll für elektronische Beschaffungsprozesse. Der AgiqonConnector unterstützt cXML Punchout Level 1 und Level 2, kompatibel mit SAP Ariba, Coupa und weiteren Systemen.

Wie funktioniert cXML Punchout?

Procurement-System  →  PunchOutSetupRequest (XML)  →  Shopware Shop
       ↑                                                      ↓
       └──── PunchOutOrderMessage (XML) ───────────────────────┘

1. Das Procurement-System sendet einen PunchOutSetupRequest als XML-Dokument per POST an die Login-URL.
2. Der Shop antwortet mit einem PunchOutSetupResponse und einer Session-URL.
3. Der Nutzer öffnet die Session-URL und kauft im Shop ein.
4. Beim Abschluss überträgt das Plugin den Warenkorb als PunchOutOrderMessage zurück.

Login-URL

https://deinshop.de/AgiqonCxmlEntry/login/{system-id}

Die {system-id} ist die ID des cXML-Systems (zu finden in der Systemliste im Admin).

Punchout Level 1 vs. Level 2

	Level 1	Level 2
Warenkorb	Wird komplett übertragen	Einzelne Positionen können bearbeitet werden
Rückgabe	Einmaliger POST	Bidirektionale Kommunikation
Konfiguration	Standard	Punchout Level 2 im System aktivieren

Authentifizierung

cXML verwendet drei optionale Prüfpunkte aus dem XML-Header:

Element	Beschreibung
From	Identität des sendenden Systems (Käufer)
To	Identität des empfangenden Systems (Shop)
Sender	Technischer Absender + Shared Secret (Passwort)

Jeder dieser Punkte kann einzeln aktiviert oder deaktiviert werden.