Installation and setup

Requirements

• CS-Cart and Multi-Vendor 4.17.2 or later (4.21.x supported).
• Administrator access to the store’s admin panel.
• A Kaufland seller account with API access. In the Kaufland Seller Portal (API settings) create a key pair: a Client Key (32 characters) and a Secret Key. The same pair works for the live API and for the Playground.
• For test mode: the Kaufland Seller API Playground must be activated for your account by Kaufland (Kaufland states this can take up to two weeks). The Playground is an isolated environment with test data; it offers units, orders, shipments, returns and subscriptions, but no product data, categories, attributes or carriers.
• In the Seller Portal: at least one shipping group (its ID is optional on the Connection page; without it Kaufland uses your default shipping group) and your storefront(s) activated.
• Products with a valid EAN as the barcode and images that are reachable from the internet (Kaufland downloads them).
• A public https address for your store if you want push notifications.
• A cron job on your server (see step 6).

Install the add-on

1. Download the kv_kaufland-<version>.zip package from your Kavio Labs or CS-Cart Marketplace account.
2. In the admin panel, open Add-ons > Manage add-ons.
3. Click the gear button and choose Manual installation, then upload the archive.
4. Find Kaufland Marketplace Connector in the list and make sure its status is Active.
5. Enter your license key under Settings > License (Kavio Labs downloads) and click Check now.

Connect Kaufland

1. Open Orders > Kaufland channel and the Connection tab.
2. Enter the Client Key and Secret Key for the mode you want (the same pair may be used in both), choose your storefront (Kaufland.de, .cz, .sk, .pl, .at and the others the Seller API lists), and optionally the shipping group ID, warehouse ID, a notification e-mail and the product safety contact. Save and click Test connection: a green message names the storefront and the number of shipping groups found.
3. Start in Test mode (Playground): unit, order, shipment and return calls go to the isolated test environment; categories, attributes and carriers are read from the live API (read only) because the Playground does not have them; product data is never sent in test mode.
4. Switch to Live mode after a successful test and test again. Products and prices now go to your real Kaufland shop.
5. Set up categories, attributes and rules (see Usage).
6. Add the cron job from the settings page (Cron section), every minute is fine. Overlapping runs are prevented.
7. Optional push notifications (Live mode): save a notification e-mail address, then press Register webhook at Kaufland. Kaufland calls your store once to verify the address and then sends a signed notification when an order unit or a return unit changes status. Your store must be reachable from the internet over https.

Multi-Vendor

By default the marketplace owner connects one Kaufland account for all vendors (Marketplace owner mode on). Switch it off to let each vendor connect their own Kaufland keys in the vendor panel (Connection tab); each vendor then maps, lists and ships on their own.

Update

1. Upload the new package the same way. Your settings, credentials and data are kept.
2. The add-on adds missing tables and settings by itself on the first request after the update.

See CHANGELOG for what changed in each version.

Uninstall

Open Add-ons > Manage add-ons, click the add-on’s gear button and choose Uninstall. This removes the add-on’s settings, language variables and database tables, including the stored credentials and mappings. Units already on Kaufland stay there; remove them in the Seller Portal if you do not want them offered.