TikTok Shop Connector FAQs¶
These frequently asked questions cover the most common setup and synchronization topics for the Odoo TikTok Shop Connector. For a full feature list and sync matrix, see TikTok Shop Connector Features.
Getting Started¶
Yes. The connector works with Odoo Enterprise (On-premise and Odoo.SH) and Odoo Community. It does not work with Odoo Online (SaaS), which does not allow third-party apps.
Two finance features need the Accounting application from Odoo Enterprise: Auto Reconcile and Auto Process Statements?. Everything else works in Community, including reconciling a payout’s bank statement by hand from the Accounting app.
The TikTok Shop module depends on Base Marketplace, which brings in Odoo Sales, Inventory and Delivery. It needs no Python package beyond the ones Odoo itself ships with.
Create an instance by navigating to , click New, select TikTok Shop as the marketplace, fill in the App Key, App Secret and Service ID of your app, choose the Authorization Portal, save, and click Connect TikTok Shop Account. See Create TikTok Shop Instance In Odoo and Generate TikTok Shop API Credentials.
An App Key, App Secret and Service ID from your app in the TikTok Shop Partner Center, and the app’s Redirect URL set to the OAuth Callback URL Odoo shows you. See Generate TikTok Shop API Credentials.
Open your TikTok Shop instance record and click Test Connection. The message Successfully Connected means the shop’s authorization is valid.
Most often because the app’s Redirect URL in Partner Center does not match the OAuth Callback URL on the instance, character for character. The callback is built from your Odoo database’s web address, so check that Odoo is reached at the address shown there.
Yes — one instance per shop. An account that authorizes several shops is refused, so create an instance for each shop and authorize it separately.
Markets¶
The connector works with the shop you authorize, wherever it trades. What differs is the features each market offers — how parcels are shipped, whether part of an order can be cancelled, whether invoices are uploaded, whether payouts are read. See TikTok Shop Supported Markets for the full table.
You do not. The market is read from the shop that authorizes the app and shown as Shop Region. Everything that depends on the market follows from it.
The Operations popup only offers what your instance can actually do. Import Manufacturers & Responsible Persons appears for Germany, Spain, France, Ireland and Italy, Export Invoices for local sellers in Brazil, and Import FBT Inventory when the instance uses Fulfilled by TikTok. See TikTok Shop Supported Markets and Fulfillment Type.
No. It selects the host the authorization is asked of, which has to be known before the first token exists, so it is fixed once the instance is saved. United States shops use the United States portal, every other market the Rest of World portal.
Products And Listings¶
By the seller SKU. TikTok Shop carries the seller’s own code on every unit, and a listing is matched to the Odoo product with the same internal reference.
A listing is checked before anything is sent, and what is missing is named in the yellow banner on the listing — usually its TikTok Category, a required attribute, an unmapped variant attribute, or a picture. See Export Products From Odoo and Attribute Mapping.
Up to 80. A product is created one request at a time, so a larger selection is asked for in more than one go.
Yes, changing the product itself does. The price and inventory are sent to TikTok Shop on their own, so neither sends the product for review.
Variants are sent only when one of them is new to TikTok Shop, and then all of them are — a variant left out of that list is deleted by TikTok Shop. Keep the listing’s variants complete in Odoo before sending it.
Stock And Orders¶
Check that each TikTok warehouse has its Odoo warehouse and Stock Location set, and Enable Import/Export Stock? switched on. A warehouse without a Stock Location is left out of the export. See TikTok Warehouses.
A new instance imports Awaiting Shipment orders only. Add the statuses you also want to TikTok Order Status on the instance’s Orders tab — and add the later statuses on any instance that uses Fulfilled by TikTok, because those orders never wait to be shipped.
Only where you ship the parcel yourself, and then the connector reports it for you — set the carrier’s TikTok Shipping Provider Code so it can. Where TikTok Shop buys the label or collects the parcel, it already knows. See TikTok Shop Update Order Status From Odoo.
Yes, where TikTok Shop allows the order to be split. Some markets ship every unit of a product together; validating a delivery that would leave part of such a product behind asks you to confirm first, because TikTok Shop could not be told about it afterwards.
Finance¶
Payouts are read by Import Statements, along with the statements they settle. See Import TikTok Shop Statements In Odoo.
A payout is only turned into accounting entries once every statement it carries is paid. Until then what reaches the bank is not final.
The instance has no Statement Journal. Set it on the Finance tab — on a confirmed instance, click Reset first, then Confirm again. See Finance Configurations.
Auto Reconcile requires the Accounting application from Odoo Enterprise. In Odoo Community it stops with “Auto Reconcile is not supported in Community.” — reconcile the payout’s bank statement from the Accounting app instead. See Reconcile TikTok Shop Payouts.
Automation¶
The scheduled actions are created inactive. Switch on the ones you want on the instance’s Automatic Jobs tab — which is visible to Odoo administrators only. See Automatic Jobs Configurations.
No. They complement them. A notification can be lost, so the scheduled imports stay active and remain the source of truth. See Webhook Configurations.
TikTok Shop accepts only a secure address (https://) with a domain name and no custom port. The
addresses are built from your Odoo database’s web address, so Odoo must be reached at such an address.
Use Test Connection on the instance to confirm the shop is still authorized.
Check the feature is available in your market — see TikTok Shop Supported Markets.
Confirm the relevant scheduled action is active; they are created inactive.
For stock and orders, check each TikTok warehouse has its Odoo warehouse and Stock Location — see TikTok Warehouses.
Review for failed lines and for error messages.