cXML – Create System & General Settings
Create a cXML system in the Shopware Admin under Connector → cXML Systems → Create new system.
Tab: General
Basic Information
| Field | Description |
|---|---|
| Name | Display name of the system (e.g. "Ariba Production") — only visible internally |
| Technical name | Unique internal identifier |
| Active | Inactive systems block login |
| Punchout Level 2 | Enables Level 2 functionality for bidirectional communication |
License
| Field | Description |
|---|---|
| License key | Key from agiqon-connector.de → My Account → Licenses |
Transfer Settings
| Field | Default | Description |
|---|---|---|
| Default unit | – | Fallback packing unit for all products without a specific unit |
| Decimal places | 2 | Number of decimal places for prices in the cXML response |
| Append shipping | off | Include shipping costs as a separate line item in the PunchOutOrderMessage |
| Append tax | off | Include the tax rate in the cXML response |
| Net total price | off | Transfer the total price as a net amount |
| Payment method | – | Shopware payment method used for both automatically and manually created orders. Optional: if none is set, the payment method selected by the buyer during the punchout session is used |
| Shipping method | – | Shopware shipping method used for both automatically and manually created orders. Optional: if none is set, the shipping method selected by the buyer during the punchout session is used |
Login Options
| Option | Default | Description |
|---|---|---|
| Separate cart session | on | The punchout session gets its own empty cart; the customer's existing shop cart stays untouched. Customer-specific prices and discounts still apply. Leave it on if unsure. (called "Guest session" up to 3.7.400 / 3.6.200) |
| Close button behavior | Stay in shop | Defines where the user is directed when clicking Close. Stay in shop: returns to the shop home page. Redirect to hook: returns to the calling procurement system — only if a hook URL is known for the session, otherwise it automatically falls back to "Stay in shop". |
Transmission Mode
| Mode | Description |
|---|---|
| Manual | A Shopware order can be created manually from the transmission payload in the admin |
| Automatic | A Shopware order is created automatically immediately on transfer |
info
The payment and shipping method (see above) apply to both transmission modes — manual and automatic. See Automatic Order Creation for details.
Login URL
https://shop.example.com/AgiqonCxmlEntry/login/{system-id}
The {system-id} can be found in the admin overview in the ID column of the system.