Kaufland is one of the largest online marketplaces in Germany and also sells in several other European countries. For many sellers already on Amazon or eBay, it is the next channel to add. The question is how to connect it to your ERP or warehouse system without adding another round of manual exports.
This guide walks through how a Kaufland integration is usually structured.
How Kaufland's marketplace model works
A few concepts matter before you write any code:
- Products are matched by EAN. Kaufland keeps a shared product catalog. When you list an item, it is matched to an existing product by its EAN (GTIN). If the product does not exist yet, you supply product data so it can be created.
- Offers are called units. A unit is your offer for a product: price, available quantity, condition, handling time and the storefront it is sold on.
- Storefronts are per country. Offers, prices and orders are tied to a storefront, such as Germany or another country where Kaufland operates. Plan from the start which storefronts you sell on.
- Orders are split into order units. Each item in a customer order is its own order unit with its own status. You confirm shipment, cancel or handle returns per order unit, not per order.
Step 1: Get API access
Kaufland offers a REST Seller API. In the seller portal you create API credentials: a client key and a secret key. Every request is signed with an HMAC signature built from the request method, URL, body and a timestamp, sent together with your client key in request headers. Kaufland also requires a meaningful User-Agent header.
As with any marketplace, keep the secret key in a secrets manager, and make sure your server clock is accurate, since signed requests with a wrong timestamp are rejected.
Step 2: Product data
Decide where product data comes from. Usually that is your ERP or PIM, sometimes supplier feeds.
- Make sure every item has a valid EAN. Missing or wrong EANs are the most common reason items cannot be listed.
- For products not yet in Kaufland's catalog, map your attributes to Kaufland's category attributes. Required attributes differ per category.
- Upload product data via the API or Kaufland's product data import, and check the import reports for rejected items.
Step 3: Offers, stock and prices
Once products exist, your integration creates and updates units:
- Push price and quantity from your ERP, which remains the source of truth.
- Set a realistic handling time, as it affects delivery promises and your seller metrics.
- Use stock buffers for items you also sell on Amazon or your own shop, so a sale elsewhere does not oversell on Kaufland before the next sync.
- Update changes often, and run a full reconciliation on a schedule to catch drift.
Step 4: Import orders
Fetch new order units on a short schedule and create orders in your ERP:
- Use the Kaufland order unit ID as a unique key, so a retry never creates duplicate orders.
- Group order units that belong to the same customer order if your ERP expects one order with several lines.
- Map Kaufland's statuses to your ERP's statuses, including cancellations requested by the customer.
- Keep customer data only as long as you need it, in line with GDPR.
Step 5: Shipping confirmation and returns
When your warehouse ships, send the confirmation back with carrier and tracking number for each order unit. Late or missing confirmations hurt your performance metrics on the marketplace.
Returns and cancellations also happen per order unit. Your integration should bring these back into the ERP so stock and accounting stay correct.
Step 6: Monitoring
A Kaufland integration needs the same safety net as any marketplace integration:
- Alerts when no orders arrive for an unusual period, or when offer updates fail.
- A log of rejected products and offers, with the reason, that someone actually reads.
- A process for API changes announced by Kaufland.
Build, buy or connector?
Multichannel tools and ERP plugins with Kaufland support exist, and for simple setups they may be enough. A custom integration makes sense when your ERP has no ready connector, you need custom logic (bundles, multiple warehouses, per-storefront pricing), or the existing connector keeps failing.
Need help connecting Kaufland?
We build and maintain Kaufland integrations connected to ERPs, warehouse systems and existing Amazon or eBay setups. See our Kaufland integration service, or describe your setup below and you will get a reply from the engineer who would build it.