Import TikTok Shop Orders In Odoo

  • The TikTok Shop Odoo Connector allows you to import TikTok Shop orders into Odoo. This can be a useful way to streamline your order management processes and keep your inventory and accounting data up-to-date.

  • Before importing orders, it’s necessary to configure certain order configuration and workflow configuration in the Instance.

  • You have the flexibility to import orders from TikTok Shop to Odoo, either through manual imports or automated processes.

Method - 1: Manual Order Import

  1. Go to the Marketplaces ‣ Overview menu in Odoo.

  2. Click on the Operations button from the instance record.

    Operation View

  3. Select Import Operation and then select Import Orders option.

    Order Import Screen

  4. The order import operation has the following options:

    • Date Range: orders changed between the two dates are retrieved from TikTok Shop, so re-running an import picks up status changes on older orders. The Date Range defaults from the last order import to now.

    • Order ID: you can import specific TikTok Shop orders by entering their IDs, separated with a comma (‘,’), like this: 576461929037725765, 576461929037725766.

  5. Press PROCESS button.

This will start fetching orders from TikTok Shop and add them to the Order Queue Job for processing. The orders are created in Odoo based on the TikTok Seller Order Workflow, or the TikTok FBT Order Workflow for orders TikTok Shop fulfils.

Method - 2: Automatic Order Import

Order import from TikTok Shop to Odoo can be automated using the Automatic Schedule action, which enables you to define a specific time interval for executing the import process. This automation ensures that the latest orders from your TikTok Shop account are consistently created/updated in Odoo without requiring manual intervention.

  1. Go to your TikTok Shop instance setting by navigating to Marketplaces ‣ Configuration ‣ Instance.

  2. Here you will see the Automatic Jobs tab. In that tab you can configure the Import Orders automatic action by setting Interval Number, Interval Unit, and then Active.

    Orders Automatic Import

Note

The scheduled action is created inactive. Tick Active for it to run. It runs every 15 minutes by default. See Automatic Jobs.

Tip

With the Order Status Change webhook active, an order also comes in on its own as soon as TikTok Shop announces it. See Webhook Configurations.

Which Orders Are Imported

Important

Orders are only imported if their current TikTok Shop status is in the TikTok Order Status filter on the instance. A new instance has only Awaiting Shipment selected, so it imports orders waiting to be shipped and nothing else until you change it.

Orders are also skipped when:

  • The order was created before the date set in Import Order After on the instance.

  • The order’s fulfillment does not match the instance’s Fulfillment Type — a TikTok-fulfilled order on a seller-fulfilled instance, for instance. It is reported in the log.

  • The order has already been imported. Re-importing an existing order updates it rather than duplicating it.

Cancelled Orders

If an order has been cancelled on TikTok Shop, the connector detects this during import and cancels the corresponding order in Odoo, noting “The order was cancelled on TikTok Shop.” in the chatter.

To cancel an order in the other direction — from Odoo to TikTok Shop — see Cancel Order In TikTok Shop From Odoo.

The Imported Order

The orders are listed under Marketplaces ‣ Orders ‣ Orders. The Marketplace Detail tab of an order shows what TikTok Shop reported for it.

TikTok Shop Order

  • TikTok Order Status: where the order stands on TikTok Shop.

  • TikTok Fulfillment: Seller Fulfilled, Fulfilled by TikTok, or Fulfilled by Dilayani Tokopedia.

  • TikTok Delivery Method: who provides the shipping service — TikTok Shipping, Seller Shipping or Digital.

  • Ready to Ship By and Auto Cancel On: when TikTok Shop expects the parcel, and when it cancels the order if nothing has shipped.

  • TikTok Payment Method and TikTok Buyer.

The shipping charge is imported on the Delivery Product and fees such as the retail delivery fee on the Fee Product. Taxes follow the Tax System of the instance; in most markets the price the buyer pays already includes tax.

Note

Customers are created from what TikTok Shop reports, which masks the buyer’s name and contact details. The same buyer keeps the same identifier across their orders.

See also