Takealot Store Management
The ECOSIRE Takealot Store Management module integrates your Takealot seller account with Odoo ERP. Takealot is South Africa's largest and most popular online retailer, receiving over 3 million visits per month and serving customers across all major product categories. This module uses the Takealot Seller API to synchronize your product catalog, orders, and inventory between Takealot and Odoo.
Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations
Key Features
- Takealot Seller API integration with API key authentication
- Product listing management and offer creation
- Automatic order import and fulfillment tracking
- Real-time inventory synchronization
- Lead time and stock level management
- Takealot Marketplace and Direct Import support
- Returns and customer service management
- Seller performance dashboard integration
- Multi-company record rules for isolated data management
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- An active ECOSIRE license for this module
- A Takealot seller account with Seller API access enabled
- API key from the Takealot Seller Portal
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-takealot-*.zip -d /opt/odoo/addons/ - Restart the Odoo service:
sudo systemctl restart odoo - Navigate to Apps, click Update Apps List
- Search for "ECOSIRE Takealot Store Management" and click Install
- Enter your ECOSIRE license key when prompted
Configuration
Step 1: Obtain Takealot API Credentials
- Log in to your Takealot Seller Portal at
https://seller.takealot.com - Navigate to Settings then API Access
- Click Generate API Key or copy your existing seller API key
- Store the key securely for use in Odoo
Step 2: Connect in Odoo
- Navigate to Takealot Store Management > Configuration
- Create a new configuration and enter:
- API Key (
api_key) -- your Takealot seller API key
- API Key (
- Click Test Connection to verify API access
- Configure your default warehouse and company mapping
Step 3: Configure Sync Settings
Product Sync
- Choose sync direction: Takealot to Odoo, Odoo to Takealot, or bidirectional
- Set sync interval: scheduled (every 5, 15, or 60 minutes)
- Configure product and offer field mapping
Inventory Sync
- Map Odoo warehouses to Takealot stock locations
- Set buffer stock quantities and lead times
- Enable real-time stock updates on inventory changes
Order Sync
- Enable automatic order import
- Map Takealot payment methods to Odoo payment journals
- Configure fulfillment tracking sync
Initial Sync
- Go to Takealot Store Management > Operations > Initial Import
- Select data types to import (Products, Customers, Orders)
- Set date range for historical orders
- Click Start Import and monitor progress in the sync log
API Details
| Field | Value |
|---|---|
| Auth method | API Key in Authorization header |
| Base endpoint | https://seller-api.takealot.com/v2 |
| Products endpoint | /listings |
| Orders endpoint | /sales |
| Inventory endpoint | /listings/stockupdates |
| Key config fields | api_key |
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 key; confirm Seller API access is enabled in your account |
| Sync not running | Check Odoo scheduled actions (cron jobs) are enabled |
| Duplicate products | Review product mapping; ensure TSIN/barcode matching is configured |
| Orders not importing | Verify order status filters and date range settings |
| 401 Unauthorized | Regenerate API key in the Takealot Seller Portal |
| Offer not activating | Verify lead time and stock quantities meet Takealot requirements |
| TSIN not found | Confirm the product exists in the Takealot catalog with a valid TSIN |
| License not active | Verify your ECOSIRE license key at Settings > ECOSIRE License |