Configuration
Add-on settings (Settings > CDON Marketplace Connector)
Section titled “Add-on settings (Settings > CDON Marketplace Connector)”| Setting | What it does |
|---|---|
| Enable | Off: no new work is started; work already under way is finished. |
| Marketplace owner mode (Multi-Vendor) | On: one CDON account for the marketplace. Off: each vendor connects their own CDON account. |
| Debug log | Also stores every call to CDON (masked). Switch off when done. |
| Log retention (days) | Older log lines are removed. |
| Sync interval (minutes) | How often orders, stock and prices are synchronised (default 15). |
| Status of imported orders | CS-Cart status of a new CDON order. |
| Payment method of imported orders | Payment method id used for imported orders (empty = the first active one). |
| Permanently delete CDON order and article links on uninstall | Off (default): uninstall keeps the links, connection and rules, so a reinstall never imports an order or creates an article twice. On: the next uninstall deletes them. |
| Cron | The command line and the secret web address that run the job queue. |
Connection page
Section titled “Connection page”| Field | Notes |
|---|---|
| Mode | Sandbox (merchants-api.sandbox.cdon.com) or Production (merchants-api.cdon.com). |
| Merchant ID, API token | From CDON, one set per mode. Sent as HTTP Basic authentication over TLS; the token is stored encrypted and never shown again. |
If CDON refuses the credentials (HTTP 401) the account is paused: nothing is sent to CDON until you save new credentials or a connection test passes. This avoids repeated failed logins.
Rules page
Section titled “Rules page”| Section | Options |
|---|---|
| CDON markets | Markets of your merchant agreement (SE, DK, FI, NO); own exchange rate per currency (0 = CS-Cart currency table); VAT per market (added only to products whose CS-Cart taxes are net; defaults 25 / 25 / 25.5 / 25 %); delivery time (min-max days) per market. A ticked market without a rate is skipped and named on the page. |
| Prices | Markup %, fixed amount (in your primary currency, converted per market), price endings (none, whole, .99, .90) applied in each market currency. Category mappings and single products can override the markup. CDON prices include VAT. |
| Stock | Buffer (units kept back), minimum (at or below it CDON sees 0), maximum. |
| New listings | Create products automatically, default brand, brand feature, GTIN feature, condition (new / refurbished), shipped from (EU / outside the EU), delivery type (mailbox, service point, home delivery). |
| Manufacturer (GPSR) | Manufacturer name, address, e-mail, website and the EU responsible person (required when the manufacturer is outside the EU). |
| Orders | Guest orders or match customers by e-mail (CDON sends no e-mail, so guest is usual), accept orders at CDON, wait for a tracking number before fulfilling, CS-Cart status for each CDON state. |
Categories and Attributes
Section titled “Categories and Attributes”- Categories: search the CDON category tree (by name) and map it to a CS-Cart category, optionally with a markup and a brand. “Refresh reference data” reloads the tree.
- Attributes: CDON properties are the same for every category: free text (colour, size, material …; up to 36 characters), pre-defined lists (size S/M/L, colour, connection type …) and numbers (weight, volume, sizes). Map a CS-Cart feature or a fixed value.
Run the queue every 5 minutes, either:
php /path/to/admin.php --dispatch=kv_cdon.cronor by calling the secret web address shown in the settings. Overlapping runs are prevented.