Rakuten Japan Odoo Integration Guide

Rakuten Ichiba is Japan's largest online shopping mall with over 50 million active members and 55,000+ merchants. Unlike Amazon Japan which operates as a direct marketplace, Rakuten functions more like a virtual shopping mall where each seller operates a branded storefront within the Rakuten ecosystem.

Integrating Rakuten Ichiba with Odoo enables sellers to manage their Japanese marketplace operations with enterprise-grade ERP capabilities while respecting the unique conventions of Japanese e-commerce.

Understanding Rakuten Ichiba

Platform Characteristics

Rakuten Ichiba differs from Western marketplaces in several important ways. Each seller has a fully customizable storefront with unique branding, HTML-rich product pages with extensive product descriptions are the norm, the Rakuten Super Points loyalty program drives significant buyer behavior, seasonal promotions like Rakuten Super SALE drive massive traffic spikes, and gift wrapping (Noshi) and seasonal packaging are expected by Japanese consumers.

Seller Requirements

Selling on Rakuten Ichiba requires a Japanese legal entity or a fiscal agent in Japan, a registered bank account for Japanese Yen settlements, product liability insurance, Japanese language capability for customer service, and compliance with Japanese commerce regulations (Tokushoho).

R-Login API and RMS

Rakuten provides seller tools through RMS (Rakuten Merchant Server). The primary API is accessed through R-Login authentication. Key API capabilities include item management for product CRUD operations, order management for order processing and status updates, inventory management for stock level updates, and category and navigation management.

API Authentication

R-Login uses a unique authentication system specific to Rakuten. You receive a serviceSecret and licenseKey through your RMS account. API requests include these credentials along with a timestamp-based signature.

Product Management

Japanese Product Data Requirements

Japanese e-commerce has specific content expectations. Product titles should follow the format: Brand + Product Name + Key Feature + Size/Color in Japanese. Descriptions are typically very detailed, often 2000+ characters with extensive use of HTML formatting. Product images require both square format (main image) and lifestyle images. Size charts must follow Japanese sizing standards. Material and care information must comply with Japanese labeling laws.

Rakuten Product Categories

Rakuten uses its own category system called "Genre IDs." Map your Odoo product categories to Rakuten's genre tree, which has thousands of leaf categories. Accurate genre mapping affects search visibility and is required for listing approval.

Order Processing

Order Flow

| Stage | RMS Status | Odoo Action | |---|---|---| | Order received | New | Create sale order | | Payment confirmed | Paid | Confirm order | | Shipping prepared | Processing | Create picking | | Shipped | Shipped | Update tracking | | Delivered | Complete | Close order |

Japanese Shipping Conventions

Japanese consumers expect precise delivery time windows. Carriers like Yamato Transport, Sagawa Express, and Japan Post offer delivery time slots (gozen/gogo - morning/afternoon). Your integration must pass time preference data from Rakuten orders to Odoo delivery orders and then to your chosen carrier.

Carriers

| Carrier | Service Level | Coverage | |---|---|---| | Yamato Transport | Next-day, time-window | Nationwide | | Sagawa Express | Standard, express | Nationwide | | Japan Post | Yu-Pack, EMS | Nationwide + international |

Japanese Compliance

Tokushoho (Specified Commercial Transaction Act)

Japanese law requires sellers to display specific business information including seller name and address, return policy, payment methods, delivery timing, and pricing including tax. Your Rakuten store page must include this information, and your Odoo integration should help maintain consistency.

Japanese Consumption Tax

Japan's consumption tax is 10% (8% on certain food and beverage items). Rakuten displays tax-inclusive prices. Your Odoo fiscal position must be configured for Japanese tax rates, tax-inclusive display pricing, invoice generation following Japanese requirements, and proper handling of the reduced 8% rate.

Noshi and Gift Wrapping

Japanese consumers frequently request gift wrapping (Noshi) with specific formatting for different occasions (weddings, funerals, celebrations). Your integration should capture Noshi preferences from Rakuten orders and pass them to Odoo as special instructions on the delivery order.

Rakuten Super Points

Rakuten's loyalty point system significantly affects pricing strategy. Sellers can offer bonus points to increase visibility. Points are effectively a discount, so your Odoo pricing must account for the cost of points granted. Settlement reports deduct point costs from payouts.

Financial Reconciliation

Rakuten settles with sellers monthly. The settlement includes product sales minus commission (typically 2-7% of monthly sales), system usage fees, payment processing fees, point costs, advertising charges, and various service fees.

Import settlement data into Odoo and create journal entries that map each fee type to the appropriate expense account.

Summary and Key Takeaways

• Storefront customization is essential on Rakuten unlike other marketplaces
• Japanese content standards demand detailed, HTML-rich product descriptions
• Delivery time windows are expected by Japanese consumers
• Noshi and gift wrapping support adds complexity but is culturally important
• Rakuten Super Points affect pricing strategy and settlement calculations

Frequently Asked Questions

Do I need a Japanese entity to sell on Rakuten Ichiba?

Yes, Rakuten Ichiba requires either a Japanese legal entity or a registered fiscal agent in Japan. This is stricter than some other Japanese marketplaces. ECOSIRE can connect you with Japanese business setup partners.

How does Rakuten compare to Amazon Japan for sellers?

Rakuten offers more storefront customization and brand building opportunities, while Amazon Japan provides access to a larger buyer base with less effort. Many successful sellers operate on both platforms simultaneously, managed through a unified Odoo integration.

What commission does Rakuten charge?

Rakuten's commission structure is based on monthly sales volume, typically ranging from 2-7%. Additional fees apply for system usage, payment processing, and point programs. Total cost of selling is usually 10-15% of revenue.

---

Ready to sell on Rakuten Japan? ECOSIRE builds Odoo integrations tailored for the Japanese market with full Rakuten Ichiba support.