Skip to main content

Jumia Store Management

The ECOSIRE Jumia Store Management module integrates your Jumia seller account with Odoo ERP. Jumia is Africa's leading e-commerce platform, often called "the Amazon of Africa," operating in 11 African countries including Nigeria, Egypt, Kenya, Morocco, South Africa, Ghana, Ivory Coast, Senegal, Tunisia, Uganda, and Tanzania. This module uses the Jumia Seller API to synchronize your product catalog, orders, and inventory across all Jumia markets.

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

Key Features​

  • Jumia Seller API integration with API key and Seller ID authentication
  • Bidirectional product synchronization (listings, variants, images, prices)
  • Automatic order import and fulfillment tracking
  • Real-time inventory synchronization
  • Multi-country support (NG, EG, KE, MA, ZA, GH, CI, SN, TN, UG, TZ)
  • Jumia Express (JEX) fulfillment support
  • Category mapping to Jumia taxonomy per country
  • Returns and customer claim management
  • Seller scorecard monitoring
  • Multi-company record rules for isolated data management

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Jumia seller account with API access for your target markets
  • API key and Seller ID from the Jumia Seller Center

Installation​

  1. Download the module ZIP from your ECOSIRE Dashboard
  2. Extract to your Odoo addons directory: 
    unzip ecosire-jumia-*.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 "ECOSIRE Jumia Store Management" and click Install
  6. Enter your ECOSIRE license key when prompted

Configuration​

Step 1: Obtain Jumia API Credentials​

  1. Log in to the Jumia Seller Center for your country (e.g., https://sellercenter.jumia.com.ng for Nigeria)
  2. Navigate to Settings then API Settings
  3. Note your Seller ID and API Key or contact Jumia Seller Support to activate API access
  4. If selling in multiple countries, repeat this process for each Seller Center

Step 2: Connect in Odoo​

  1. Navigate to Jumia Store Management > Configuration
  2. Create a new configuration and enter:
    • API Key (api_key) -- your Jumia seller API key
    • Seller ID (seller_id) -- your Jumia seller identifier
    • Country (country) -- target market (NG, EG, KE, MA, ZA, GH, CI, SN, TN, UG, TZ)
  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: Jumia to Odoo, Odoo to Jumia, or bidirectional
  • Set sync interval: scheduled (every 5, 15, or 60 minutes)
  • Configure product field mapping and category mapping per country

Inventory Sync​

  • Map Odoo warehouses to Jumia fulfillment settings (JEX or self-fulfillment)
  • Set buffer stock quantities to prevent overselling
  • Enable real-time stock updates on inventory changes

Order Sync​

  • Enable automatic order import
  • Map Jumia payment methods to Odoo payment journals
  • Configure shipment tracking sync for fulfillment updates

Initial Sync​

  1. Go to Jumia 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-SHA256 signed requests with API key and Seller ID
NG endpointhttps://sellercenter-api.jumia.com.ng/v2
EG endpointhttps://sellercenter-api.jumia.com.eg/v2
KE endpointhttps://sellercenter-api.jumia.co.ke/v2
Base patternhttps://sellercenter-api.jumia.{country_tld}/v2
Key config fieldsapi_key, seller_id, country

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 key and seller ID; confirm the country endpoint is correct
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Products rejectedCheck product data completeness and country-specific category requirements
Orders not importingVerify order status filters and date range settings
Signature errorConfirm API key and signing algorithm match Jumia's specification
Wrong country endpointSelect the correct country code matching your Seller Center account
JEX inventory mismatchCheck JEX warehouse mapping settings
License not activeVerify your ECOSIRE license key at Settings > ECOSIRE License

Support​

Last updated on