Skip to main content

AliExpress Store Management

Integrate your AliExpress seller account with Odoo to manage products, orders, and cross-border logistics on one of the world's largest global e-commerce marketplaces. This module connects to the AliExpress Open Platform API (https://api-sg.aliexpress.com/sync) using HMAC-MD5 signed requests, synchronizing your catalog, automating order forwarding, and tracking performance through a real-time OWL 2 dashboard built directly into Odoo.

Compatibility: Odoo 17 / 18 / 19 Price: $249 (one-time) License: Up to 3 domain activations

Key Features​

  • Bidirectional product synchronization with AliExpress catalog
  • Automatic order import and status updates
  • Dropshipping automation with one-click order forwarding to suppliers
  • Real-time inventory synchronization across warehouses
  • Supplier management with performance tracking and rating
  • Cross-border logistics integration with international shipping providers
  • Product sourcing tools for finding and importing supplier catalogs
  • Multi-language listings with automatic translation support
  • Dispute management with case tracking and resolution workflows
  • Shipping template mapping between AliExpress and Odoo carriers
  • Cost and margin tracking with landed cost calculations
  • Multi-currency support for cross-border transactions

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • An AliExpress seller account with Open Platform access
  • AliExpress Open Platform App Key and App Secret

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-aliexpress-*.zip -d /opt/odoo/addons/
  3. Restart the Odoo service: 
    sudo systemctl restart odoo
  4. Navigate to Apps, click Update Apps List
  5. Search for the module and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain AliExpress API Credentials​

  1. Go to the AliExpress Open Platform and sign in
  2. Create a new application to receive your App Key and App Secret
  3. Request the necessary API permissions (Product, Order, Logistics, Data)
  4. Complete the OAuth flow to obtain your Access Token and Refresh Token
  5. Note your token expiry -- tokens auto-refresh via the module

Step 2: Connect in Odoo​

  1. Navigate to AliExpress Store Management > Configuration
  2. Create a new configuration and enter:
    • App Key (app_key) -- your AliExpress application key
    • App Secret (app_secret) -- your application secret
    • Access Token (access_token) -- OAuth access token
    • Refresh Token (refresh_token) -- for automatic token renewal
  3. Click Test Connection to verify API access
  4. Configure your default warehouse and company mapping

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: AliExpress-to-Odoo, Odoo-to-AliExpress, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping
  • Map AliExpress product identifiers (SKU, ID) to Odoo products

Inventory Sync​

  • Map Odoo warehouses to AliExpress fulfillment locations
  • Set buffer stock quantities if needed
  • Enable real-time stock updates on changes

Order Sync​

  • Enable automatic order import
  • Map AliExpress payment methods to Odoo payment journals
  • Configure fulfillment sync to push tracking numbers
  • Set up order status filter rules

Initial Sync​

  1. Go to AliExpress Store Management > Operations > Initial Import
  2. Select data types to import (Products, Customers, Orders)
  3. Set date range for historical orders
  4. Click Start Import and monitor progress in the sync log

API Details​

FieldValue
Auth methodHMAC-MD5 signed requests
Base URLhttps://api-sg.aliexpress.com/sync
Token URLhttps://api-sg.aliexpress.com/auth/token/create
SignatureHMAC-MD5 over sorted params wrapped with app_secret
API versionv2.0
Key config fieldsapp_key, app_secret, access_token, refresh_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​

IssueSolution
Connection failedVerify API credentials; check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping; ensure SKU matching is configured
Orders not importingVerify order status filters and date range settings
Token expiredModule auto-refreshes tokens; check refresh_token is still valid
Signature errorVerify app_secret matches your Open Platform application
Dropship order stuckCheck supplier availability and logistics template mapping
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on