Usage

First listing

1. Categories: search the Kaufland category tree (leaf categories only) and map a CS-Cart category to one, with an optional markup and a manufacturer (brand) name. The tree is loaded with one call per storefront and cached for a day; press Refresh reference data after Kaufland changes categories.
2. Attributes: for the chosen Kaufland category the required attributes are listed first, then the optional and conditional ones. Map each to a product feature or a fixed value. Values of attributes that have a shared set (for example a colour list) are matched by their label and sent as the Kaufland value; other values are sent as typed. Title, description, pictures, category, manufacturer and EAN come from the CS-Cart product and are not offered for mapping.
3. Rules: markup, price endings, stock buffer, handling time (days), default brand, weight, and whether the add-on creates units automatically.
4. Listings: map products (one by one or a whole CS-Cart category). The barcode is the EAN. Mapped products without a unit are created on the next sync.
5. Watch the Listings page: a product shows Waiting while Kaufland processes it, Live when its unit exists, or the exact reason Kaufland gave (for example the attributes it misses). Fix the data and press Retry.

What happens when you list a product

• The EAN already has a Kaufland product page (someone else listed it): the add-on creates your unit (price, stock, handling time, condition NEW, shipping group) at once. Kaufland matches your offer to the existing product; your own title and images are not used for it.
• The EAN is new to Kaufland: the add-on sends your product data (title, description as plain text, pictures, category, manufacturer, mapped attributes, product safety contact) and then polls the product data status. Kaufland processes it asynchronously and may review it manually, which can take hours or days. When the product is ready the unit is created. Until then the batch shows Waiting; after four hours the listing shows a retry message, and Retry continues (the product data is not sent again when the product is ready by then).
• Product data cannot be sent in test mode; use Live for new products.

Stock and price

Stock and price are pushed as bulk unit updates (one call per 150 units) on the schedule and whenever a mapped product is saved. Sync now queues an immediate push and order import. Prices are integer cents of the storefront currency (EUR, CZK or PLN); the CS-Cart price is converted with the CS-Cart currency of the same code or the fixed rate on the Rules page.

Orders

• Kaufland creates an order unit with status open when a customer buys; about 15 minutes later it becomes need_to_be_sent and carries the addresses. The add-on imports an order once all its units are past open: buyer, delivery and billing address (street and house number joined), company name, and the prices as sold. Units of the same product become one line with the quantity.
• A line whose EAN is not mapped is not imported: the Orders page shows the reason and the import is retried every hour.
• Status changes at Kaufland (sent, received, returned, cancelled) follow into CS-Cart through the status mapping.
• When you create a shipment with a tracking number in CS-Cart, the add-on marks every order unit of the order as sent. The carrier name of the CS-Cart shipment is matched to the Kaufland carrier list (for example DHL, Deutsche Post, DPD); a carrier that is not in the list is sent as Other.
• Cannot supply on the Orders page cancels the order units at Kaufland with the reason you choose from the Kaufland list (default NoInventory).
• Shipping cost and discounts of the Kaufland order are not recreated in the CS-Cart total; they are written to the order notes.

Returns

Return units appear on the Returns page linked to the CS-Cart order. Approve accepts the return units that arrived at your warehouse. Clarify, reject and repair are done in the Kaufland Seller Portal. Refunds are issued by Kaufland.

Jobs, log and connection

• Jobs: counts per state, the list with the last error, Retry, Remove and Run the queue now.
• Log: filter and export what happened and when.
• Connection: keys, storefront, shipping group, notification e-mail, product safety contact, Test connection, push notification registration.

Limits worth knowing

• Kaufland allows 111 requests per second per seller across all endpoints; the queue retries after a 429 answer.
• Bulk unit updates take at most 150 units and no duplicates per call.
• A new unit appears in the unit list of the API only after up to several minutes; the add-on remembers the unit ids it created.
• The Kaufland Seller API has no unit price or stock history; the add-on shows the last values it pushed.
• Invoices are not uploaded in version 1.0 (the API has an order invoice upload; it is on the roadmap).