Configuration
Add-on settings (Settings > Cdiscount Marketplace Connector)
Section titled “Add-on settings (Settings > Cdiscount 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 Cdiscount account for the marketplace. Off: each vendor connects their own Cdiscount account. |
| Debug log | Also stores every call to Octopia (secrets and tokens 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 newly imported Cdiscount order. |
| Payment method of imported orders | Payment method id used for imported orders (empty = the first active one). |
| Permanently delete Cdiscount order and offer links on uninstall | Off (default): uninstall keeps the links, connection and rules, so a reinstall never imports an order or reports a shipment 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”Seller ID (sent in the SellerId header of every call), mode (Test = Seller Sandbox SELLZZ, Production = Cdiscount CDISFR), client ID
and client secret per mode. The secret is stored encrypted (AES-256-GCM with your store key) and never shown again; leave the field empty
to keep it. The add-on gets a token with the OAuth 2.0 client credentials flow and keeps it for its lifetime (2 hours), so it stays far
below the token quota of 500 per hour. When Octopia refuses the credentials the account is paused (no further calls) until you save
the form again or a connection test passes.
Rules page
Section titled “Rules page”| Group | Options |
|---|---|
| Prices and taxes | Euro rate (only when your store currency is not the euro; 0 = Administration > Currencies), VAT rate (sent with every offer and added to net prices; a product’s own percentage tax wins), markup %, fixed markup (primary currency, converted), price endings (none, whole, .99, .90), strike-through price %, eco-participation and DEEE product features (amounts in euros). |
| Stock | Buffer (units kept back), minimum (at or below: Cdiscount sees 0), maximum. |
| Offers | Send offers automatically, EAN feature (or the product code when it is an EAN), condition (New, used or refurbished grades), preparation time (days), delivery modes (NTHD, THD, EHD, SHD, FDHD, SRHD, WSHD, IVP, SVP, PPMR, PPLP) with the shipping price per order and per additional unit in euros. |
| Cdiscount catalogue | Create missing products, default brand, brand feature. |
| Orders | Acceptance (automatic when every product is mapped, active and in stock, or manual), customer (guest or matched by e-mail), carrier code sent with tracking numbers and a mapping from CS-Cart carriers to Octopia carrier codes (codes listed from Octopia), tracking link, cancellation reason (reasons listed from Octopia), status mapping. |
Prices: a CS-Cart price with a net tax gets the VAT first, then it is converted into euros, then the markup and endings run on the euro price. Offer data changes (delivery modes, preparation time) send every live offer again; price rule changes push every price again. The condition and the EAN source cannot change while offers are live (they identify the offer at Cdiscount). The VAT rate is taken from the product’s tax rate for a destination that contains France; without one, the Rules default applies.
Categories and Attributes
Section titled “Categories and Attributes”Needed only to create products in the Cdiscount catalogue. Map a CS-Cart category to a Cdiscount category of level 3 (the deepest mapped category of a product wins; the mapping can carry its own markup and brand). On Attributes, map each property of the Cdiscount category to a product feature or a fixed value; values are matched with the Cdiscount choices by name (accents and case ignored; French variant names are used when the store has them). Mandatory properties without a value stop the product with a readable reason.
Run the queue every 5 minutes, either:
php /path/to/admin.php --dispatch=kv_cdiscount.cronor by calling the secret web address shown in the settings. Overlapping runs are prevented.