Kaufland Store Management

Connect your Kaufland Global Marketplace seller account to Odoo through the Kaufland Seller API v2. This module uses HMAC-SHA256 signature authentication with HM-Access-Key, HM-Signature, and HM-Timestamp headers. Manage products, orders, and inventory across all Kaufland storefronts (Germany, Czech Republic, Slovakia, Poland, Austria) from a single Odoo instance.

Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations

Key Features

• Kaufland Seller API v2 with HMAC-SHA256 signing
• Multi-storefront support (DE, CZ, SK, PL, AT)
• Bidirectional product synchronization
• Automatic order import and fulfillment tracking
• Real-time inventory synchronization
• Category mapping with Kaufland taxonomy
• EAN/GTIN barcode management
• Shipping carrier and warehouse mapping
• Returns and refund processing
• Automatic retry with exponential backoff
• Seller performance monitoring
• Commission tracking

Prerequisites

• Odoo 17, 18, or 19 (Community or Enterprise edition)
• An active ECOSIRE license for this module
• A Kaufland Global Marketplace seller account
• Kaufland Seller API credentials (Client Key + Secret Key)

Installation

1. Download the module ZIP from your ECOSIRE Dashboard
2. Extract to your Odoo addons directory:

   unzip ecosire-kaufland-*.zip -d /opt/odoo/addons/

3. Restart the Odoo service:

   sudo systemctl restart odoo

4. Navigate to Apps, click Update Apps List
5. Search for the module and click Install
6. Enter your ECOSIRE license key when prompted

Configuration

Step 1: Obtain Kaufland API Credentials

1. Log in to your Kaufland Seller Portal
2. Navigate to Settings > API Access
3. Generate a new API key pair
4. Note your Client Key and Secret Key
5. Select your target storefront(s): DE, CZ, SK, PL, or AT

Step 2: Connect in Odoo

1. Navigate to Kaufland Store Management > Configuration
2. Create a new configuration and enter:
   • Client Key (client_key) -- Kaufland API access key (sent as HM-Access-Key)
   • Secret Key (secret_key) -- used for HMAC-SHA256 signature generation
   • Storefront (storefront) -- select de, cz, sk, pl, or at
3. Click Test Connection to verify API access
4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings

Product Sync

• Choose sync direction: Kaufland-to-Odoo, Odoo-to-Kaufland, or bidirectional
• Set sync interval: scheduled (every 5, 15, or 60 minutes)
• Configure product field mapping and category mapping

Inventory Sync

• Map Odoo warehouses to Kaufland stock per storefront
• Set buffer stock quantities if needed
• Enable real-time stock updates on changes

Order Sync

• Enable automatic order import
• Map Kaufland payment methods to Odoo payment journals
• Configure fulfillment sync to push tracking numbers

Initial Sync

1. Go to Kaufland Store Management > Operations > Initial Import
2. Select data types to import (Products, Customers, Orders)
3. Set date range for historical orders
4. Click Start Import and monitor progress in the sync log

API Details

Field	Value
Auth method	HMAC-SHA256 signature (HM-Access-Key, HM-Signature, HM-Timestamp headers)
Base URL	https://sellerapi.kaufland.de/v2
API version	v2
Storefronts	de, cz, sk, pl, at
Retry policy	3 retries, 0.5s backoff, on 429/500/502/503/504
Key config fields	client_key, secret_key, storefront

Dashboard

The built-in OWL 2 dashboard provides real-time visibility into your integration:

• 6 KPI cards -- Revenue, Orders, Customers, Products, Avg Order Value, and Sync Health -- each with period-over-period delta indicators
• Sales Trend chart (Chart.js line chart) with interactive date filtering
• Order Status breakdown (doughnut chart) showing distribution across statuses
• Period filters -- Today, 7 days, 30 days, 90 days, Year, or Custom date range
• Activity feed showing recent sync log entries with type indicators
• Quick action buttons for Products, Orders, Customers, Queue, Logs, and Settings
• Status footer with Queue Jobs, Errors, Out of Stock, and Sync Rate
• Auto-refresh every 60 seconds with dark mode support

Troubleshooting

Issue	Solution
Connection failed	Verify API credentials; check network connectivity
Sync not running	Check Odoo scheduled actions (cron jobs) are enabled
Duplicate products	Review product mapping; ensure SKU matching is configured
Orders not importing	Verify order status filters and date range settings
Signature mismatch	Verify Client Key and Secret Key; ensure server clock is synchronized
Storefront not available	Valid storefronts are: de, cz, sk, pl, at
EAN required	Kaufland requires valid EAN/GTIN for all products
License not active	Verify your ECOSIRE license key at Settings > ECOSIRE License

Support

• General Troubleshooting
• Email: [email protected]
• Support Portal