Tokopedia Store Management
The ECOSIRE Tokopedia Store Management module connects your Tokopedia seller account to Odoo over the Tokopedia FS (Fulfillment Service) API. Orders, listings, customers and stock levels are pulled into Odoo on a schedule you set, and the parts of the Tokopedia ecosystem that carry money — GoPay, GoPay PayLater, Dilayani Tokopedia, Affiliate commissions and the TokoCabang warehouse network — are modelled as Odoo records you can report on, rather than left as text in an order note.
Compatibility: Odoo 17/18/19 (Community or Enterprise)
Price: $499 (one-time, per Odoo version)
Current version: 17.0 → 17.0.2.4.0 · 18.0 → 18.0.2.4.0 · 19.0 → 19.0.2.4.0
2.4.0 — 2026-09-25: a hardening release that fixes 36 known real-world failure cases, each now covered by a regression test. The import takes the whole catalogue rather than the first page, two shops can no longer collide on the same external order id, orders keep their tax, shipping and marketplace currency, settlement statements classify commission, fees, discounts and refunds as separate figures, a partial sync is reported as partial instead of advancing the "last successful sync" stamp, and credentials and buyer data are redacted before they reach the logs. All three Odoo versions are built from the same code. Full notes on the installation and configuration page.
Key Features
- Order import with the marketplace's own status, fulfilment and affiliate attribution, and idempotent matching so a re-import updates rather than duplicates.
- Listing import with the Indonesian product title, sync state and last sync error visible on the standard product form.
- Activate / deactivate listings in bulk from the imported-products list.
- Customer import, mapped to Odoo contacts.
- Stock level sync on its own schedule.
- GoPay wallet transactions and GoPay PayLater (BNPL) plans, each as its own Odoo model with tenor, principal, instalment and repayment fields.
- Dilayani Tokopedia shipments.
- Affiliate creator commissions, with gross sale, rate and commission amount.
- TokoCabang warehouse network, with cross-province eligibility so an order can qualify for the shipping subsidy.
- Indonesian compliance fields — NPWP, KTP and BPJS on partners and invoices.
- Dashboard with sales, orders, customers, sync success rate and a sales trend, in your company's own currency.
- Honest failure reporting — a failed sync records why it failed and tells you, instead of reporting a clean run.
What this module does not do
Stated plainly, because these are commonly assumed of a marketplace connector:
- It does not push your Odoo catalogue to Tokopedia. Listings are imported and can be activated or deactivated; product creation, price updates and content editing on the marketplace are not part of this build.
- It does not receive real-time webhooks. The receiver exists and fails closed (see the installation guide); syncing is scheduled polling.
- It does not manage vouchers, flash deals or promotional campaigns, and does not reply to buyer chat.
- Historical settlement and statement reconciliation are not part of this build.
Platform status
Tokopedia's Open API is being retired into TikTok Shop: developer.tokopedia.com now redirects to the TikTok Shop Partner Center. Ten of the operations this connector records are still routed on the legacy FS host, and they are the ones the module calls. The rest answer 404 — the host no longer serves them. This connector keeps the legacy surface working for grandfathered partners; for new integrations use TikTok Store Management.
Prerequisites
- Odoo 17, 18 or 19 (Community or Enterprise)
- A Tokopedia seller account with FS (Fulfillment Service) API access
- Your API Client ID, Client Secret, FS ID and Shop ID from the Tokopedia seller dashboard
- The
requestsPython package in the interpreter that runs Odoo
Installation
- Download the module ZIP from your ECOSIRE Dashboard
- Extract to your Odoo addons directory:
unzip tokopedia_store_management_v19_*.zip -d /opt/odoo/addons/
- Restart the Odoo service:
sudo systemctl restart odoo
- Navigate to Apps, click Update Apps List
- Search for "Tokopedia Store Management" and click Install
There is no licence key and no separate module to install. The full installation and configuration guide, including the connection field table and the scheduled actions, is on the Tokopedia Store Management installation page.
Configuration
Step 1: Collect your Tokopedia credentials
From your Tokopedia seller account, note your Client ID, Client Secret, FS ID (Fulfillment Service ID) and Shop ID.
Step 2: Connect in Odoo
- Go to Tokopedia → Configuration → Settings.
- Enter the credentials above and save.
- Click Test Connection to verify — it tests exactly what is on the form and reports the platform's own error if it fails.
- Choose your Sync Frequency, which sets the interval the scheduled actions run at.
Step 3: Choose what syncs
Four switches on the connection record gate the automatic jobs — products, orders, customers and inventory. Turn on what you are ready for, one at a time.
Initial import
Use Tokopedia → Operations → Import Wizard to pull a first batch. Restrict it by date or by a handful of products, review the result, and only then let the scheduled actions take over. Failures are recorded on the sync log rather than raised at the user.
Dashboard
Tokopedia → Dashboard shows sales, order and customer counts, the sync success rate, and a sales trend for the selected period. Every figure is computed from the imported records and formatted in the store company's own currency — rupiah, normally, not a hardcoded dollar sign.
Compliance and reporting records
| Record | Menu | What it holds |
|---|---|---|
| GoPay transactions | Tokopedia → GoPay Transactions | Wallet movements with amount, fee, net amount and settlement state |
| PayLater plans | Tokopedia → PayLater Plans | BNPL plans with tenor, principal, monthly instalment and total repayable |
| Dilayani shipments | Tokopedia → Dilayani Shipments | Fulfilment-by-Tokopedia shipments |
| Affiliate commissions | Tokopedia → Affiliate Commissions | Creator attribution with gross sale, rate and commission |
| TokoCabang warehouses | Tokopedia → TokoCabang Warehouses | Your shipping hubs, with cross-province eligibility |
Troubleshooting
| Issue | Solution |
|---|---|
| Connection failed | Verify the Client ID, Client Secret, FS ID and Shop ID. A 401 is a credential problem; a 404 means the path is not routed for your partnership. |
| Sync not running | Check that the scheduled actions are enabled (Settings → Technical → Scheduled Actions) and that Odoo's cron worker is running. |
| Duplicate products | Check the existing records before re-running an interrupted first import. |
| Orders not importing | Verify the order status filters and date range settings. |
| Nothing appears on the dashboard | Confirm the demo or live data falls inside the selected period; the dashboard windows on the period you choose. |
| Amounts in the wrong currency | Set the store company's currency to IDR. |