AliExpress (Global)
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 |
| Current release | 19.0.2.1.2 on Odoo 19 (17.0 and 18.0 builds also available) |
| Compatibility | Odoo 17 / 18 / 19 -- Community + Enterprise -- On-Premise + Odoo.sh |
| Price | USD 499 (one-time, per Odoo version) |
| License | OPL-1 |
| Author | ECOSIRE (PRIVATE) LIMITED |
For step-by-step installation, connection, webhook setup and troubleshooting, see the full AliExpress Store Management guide.
Key Features
Capability areas
- Orders -- Full order lifecycle (placed → finish → returned) with region routing, ship-to-country ISO-2, Cainiao tracking number, AliExpress Choice flag for SLA monitoring. Imported orders appear in Odoo as native sale orders, each with an AliExpress page showing the platform status, Choice flag and ship-to country.
- Products -- Multilingual listings (EN + RU/ES/FR/DE/PT), GTIN-required flag, Choice eligibility, approval state mirror, and a computed compliance-ready flag that warns before you publish a listing missing a barcode, English title, price or taxes.
- Product images -- Photobank tracker (CDN URL + sequence + state).
- Customers -- Masked buyer profiles (AliExpress masks PII; the masked payload is stored verbatim).
- Collections -- Category tree mirror with self-referential parent/child.
- Locations -- CN origin / US-EU-RU bonded / AliExpress Choice hubs.
- Carriers -- Cainiao logistics: the carrier record resolves the seller's tracking template, falling back to the public Cainiao tracker, surfaced as a tracking URL on the order.
- Returns and refunds -- Return lifecycle (created → received → refunded); refunds linked to their Odoo credit note.
- Risk -- Fraud scoring per order (flagged when score ≥ 0.7).
- Settlements -- Finance ingestion plus AE-Affiliate commission tracking; one-to-many ledger lines (sale / fee / tax / commission / adjustment / payout).
- Analytics -- Per-region daily aggregates (GMV, orders, refunds, Choice orders, affiliate commission).
- Workflows -- Per-region auto-confirm / auto-invoice / auto-deliver rules (e.g. Choice may auto-deliver on shipped while CN waits for buyer-confirm). Posted invoices are created for the prepaid marketplace orders the run produces.
- Choice fulfillment programs -- Dedicated AliExpress Choice SLA tracker: handling-hours and delivery-days thresholds count real violations (orders pre-dispatch past handling, still open past delivery, plus returns) with a compliance percentage.
Multi-Region Runtime
| Region | Code | Notes |
|---|---|---|
| China (Origin) | cn | Primary fulfillment |
| United States (Bonded) | us | State sales-tax nexus |
| European Union (Bonded) | eu | OSS / IOSS compliant |
| Russia (Bonded) | ru | Bonded local DC |
| AliExpress Choice (Premium) | choice | Strict handling + delivery SLA |
2026 Compliance Deltas
All identifiers below are editable on the contact's AliExpress page in the Odoo form:
- EU One-Stop-Shop (OSS) for cross-border > EUR 150 and Import One-Stop-Shop (IOSS) for shipments ≤ EUR 150 --
eu_oss_vat_numberandeu_ioss_numberon partners - US sales-tax nexus (50 states) tracked on partners via
us_sales_tax_nexus_states; leverages Odoo's US localization for the actual rates - UK VAT post-Brexit --
uk_vat_numberon partners; UK orders treated as third-country exports - KSA ZATCA Phase 2 -- honors
vat_registration_number+cr_numberon the partner; e-invoice XML / QR generation delegates to Odoo's KSA localization - Brazil RFB -- CPF and CNPJ identifiers on partners
- AE-Affiliate API commission tracking on every settlement --
affiliate_commissionon the settlement plus acommissionledger line type for affiliate payout reconciliation
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- An AliExpress seller account with Open Platform access
- Your own AliExpress Open Platform application (App Key + App Secret)
Getting Started
- Install -- download the ZIP for your Odoo version from your ECOSIRE Dashboard or the Odoo App Store, extract it into your addons directory, restart Odoo and install AliExpress Store Management from Apps. It installs standalone -- there is no licence key to activate.
- Register your AliExpress Open Platform App at the AliExpress Open Platform -- record your App Key and App Secret and request the API areas you will use (product, order, logistics, finance, affiliate).
- Connect in Odoo -- create a configuration under AliExpress → Configuration → Settings with App Key, App Secret and the OAuth Access / Refresh Tokens from your application, then run Test Connection until the instance reads connected. The 4-step onboarding wizard (Configuration → Onboarding Wizard) walks through the same flow: Credentials (with sign method), Ship-From Country, AliExpress Choice opt-in, Test Connection.
- First import -- AliExpress → Operations → Import Wizard; start with a small date range, review the mappings (categories, order statuses, payment and shipping methods), and watch the Logs view before letting the scheduled actions take over.
- Webhook (optional) -- register
https://<your-odoo-host>/aliexpress/webhookas your message-subscription destination. It needs one Active webhook record holding the platform's Secret Key -- a one-time setup by your Odoo administrator or ECOSIRE support, detailed in the full guide. Unverified deliveries are rejected with HTTP 403.
Full details: the AliExpress Store Management guide.
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-refreshed by the module) |
| Rate limits | Sliding-window per-second and per-method QPS limiter + 5,000 calls/day app cap, with backoff and retry on throttling |
| Gateway | api-sg.aliexpress.com -- /sync for TOP methods, /rest for OAuth tokens |
| Webhook | TOP message subscription (async push with signature validation, fail-closed) |
| Key config fields | app_key, app_secret, access_token, refresh_token (masked, System group only) |
Dashboard
AliExpress → Dashboard renders KPI tiles computed from your real records -- total sales, orders, average order value, customers, imported products, out-of-stock listings, sync success rate -- each with its change versus the previous period and in your active company's currency. Period filters cover today / 7 days / 30 days / 90 days / year / custom range. The sales-trend and order-status charts drill down to the underlying AliExpress orders on click, Top Products ranks your five best sellers by the revenue of their real order lines, and an activity feed streams the latest sync log entries. The dashboard auto-refreshes every 60 seconds, and with no configuration yet it explains itself and links to Settings instead of showing empty numbers.
Daily Digest
A daily scheduled action mails an HTML summary of activity; configure it under AliExpress → Finance → Daily Digests.
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify App Key + App Secret; confirm the OAuth access token is fresh; check the Open Platform app has the required API areas enabled |
| Sync not running | Check Odoo scheduled actions; confirm the configuration is Active |
| Duplicate products | Review SKU + GTIN matching in Operations → Mapping Wizard |
| Orders not importing | Verify the date range of your import; a single bad record is contained and logged -- read the Logs view |
| Token expired | The module auto-refreshes via the refresh token; if that fails, re-run the OAuth consent flow and update the tokens |
| Signature error | HMAC-SHA256 vs HMAC-MD5 mismatch -- verify the sign method on your Open Platform app matches the onboarding wizard |
| Choice SLA breach | Open Logistics → Fulfillment Programs (Choice SLA); violations count orders pre-dispatch past the handling threshold, still open past the delivery threshold, and returns |
| Export or stock push refuses | Product and inventory export to AliExpress is not implemented -- the connector is import-first by design |
Live Demo
Try the connector on our sandbox at aliexpress.demo.ecosire.com -- request a login from [email protected].
Support
- Full installation & configuration guide
- General Troubleshooting
- Email: [email protected]
- Support Portal
AliExpress Store Management 19.0.2 -- OPL-1 -- Built by ECOSIRE (PRIVATE) LIMITED -- ecosire.com