Skip to content

Kaufland API Setup

Central setup page for the Kaufland Connector. This is where API credentials, order import settings, synchronization status, and debug options are configured.

The connection to Kaufland is established via the Kaufland Seller API using a Client Key and Secret Key. Additionally, a Playground environment (sandbox) is available for testing.

Opening the Page

  • Via search: Kaufland API Setup
  • Via the Role Center → Administration → Setup
  • Via the Dashboard → Action Setup

Fields

General

General API settings.

Field Description
Base URL Base URL of the Kaufland Seller API (e.g., https://sellerapi.kaufland.de/v2).
Use Playground When enabled, all API calls are sent to the Kaufland sandbox environment. Ideal for testing without affecting the production shop.
Default Storefront Default country shop for API calls (e.g., DE, AT). Can be overridden per storefront configuration.
User Agent HTTP User-Agent header for API calls. Identifies the calling system to Kaufland.

Authentication

Credentials for the Kaufland Seller API.

Field Description
Client Key 32-character API Client Key from the Kaufland Seller Portal. Found under Settings > API Access.
Secret Key 64-character Secret Key for HMAC signing of API calls. Displayed masked (***).

API Keys

The Secret Key is stored encrypted. Keep the keys safe – if lost, a new key must be generated in the Kaufland Seller Portal.

Order Import

Settings for automatic order import.

Field Description
Auto Import Orders Enables automatic order import via Job Queue.
Order Import Interval (Min) Interval in minutes for automatic order import. Only active when Auto Import Orders is enabled.
Create Sales Orders When enabled, imported Kaufland orders are automatically created as BC sales orders.
Default Customer No. Default customer number for automatically created sales orders. Only active when Create Sales Orders is enabled.

Sync Status

Read-only status information about the last synchronization.

Field Description
Last Order Sync Timestamp of the last order synchronization.
Last Order Sync Status Status of the last synchronization (color-coded: Green = Success, Red = Error).
Last Order Sync Message Status message or error description of the last synchronization.

Debugging

Field Description
Log API Requests When enabled, all API calls are logged in the API Log (including request/response body). Useful for troubleshooting; should be disabled in production for performance reasons.

Actions

Action Description
Test Connection Tests the connection to the Kaufland Seller API with the entered credentials. On success, a confirmation appears; on failure, the error message is shown.
Import Orders Starts the manual order import. All new orders since the last synchronization are imported.
View Orders Opens the Orders list.
View API Log Opens the API Log with all logged API calls.