Rakuten Store Management
The ECOSIRE Rakuten Store Management module connects a Rakuten Ichiba (Japan) shop to Odoo through the Rakuten RMS API. It imports your item catalogue and your orders — with buyer, shipping address and payment evidence — into Odoo, and gives you a company-scoped dashboard and sync log so you can see what came across and when.
This page is the short overview. The installation and configuration guide covers the connection record, the scheduled actions and troubleshooting in detail.
| Odoo versions | 17.0 / 18.0 / 19.0 (Community or Enterprise) |
| Current shipped version | 17.0 → 17.0.2.2.4, 18.0 → 18.0.2.2.4, 19.0 → 19.0.2.3.2 |
| Price | $499 USD — one-time, per Odoo version |
| Licence | OPL-1 — no activation key, no external licence service |
What it does
- Product catalogue import from RMS item search, matching existing Odoo products on the Rakuten item number, the merchant SKU (
manageNumber), the barcode, or the name, and creating only what is genuinely new. - Hydrated order import. RMS exposes orders in two steps — a search that returns order numbers and a detail call that returns the full envelope. The connector does both and refuses an order whose detail never arrived, rather than importing a half-order.
- Buyer and shipping-address creation from the order payload, deduplicated on the Rakuten customer id, so a returning buyer does not become a new contact on every order.
- Japan compliance helpers. Consumption-tax rate per product (10% / 8% reduced) and validation of the 14-character JP Qualified-Invoice number (適格請求書発行事業者) on partners.
- A company-scoped dashboard and a per-run sync log, so a sync that fails part-way is visible rather than silent.
- API Coverage screen, under Rakuten → Operations, listing every RMS operation the platform contract names next to whether this connector calls it — so the boundary is visible before you trust a sync.
What it does not do
Stated plainly, because these are the questions buyers ask:
- Rakuten Ichiba Japan only. Rakuten Rewards and the former EU marketplaces (France, Germany, Spain) use separate APIs and are not supported. The module refuses a non-Japan region at the model level.
- No inventory push, no coupon/promotion sync, no webhooks, no R-Points, no RSL, no refund or settlement import. Rakuten publishes no webhook surface, and the remaining operations are not wired to a verified payload mapping. The API Coverage screen names each of them and what the connector does instead.
- No standalone customer list. RMS has no buyer-list API; buyers are imported from complete order payloads. The Settings screen says so rather than offering a switch that does nothing.
Requirements
- Odoo 17.0, 18.0 or 19.0 — Community or Enterprise. Self-hosted or Odoo.sh. Odoo Online (SaaS) cannot install third-party modules.
- A Rakuten Ichiba seller account with RMS API access.
- Your shop's serviceSecret and licenseKey from the RMS R-License page.
- The Python
requestslibrary in the interpreter that runs Odoo.
Currency — read this before your first sync
RMS quotes in JPY. If the Odoo company you are importing into keeps its books in another currency, configure the JPY exchange rate (Accounting → Configuration → Currencies) before the first sync.
The connector converts every amount — order lines, shipping, discounts and catalogue prices — into the company currency, and refuses the import when no rate is available for the order date rather than booking yen at face value. That refusal is deliberate: a silent 1:1 assumption produces books that look plausible and are wrong.
Installation
- Download the ZIP from your ECOSIRE dashboard.
- Extract it so that
rakuten_store_management/__manifest__.pysits directly inside your addons path. - Restart Odoo and click Update Apps List.
- Search for Rakuten Store Management and click Install. There is no licence key to enter and no separate module to download first.
Full steps, including the connection record and the scheduled actions, are in the configuration guide.