Skip to main content

TikTok Shop Store Management - Installation

This page covers installation and licensing. For the exact supported API boundary, synchronization behavior, historical order backfill, Affiliate API permission requirement, and troubleshooting, use the TikTok Shop workflow guide.

ItemCurrent release
Technical nametiktok_store_management
Odoo 1717.0.2.9.17
Odoo 1818.0.2.9.17
Odoo 1919.0.2.9.17
EditionsCommunity and Enterprise
Required ECOSIRE dependencyecosire_license_client
Python dependencyrequests

The connector implements a verified subset of TikTok Shop seller operations. It does not claim the complete Open API, provider LIVE viewer or engagement metrics, provider webhook-subscription CRUD, or shipment/tracking push from Odoo to TikTok Shop.

Install​

  1. Download the archive matching your Odoo major version from the ECOSIRE Dashboard.
  2. Download the matching ecosire_license_client archive.
  3. Extract both top-level module folders into an Odoo addons directory.
  4. Install requests into the same Python environment that runs Odoo.
  5. Restart Odoo, update the Apps list, and install TikTok Shop Store Management.

Example for Odoo 19:

unzip ecosire_license_client_v19_*.zip -d /opt/odoo/addons/
unzip tiktok_store_management_v19_*.zip -d /opt/odoo/addons/
sudo -u odoo pip install requests
sudo systemctl restart odoo

The module directory must contain __manifest__.py directly under tiktok_store_management/; avoid an extra nested folder.

Upgrade an existing database​

Copy the new module source into the addons path, restart Odoo, and run an Apps upgrade for TikTok Shop Store Management. Copying files without upgrading does not load new fields, views, data, or migrations.

For a production database, take a restorable backup before the upgrade and verify afterward that Apps shows the expected version and the Odoo update log contains no module-load errors.

Activate the ECOSIRE license​

  1. Confirm web.base.url contains the real public HTTPS URL of the database.
  2. Open Settings → ECOSIRE.COM → Activate License.
  3. Enter the license key and choose TikTok Shop Store Management.
  4. Activate, then verify the module status in License Status.

Activation limits and Odoo-version entitlement are defined by the individual license. Use the ECOSIRE Dashboard or License Status as the source of truth; this guide does not assume a price or a fixed number of domain slots.

Connect TikTok Shop​

  1. Create or select the seller application in TikTok Shop Partner Center.
  2. Obtain approval for the scopes required by the workflows you will enable.
  3. In Odoo, open TikTok Shop → Configuration.
  4. Enter the protected application credentials and shop identity, assign the Odoo company, and select the region matching the shop.
  5. Complete authorization and use Test Connection.
  6. Enable only the synchronization areas approved for that application.

Affiliate Seller synchronization needs TikTok's Affiliate API read permission; a normal seller authorization does not include it automatically. TikTok error 105005 indicates that provider-app permission is missing.

First production verification​

  1. Run a small product or order synchronization and inspect the sync log.
  2. Verify imported order dates and company currency.
  3. If historical orders are required, set the one-off backfill range, run Sync Orders, confirm the oldest order date, then clear the range.
  4. Run only the Finance, Analytics, Returns, Promotions, Affiliate Seller, and FBT actions for which the Partner Center app has approved access.

Support​

Last updated on