Odoo TikTok Shop Integration: What Syncs and What Doesn't

Does Odoo integrate with TikTok Shop?

Yes. Odoo ships a native TikTok Shop Connector. It pulls seller-fulfilled TikTok Shop orders into Odoo as sales orders, pushes your available stock back to TikTok Shop, and attaches shipping labels and tracking numbers to the matching delivery orders.

Three facts decide whether it fits your shop:

• Version: Odoo documents the connector for 19.0 and the releases after it. The Odoo 18 documentation has no TikTok Shop page.
• Edition: the connector is not part of the open-source Community code. The 19.0 branch of Odoo's public repository contains no TikTok module (checked on 7 October 2026), so plan on Odoo Enterprise.
• Scope: it is an order and inventory sync, not a full TikTok Shop back office. Refunds, disputes and fee reports stay on TikTok's side.

The rest of this guide covers what syncs and how often, the setup, the limits that are easy to miss, and what to do on Community or an older version.

What the Odoo TikTok Shop connector syncs, and how often

The sync is not real time. Odoo runs each data type on its own schedule:

Orders, labels, inventory and catalog can also be synced by hand with their buttons on the shop record. The intervals come from Odoo's TikTok Shop order management documentation.

Two wording traps in the official docs:

• FBS and FBM mean the same thing here. One page says Fulfilled By Seller, another says Fulfilled By Merchant. Both mean you ship the parcel yourself.
• Partner Center is the developer portal. You create the API app there. Daily seller work such as arranging shipment or bulk editing products happens in Seller Center, the seller-xx.tiktok.com sites the docs list per country.

Which TikTok Shop markets Odoo supports

Odoo lists 16 TikTok Shop marketplaces for the connector:

The connector supports several seller accounts, with one marketplace per account. A brand selling in Germany, France and Spain therefore sets up three shop records in Odoo, each with its own warehouse rule and sales team.

How to connect TikTok Shop to Odoo

You need a TikTok Shop Seller account, a separate TikTok Shop Partner Center account, a short description of what the integration is for, and your Odoo database URL with a tester login.

1. Register in Partner Center. Choose Add category and market, pick App developers (ISV) as the business category, fill in region and target market, then click Get app key now and wait for approval.
2. Create the app. Under App & Service, set the type to Custom and the service category to eCommerce Management / Connectors. Turn Enable API on.
3. Set the redirect URL to https://<your database url>.odoo.com/tiktok/return_from_authorization.
4. Enable eight API scopes under Manage API: Finance Information, Fulfillment Basic, Logistics Basic, Order Information, Product Basic, Product Modify, Shop Authorized Information, Global Shop Information.
5. Publish the app and copy the Service ID, App key and App secret.
6. Install the connector in Odoo. In Apps, search for TikTok Shop Connector and activate it.
7. Connect the shop. Go to Sales → Configuration → Shops, click Connect New Shop, and enter the three credentials. Log in with the seller account you want to link.
8. Re-authorize. Back in Odoo, click Re-authorize Shop to obtain a fresh refresh token.
9. Configure before go-live. Set the FBS Warehouse, run Sync Catalog, and only then enable inventory sync.

Field names and screenshots are in Odoo's TikTok Shop connector configuration guide.

SKU mapping: the rule that keeps stock correct

The TikTok Shop Seller SKU must match the Odoo Internal Reference of the product or variant exactly. A trailing space or a different letter case is a mismatch.

The failure is quiet. When Odoo cannot find the product, it books the order line on a default product instead. The order still appears, so nothing looks broken, but the real item's stock does not move and the next stock push can send TikTok Shop a quantity that is too high.

Check your references before the first sync. On a self-hosted or Odoo.sh database, run this in the Odoo shell:

from collections import Counter

products = env['product.product'].search([('sale_ok', '=', True)])
refs = products.mapped('default_code')

missing = [p.display_name for p in products if not p.default_code]
duplicates = [r for r, n in Counter(r for r in refs if r).items() if n > 1]
padded = [r for r in refs if r and r != r.strip()]

print('No Internal Reference:', len(missing))
print('Duplicate references:', duplicates)
print('References with stray spaces:', padded)

On Odoo Online, group the product variant list by Internal Reference to get the same answer. All three lists should be empty for anything you sell on TikTok Shop.

How you start depends on where your catalog lives:

• Products already in Odoo: run Sync Catalog to match active TikTok Shop listings to them.
• Products only on TikTok Shop: export the catalog with the bulk edit feature on TikTok's side, import it into Odoo, and map the TikTok Shop Item ID to the product external ID.

Odoo TikTok Shop connector limitations

Each limit below comes from Odoo's own documentation. The workaround column is our recommendation.

One more gap to note: the documentation covers importing the catalog from TikTok Shop and mapping it, not publishing or editing listings from Odoo. To send Odoo products to TikTok Shop, the docs point to bulk upload in Seller Center. Titles, images and prices are still managed on TikTok.

TikTok Shop integration for Odoo Community, 17 or 18

If you are not on Odoo 19 Enterprise or later, the native connector is not available. You have four routes:

Before installing any third-party connector, check five things:

• Licence. Paid modules are often sold under the Odoo Proprietary License (OPL-1). Confirm you may modify the code and deploy it on every database you need.
• Where your credentials go. Your App secret and tokens should stay in your own database. A module that routes calls through the vendor's server gives that vendor access to your shop.
• Readable source. You, or a developer you hire, must be able to audit and patch it.
• Markets and Odoo version. Confirm your exact country and Odoo version are supported, not just TikTok Shop in general.
• Maintenance record. Look at the last update date. An integration nobody maintains breaks when TikTok changes its API.

A custom module uses the same building blocks the native setup needs: a Custom app in Partner Center, the scopes you enable, and the seller authorization. The difference is that you decide what syncs and when. Netalith builds this kind of connector as part of its Odoo development and custom module service, on both Community and Enterprise.

Is the native connector enough for your shop?

The practical order of work: clean your Internal References, start the Partner Center registration early, connect one shop, sync the catalog, check that unmatched products are zero, then enable inventory sync.

If the gaps above are the parts you need, or you are on Community, tell us your Odoo version, your TikTok Shop markets and your monthly order volume. Netalith's TikTok Shop API integration service scopes the connector to what your shop actually uses, priced to scope.