OCI – Customers & Units
Tab: Customers
Only Shopware customers that are explicitly assigned to an OCI system can log in via that system. All others are rejected at login.
Assigning Customers
In the Customers tab, add the permitted customers:
| Field | Description |
|---|---|
| Customer | Linked Shopware customer (search by name or email) |
A customer can be assigned to multiple systems — e.g. one OCI and one cXML system. Each customer needs a separate license for each system.
Which System Handles the Login?
OCI has no system-specific entry URL — every procurement system calls the same route. The connector therefore first narrows the request down via the variable names to all active systems that match. Which of those systems actually handles the request is decided by the customer assignment.
If a customer is assigned to an active system whose variable names the procurement system does not send, the login is rejected. The log entry names the candidate systems and the customer's system.
Check the customer assignment before updating productive integrations.
When several active systems use the same variable names for user name, password and hook URL, the administration warns when a system is saved. A login can then only be assigned via the customer.
Tab: Units of Measure
In the Units of Measure tab, system-specific packing units are defined. A Shopware unit (from Settings → Units) is mapped to the value that should be sent in the OCI transfer for that unit.
Interaction with the Field Mapping
The mappings from this tab are read by the productSystemUnit data field. Whether and when that value applies is decided solely by the system's field mapping — there is no built-in precedence between the custom field on the product (productOciMe), the system unit table (productSystemUnit) and the default unit (systemDefaultUnit). Which source acts as the primary field and which as a fallback is configured under Configure fields.
A comparison of the three unit data fields together with a recommended default configuration is available under Units of Measure.
Many procurement systems expect standardized unit codes according to UN/CEFACT (e.g. PCE for piece, KGM for kilogram, LTR for litre). Enter these codes in the system unit table.