Cdiscount Store Management
Connect your Cdiscount seller account to Odoo through the Cdiscount Marketplace API. This module authenticates via OAuth 2.0 (password grant) against iam.cdiscount.com, then uses bearer tokens to communicate with the REST API at api.cdiscount.com/v1. Synchronize your product catalog, import orders, manage inventory, and track performance on France's second-largest e-commerce marketplace.
Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations
Key Features
- Cdiscount API integration with OAuth 2.0 password grant
- Bidirectional product synchronization
- Automatic order import and fulfillment tracking
- Real-time inventory synchronization
- Category mapping with Cdiscount product taxonomy
- Shipping carrier integration
- Automatic retry with exponential backoff
- Commission and fee tracking
- Returns and claims management
- Promotion management
- Multi-warehouse support
- Performance monitoring
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- An active ECOSIRE license for this module
- A Cdiscount seller account (cdiscount.com)
- Cdiscount API Login and Password from the Seller Portal
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-cdiscount-*.zip -d /opt/odoo/addons/ - Restart the Odoo service:
sudo systemctl restart odoo - Navigate to Apps, click Update Apps List
- Search for the module and click Install
- Enter your ECOSIRE license key when prompted
Configuration
Step 1: Obtain Cdiscount API Credentials
- Log in to your Cdiscount Seller Portal
- Navigate to API Settings
- Note your API Login and API Password
- Optionally note your Seller ID for reference
Step 2: Connect in Odoo
- Navigate to Cdiscount Store Management > Configuration
- Create a new configuration and enter:
- API Login (
api_login) -- your Cdiscount API login username - API Password (
api_password) -- your Cdiscount API password - Seller ID (
seller_id) -- your Cdiscount seller identifier
- API Login (
- Click Test Connection to verify API access
- Configure your default warehouse and company mapping
Step 3: Configure Sync Settings
Product Sync
- Choose sync direction: Cdiscount-to-Odoo, Odoo-to-Cdiscount, 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 Cdiscount fulfillment locations
- Set buffer stock quantities if needed
- Enable real-time stock updates on changes
Order Sync
- Enable automatic order import
- Map Cdiscount payment methods to Odoo payment journals
- Configure fulfillment sync to push tracking numbers
Initial Sync
- Go to Cdiscount 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 | OAuth 2.0 password grant (bearer token) |
| Token URL | https://iam.cdiscount.com/idp/oauth2/token |
| Base URL | https://api.cdiscount.com/v1 |
| Token grant | grant_type=password with scope=openid |
| Retry policy | 3 retries, 0.5s backoff, on 429/500/502/503/504 |
| Key config fields | api_login, api_password, seller_id |
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 |
| Token expired | Module auto-refreshes; verify API Login and Password are still valid |
| Product rejected by Cdiscount | Check required fields (EAN, description length, category code) |
| Claims not syncing | Verify claims API permission is enabled on your account |
| License not active | Verify your ECOSIRE license key at Settings > ECOSIRE License |