Kaufland Marketplace Connector for OpenCart 2.3, 3.x and 4.x — offers, prices, orders

Kaufland Marketplace Connector for OpenCart sells shop products on the Kaufland Global Marketplace storefronts through the Seller API: Germany, Austria, Czechia, Slovakia, Poland and the others open to your account. It links existing offers, creates new ones by EAN and keeps the price and stock on every storefront. Pro brings Kaufland orders into OpenCart and sends shipment, cancellation, the invoice and product data back.

What the buyer sees

A Kaufland buyer finds your product by EAN at a price in the storefront currency (EUR, CZK, PLN): gross with the storefront VAT, your markup, the OpenCart special price. A disabled product goes on hold with quantity 0.

What the admin gets

Extensions → Modules → Kaufland Marketplace Connector: keys, a Playground switch, and a connection check that lists storefronts, VAT rates, warehouses and shipping groups. Per storefront: sell or not, percentage and fixed markup, shipping group, warehouse. The import links existing offers by id_offer or EAN.

In Pro, Kaufland orders arrive by push notification and by polling every 4–5 minutes. The order page gets a panel: items with their offers, “Read again from Kaufland”, shipment with carrier and tracking number, cancellation with a reason, PDF invoice upload. The Shipped and Cancelled statuses in OpenCart go to Kaufland too.

How it works, step by step

1. In the Seller Portal (Settings → API) you generate the Client Key and Secret Key, paste them into the module and check the connection.
2. You switch on the storefronts, set the markup, shipping group and warehouse, and fill in EANs on the products.
3. The import links existing offers; new ones can be created by EAN.
4. Price and stock changes go to a queue and out in batches of up to 150 offers; 5xx and 429 errors stay in the queue.
5. In Pro orders come into OpenCart, and shipment and cancellation go back to Kaufland.

Under the hood

• Every request is signed with HMAC; keys are stored encrypted.
• The price is counted in cents in the storefront currency: the shop rate or a manual EUR/CZK/PLN one, with the storefront VAT by tax class.
• A deleted product removes its offer; an offer answering 404 is created again.
• Orders are never doubled (a lock and a link to the Kaufland number); FBK orders are not imported.
• Pro sends product data in the language of each storefront: title, description, pictures, manufacturer, category and attributes by your map.
• API log: 100 entries over 30 days.

How to install

1. Extensions → Installer: upload the archive for your version without renaming the file.
2. OpenCart 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Modules → Kaufland Marketplace Connector → install → edit.
4. Paste the keys, check the connection, switch on the storefronts and run the offer import.
5. For Pro: paste the key or start the 7-day trial on the Licence tab.