Daraz Store Management
Connect your Daraz seller account to Odoo through the Daraz Open Platform API. Built on Lazada's API infrastructure, this module uses HMAC-SHA256 signed requests with country-specific endpoints to synchronize products, orders, and inventory across all Daraz markets (Pakistan, Bangladesh, Sri Lanka, Myanmar, and Nepal).
Compatibility: Odoo 17 / 18 / 19
Price: $499 (one-time, per Odoo version)
License: OPL-1 — no activation key, no licence client, the module runs standalone
Current version: 19.0.9.8.0. The 18.0 and 17.0 builds are published at 18.0.9.7.2 and 17.0.9.7.2 and do not yet include the 9.8.0 API-coverage release.
See the detailed install & configuration guide for requirements, scheduled actions, and troubleshooting.
Key Features
- Daraz Open Platform API integration (based on Lazada API)
- HMAC-SHA256 request signing
- Multi-country support: Pakistan, Bangladesh, Sri Lanka, Myanmar, Nepal
- Country-specific API endpoints
- Product sync: import Daraz listings, link to existing Odoo products by Seller SKU (no duplicates), and push stock + price back to Daraz
- Product export: create real Daraz listings from Odoo (per-variant Seller SKUs, price, quantity, category-required attributes)
- Automatic order import and fulfillment tracking
- Inventory synchronization in both directions (Daraz → Odoo mirror, Odoo → Daraz stock + price push)
- Order pricing fidelity: the Daraz paid price is kept, platform-funded vouchers preserved as seller revenue
- Category mapping with Daraz taxonomy
- Voucher and special-price handling on imported orders and catalogue prices
- Complete documented API coverage: every operation the Daraz Open Platform catalog publishes (122 across all 13 categories) is callable through the connector — the 20 the module automates have typed helpers, and the rest are issued through a validated dispatcher that signs them the same way and refuses anything Daraz does not publish
Prerequisites
- Odoo 17, 18, or 19 (Community or Enterprise edition)
- A Daraz seller account (daraz.pk, daraz.com.bd, daraz.lk, etc.)
- Daraz Open Platform App Key and App Secret
No licence activation is required — install the module and configure your store.
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip daraz_store_management_v*.zip -d /opt/odoo/addons/
- Restart the Odoo service:
sudo systemctl restart odoo
- Navigate to Apps, click Update Apps List
- Search for the module and click Install
Configuration
Step 1: Obtain Daraz API Credentials
- Go to the Daraz Open Platform for your country
- Register as a developer and create an application
- 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 Daraz > Configuration > Settings
- Create a new configuration and enter:
- App Key (
app_key) -- Daraz application key - App Secret (
app_secret) -- Daraz application secret - Access Token (
access_token) -- OAuth access token - Refresh Token (
refresh_token) -- for automatic renewal - Country (
country) -- select PK, BD, LK, MM, or NP
- App Key (
- Click Test Connection to verify API access
- Set the Warehouse Daraz stock mirrors into, and review the sync toggles
Step 3: Configure Sync Settings
Product Sync
- Import Daraz listings into Odoo and push stock + price back to Daraz.
- Create brand-new Daraz listings from Odoo: set a Daraz Category (per product, or once per Odoo category under Configuration → Category Mapping), click Fetch Required Attributes, fill the required key/values, then Export to Daraz — single products from the product form or in bulk via Operations → Export Wizard.
- Set the sync frequency on the store: every 15 or 30 minutes, 1, 6 or 12 hours, or daily (default hourly)
- Configure product field mapping and category mapping
Inventory Sync
- Decide which system owns stock: Sync Inventory (Daraz → Odoo) mirrors Daraz quantities into your warehouse; Push Inventory (Odoo → Daraz) (toggle
auto_push_inventory) writes Odoo stock + price back to Daraz - Map the store to one Odoo warehouse
- Rehearse both directions with Sandbox Mode on before going live
Order Sync
- Enable automatic order import (30-minute scheduled sync by default)
- Set Sync Orders From Date so scheduled syncs never import orders created before that date (the Historical Import wizard bypasses it for backfills)
- Map Daraz payment methods to Odoo records under Configuration → Mappings
- Configure fulfillment sync to push tracking numbers
Initial Sync
- Go to Daraz > Operations > Import Wizard
- Select data types to import (Products, Customers, Orders)
- For older orders, use Daraz > Operations > Import Historical Orders and set the date range
- Click Start Import and monitor progress in the sync log
Map products to your existing catalogue
If you already keep your products in Odoo and want Daraz to link to them — not create duplicates, and not split a variant product into copies:
- Open your store under Configuration → Settings and set "Create Missing Products" = OFF.
- Make each Odoo product's Internal Reference (
default_code) — or Barcode — equal to its Daraz Seller SKU. For variant products, set it on each variant. - Daraz → Operations → Import Product Mapping (Excel/CSV) → Match By = Seller SKU → run Preview only, review the log, then run Only update existing products. Matching products are linked to the store; no new products are created. The template carries
sizeandcolorcolumns so each Seller SKU binds to its own variant. - For orders that arrived before mapping (flagged "Needs Product Mapping"), open the order and click Re-map Daraz Products.
Variant listings (several SKUs under one Daraz product) become one Odoo product with proper variants, on every import path.
👉 Full self-serve walkthrough: Store Connector Setup & Product Mapping.
Fulfilment — push status & print labels
From a Daraz order in Odoo:
- Mark Packed — set the Shipment Provider field first (e.g. "Daraz Express"); Daraz rejects a pack request with no provider.
- Ready to Ship — pushes RTS with optional carrier + tracking number.
- Print AWB / Print Invoice — fetches the PDF from Daraz and attaches it to the order.
API Details
| Field | Value |
|---|---|
| Auth method | HMAC-SHA256 signed requests + OAuth tokens |
| PK endpoint | https://api.daraz.pk/rest |
| BD endpoint | https://api.daraz.com.bd/rest |
| LK endpoint | https://api.daraz.lk/rest |
| MM endpoint | https://api.shop.com.mm/rest |
| NP endpoint | https://api.daraz.com.np/rest |
| Signature | HMAC-SHA256 over sorted params with api_path prefix |
| Key config fields | app_key, app_secret, access_token, refresh_token, country |
Dashboard
The built-in OWL 2 dashboard provides real-time visibility into your integration:
- Store selector for merchants running several Daraz stores — every KPI, chart and top-products list switches with it
- KPI cards -- Revenue, Orders, Customers, Products (+ a variant count), Avg Order Value, and Sync Health -- with period-over-period deltas, in the store's own currency
- Sales Trend chart (Chart.js line chart) with interactive date filtering
- Order Status breakdown (doughnut chart) driven by the real Daraz order status
- Top Products scoped to the selected store
- 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 actions 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, announced loading/error states and a setup-required empty state
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify API credentials; check network connectivity |
| Sync not running | Check Odoo scheduled actions (cron jobs) are enabled and the store's auto-sync toggles are on |
| Duplicate products | Set Create Missing Products = OFF and map by Seller SKU — see Map products to your existing catalogue |
| Variants split into separate products | Set each variant's Internal Reference to its own Daraz Seller SKU, then Re-map Daraz Products |
| Mark Packed: "status not updated" | Set the Shipment Provider on the order and confirm Sandbox Mode is OFF |
| AWB will not print | Confirm Sandbox Mode is off and the order has live Daraz item IDs, then retry |
| Orders not importing | Verify order status filters, the Sync Orders From Date floor, and the date range settings |
| Order imported with blank Daraz status | Daraz sent a status not yet mapped — it is logged by name; the order still imported |
| Wrong country endpoint | Verify the Country field matches your Daraz seller account region |
| Signature error | Check app_secret matches your Open Platform application |
| Token expired | Module auto-refreshes; verify refresh_token is still valid |
Odoo 17 install raises ValueError: Wrong value for ir.actions.act_window.view.view_mode: 'list' | Upgrade to daraz_store_management 17.0.5.0.1 or newer — fixed 2026-05-10. See common issues |