Skip to main content
iVentureTeam
Odoo 19

Odoo TikTok Shop Integration: Orders, Stock and Invoices in Odoo 19/20

Odoo TikTok Shop integration for Odoo 19 and 20: what the native connector syncs, its limits, setup steps, accounting for payouts and options for 17/18.

Siddharth JambukiyaSiddharth JambukiyaOdoo Techno-Functional Consultant
October 27, 202612 min read1 view
Odoo TikTok Shop Integration: Orders, Stock and Invoices in Odoo 19/20 cover

TikTok Shop orders arrive fast and in bursts, often after a single live stream. If stock, picking and invoicing live in Odoo, the link between the two systems decides whether you oversell. Our Odoo integration services start by mapping that order flow end to end.

This guide is for eCommerce managers, finance leads and owners selling on TikTok Shop who run Odoo or plan to. If you also sell on Amazon, compare it with our Odoo Amazon integration guide, which uses a similar connector model.

What is the Odoo TikTok Shop integration?

The Odoo TikTok Shop integration is a link that moves TikTok Shop orders into Odoo and sends stock levels back, so one system runs fulfilment and accounting. You can get it three ways: Odoo's own connector, a third-party app or a custom build.

Odoo's official Odoo 20 release notes describe the native app as a marketplace integration that fetches orders and delivery slips and synchronizes inventory, available from Odoo 19.

Our own Odoo 20 Sales release notes mark it Enterprise only. In Odoo 20 you find it at Sales, then Marketplaces, then TikTok Shop, then Shops, where Connect New Shop asks for an App Key, App Secret and Service ID.

This matters for social commerce because TikTok sales spike around live streams and creator videos. A sync that runs every few minutes, with stock pushed back to TikTok, is what keeps a viral product from selling units you do not have.

Which Odoo versions have a TikTok Shop connector?

Only Odoo 19 and Odoo 20 Enterprise ship a native TikTok Shop connector; earlier versions and Community need another route. Check your version and edition before you plan anything else.

Odoo version and editionNative TikTok connectorPractical route
Odoo 16 or 17NoThird-party app or custom API integration
Odoo 18No (Shopee arrived here, not TikTok)Third-party app, or upgrade first
Odoo 19 EnterpriseYes, under Sales configurationNative connector
Odoo 20 EnterpriseYes, under Sales, MarketplacesNative connector
Odoo 19 or 20 CommunityNoThird-party app or custom API integration
Odoo Online (Standard plan)Yes, on supported versionsNative connector, no custom modules

The Odoo Apps Store search for TikTok Shop returned 25 apps when we checked, priced from free to about US$950 on the first results page.

If you are on Odoo 17 or 18, an upgrade can be the cleaner path than buying a third-party module you will later replace. Our guide to Odoo 20 upgrades and eCommerce integrations covers the order flow risks.

What does the native Odoo TikTok connector sync?

The native Odoo TikTok connector syncs orders that need shipping, product mapping, stock levels and shipping labels, on set intervals. It is built for seller-fulfilled orders, not every TikTok Shop process.

DataDirectionHow often
Orders awaiting shipment or collectionTikTok Shop to OdooEvery 5 minutes, with order status webhooks
Shipping labels and tracking numbersTikTok Shop to OdooEvery 15 minutes
Available stock quantitiesOdoo to TikTok ShopEvery 30 minutes
Product catalog and Item IDsTikTok Shop to Odoo, or mappedOn demand with Sync Catalog
Cancellations made in TikTok ShopTikTok Shop to OdooWith order sync
CustomersCreated in Odoo per orderWith order sync

These intervals come from Odoo's TikTok Shop order management documentation. A 30-minute stock cycle is fine for steady sales, but it can lag during a live stream that sells out fast.

The connector supports multiple seller accounts, with one TikTok Shop per account. Odoo lists 16 supported markets, including the US, UK, Germany, France, Spain, Italy, Ireland, Brazil, Mexico, Japan and six Southeast Asian countries.

What the Odoo TikTok connector does not do

The native connector covers orders and stock, but several TikTok Shop tasks stay outside Odoo. Odoo's own TikTok Shop connector features page says these must be handled in TikTok Shop Partner Center.

  • Refunds and returns: issued in TikTok Shop, then reflected in Odoo by your team.
  • Disputes: handled only in TikTok Shop.
  • Fee reports: monthly fee reports are downloaded from TikTok, not synced.
  • Cancellations from Odoo: cancelling an order in Odoo does not cancel it on TikTok Shop.
  • Shipped or completed orders: orders already marked Shipped, Completed, Cancelled or Unpaid are not imported.
  • Emailed invoices: TikTok Shop does not share buyer emails, so Odoo cannot send invoices directly.
  • Shipment arrangement: you arrange shipment in TikTok Shop Partner Center; Odoo then fetches the label.

Need refunds or settlements in Odoo? Plan a custom extension or a third-party app on top.

How do you set up the Odoo TikTok Shop connector?

Setting up the Odoo TikTok Shop connector takes a TikTok Shop Partner Center app, API scopes, an Odoo shop record and careful SKU mapping. The Odoo TikTok Shop connector setup guide lists these steps.

  1. Partner Center account: register on TikTok Shop Partner Center as an App developer (ISV). This account is separate from your seller account.
  2. Custom app: create a Custom app in the eCommerce Management or Connectors category, turn on the API and set the redirect URL to your Odoo database.
  3. API scopes: enable order, product, fulfilment, logistics, finance and shop information scopes, then publish the app to get the keys.
  4. Install in Odoo: activate the TikTok Shop Connector app, then click Connect New Shop and enter the App Key, App Secret and Service ID.
  5. Authorize: log in to the right seller account, return to Odoo and click Re-authorize Shop to refresh the token.
  6. Warehouse and stock: set the FBS Warehouse and turn on inventory sync.
  7. Catalog: click Sync Catalog, check every match, then test real orders before launch.

New accounts may need TikTok to review the app before API access works, so start this step early. Odoo's guide shows the redirect URL on an odoo.com database; on Odoo.sh or your own servers, use your own domain.

How do TikTok Shop orders and stock flow through Odoo?

Each TikTok Shop order becomes an Odoo sales order with a delivery picking, and stock leaves Odoo when you validate that picking. The SKU match decides whether this works.

The TikTok Shop Seller SKU must match the Internal Reference of the Odoo product or variant exactly. If it does not, Odoo falls back to a default product, which breaks stock and margin reports. Clean SKUs before you connect anything.

For a new database, export your TikTok catalog with its Item IDs and import it into Odoo, mapping the Item ID to the product external ID. For an existing catalog, Sync Catalog matches active products automatically.

Once an order lands, your team confirms the picking, arranges shipment in Partner Center, and Odoo attaches the label and tracking number. Validating the picking reduces stock, and the next inventory sync updates TikTok Shop.

How do you handle TikTok Shop invoices and payouts in Odoo accounting?

Create invoices in Odoo, upload them to TikTok Shop by hand, and reconcile TikTok's batch payouts through a dedicated journal and batch payments. This is where most DIY setups go wrong.

Odoo's guide suggests a bank journal such as "TikTok Payments" with a suspense account. Each payout then settles many invoices at once through a batch payment in Odoo Accounting.

The gap is fees. TikTok Shop pays in batches, and the connector does not sync fee reports. Any gap between your invoice totals and the payout must be booked from the TikTok statement by finance, or by a custom import.

For a clean month-end, assign one sales team per shop and keep a short checklist for refunds raised in TikTok. Our guide on how Odoo Accounting works explains journals and reconciliation.

Native connector vs third-party app vs custom API: which fits?

TikTok Shop to Odoo: Which route fits your shop?

Use the native connector if you run Odoo 19 or 20 Enterprise and fulfil orders yourself; choose a third-party app or custom build for older versions, Community or deeper finance sync. The table compares the three TikTok Shop ERP routes.

FactorNative Odoo connectorThird-party Apps Store moduleCustom API integration
Odoo versions19 and 20 EnterpriseDepends on the vendor's versionsAny version you maintain
Orders and stockYes, set intervalsUsually, varies by appYes, intervals you choose
Refunds and feesNo, manualSome apps claim it; test itYes, if you build it
Upgrade effortOdoo maintains itWait for the vendor's next portYour code to upgrade
Odoo OnlineYesNo custom modules allowedExternal sync only
Best forSeller-fulfilled shops on 19 or 20Odoo 16 to 18 or CommunityHigh volume or finance depth

A custom build talks to Odoo through its external API. In Odoo 20, XML-RPC and JSON-RPC are deprecated, and the Odoo external API reference says the common and object services are scheduled for removal in Odoo 22. Build new sync on JSON-2.

Our guide to the Odoo JSON-2 API migration explains the change. For a quick budget on any route, try the Odoo project estimate tool.

TikTok Shop ERP needs by industry

Most TikTok Shop sellers are consumer brands, and each one stresses a different part of the Odoo TikTok sync. The table shows what to plan for.

IndustryPain or cost driverOdoo approachHow iVentureTeam helps
Fashion and apparelMany size and color variantsVariant Internal References matched to Seller SKUsClean and map variant SKUs
Beauty and personal careBatches and expiry datesLots and expiration dates in InventorySet up lot tracking and picking rules
Consumer electronicsSerial numbers and returnsSerial tracking on deliveries and returnsDesign the returns flow
Food and snacksShort shelf life, fast selloutsStock limited to one FBS WarehouseSet the FBS Warehouse and buffers
Home and giftsBundles sold as one listingKits through bills of materialsMap bundles to components

Whatever you sell, test one live-stream sized order burst on a staging database before launch. Our Odoo eCommerce development services cover the same work when your own Odoo website is a channel too.

How much does an Odoo TikTok Shop integration cost?

Your cost is the Odoo licence, plus setup and SKU clean-up, plus any custom work for refunds, fees or older versions. The native connector itself is part of Odoo Enterprise.

Odoo Enterprise costs US$31.10 per user a month on Standard and US$61.00 on Custom, billed yearly, or Rs 725 and Rs 1,350 in India. Standard runs on Odoo Online; Custom adds the external API, Odoo.sh and on-premise hosting.

Odoo's connector documentation does not mention extra fees or IAP credits for the TikTok sync. Third-party apps add their own listed price, and custom builds add development and yearly upkeep.

As a guide, our published Odoo implementation cost ranges are $3k to $9k for a small project and $9k to $27k for mid-size. A TikTok connector is usually one workstream inside that scope, not a separate project.

How iVentureTeam helps with Odoo TikTok Shop integration

Planning TikTok sync? Price the project

We plan the full TikTok Shop to Odoo flow, from SKU mapping to month-end, and fill the gaps the native connector leaves. We have delivered 150+ ERP projects across 35+ countries with 40+ Odoo specialists over 13+ years.

  • Version check: confirm whether the native connector fits, or plan an upgrade or third-party route.
  • Connector setup: Partner Center app, API scopes, shop record, warehouse and catalog mapping.
  • Accounting design: clearing journals, batch payments and a fee booking routine your finance team can run.
  • Custom extensions: refunds, settlements and multi-channel stock rules through Odoo customization services.
  • Testing and support: order burst tests on staging, go-live monitoring and fixes after launch.

Odoo marketplace connector case study: Thai eCommerce merchant on JD Central

A Thai online seller connected its JD Central marketplace storefront to Odoo, so orders, stock and customers run from one ERP. The pattern is the same one TikTok Shop sellers need.

The merchant ran the marketplace as its front end and Odoo as its system of record, but nothing connected them. Orders were copied into Odoo by hand, listing stock drifted from warehouse stock, and product changes were maintained twice.

We built a connector with scheduled two-way sync covering five data domains: products, categories, inventory, customers and orders. Orders now arrive in Odoo automatically with their status, ready to pick and invoice. Delivery took 6 weeks.

The client's eCommerce Director said: "JD orders now land in Odoo automatically with stock and pricing kept current. We scaled marketplace sales without scaling admin work." Read the JD Central and Odoo marketplace integration case study.

The bottom line on Odoo TikTok Shop integration

If you run Odoo 19 or 20 Enterprise and ship your own orders, start with the native TikTok Shop Connector and plan the accounting around it. Use a third-party app or custom build only where it falls short.

Clean SKUs first, set a clear owner for refunds and fees, and test a live-stream sized order burst before launch. That covers most of the risk in TikTok Shop order management with Odoo.

Ready to connect TikTok Shop to Odoo?

Plan my TikTok sync

Get a clear plan for your TikTok Shop order, stock and invoice flow. Talk to our team about your TikTok Shop and Odoo sync, call +91-90235-15208, or email business@iventureteam.com.

Frequently Asked Questions

Does Odoo have a TikTok Shop integration?

+

Yes. Odoo 19 and Odoo 20 Enterprise include a native TikTok Shop Connector. It imports orders that need shipping, pushes stock levels to TikTok Shop and fetches shipping labels and tracking numbers.

Is the Odoo TikTok connector available in Odoo Community?

+

No. The native connector is Enterprise only. Community users can install a third-party module from the Odoo Apps Store or build a custom integration through the external API.

Can I connect TikTok Shop to Odoo 17 or Odoo 18?

+

Not with a native app, because the connector arrived in Odoo 19. Use a third-party module, a custom integration, or upgrade to Odoo 19 or 20 and use the native connector.

How often does Odoo sync TikTok Shop orders and stock?

+

Odoo's documentation says orders and status webhooks are processed every 5 minutes, shipping labels every 15 minutes and inventory every 30 minutes. You can also trigger each sync manually.

Does the Odoo TikTok connector handle refunds?

+

No. Refunds, disputes and fee reports are handled in TikTok Shop Partner Center. Your team then records refunds and fees in Odoo, or a custom extension imports them.

Can Odoo send invoices to TikTok Shop buyers?

+

Not directly, because TikTok Shop does not share buyer email addresses. You create invoices in Odoo and upload them manually to TikTok Shop Partner Center when needed.

Can I connect more than one TikTok Shop to Odoo?

+

Yes. The connector supports multiple seller accounts, with one TikTok Shop per account. Assign a sales team to each shop for separate reporting.

Does the connector support Fulfilled by TikTok orders?

+

Odoo documents the connector for seller-fulfilled orders, with stock pushed from your chosen warehouse. If you use TikTok fulfilment, test the flow carefully or plan a custom sync.

Ready to put this into action?

Talk to iVentureTeam about Odoo, AI automation, or custom development — get a free, no-obligation consultation.