← Back to EcomCentral
KAUFLAND SELLER API v2

Kaufland Setup Guide

Connect your Kaufland seller account using the Kaufland Seller API with HMAC-SHA256 request signing.

Prerequisites

ℹ️ Kaufland uses HMAC-SHA256 signed requests. Every API call is signed with a timestamp and your Client Secret. No OAuth flow or token exchange is needed — credentials are used directly per request.

Getting Your API Credentials

  1. Log in to the Kaufland Seller Portal at sellerportal.kaufland.de
  2. Navigate to Einstellungen → API (Settings → API)
  3. Click Neuen API-Zugang erstellen (Create new API access)
  4. Enter a name for your integration (e.g. "EcomCentral")
  5. Copy the generated Client Key and Client Secret
  6. In EcomCentral, go to Connections → Add Connection, select Kaufland
  7. Paste the Client Key into client_key, the Client Secret into client_secret
  8. Set storefront to your marketplace country code (e.g. de for Germany)
  9. Click ⚡ Test on the connection card to verify the HMAC signature works
⚠️ The Client Secret is shown only once in the Seller Portal. Copy it immediately and store it securely — EcomCentral encrypts it before saving to the database.

Credentials Reference

KeyRequiredDescriptionExample
client_key Required The API client key from Kaufland Seller Portal (used in Shop-Client-Key header) a1b2c3d4e5f6…
client_secret Required The API client secret — used to generate the HMAC-SHA256 request signature s3cr3t…
storefront Optional Country/marketplace code. Defaults to de if omitted de
✅ Alternative key names also accepted: api_key / key for the client key; api_secret / secret for the client secret; country for storefront.

Available Storefronts

Kaufland operates in multiple European markets. Each storefront is a separate marketplace. Set the storefront credential to match your seller account:

de
Germany
at
Austria
sk
Slovakia
cz
Czech Rep.
pl
Poland
be
Belgium
nl
Netherlands
lu
Luxembourg
ℹ️ If you sell on multiple Kaufland storefronts, create a separate EcomCentral connection per storefront.

Order & Order-Unit Statuses

In Kaufland's model, an order contains one or more order units (individual line items). Statuses are managed at the order-unit level.

need_to_be_sent
Ready to ship — action required
sent
Tracking submitted — shipped
returned
Item returned by the customer
cancelled
Order unit cancelled

Supported Carrier Codes

Use one of these carrier codes when sending tracking. The UI provides a dropdown with the most common options.

dhl
hermes
dpd
ups
fedex
gls
tnt
post_at
post_de
amazon_logistics
other
ℹ️ When tracking is sent, EcomCentral fetches all order units for the order and dispatches the same carrier & tracking number to each unit in a single operation.

Supported Features

FeatureSupportedNotes
View orders list✅Paginated, with status filter
View order details✅Address, order units, prices, tracking status
Send tracking✅Sends carrier + number to all units in the order
Cancel orders❌Not available in Kaufland Seller API v2
View inventory / listing units✅EAN, title, stock, listing price
Update stock quantity❌Kaufland API has no write endpoint for stock
Test connection✅Validates HMAC signing and API access
Multiple storefronts✅Create one connection per storefront country
⚠️ Stock updates are not supported by the Kaufland Seller API. Manage stock quantities directly in the Kaufland Seller Portal or via a third-party ERP integration.

Troubleshooting

✕ HTTP 401 — Signature invalid

The HMAC signature check failed. This usually means the Client Secret is wrong, or the server clock is more than 5 minutes out of sync. Verify credentials and ensure the server time is accurate (NTP). Check that you did not accidentally include extra whitespace when copying the secret.

✕ HTTP 403 — Forbidden

Your API key does not have permission for this endpoint. Go to Seller Portal → Settings → API and check which scopes are enabled for your key.

✕ HTTP 422 — Invalid storefront

The storefront value is not one of the accepted country codes. Update the connection credential to a valid code such as de, at, cz, etc.

✕ Empty order list

Your seller account may have no orders yet, or you may be filtering by a status with no results. Try clearing the status filter dropdown to see all orders.