Elbuz links a TikTok Shop store with a code, pulls products into the base catalog, receives orders and sends prices and stock back — a TikTok sale cuts availability on all channels at once.
When you need this:
- Your products are already in TikTok Shop — active items arrive with price, stock, photos and category.
- A good livestream clears your stock in an hour — orders become documents, and TikTok stock updates from Elbuz.
- You manage the catalog in Elbuz — new products are published to TikTok Shop together with photos.
Where to start: create a template of the “TikTok Shop” type and link your store with a code.
What the TikTok Shop connection can do
- Link with a code — no app registration, keys or signatures.
- Import active products — name, description, SKU, price, stock summed across warehouses, category and photos.
- Orders — history on the first run, then only changed orders.
- Prices and stock back to TikTok — stock goes to the selected warehouse.
- Publishing new products — Elbuz uploads the photos and creates the listing itself.
What you need from TikTok Shop
You don't need to register an app on TikTok or deal with keys and signatures. The template form has an app installation card: click “Connect”, approve access to your store and enter a short link code. Elbuz then works on your behalf, and access is renewed automatically.
The “Connection” card has two fields, both optional:
| Field | Why |
|---|---|
| Warehouse | A handy way to find the warehouse ID: the “Pick from list” button shows the warehouses in your account |
| Currency for publishing | A currency code, for example USD. This field doesn't affect export or publishing — the currency is set by the export template |
The warehouse and currency for stock and publishing are set in the “TikTok Shop” export template, field “API version (marketplace parameters)”. The format is the warehouse ID and currency code separated by a vertical bar, for example 74012345|USD.
- Field empty — the default warehouse from your account and the store's default currency in Elbuz.
- Only the warehouse is set — the store's default currency.
TikTok Shop tracks stock per warehouse. Elbuz updates one warehouse — the one in the “API version” field of the export template or, if it's empty, the default one. If you sell from a specific warehouse, set it explicitly, otherwise the numbers in your account and in Elbuz will drift apart.
If no warehouse is set and Elbuz can't find a default warehouse in TikTok Shop, only prices go to the marketplace; the log shows “TikTok Shop: warehouse not found — stock not updated, prices only…”. New products aren't published without a warehouse.
The “Pick from list” button under the “Warehouse ID” field in the import template requests the warehouses from TikTok Shop and shows them with their type and a default-warehouse mark. Copy the ID you find into the “API version” field of the export template.
How to connect, step by step
- Create a template of the “TikTok Shop” type and save it — linking works only for a saved template. “Active” and “Orders” are already on in a new template: within 5 minutes of linking, Elbuz starts fetching the order history. Elbuz maps marketplace statuses to yours automatically, by name; the template's “Order statuses” window shows what came in and how it was mapped. Want to check first? Clear “Orders”.
- Click “Connect”, approve access to your store, copy the short code and paste it into the form right away: the code expires quickly.
- Click “Test connection” — the response should show your store name.
- Click “Pick from list” under the warehouse field and set the warehouse you need in the “API version” field of the export template.
- Select what to import, run the template manually and compare a few products and orders with your account. Once the numbers match, put the catalog on a schedule.
There's one link per TikTok Shop account: if you connected in the import template, the export template uses the same access, and vice versa. The “Connect” button and the “Link code” field are in both templates.
What goes into the product card
Elbuz pulls the store's active products. It reads the list first, then requests the full listing for each product, so there are more requests than products and a large catalog takes noticeably long to import.
| TikTok Shop data | Product field in Elbuz |
|---|---|
| product name | Name |
| description | Description |
| seller | SKU |
| item price | Price |
| stock per warehouse | Quantity (summed across all warehouses) |
| product status | Status: active means an enabled product |
| TikTok category | Category |
| main images | Photos (if the checkbox is on) |
Attributes and categories
TikTok Shop doesn't send product attributes. If Elbuz is your main catalog, fill in the attributes there — from Elbuz they go to the channels that need them.
The category arrives as a numeric code; Elbuz takes the readable name from the TikTok category dictionary. The dictionary is loaded with the “Load marketplace dictionary” button in the category matching window. Until it's loaded, products land in the source category — sort them into your own tree, and updates will go there.
A product disappeared from TikTok Shop or you disabled it
Elbuz asks the marketplace only for products with the “Active” status. An item that was delisted, deactivated, deleted or sent for review isn't included in the run, and nothing happens to its card in Elbuz: the last price, quantity and “Enabled” flag stay. The only sign is a smaller count in the “catalog loaded, products: …” summary.
The flip side: if you disabled a product in Elbuz but it's still live on the marketplace, the next run enables it again. To keep your value, use the “Do not update” toggle in the product card, “Import protection” section: the run doesn't overwrite that card at all. “Fixed Price” protects only the price.
1
Do not update2
Fixed Price- Do not update — the import run skips the whole product card.
- Fixed Price — the import run does not change the price of the card.
The card stays linked to the marketplace even after the product is gone from TikTok. Export keeps sending its price and stock; the marketplace's rejection shows in the log as “TikTok Shop: export error” with the product name.
How orders arrive
The first run imports the history; after that, Elbuz pulls orders changed since the previous run, and already imported orders are updated, not duplicated. An item that isn't in the catalog becomes a new card in a separate “Products - tiktok - …” category.
The document gets:
- order number, creation and change dates, status;
- recipient name, phone, buyer email, buyer message;
- delivery address in one line with postal code and region code, shipping provider;
- currency, paid flag, payment method.
TikTok returns an order as individual units, with no “quantity” field. Elbuz groups identical units into one item: three identical products become one item with a quantity of three. The item amount is price times quantity, so the order total matches.
How prices and stock go back to TikTok Shop
The reverse direction is a separate export template of the “TikTok Shop” type. Price and stock go in two separate calls per item, and stock goes to a specific warehouse. Elbuz stores the keys for this during the catalog import, so import the catalog from TikTok once first, then set up the export.
If no warehouse is determined (the “API version” field is empty and the account didn't return a default warehouse), stock isn't sent and only prices are updated; the log shows a red line about it (troubleshooting).
- Start or end
- Action or result
- Decision: the path depends on the answer
An item is exported if it has the “Export to file (to website)” flag and its category is active and marked for export. Clearing the product's “Activity” does not stop TikTok updates. Elbuz can't disable a product on the marketplace — only price and stock are sent; to take an item off sale, set its stock to zero.
Several warehouses, several stores
- Stock arrives as a sum but goes back to one warehouse. With more than one warehouse, after an import–export round the numbers in your account won't be what you expected.
- Protection works one way. “Do not update” and “Fixed Price” block writing to the card, but that card's price and stock still go to TikTok.
- Product keys can come from another connection. If a key is missing in the template, Elbuz looks for it across all TikTok connections in the account. With two TikTok stores, an update may go to the other store's product.
When another source also manages the product, the field keeps the value from whichever run finished last: sources have no priority (two templates for the same product).
Publishing new products
With “Publish new products” checked in the export template, Elbuz creates TikTok Shop listings for products not yet linked to the marketplace. The marketplace doesn't accept photos by URL, so Elbuz downloads the images and uploads them, then creates the product with name, description, category, package weight, SKU, price and stock.
The price is sent in the currency from the “API version” field or, if it's empty, in the store's default currency.
- The TikTok category is matched to the product's category — otherwise the product is skipped.
- At least one photo was uploaded — the marketplace won't accept a product without an image. Up to 9 photos are sent.
- Stock is above zero — a product with zero stock is skipped.
- A warehouse is determined — without it, publishing doesn't start at all.
Each skip shows in the log as a separate line with the product name; zero-stock skips show as one total counter. If no weight is set, the listing gets 0.5 kg.
A published product gets a marketplace link and the “Exported” flag. Elbuz can't deactivate or delete a listing in TikTok — do that in the marketplace account.
Scheduled updates
TikTok Shop sends no instant notifications, so Elbuz fetches orders itself every 5 minutes if “Orders” is checked and the store is linked: a livestream order wave won't wait. The shared “Marketplace orders” task in “Job schedule” does this; change the interval there. This pass skips the catalog, and orders also picked up by the template schedule aren't duplicated.
The template's own schedule updates the catalog — the “Schedule setup” button in the template form. Once a day, say at night, is enough: while the catalog runs, orders passes are skipped. General schedule rules and disabling a template: data import overview.
How to tell the run worked
The run log opens in the Operations Center; you can close the template window. For a TikTok connection, the log shows these numbers:
| Log line | What it means |
|---|---|
| “TikTok Shop: products received: …” | after each list page, as a running total |
| “TikTok Shop: catalog loaded, products: …” | how many active products the marketplace returned and went into the catalog |
| “TikTok Shop: orders loaded: …” | after each page of orders, as a running total |
| “TikTok Shop: API error -” (red) | the marketplace rejected the request; this part of the run breaks off, but the operation still ends with “Data import completed!” |
| “TikTok Shop: products updated: …” | export, every 50 updated items |
| “TikTok Shop: prices and stock updated, products: … (errors: …)” | export summary; errors are items where the marketplace rejected at least one of the two calls |
| “TikTok Shop: new products created: … (errors: …)” | publishing summary |
| “TikTok Shop: product ‘…’ published (ID …)” | use this ID to find the listing in your account |
Red lines don't mark the operation card as failed — look for them yourself. A TikTok run has no “Data integrity check” or “Product indexing” lines: the catalog path does that work without separate lines.
If a full-listing request fails, the run goes on without a log line — the card is built from the short list entry. Without the variants block, price and quantity arrive as zeros: a zero price isn't written, but a quantity of 0 is. After a run with marketplace failures, filter the “Products” grid by today's “Date updated”.
How long it takes
There's no cap on the number of products or orders: pages are read as long as the marketplace returns the next one. How long your catalog takes shows in the “Time spent” column of the template list and in the last line of the log.
- Start or end
- Action or result
- Decision: the path depends on the answer
| What is limited | Value |
|---|---|
| Page size | 100 products or 100 orders per request |
| Requests per catalog import | one per list page plus one per product |
| Catalog write batch | 500 products |
| Response timeout per request | 120 seconds; 30 for establishing the connection |
| Marketplace rate limit exceeded | three retries with pauses of 2, 4 and 6 seconds; after that, on a list page the run stops with an error, on a full listing the short entry is used, and on export only that item gets an error |
| Requests per item on export | two: stock and price separately |
| Photos when publishing | no more than 9 per product, up to 60 seconds to download each |
| Field truncation when publishing | name — 255 characters, description — 10,000, SKU — 50 |
Scenarios
1
Products checkbox2
Photo checkbox3
Orders checkbox- Products — import the product catalog.
- Photo — import product photos.
- Orders — receive orders from the marketplace.
Bring TikTok store products into the base catalog
What to turn on. In the “Select data to import” card — “Products”, plus “Photo” for images.
What you get. Active products arrive with name, description, SKU, price, stock summed across warehouses and category, and each card gets the keys for export. Attributes don't arrive; re-running doesn't create duplicates.
Receive TikTok orders without a catalog run
What to turn on. Only “Orders”; clear “Products”. The template needs no schedule: orders arrive by themselves every 5 minutes.
What you get. The first run imports the history, later runs pick up changed orders. This template doesn't change prices or stock of existing cards, and an item not in the catalog becomes a new card in the “Products - tiktok - …” category.
Keep your own price or the whole card
What to turn on. In the product card, “Import protection” section — “Fixed Price” or “Do not update”.
What you get. With “Fixed Price”, the run won't overwrite prices, but name, description and stock will update; with “Do not update”, the card isn't overwritten at all. The card's price and stock still go to TikTok.
Update prices and stock in TikTok for products already on sale there
What to turn on. First run the import with “Products” checked at least once, then create an export template of the “TikTok Shop” type with “Products” checked.
What you get. Each product gets two requests: stock to the warehouse and price. Name, description and photos aren't updated in TikTok, and a product without marketplace keys is skipped silently unless publishing is on.
What to do when TikTok Shop doesn't send or accept data
| What you see | Why | What to do |
|---|---|---|
| “TikTok Shop: connect the shop with the Connect button (link code)” | The template has no access to the store: linking wasn't finished or access was revoked | Link again and check with the “Test connection” button (how to connect) |
| “Test connection” doesn't show the store name | The link code expires quickly and may have gone stale | Connect again and paste the new code right away (how to connect) |
| “TikTok Shop: API error -” followed by text from the marketplace | The marketplace rejected the request; the run stopped at that point, and earlier batches of 500 products are already in the catalog | Read the text after the dash and run the template again — re-running is safe (if a run broke off) |
| An order run broke off midway | The “resume from” marker is updated after each saved page | Run it again: the latest orders arrive a second time and are updated, not duplicated |
| “Operation aborted by user!” and fewer products in the summary | “Stop” takes effect after the current page (up to 100 products or orders); what was collected goes into the catalog with markup | The next run updates the rest (stopping a run) |
| “TikTok Shop: no warehouse found - publishing is not possible” or “… — stock not updated, prices only” | No warehouse was found in the export template or in the account: new products aren't created, and existing ones get prices only | Find the warehouse with the “Pick from list” button under the “Warehouse ID” field and enter its ID in the “API version” field of the export template (what you need) |
| Stock in your account doesn't match Elbuz or went to the wrong warehouse | Exactly one warehouse is updated — from the “API version” field or the default; Elbuz doesn't clear the others | Enter the correct warehouse and run the export again; on the wrong warehouse, remove the stock manually in your account (several warehouses) |
| “TikTok Shop: “…” — category not mapped to TikTok, product not created” | No TikTok category is matched to the product's category | Match the category; if the dictionary is empty, first click “Load marketplace dictionary” in the matching window (publishing) |
| “TikTok Shop: ‘…’ - no photo (TikTok requires at least one), product not created” | None of the product's images could be downloaded and uploaded to the marketplace | Add a photo available by URL and run the export again (publishing) |
| “TikTok Shop: new products not published: …” | The category isn't matched or there's no photo; the skipped products are named in the lines above | Fix what those lines name and run the export again (publishing) |
| The catalog pulled in extra products or overwrote your edits | This applies to all sources; there's no bulk rollback of values | Filter the template's products by the “Source - name” column, and the affected ones by “Date updated” (if you imported the wrong data) |
FAQ
Why do the products have no attributes?
TikTok Shop doesn't pass attributes through this channel. Attributes are filled in Elbuz and go from there to other channels (attributes).
Why does an order item have a quantity of three while the account shows three lines?
TikTok returns orders as individual units, with no quantity. Elbuz groups identical units into one item, and the total matches (orders).
A product disappeared from TikTok Shop — what happens to its card in Elbuz?
Nothing: the card keeps the last price, quantity and “Enabled” flag (disappeared products).
I disabled a product in Elbuz — why is it still on sale in TikTok?
Clearing “Activity” doesn't stop the export, and Elbuz can't disable a product on the marketplace. Set the stock to zero or deactivate the product in your account (export).
Why does the catalog take so long to import?
Elbuz requests the full listing for each product separately. Once a day, at night, is enough for the catalog; Elbuz fetches orders separately every 5 minutes (how long it takes).
Where to find it and who has access
- Menu
- Directories → Operations → Data import → new template of the “TikTok Shop” type
- Other entry points
- Directories → Operations → Data export — template for prices and stock
- Access right
- the “Import” window in “Group permissions”
- Prepare
- seller access to your TikTok Shop account
1
Warehouse ID field2
Currency for publishing field- Warehouse ID — leave empty to use the default TikTok Shop warehouse.
- Currency for publishing — the currency in which products are published (USD by default).
Related topics
- For the general import mechanics — schedule, broken-off runs, service categories: data import overview.
- If you also receive orders from other marketplaces: importing orders via API.
- To connect another API catalog source: importing a catalog via API.
