Skip to content

Getting Started: From Installation to the First Order

This page walks you, in the right order, through everything between installing the Kaufland connector and the first Kaufland order that has been shipped and invoiced. Each step links to the page that describes it in detail.

Start in the Playground

Kaufland's Playground is a test environment that accepts the same keys as your live account but touches no order, offer or price in the live shop. Turn on Use Playground in the setup while you try things out. In the Playground you create test orders yourself with Create Playground Order on the Kaufland Orders page.


1. Install

  • Install the Kaufland connector (app AD merchantCENTRAL Connector Kaufland) in the environment. It requires merchantCENTRAL version 2.210 or later.
  • merchantCENTRAL itself must be set up. The Kaufland setup wizard checks this first and otherwise takes you to the merchantCENTRAL setup.
  • Assign a permission set of the connector to the users: ALN MCK Admin (merchantCENTRAL Kaufland Admin) for the setup, ALN MCK User (merchantCENTRAL Kaufland User) for daily work. Only users who may change the Kaufland Settings can enter or delete the keys.

2. Run the assisted setup

Open Assisted Setup → group "AD merchantCENTRAL Setup" → Kaufland Connector Setup. Have the Client Key and the Secret Key from the Kaufland Seller Portal (Settings → API Keys) at hand.

The wizard asks for the keys, tests the connection, lets you choose the Default Storefront, the warehouse and the shipping group from your Kaufland account, and at the end switches Kaufland on and starts the background tasks. Afterwards, the Kaufland Setup opens on the Marketplace Card – the only setup page of Kaufland, where you find everything the wizard has set.

3. Enable and license Kaufland on the marketplace card

Kaufland is a merchantCENTRAL marketplace: page Marketplaces → row KAUFLAND.

  • Enabled switches Kaufland on – the wizard does this with Switch On Kaufland.
  • Without a license, merchantCENTRAL opens the registration of the free demo (Start Free Trial). Without a valid license or demo, all Kaufland tasks wait: their last run shows Waiting, and they start working on their own as soon as the license is active. An action run by hand reports "Kaufland is not licensed …" instead.
  • In the Data Protection section you choose the customer of the orders: with Post to a Collective Customer one collective customer for all Kaufland orders; otherwise the import creates a customer per buyer.
  • If Business Central finds no item for an EAN and merchantCENTRAL does not know the offer ID as a SKU, the hub setting Hold Order on Unknown Item decides: turned on, merchantCENTRAL holds the order (status On Hold) until the SKU is assigned; turned off, no sales order is created, and the order reports the EAN with the status Error in Error Message until the item is found.

4. Storefronts, warehouse and shipping groups

  • Storefronts: On the Marketplace Card, Add Storefronts adds the missing countries to the list Sales Channels, switched off. Switch on every storefront you sell on with Enabled there. Each storefront is a sales channel; orders, returns and tickets are imported only from enabled storefronts, see Storefront and Sales Channel.
  • Warehouse: Your account needs at least one warehouse in the Kaufland Seller Portal (Add warehouse). It is chosen in the Kaufland setup as Default Warehouse ID; the Kaufland Warehouses page shows all of them. In the Playground, Create Demo Warehouse (Playground) creates one. A Kaufland warehouse is not the same as a location in Business Central: you assign the location that supplies the stock to the Kaufland warehouse there.
  • Shipping groups: A shipping group belongs to exactly one storefront. Without a shipping group, Kaufland accepts no offers. The one of the default storefront is in the Kaufland Settings (Default Shipping Group ID), those of the other storefronts in the part Kaufland Storefront below the list of sales channels.

5. List items and create offers

Kaufland keeps exactly one product page per EAN; your offers are attached to it, per storefront and condition. An item therefore needs a GTIN (EAN) on the item card.

  1. List items for Kaufland: on the item card or item list, choose Add to Marketplace and select the Kaufland sales channels (storefronts). Alternatively, the EAN Lookup searches an EAN in the Kaufland catalog and lists the item with Add Item to Kaufland. An item with variants is listed per variant, under the bar code of the variant (Item Variants on Kaufland). Listed items appear in Kaufland Products.
  2. Does Kaufland know the EAN? The EAN Lookup (Lookup EAN in Kaufland Products) tells you. If there is no product page yet, upload the product data first (Upload Product Data) and wait until Kaufland has accepted it.
  3. Create offers:
    • several at once: select the products in Kaufland Products and choose Create Offers – one offer of new goods per product, with the price from the price list of the sales channel and quantity and handling time from merchantCENTRAL;
    • one at a time: Create Offer on the Kaufland Product card or in Kaufland Offers.
  4. Offers that already exist: If you already have offers in the Kaufland Seller Portal, Import Offers on the Kaufland Offers page reads them; the import finds item and variant by the EAN (GTIN or barcode item reference). The scheduled task REFRESH-OFFERS does this every hour. Only then do these offers get stock and price from Business Central.

6. Sales price lists per storefront

Prices at Kaufland come from a sales price list per sales channel – not from the unit price of the item card.

  • On the marketplace card, in the Sales Channels section, assign a Price List Code to each channel. The list must be in the currency of the storefront: CZ in CZK, PL in PLN, all others in EUR. merchantCENTRAL does not convert; a price in the wrong currency is not sent.
  • Prices are sent by the scheduled task SYNC-PRICES-BC ("Send prices to Kaufland"). It is created switched off: turn it on once the price lists are right – from then on their prices replace the prices at Kaufland. Once by hand: Sync Prices in Kaufland Offers.

7. Check the scheduled tasks

The Kaufland Scheduled Tasks page shows what runs in the background. After the wizard, these are on: orders (IMPORT-ORDERS) and shipment confirmations (SYNC-SHIPMENTS) every 15 minutes, inventory (SYNC-INV-BC, if Auto Sync Inventory is on) every 15 minutes, returns and tickets every 30 minutes, and every hour the offers (REFRESH-OFFERS) and the invoice upload (UPLOAD-INVOICES). If a task is missing, Create Default Tasks creates it.

8. The first order

  • IMPORT-ORDERS fetches the orders of all enabled storefronts; by hand: Import Orders on the Kaufland Dashboard or in Kaufland Orders.
  • For the first 15 minutes after the purchase, an order is Open: Kaufland withholds the address because the buyer can still cancel. As soon as it is To Be Sent, merchantCENTRAL creates the sales order – with gross prices, as the buyer paid them, and the latest ship date Kaufland sets.
  • If an order cannot be taken over, it gets the status Error or On Hold, and Error Message gives the reason; the other orders continue. See Troubleshooting.

9. Ship and send the shipment confirmation

Post the shipment of the sales order as usual. As soon as there is a tracking number – from a shipping label of the shipping module, from the vendor in a drop shipment, or entered by hand with Add Tracking Number on the posted shipment – merchantCENTRAL queues a shipment confirmation. SYNC-SHIPMENTS sends it to Kaufland within 15 minutes. merchantCENTRAL takes the carrier from the shipment itself – from the shipping agent of the tracking number, otherwise from that of the posted shipment. If the code or name of a shipping agent does not reveal the carrier, map it in the Kaufland Carrier Mapping; until then the confirmation waits. What was sent and what Kaufland rejected is shown in Kaufland Shipment Confirmations.

10. Invoice

Kaufland passes the invoice on to the buyer as a PDF. Post the invoice of the sales order; the scheduled task UPLOAD-INVOICES uploads the PDF of every posted sales invoice of a Kaufland order from the last 30 days that is not yet at Kaufland. Each invoice goes to Kaufland only once – a manual upload is refused as well if it is already there. By hand: Upload Invoice (under Marketplace) on the posted sales invoice, see Upload Invoice and Kaufland Order Invoices.


Where to go next