What syncs between Katana and TikTok
The table below summarizes each data type and the direction it moves between TikTok and Katana.
Data | Direction | Status |
Orders | TikTok → Katana | Available |
Products | TikTok → Katana | Available |
Inventory sync | TikTok → Katana | Available |
Locations and mapping
After you authorize the connection with your TikTok login, the configuration screen opens on the Location tab. Each TikTok warehouse maps 1:1 to its own dedicated Katana location.
A warehouse that has never been mapped shows Not mapped. Click Add to Katana to create its Katana location automatically.
To pause a mapped warehouse, click Unlink. Its status then shows Unlinked.
To resume syncing, click Relink.
Only mapped warehouses sync.
Products sync
Product mapping creates a required link between each TikTok product and a Katana item. First, choose how SKUs are matched:
Direct 1:1: the TikTok SKU must equal the Katana SKU.
SKU aliases: a TikTok SKU is linked to a different Katana SKU.
Products are imported by SKU. If a SKU already exists in Katana, the TikTok product is matched to that product. If a SKU is unknown, Katana creates the product automatically when it is first needed.
Kits and bundles become Katana products. Add a bill of materials (BOM) of their components in Katana. A kit order line stays a single row on the sales order.
SKU aliasing
An SKU alias links a TikTok SKU to a different Katana SKU. Use one when the same product has different SKUs in TikTok and Katana. Upload your SKU alias mapping before you import products, so mismatched SKUs match existing Katana products instead of creating new ones.
Orders sync
Orders flow one way only, from TikTok into Katana.
When orders import: an order imports once it reaches the import-from status you configure. The default is the Open state.
Status updates: after import, the order keeps updating automatically through every later status change in TikTok.
Order structure: each TikTok order becomes one Katana sales order, with one row per order line. The order source is shown as TikTok.
Fulfillments and tracking
Each shipped package becomes a Katana fulfillment with its carrier and tracking number. Multi-package shipments create one fulfillment per package, so one order can show several fulfillments. Together, these fulfillments never exceed the ordered quantities.
Cancellations
When an order is canceled in TikTok, Katana deletes the matching sales order only if that sales order is still open. Canceling a sales order in Katana does not cancel the order in TikTok.
Inventory sync
TikTok stock levels appear in Katana as read-only External inventory at each warehouse's mapped location. The number shown is TikTok's On hand quantity.
Reconciliation compares Katana's in-stock quantity with TikTok's on-hand quantity. It runs on a schedule, or you can run it on demand. For any difference, Katana creates a stock adjustment, so your Katana stock matches TikTok.
What does not sync
Orders created in Katana are not sent to TikTok. Orders flow from TikTok into Katana only.
Katana never sends products or stock changes to TikTok.
Inbound shipments and stock transfers are not synced.
Returns and RMAs are not synced.
Serial numbers are not tracked. Lot or batch data is shown read-only where TikTok provides it.
Disconnecting
To disconnect, go to Katana's Integrations page and open the TikTok integration. Once you disconnect, syncing between TikTok and Katana stops.
Records that were already imported, such as sales orders, fulfillments, products and locations, stay in Katana.