AliExpress Store Management

Premium connector for AliExpress -- Alibaba Group's global B2C marketplace covering 200+ countries -- from a single Odoo instance. The connector uses HMAC-SHA256 TOP-API authentication, region-aware fulfillment routing across CN / US / EU / RU and the AliExpress Choice premium delivery program, full settlement ingestion with AE-Affiliate commission tracking, and 2026-compliant tax flows for EU OSS/IOSS, US 50-state sales-tax nexus, UK post-Brexit VAT, KSA ZATCA Phase 2, and Brazil RFB.

Module	aliexpress_store_management
Version	19.0.2.0.0 (also 18.0.2.0.0 and 17.0.2.0.0)
Compatibility	Odoo 17 / 18 / 19 -- Community + Enterprise -- On-Premise + Odoo.sh
Price	USD 249 (one-time licence per Odoo instance)
License	LGPL-3 (open source, audit-friendly)
Author	ECOSIRE (PRIVATE) LIMITED

Key Features

14 Capability Areas (v19.0.2)

• aliexpress.order -- Full order lifecycle (placed → finish → returned) with region routing, ship-to-country ISO-2, Cainiao tracking number, AliExpress Choice flag for SLA monitoring
• aliexpress.product -- Multilingual listings (EN + RU/ES/FR/DE/PT), GTIN required, choice_eligible flag, approval state mirror
• aliexpress.product.image -- Photobank tracker (CDN URL + sequence + state)
• aliexpress.customer -- Masked buyer profiles (AliExpress masks PII; we store the masked payload verbatim)
• aliexpress.collection -- Category tree mirror with self-referential parent/child + parent_path
• aliexpress.location -- CN origin / US-EU-RU bonded / AliExpress Choice hubs
• aliexpress.carrier -- Cainiao logistics integration with is_cainiao flag and global.cainiao.com deep-link template
• aliexpress.return -- Return lifecycle (created → received → refunded)
• aliexpress.refund -- Refund record with linked credit note (account.move)
• aliexpress.risk -- Fraud scoring per order (flagged when score ≥ 0.7)
• aliexpress.settlement -- Finance ingestion plus AE-Affiliate API commission tracking; one-to-many ledger lines (sale / fee / tax / commission / adjustment / payout)
• aliexpress.analytics -- Per-region daily aggregates (GMV, orders, refunds, Choice orders, affiliate commission) feeding the OWL dashboard
• aliexpress.workflow + aliexpress.auto.workflow -- Per-region auto-confirm / auto-invoice / auto-deliver rules (e.g. Choice may auto-deliver on shipped while CN waits for buyer-confirm)
• aliexpress.fulfillment.program -- Dedicated AliExpress Choice 24h SLA tracker with computed SLA violations + compliance percentage badge

Multi-Region Runtime

Region	Code	Currency	Notes
China (Origin)	cn	USD/CNY	Primary fulfillment
United States (Bonded)	us	USD	State sales-tax nexus
European Union (Bonded)	eu	EUR	OSS / IOSS compliant
Russia (Bonded)	ru	USD	Bonded local DC
AliExpress Choice (Premium)	choice	USD	Strict 24h SLA

2026 Compliance Deltas

• EU One-Stop-Shop (OSS) for cross-border > EUR 150 single-VAT registration; Import One-Stop-Shop (IOSS) for shipments ≤ EUR 150 -- both surface on res.partner as eu_oss_vat_number and eu_ioss_number
• US sales-tax nexus (50 states) tracked on partners via us_sales_tax_nexus_states; leverages Odoo 19 US localization for the actual rates
• UK VAT post-Brexit -- uk_vat_number on partners; UK orders treated as third-country exports
• KSA ZATCA Phase 2 -- honors vat_registration_number + cr_number on partner; e-invoice XML / QR generation delegates to Odoo's KSA localization
• Brazil RFB -- CPF (11 digits, individuals) + CNPJ (14 digits, companies) regex-validated on partners
• AliExpress Choice (2026 Premium Program) -- strict 24h handling SLA + 5-10 day end-to-end delivery, modeled as aliexpress.fulfillment.program with computed SLA violations + compliance percentage
• AE-Affiliate API commission tracking on every settlement -- affiliate_commission Monetary field on aliexpress.settlement plus commission ledger line type for affiliate payout reconciliation
• Cainiao Logistics Tracking -- carrier is_cainiao flag and {tracking_no} URL template for global.cainiao.com deep links from the order form

Prerequisites

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

Installation

1. Download the module ZIP from your ECOSIRE Dashboard, or pull the source from github.com/ecosire/aliexpress_store_management
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 "AliExpress Store Management" and click Install
6. Enter your ECOSIRE licence key when prompted

Configuration

The connector works with your own AliExpress Open Platform application -- ECOSIRE never proxies or holds your credentials.

Step 1: Register your AliExpress Open Platform App

1. Sign in at the AliExpress Open Platform
2. Create a new application -- record your App Key and App Secret
3. Request the necessary API permissions (Product, Order, Logistics, Finance, Affiliate)
4. Note your sandbox vs production environment

Step 2: Connect in Odoo

1. Navigate to AliExpress → Configuration → New
2. Enter:
   • App Key -- your AliExpress application key
   • App Secret -- your application secret (stored encrypted, groups='base.group_system')
   • Sign Method -- HMAC-SHA256 (recommended) or HMAC-MD5
3. Click Authorize to launch the OAuth2 flow -- the Access Token and Refresh Token populate automatically
4. Click Test Connection -- the wizard runs a live round-trip against aliexpress.solution.seller.account.info.get

Step 3: Run the 5-Step Onboarding Wizard

1. Credentials -- App Key + App Secret + Access Token + sign method check
2. Ship-From Country -- CN / US / EU / RU
3. Ship-To Regions -- top destination ISO-2 country codes
4. AliExpress Choice Opt-In -- toggle premium delivery program enrolment
5. Test Connection -- live round-trip plus rate-limit budget probe

Step 4: Configure Sync Settings

Product Sync

• Bidirectional sync between AliExpress catalog and Odoo products
• Sync interval: 15 min / 30 min / hourly / 6h / 12h / daily (configurable per-configuration)
• Multi-language listing fields (EN + RU/ES/FR/DE/PT)
• GTIN required + choice_eligible flag for Choice program enrolment

Inventory Sync

• Map Odoo warehouses to aliexpress.location (CN origin / US-EU-RU bonded / Choice hubs)
• Real-time stock updates with auto-sync on changes

Order Sync

• Auto-import orders with region routing
• Cainiao tracking number propagation to stock.picking
• Per-region auto-workflow rules (auto-confirm / auto-invoice / auto-deliver)

Settlement Sync

• Reads aliexpress.solution.finance.order.statement.get and withholding.tax.list.get
• AE-Affiliate API commission tracked alongside gross sales
• Automatic JE posting with one-to-many ledger lines

Initial Sync

1. Open AliExpress → Operations → Initial Import
2. Select data types: Products / Customers / Orders / Settlements
3. Set the date range for historical orders
4. Click Start Import -- monitor progress in AliExpress → Sync Log
5. Use AliExpress → Queue Monitor for retry / cancel / flush controls (manager-only)

API Details

Field	Value
Auth method	HMAC-SHA256 (recommended) -- HMAC-MD5 still supported for legacy apps
Sign type	TOP-API standard signed-request envelope
OAuth	OAuth2 Access Token + Refresh Token (auto-refresh by the module)
Rate limits	Sliding-window per-method QPS limiter + 5,000 calls/day app cap
Webhook	TOP message subscription (async push with HMAC validation)
Required scopes	Product / Order / Logistics / Finance / Affiliate
Key config fields	app_key, app_secret, access_token, refresh_token (all encrypted, system-group only)

Dashboard

The OWL 2 dashboard at AliExpress → Dashboard ships five region tabs -- CN, US, EU, RU, Choice -- each rendering:

• Revenue trend (Chart.js line) over a configurable period (Today / 7d / 30d / 90d / Year / Custom)
• Order status pie showing distribution across order states for the region
• AliExpress Choice SLA gauge -- compliance percentage with red/amber/green thresholds
• Top 10 products by GMV for the period
• Settlement balance -- pending / received / disputed
• Region-aware CSS via ae_region_* class prefix

Plus across the dashboard:

• Activity feed with sync log entries colour-coded by type
• Quick action buttons for Products, Orders, Customers, Settlements, Queue, Logs, Settings
• Status footer with Queue Jobs, Errors, Out of Stock, Sync Rate
• Auto-refresh every 60 seconds, dark-mode aware

Daily Digest

aliexpress.digest mails a daily HTML summary at 06:00 server time with per-region GMV / orders / refunds / SLA compliance. Configure recipients under AliExpress → Configuration → Digest.

Troubleshooting

Issue	Solution
Connection failed	Verify App Key + App Secret; confirm OAuth2 access token is fresh; check the Open Platform app has required scopes
Sync not running	Check Odoo scheduled actions; confirm the configuration is Active and within rate-limit budget
Duplicate products	Review SKU + GTIN matching in Configuration → Mapping
Orders not importing	Verify region routing rules and date range; check aliexpress.queue for stalled jobs
Token expired	Module auto-refreshes via refresh_token; if it fails, re-run the Authorize flow
Signature error	HMAC-SHA256 vs HMAC-MD5 mismatch -- verify the sign method on your Open Platform app matches the configuration
Choice SLA breach	Open the order → Fulfillment Program tab; SLA gauge surfaces violations with timestamps
Affiliate commission missing	Confirm AE-Affiliate API is enabled on your Open Platform app; settlements without commission are logged in aliexpress.sync_log
OSS / IOSS not applied	Check eu_oss_vat_number / eu_ioss_number on the customer partner; threshold is EUR 150 cross-border
ZATCA Phase 2 not generating	Module delegates to Odoo's KSA localization -- verify l10n_sa_edi is installed
Licence not active	Verify your ECOSIRE licence key under Settings → ECOSIRE Licence

Live Demo

Try the connector on our sandbox at aliexpress.demo.ecosire.com -- request a login from [email protected].

Source

LGPL-3 source on GitHub: github.com/ecosire/aliexpress_store_management.

Support

• General Troubleshooting
• Email: [email protected]
• Support Portal

---

AliExpress Store Management v19.0.2 -- LGPL-3 -- Built by ECOSIRE (PRIVATE) LIMITED -- ecosire.com