↑↓ selectEnter openEsc close

    1. Elbuz
    2. US marketplaces

    How to connect TikTok Shop to Elbuz: products, orders and warehouse stock

    17 min readUpdated

    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

    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:

    FieldWhy
    Warehouse A handy way to find the warehouse ID: the “Pick from list” button shows the warehouses in your account
    Currency for publishingA 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

    1. 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”.
    2. Click “Connect”, approve access to your store, copy the short code and paste it into the form right away: the code expires quickly.
    3. Click “Test connection” — the response should show your store name.
    4. Click “Pick from list” under the warehouse field and set the warehouse you need in the “API version” field of the export template.
    5. 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 dataProduct field in Elbuz
    product nameName
    descriptionDescription
    seller SKU
    item pricePrice
    stock per warehouseQuantity (summed across all warehouses)
    product statusStatus: active means an enabled product
    TikTok categoryCategory
    main imagesPhotos (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.

    Import protection section of the product card with the Do not update and Fixed Price switches
    1Do not update
    2Fixed Price
    1. Do not update — the import run skips the whole product card.
    2. 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).

    The left branch shows where the product keys come from: first from this template, and if either of the two keys is missing here — from any other TikTok connection. A product without keys is dropped silently if “Publish new products” is off and isn't included in the summary counters; with the checkbox on, it goes to publishing.
    yesnoyesnoyesnoyesno“TikTok Shop” export template with“Products” checkedWarehouse determined?Product from the export selectionRed line “warehouse not found —stock not updated, prices only”Both marketplace keys in thistemplate?Stock to the warehouse — separaterequest, if a warehouse isdeterminedKeys in another TikTok connection?Without “Publish new products” —skipped with no log line; with it — topublishing after the loopPrice — separate requestRequests accepted?To the updated counter“TikTok Shop: export error” and tothe error counter“TikTok Shop: prices and stockupdated, products: … (errors: …)”
    • 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 lineWhat 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.

    The loop returns to a new page as long as the marketplace returns one. There are two exits: a marketplace rejection breaks off the catalog with no summary and no markup, while “Stop” or the end of the list lead to the normal summary. A failed full-listing request doesn't stop the run — the card is built from the short entry.
    noyesnoyesnoyesTemplate run with “Products”checkedPage of active products — up to 100Marketplace responded?“TikTok Shop: API error -” and endof catalogFull listing for each productListing received?Card from the short list entryProduct into the batch — every 500go into the catalog“TikTok Shop: products received: …”“Stop” clicked or no more pages?Rest of the batch into the catalogand markup rules“TikTok Shop: catalog loaded,products: …”
    • Start or end
    • Action or result
    • Decision: the path depends on the answer
    What is limitedValue
    Page size100 products or 100 orders per request
    Requests per catalog importone per list page plus one per product
    Catalog write batch500 products
    Response timeout per request120 seconds; 30 for establishing the connection
    Marketplace rate limit exceededthree 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 exporttwo: stock and price separately
    Photos when publishingno more than 9 per product, up to 60 seconds to download each
    Field truncation when publishingname — 255 characters, description — 10,000, SKU — 50

    Scenarios

    TikTok Shop template: the card for choosing the data to import
    1Products checkbox
    2Photo checkbox
    3Orders checkbox
    1. Products — import the product catalog.
    2. Photo — import product photos.
    3. 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 the log says and what to do about it
    What you seeWhyWhat 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
    TikTok Shop template: the Connection card with the warehouse and currency fields
    1Warehouse ID field
    2Currency for publishing field
    1. Warehouse ID — leave empty to use the default TikTok Shop warehouse.
    2. Currency for publishing — the currency in which products are published (USD by default).

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free