TikTok Shop Store Management
The ECOSIRE TikTok Shop Store Management module connects your TikTok Shop seller account to Odoo ERP through the TikTok Shop Open API v2. Built for the fast-paced world of social commerce, this module supports live shopping integration, affiliate marketplace management, and video commerce workflows. Operate across 8+ regional markets with flash sale management, logistics integration, and creator collaboration tools, all orchestrated from within your Odoo instance.
Compatibility: Odoo 17/18/19 Price: $349 (one-time) License: Up to 3 domain activations
Key Features
- Open API v2 integration
- Live shopping integration
- Affiliate marketplace support
- Video commerce support
- 8+ regional market coverage
- Flash sale management
- Logistics integration
- Sample management
- Content compliance tools
- Creator collaboration tools
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- An active ECOSIRE license for this module
- A TikTok Shop seller account with API access through the TikTok Shop Partner Center
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip ecosire-tiktok-shop-*.zip -d /opt/odoo/addons/ - Restart the Odoo service:
sudo systemctl restart odoo - Navigate to Apps, click Update Apps List
- Search for "ECOSIRE TikTok Shop Store Management" and click Install
- Enter your ECOSIRE license key when prompted
Configuration
Step 1: Obtain TikTok Shop API Credentials
- Go to the TikTok Shop Partner Center and sign in
- Navigate to My Apps and click Create App
- Enter your app name (e.g., "ECOSIRE Odoo Integration")
- Select the app type as Private App for single-seller use or Public App for multi-seller
- Configure the required API permissions:
- Product: Read and Write
- Order: Read and Write
- Fulfillment: Read and Write
- Finance: Read
- Logistics: Read and Write
- Promotion: Read and Write
- Set the Callback URL to point to your Odoo instance
- Submit the app for review and wait for approval
- After approval, note your App Key and App Secret
- Complete the OAuth flow to obtain your Access Token and Refresh Token
Step 2: Connect in Odoo
- Navigate to TikTok Shop Store Management then Configuration
- Enter your TikTok Shop App Key, App Secret, Access Token, and Refresh Token
- Select your target regional market(s)
- Click Test Connection to verify
- Configure your default warehouse and company mapping
Step 3: Configure Sync Settings
Product Sync
- Choose sync direction: TikTok Shop to Odoo, Odoo to TikTok Shop, or bidirectional
- Set sync interval: Real-time (webhook) or scheduled (5/15/60 minutes)
- Configure product field mapping and category mapping
- Map TikTok Shop product categories to Odoo categories
Inventory Sync
- Map Odoo warehouses to TikTok Shop warehouses
- Set buffer stock quantities if needed
- Enable real-time stock updates
Order Sync
- Enable automatic order import
- Map TikTok Shop payment methods to Odoo payment journals
- Configure fulfillment sync to push tracking numbers
- Handle live shopping and flash sale orders with priority processing
Initial Sync
- Go to TikTok Shop Store Management then Operations then 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
Dashboard
The OWL 2 dashboard provides:
- 6 KPI cards showing real-time sales, orders, and sync metrics
- Interactive Chart.js sales analytics with date filtering
- Top products ranking by revenue
- Live activity feed of recent sync operations
- Quick action buttons for common tasks
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify API credentials and check network connectivity |
| Sync not running | Check Odoo scheduled actions (cron jobs) are enabled |
| Duplicate products | Review product mapping settings and matching rules |
| Orders not importing | Verify order status filters and date range settings |