Wildberries Store Management
The ECOSIRE Wildberries Store Management module integrates your Wildberries seller account with Odoo ERP. Wildberries is Russia's largest online marketplace and one of the top e-commerce platforms across CIS countries, serving millions of buyers daily. This module synchronizes your product catalog, orders, and inventory in real time, giving you full visibility over your Wildberries operations from within Odoo.
Compatibility: Odoo 17 / 18 / 19 Price: $349 (one-time) License: Up to 3 domain activations
Key Features
- Wildberries Seller API integration with API token authentication
- Bidirectional product synchronization (listings, prices, descriptions, images)
- Automatic order import and status tracking
- Real-time inventory synchronization across warehouses
- FBO (Fulfillment by Wildberries) and FBS (Fulfillment by Seller) support
- Category mapping to Wildberries taxonomy
- Returns and refund management
- Seller analytics and rating 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 Wildberries seller account with API access enabled
- Wildberries API token from the Seller Portal
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-wildberries-*.zip -d /opt/odoo/addons/ - Restart the Odoo service:
sudo systemctl restart odoo - Navigate to Apps, click Update Apps List
- Search for "ECOSIRE Wildberries Store Management" and click Install
- Enter your ECOSIRE license key when prompted
Configuration
Step 1: Obtain Wildberries API Token
- Log in to your Wildberries Seller Portal at
https://seller.wildberries.ru - Navigate to Settings then Access to API
- Click New token and select the required API scopes:
- Content (for product management)
- Marketplace (for orders and inventory)
- Statistics (for analytics)
- Prices and Discounts
- Copy and save the generated API token securely
Step 2: Connect in Odoo
- Navigate to Wildberries Store Management > Configuration
- Create a new configuration and enter:
- API Token (
api_token) -- your Wildberries Seller API token - Warehouse -- select the default Odoo warehouse for this account
- Company -- select the Odoo company for multi-company environments
- API 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: Wildberries to Odoo, Odoo to Wildberries, or bidirectional
- Set sync interval: scheduled (every 5, 15, or 60 minutes)
- Configure product field mapping and category mapping to Wildberries taxonomy
Inventory Sync
- Map Odoo warehouses to Wildberries fulfillment types (FBO or FBS)
- Set buffer stock quantities to prevent overselling
- Enable real-time stock updates on inventory changes
Order Sync
- Enable automatic order import
- Map Wildberries payment methods to Odoo payment journals
- Configure fulfillment sync for FBS orders (push tracking numbers)
Initial Sync
- Go to Wildberries 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 | Bearer token (API token in Authorization header) |
| Base endpoint | https://suppliers-api.wildberries.ru |
| Statistics endpoint | https://statistics-api.wildberries.ru |
| Prices endpoint | https://discounts-prices-api.wb.ru |
| Content endpoint | https://content-api.wildberries.ru |
| Key config fields | api_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 your API token; ensure the correct scopes are enabled |
| 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 unauthorized | Regenerate the API token in the Wildberries Seller Portal |
| FBO inventory mismatch | Check FBO vs FBS warehouse mapping settings |
| Price not updating | Verify the Prices and Discounts API scope is enabled on your token |
| License not active | Verify your ECOSIRE license key at Settings > ECOSIRE License |