Kogan Store Management
The ECOSIRE Kogan Store Management module integrates your Kogan Marketplace seller account with Odoo ERP. Kogan.com is one of Australia's largest and most visited online retailers, offering a wide range of products from electronics to fashion to home goods through its marketplace model. With millions of active customers, Kogan Marketplace provides significant reach for Australian and international sellers. This module uses the Kogan Marketplace API to synchronize your product catalog, orders, and inventory.
Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations
Key Features
- Kogan Marketplace API integration with seller token authentication
- Bidirectional product synchronization (listings, variants, prices, images)
- Automatic order import and fulfillment tracking
- Real-time inventory synchronization
- Category mapping to Kogan taxonomy
- Price update management
- Returns and refund processing
- Seller performance metrics monitoring
- 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 Kogan Marketplace seller account with API access
- Seller token from the Kogan Marketplace Portal
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-kogan-*.zip -d /opt/odoo/addons/ - Restart the Odoo service:
sudo systemctl restart odoo - Navigate to Apps, click Update Apps List
- Search for "ECOSIRE Kogan Store Management" and click Install
- Enter your ECOSIRE license key when prompted
Configuration
Step 1: Obtain Kogan API Credentials
- Log in to your Kogan Marketplace Portal at
https://sellers.kogan.com.au - Navigate to Account Settings then API Access or Integrations
- Copy your Seller Token from the API access section
- Contact Kogan Seller Support if API access needs to be activated for your account
Step 2: Connect in Odoo
- Navigate to Kogan Store Management > Configuration
- Create a new configuration and enter:
- Seller Token (
seller_token) -- your Kogan Marketplace seller token
- Seller Token (
- Click Test Connection to verify API access
- Configure your default warehouse and company mapping
Step 3: Configure Sync Settings
Product Sync
- Choose sync direction: Kogan to Odoo, Odoo to Kogan, or bidirectional
- Set sync interval: scheduled (every 5, 15, or 60 minutes)
- Configure product field mapping and category mapping to Kogan taxonomy
Inventory Sync
- Map Odoo warehouses to Kogan seller settings
- Set buffer stock quantities to prevent overselling
- Enable real-time stock updates on inventory changes
Order Sync
- Enable automatic order import
- Map Kogan payment methods to Odoo payment journals
- Configure fulfillment tracking sync to push tracking numbers
Initial Sync
- Go to Kogan 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 | Token-based authentication (Seller Token in header) |
| Base endpoint | https://www.kogan.com/api/v2/partner |
| Products endpoint | /products |
| Orders endpoint | /orders |
| Inventory endpoint | /inventory |
| Key config fields | seller_token |
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 seller token; confirm API access is enabled in your account |
| 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 |
| 401 Unauthorized | Regenerate seller token in the Kogan Marketplace Portal |
| Product not visible | Check listing status and Kogan category requirements for your product type |
| Price not updating | Verify price sync settings and minimum margin requirements |
| License not active | Verify your ECOSIRE license key at Settings > ECOSIRE License |