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.143 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 setup 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) 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. Everything it sets can be found later in the Kaufland setup.

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 until the SKU is assigned; turned off, no sales order is created, and the order reports the EAN in Import Error until the item is found.

4. Storefronts, warehouse and shipping groups

  • Storefronts: On the Kaufland Storefront Configuration page, Add All Storefronts creates the missing countries, switched off. Switch on every storefront you sell on. Each enabled storefront is a sales channel of the marketplace card; orders, returns and tickets are imported only from enabled storefronts.
  • 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.
  • 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 setup (Default Shipping Group ID), those of the other storefronts on their storefront card.

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. 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 Selected 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, Refresh 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 from BC 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 notices (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, the reason is in the order's Import Error; the other orders continue. See Troubleshooting.

9. Ship and send the shipment notice

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 notice. SYNC-SHIPMENTS sends it to Kaufland within 15 minutes. So that Kaufland recognizes the carrier, map your shipping agents in the Kaufland Carrier Mapping if needed, or set a Default Carrier. What was sent and what Kaufland rejected is shown in Kaufland Shipment Notices.

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 to Kaufland on the posted sales invoice, see Upload Invoice and Kaufland Order Invoices.

Where to go next