cXML – Overview

cXML (Commerce XML) is an XML-based protocol for electronic procurement. The AgiqonConnector supports cXML Punchout Level 1 and Level 2, compatible with SAP Ariba, Coupa, and other systems.

How cXML Punchout Works

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

1. The procurement system sends a PunchOutSetupRequest as an XML document via POST to the login URL.
2. The shop responds with a PunchOutSetupResponse containing a session URL.
3. The user opens the session URL and shops.
4. At checkout, the plugin sends the cart back as a PunchOutOrderMessage.

Login URL

https://yourshop.com/AgiqonCxmlEntry/login/{system-id}

The {system-id} is the ID of the cXML system (visible in the system list in the Admin).

Punchout Level 1 vs. Level 2

	Level 1	Level 2
Cart	Transferred in full	Individual items can be edited
Return	Single POST	Bidirectional communication
Setup	Default	Enable Punchout Level 2 in the system

Authentication

cXML uses three optional validation points from the XML header:

Element	Description
From	Identity of the sending system (buyer)
To	Identity of the receiving system (shop)
Sender	Technical sender + Shared Secret (password)

Each can be enabled or disabled independently.