Skip to main content

Rakuten Store Management

The ECOSIRE Rakuten Store Management module connects your Rakuten seller accounts with Odoo through the official Rakuten Marketplace API. Manage products, orders, inventory, and fulfillment across Rakuten's four regional marketplaces (Japan, US, France, and Germany) from a single Odoo instance. With access to over 100 million members, integrated loyalty points program support, and automated settlement reconciliation, this module helps you tap into one of the world's largest e-commerce ecosystems while keeping your ERP data synchronized and accurate.

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

Key Features​

  • Rakuten Marketplace API integration
  • 4 regional markets supported (Japan, US, France, Germany)
  • Access to 100M+ member base
  • Points program integration (Super Points / Rakuten Points)
  • Shipping method mapping
  • Category management
  • Product content rules enforcement
  • Order lifecycle tracking
  • Settlement reports and reconciliation
  • Campaign management (Super Sale, Marathon, etc.)

Prerequisites​

  • Odoo 17, 18, or 19 (Community or Enterprise edition)
  • An active ECOSIRE license for this module
  • A Rakuten seller account with API access on one or more regional marketplaces
  • API credentials (ServiceSecret and LicenseKey) from Rakuten RMS or equivalent regional portal

Installation​

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

Configuration​

Step 1: Obtain Rakuten API Credentials​

  1. Log in to your Rakuten merchant portal (RMS for Japan, or the relevant regional seller portal)
  2. Navigate to API Settings or Developer Console
  3. Generate or locate your ServiceSecret and LicenseKey
  4. For Rakuten Japan (Ichiba), access the RMS API settings under Shop Management then API Configuration
  5. For Rakuten France/Germany, locate API credentials under Seller Dashboard then Technical Settings
  6. Note the marketplace-specific endpoint URLs for each region you plan to connect

Step 2: Connect in Odoo​

  1. Navigate to Rakuten Store Management then Configuration
  2. Click Add Marketplace and select your target region (Japan, US, France, or Germany)
  3. Enter your API credentials (ServiceSecret and LicenseKey) for the selected region
  4. Click Test Connection to verify connectivity
  5. Repeat for additional regional marketplaces if needed
  6. Configure your default warehouse and company mapping for each marketplace

Step 3: Configure Sync Settings​

Product Sync​

  • Choose sync direction: Rakuten to Odoo, Odoo to Rakuten, or bidirectional
  • Set sync interval: Scheduled (5/15/60 minutes)
  • Configure product field mapping and Rakuten category (genre) mapping
  • Define product content rules to meet Rakuten listing requirements
  • Map Rakuten item codes to Odoo product SKUs

Inventory Sync​

  • Map Odoo warehouses to Rakuten fulfillment channels
  • Set buffer stock quantities per marketplace
  • Enable scheduled stock updates
  • Configure allocation rules when selling across multiple Rakuten regions

Order Sync​

  • Enable automatic order import from each connected marketplace
  • Map Rakuten payment methods to Odoo payment journals
  • Configure shipping method mapping for each region
  • Set up Rakuten Points tracking on order lines

Initial Sync​

  1. Go to Rakuten Store Management then Operations then Initial Import
  2. Select the marketplace(s) to import from
  3. Choose data types to import (Products, Orders, Customers)
  4. Set date range for historical orders
  5. Click Start Import and monitor progress in the sync log

Dashboard​

The OWL 2 dashboard provides:

  • 6 KPI cards showing real-time sales, orders, and sync metrics per marketplace
  • Interactive Chart.js sales analytics with date and region filtering
  • Top products ranking by revenue across all connected Rakuten markets
  • Points program analytics showing loyalty impact on sales
  • Campaign performance tracking for promotional events
  • Live activity feed of recent sync operations

Troubleshooting​

IssueSolution
Connection failedVerify API credentials and check network connectivity
Sync not runningCheck Odoo scheduled actions (cron jobs) are enabled
Duplicate productsReview product mapping settings and matching rules
Orders not importingVerify order status filters and date range settings
Points not syncingConfirm Points program is enabled in your Rakuten seller account
Content rejectedReview Rakuten product content rules and required fields for your category

Support​

Last updated on