How to connect Kaufland with easySales: a complete setup guide
Connect any of Kaufland's seven storefronts to easySales: the two-step key form, every offer default, the EU responsible person, category mapping, and what each error on the offers list means.
What connecting Kaufland gives you
Kaufland's marketplace runs as seven separate storefronts. Connect one in easySales and your products become offers on it, orders come back into the same order list as every other channel, and the tracking number you generate is reported to Kaufland automatically.
This guide covers one connection from end to end. It gives most of its attention to the two things that decide whether your offers ever go live: the EAN, which is how Kaufland recognises what you are selling, and the category mapping, which is checked before anything is sent.
Before you start
A Kaufland seller account
One per country you want to sell in. The marketplace runs seven storefronts and each has its own account.
A Client key and a Secret key
Generated in the Kaufland Seller Portal, in the API section of your shop settings. They are what easySales signs every request with.
EANs on your products
Kaufland matches offers to its catalogue by barcode. Products without a real EAN cannot be listed.
Your categories mapped
Each of your categories has to point at a Kaufland category before offers made from it can be sent.
Step 1 — Find the right Kaufland card
Go to Integrations → Marketplaces and search for kaufland.
Press Connect on the card for the country you sell in, or Edit if you have connected it before.
Step 2 — Client key and Secret key
Kaufland authenticates every request with a Client key and a Secret key pair generated in your Kaufland Seller Portal, in the API section of your shop settings. They belong to one storefront: a key pair issued for the German shop will not open the Czech one.
Connection Name is the name you will see everywhere inside easySales — on the offers tab, on the order, in the connection list. Give it the country.
New order custom status is optional. If you keep your own order statuses, new Kaufland orders can land on one of them instead of the default.
Step 3 — Offer defaults
Once the keys are accepted the rest of the form appears. Everything in it is a default applied to offers created on this connection.
| Field | What it does |
|---|---|
| Invoice Series | The series used for invoices issued for orders from this storefront. |
| Price Addition | A percentage added on top of your product price when the offer is created. 10% on a 100 EUR product sends 110 EUR. It is a starting point — offer prices can be changed one by one or by rule afterwards. |
| Default shipping tax | The VAT rate applied to the shipping line on the invoice. |
| Default Tax Rate | The VAT rate sent with an offer that does not carry its own. The list comes from Kaufland, for that country. |
| Condition | New, or one of four used grades. It is applied to every offer created on the connection; a used-goods seller sets it once here. |
| Shipping group | Which of your Kaufland shipping groups an offer is sold under. The list is read from your Kaufland account, and an individual offer can use a different one. |
| Warehouse | The Kaufland warehouse the stock is held against. Also read from your account. |
| Default phone number | Used on an order that arrives without a phone number, so that the address is still complete enough to produce a shipping label. |
Step 4 — The EU responsible person
This block is the EU product-safety contact — the person or company inside the European Union responsible for the goods you list. Kaufland asks for it, and easySales copies what you enter here onto every offer it creates afterwards.
Step 5 — Additional settings
The second tab at the top of the form, Additional settings, holds three switches that decide how much of your data easySales keeps pushing after an offer exists.
| Setting | What it does |
|---|---|
| Send offer prices to marketplace | On by default. Turn it off if you set your Kaufland prices in the Seller Portal and do not want easySales overwriting them. A brand-new offer always carries its price, whatever this is set to. |
| Send offer stock to marketplace | On by default. Turn it off if another system owns your Kaufland stock. As above, a new offer always carries its stock. |
| Automatically enable offers when products have stock | Off by default. With it on, an offer you disabled because it ran out comes back by itself when the product has stock again. |
Step 6 — Map your categories
Kaufland will not take an offer that is not in one of its own categories, so before you create offers, map each of your categories to a Kaufland one.
Go to Products → Categories. The Mapped column shows which marketplaces each of your categories is already bound to.
Press Map categories on a row and pick Kaufland from the list of marketplaces. Type a few letters to search Kaufland's own category tree and choose the leaf category your products belong in.
Underneath, each characteristic Kaufland asks for in that category is listed, and you match it with one of your own product characteristics. Characteristics marked with an asterisk are the ones Kaufland requires.
Step 7 — Create the offers
Go to Products, turn on the Without offers on filter and pick your Kaufland connection: what is left is everything you sell that is not on Kaufland yet.
Use Add offer on a product, or select several and create them together. Each new offer inherits the defaults from the connection — condition, shipping group, warehouse, price addition, tax rate and the EU responsible person — and you can change any of them on the offer itself.
What Kaufland refuses, and why
The Offers page has a tab per marketplace. Open the Kaufland one and the Errors column tells you exactly why an offer is not live.
Some checks happen in easySales before anything is sent. These are the ones you fix yourself:
| Code | What it means | What to do |
|---|---|---|
| 2910 Missing category | The product's category is not mapped to a Kaufland category. | Products → Categories → Map categories, then resend the offer. |
| 2911 Product safety contact name is missing | The EU responsible person block is on and the offer has no name. | Fill the name on the connection and on the offers created before you switched it on. |
| 2912 Product safety contact address is missing | The same, for the address. | As above — the two always appear together. |
| 2909 Missing EAN | The product has no EAN. | Add the barcode to the product, then resend. |
The rest come back from Kaufland with its own message, under code 5:
| Message | What it means |
|---|---|
EAN "…" is not valid
|
The number is not a barcode Kaufland accepts. An internal code from your own stock system is the usual cause. |
A unit with the id_offer … already exists.
|
That SKU is already on your Kaufland shop. Two products cannot share one SKU. |
Max 20 pictures is allowed.
|
The offer carries more than twenty images. |
Parameter [listing_price] is missing or has wrong value
|
The price did not reach Kaufland in a form it accepts — usually a zero or empty price on the offer. |
Validation Failed with a field name
|
Kaufland refused one field and names it, for example an image URL it could not read. |
Orders, invoices and tracking
Orders from the storefront arrive in Orders like any other channel, with the invoice series you chose on the connection.
When you generate a shipping document, easySales sends the tracking number to Kaufland together with a carrier code, so the buyer can follow the parcel from their Kaufland account. The code is picked from the courier you used.
More than one storefront
Each Kaufland country is a separate card, a separate Seller Portal account and a separate connection in easySales — including a separate category mapping and separate offers. Sellers who list in several countries connect several cards and give each one a clear Connection Name.
| Shared | Per storefront | |
|---|---|---|
| Kaufland account and keys | — | Each country has its own account and its own Client/Secret key pair. |
| Products | Your product catalogue in easySales is one. | — |
| Category mapping | — | Each Kaufland country has its own category tree and its own mapping. |
| Offers | — | An offer belongs to one storefront, with its own price, stock and status. |
| Orders and invoices | One order list. | The invoice series is set per connection. |