Kaufland Connector Setup
The setup wizard guides you through the initial setup in five steps: keys, connection test, storefront, warehouse and shipping group, orders and inventory. At the end, it switches Kaufland on in merchantCENTRAL and starts the scheduled tasks. All settings can be changed later on the KAUFLAND row of the marketplace card. What is still to do up to the first order is described in Getting Started.
Opening the Page
- Assisted Setup → group “AD merchantCENTRAL Setup” → Kaufland Connector Setup
- On the marketplace card via the action Setup Wizard
The entry in Assisted Setup is created by the installation; a company created later gets it as soon as someone opens the list. An update leaves a completed entry completed.
The wizard first checks whether merchantCENTRAL itself is set up, and otherwise takes you there.
Prerequisites
- A Kaufland seller account with API access
- Client Key and Secret Key from the Kaufland Seller Portal (Settings → API Keys)
- A warehouse and one shipping group per storefront in the Seller Portal (Settings); without a shipping group, Kaufland does not accept offers
Steps
| Step | Content |
|---|---|
| 1. Welcome | What the connector does – orders, stock and prices, returns and tickets, product data, figures per storefront – and the prerequisites. |
| 2. Authentication | Enter the Client Key; enter the Secret Key by clicking the field (it is stored encrypted and never displayed). Use Playground for tests without any effect on the live shop; the Base URL follows this switch. Next requires both keys. |
| 3. Connection Test | Test Connection sends Kaufland a request that Kaufland verifies using the keys. The Status field shows whether Kaufland accepted the keys, or Kaufland's response if it did not. The test is optional: Next works without it as well. |
| 4. Marketplace Configuration | Default Storefront (the country you start with), Default Warehouse ID and Default Shipping Group ID from the lookup lists that Kaufland provides for your account, as well as Create Sales Orders and Auto Sync Inventory (both on by default). |
| 5. Switch On | Switch On Kaufland and Start Background Tasks (both on by default), plus what runs from now on – every 15 minutes orders, shipment confirmations and stock, every 30 minutes returns and tickets, every hour the offers and the upload of the posted sales invoices, the prices only once you decide – and what is still left to do. |
What “Finish” Does
- Saves the settings and enables the default storefront: it becomes the first sales channel on the marketplace card.
- With Start Background Tasks: creates the missing scheduled tasks and starts day-to-day operations – every 15 minutes orders (with sales orders), shipment confirmations and, with Auto Sync Inventory, the stock; every 30 minutes returns and tickets; every hour the offers at Kaufland (REFRESH-OFFERS) and the upload of the posted invoices (UPLOAD-INVOICES). If these tasks already exist from an earlier setup and are switched off, the wizard switches them on; their interval and time window stay. The wizard does not start the prices: you decide yourself when the sales price lists replace the prices on Kaufland, with the task “Send prices to Kaufland” (SYNC-PRICES-BC) or Sync Prices.
- Marks the assisted setup as completed.
- With Switch On Kaufland: switches Kaufland on in merchantCENTRAL, like Enabled on the marketplace card. Without a license, merchantCENTRAL first opens the registration for the free demo. If you cancel it, or merchantCENTRAL refuses to switch Kaufland on, Kaufland stays switched off; the settings and tasks of steps 1–3 stay saved, and the tasks wait until Kaufland is switched on and licensed.
A message summarizes whether Kaufland is switched on – if not, with merchantCENTRAL's answer –, whether the background tasks are running, and which storefront was enabled. Afterwards, the Kaufland Setup opens on the Marketplace Card, with the default storefront selected in the list Sales Channels.
Afterwards
- On the marketplace card, assign each sales channel a sales price list in its currency (CZ in CZK, PL in PLN, otherwise EUR).
- Add further storefronts to the list Sales Channels with Add Storefronts and switch them on there with Enabled; their shipping group is in the part Kaufland Storefront.
- On the marketplace card, in the Data Protection section, choose the customer for the orders: a collective customer or one customer per buyer.
- Link the offers from Kaufland to your items on the Kaufland Offers page. The REFRESH-OFFERS task reads them within the next hour; Import Offers reads them at once.
Help with the wizard's messages: Troubleshooting.