Skip to main content

Miravia Store Management

The ECOSIRE Miravia Store Management module integrates your Miravia seller account with Odoo. Manage products, orders, inventory, customers and payouts on Alibaba's Southern European marketplace (Spain, Portugal, Italy) directly from Odoo.

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

Key Features​

  • Miravia Open Platform API integration (OAuth)
  • Multi-store / multi-instance support
  • Bidirectional product sync (Odoo ↔ Miravia)
  • Variant + image + attribute mapping
  • Order import with status mapping and SLA tracking
  • Inventory sync with location mapping and stock buffers
  • Customer + address sync
  • Payout / settlement reports + reconciliation helpers
  • Webhook framework for near-real-time updates
  • OWL 2 real-time dashboard with KPIs and charts
  • License-mixin enforced — one key per Odoo SH or on-prem domain

Prerequisites​

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

Installation​

  1. Download the module ZIP delivered with your purchase.
  2. Extract miravia_store_management/ into your Odoo addons directory.
  3. Make sure ecosire_license_client/ is also on the addons path (ships in the same delivery).
  4. Restart Odoo and click Apps → Update Apps List.
  5. Search for ECOSIRE Miravia Store Management and click Install.
  6. Paste your license key when prompted, then click Activate.

Configuration​

Step 1: Get Miravia API credentials​

  1. Sign in to the Miravia Open Platform.
  2. Create a developer app and request the scopes you need (Products, Orders, Inventory, Customers, Logistics, Finance).
  3. Copy the App Key and App Secret.
  4. Generate a seller access token via the OAuth flow against your seller account.

Step 2: Create an instance in Odoo​

  1. Navigate to Miravia → Configuration → Instances.
  2. Click Create and fill in:
    • Instance name (e.g. Miravia ES — Main)
    • App Key, App Secret, Access Token, Refresh Token
    • Marketplace (ES / PT / IT)
    • Default warehouse, company, pricelist, and tax mapping
  3. Click Test Connection to verify.
  4. Save and click Activate Instance.

Step 3: Sync configuration​

  • Product Sync — choose direction (one-way / two-way), category mapping, and variant attribute mapping.
  • Inventory Sync — set the cron cadence (recommended 15 min), buffer stock, and oversell prevention thresholds.
  • Order Sync — map Miravia order statuses to Odoo sale order stages, configure payment journals and SLA timers.
  • Webhooks — enable webhook endpoints and register them with Miravia from the configuration form.

Initial Sync​

  1. Open Miravia → Operations → Initial Import.
  2. Pick the data types (Categories, Products, Orders, Customers, Inventory).
  3. Set the date range for historical orders.
  4. Click Start Import and monitor progress in the Queue Jobs / sync log.

Dashboard​

The OWL 2 dashboard renders:

  • KPI cards: revenue, orders, units, returns, average order value
  • Sales chart with marketplace and date filtering
  • Top sellers ranking with quick links to product mappings
  • Sync health: per-cron status, error counts, last successful run
  • Queue overview: pending, in-progress, failed jobs with retry shortcuts

Troubleshooting​

IssueLikely cause + fix
License is not valid for Odoo versionConfirm the key you pasted is the one issued for v19 (not a v17/v18 key) and that the connector module version matches v19.0.1.0.x.
Connection failedRe-check App Key / App Secret. Make sure the access token hasn't expired — the connector auto-refreshes via the refresh token.
Sync not runningOpen Settings → Technical → Scheduled Actions and confirm the Miravia cron jobs are active.
Duplicate productsAdjust the matching rule on the instance (default: external_id → internal_reference → barcode).
Orders missingVerify the order status filter and date range on the Order Sync section.

Support​