cXML – Configuration
cXML systems are managed under Extensions → cXML Systems.
Tab: General
General Information
| Field | Description |
|---|---|
| Name | Display name of the system |
| Technical Name | Unique internal identifier |
| Active | Inactive systems block login |
| Punchout Level 2 | Enables Level 2 functionality |
| Default Unit | Fallback packaging unit |
| Price Digits | Decimal places for prices (default: 2) |
| Attach Shipping | Include shipping as a line item in the response |
| Attach Tax | Include tax rate in the cXML response |
| Total Price Net | Transfer total price as net amount |
License
| Field | Description |
|---|---|
| License Key | Key from agiqon-connector.de → My Account → Licenses |
Login – Authentication
Authentication uses elements from the cXML header. Each element can be enabled and configured separately.
FROM
Validates the identity of the buying system.
| Field | Description |
|---|---|
| Verify FROM | Enables FROM validation |
| FROM Domain | Expected domain value (e.g. DUNS number, NetworkId) |
| FROM Field | Shopware field to compare against (email, customer number, or custom field) |
TO
Validates that the cXML is addressed to the correct recipient.
| Field | Description |
|---|---|
| Verify TO | Enables TO validation |
| TO Domain | Expected domain value |
| TO Field | Shopware field for comparison |
SENDER / Shared Secret
Validates the technical sender and password.
| Field | Description |
|---|---|
| Verify SENDER | Enables SENDER validation |
| SENDER Domain | Expected domain value |
| Verify Shared Secret | Enables password validation |
| Shared Secret | Password from Shopware customer profile or custom field |
Default Configuration
By default, only FROM verification is active. TO and SENDER are optional.
Tab: Fields
Configuration of XML fields transmitted per item in the PunchOutOrderMessage. Works the same as OCI product fields: data field, fallbacks, fixed value.
Tab: Customers
Assigns Shopware customers to the cXML system. Only assigned customers can log in.
Tab: Units
System-specific packaging units (same as OCI).
Unit Priority
- Unit on the product (custom field)
- Unit from the system units table
- System default unit