stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 For Indonesian market: Changes in Order and Finance APIs for Horizon+ Orders
The orders with tag "Horizon+" will hide shipping fees at sku prices, so the sku prices will be increased and the shipping fee will be reduced. There are changes in order and finance APIs for this type of order which are estimated to be effective on January 22, 2026. By using these API, the sellers can get the original sku prices and shipping fees. These original sku prices and shipping fees can also be checked at the seller center. Here is the list of changes:
- Get Order Detail (https://partner.tiktokshop.com/docv2/page/get-order-detail-202507) and Get Order List (https://partner.tiktokshop.com/docv2/page/get-order-list-202309) API
Response Parameters (Newly added fields in bond lines, existing fields with new logic in italic lines):
| Properties | Type | Properties description | New logic | |
|---|---|---|---|---|
| code | int | The success or failure status code returned in API response. | ||
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. | ||
| request_id | string | Request log | ||
| data | object | Specific return information | ||
| > | orders | []object | Order information. | |
| >> | order_rights | int | Order tag identifier if has certain rights within the order based on the program subscribed by sellers. 1 = Shipping Fee Reimbursement Program 2 = Horizon+ Program Applicable for SEA market only | |
| >> | Payment | []object | Payment info about a TikTok Shop order. | |
| >>> | sub_total | string | Buyer paid subtotal of all the SKUs in the order. For the US market, this is pre-tax total amount.sub_total = original_total_product_price - seller_discount - platform_discount. | SKUPriceRemainingAmount + SKUPriceOverchargeAmount |
| >>> | shipping_fee | string | Buyer paid shipping fee. shipping_fee = original_shipping_fee - shipping_fee_seller_discount - shipping_fee_platform_discountFor the US market, this is pre-tax total amount. | ShippingSalePrice (No change) |
| >>> | original_shipping_fee | string | Shipping fee before discount | ShippingListPrice (No Change) |
| >>> | original_total_product_price | string | Total original price of products (VAT included for crossborder shop).For the US market, this is pre-tax total amount. | Total of SKUlistPrice, if the order is distance fee, then total of SKUOriginListPrice |
| >>> | distance_shipping_fee | string | Distance shipping fee is fee that is charged by our logistics partner and covers the separate distance-based cost for deliveries outside Java island as a part of Horizon+ Program. Only applicable in ID Market. | SKUPriceLogisticsAmount |
| >>> | distance_fee_amount | string | Total distance fee for Horizon+ Program. Only applicable for ID market | SKUFreightEmbedAmount |
| >> | line_items | []object | Line item info list. | |
| >>> | original_price | string | Item original price, please refer to the currency of payment_info. | if hidden fee, then it shows SKUOriginListPrice, but if normal order then it shows SKUlistprice value |
| >>> | salePrice | string | Item sale price, please refer to the currency of payment_info. For ID market, if order included in the horizon+ program, the saleprice is equal to final sale product without the distance fee | Item subtotal after discount |
| >>> | distance_shipping_fee | string | Distance shipping fee is fee that is charged by our logistics partner and covers the separate distance-based cost for deliveries outside Java island as a part of Horizon+ Program. Only applicable in ID Market. | SKUPriceLogisticsAmount |
| >>> | distance_fee_amount | string | Total distance fee for Horizon+ Program. Only applicable for ID market | SKUFreightEmbedAmount |
- Get Price Detail API (https://partner.tiktokshop.com/docv2/page/get-price-detail-202407)
Response Parameters (Newly added fields in bond lines, existing fields with new logic in italic lines):
| Properties | Type | Properties description | New Calculation | |
|---|---|---|---|---|
| code | int | The success or failure status code returned in API response. | ||
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. | ||
| request_id | string | Request log | ||
| data | object | Specific return information | ||
| > | sku_list_price | string | Total MSRP price of the products. | if hidden fee, then it shows SKUOriginListPrice, but if normal order then it shows SKUlistprice value |
| > | subtotal | string | Total promotional sale price of the products including tax. Calculation: sku_sale_price + subtotal_tax_amount | SKUPriceRemainingAmount + SKUPriceOverchargeAmount |
| > | sku_sale_price | string | Total promotional sale price of the products. Calculation: sku_list_price - subtotal_deduction_seller - subtotal_deduction_platform For ID market, if order included in the horizon+ program, the saleprice is equal to final sale product without the distance fee | New field from pricedetail = SkuListPrice - Platform discount on items - Seller discount on items - Distant Shipping fee from Horizon Program - SkuPriceOverChargePlatformAmount = SkuPriceRemainingAmount + SkuPriceOverChargeAmount |
| > | shipping_list_price | string | Original shipping price | ShippingListPrice (No change) |
| > | shipping_sale_price | string | Promotional shipping price Calculation: shipping_list_price - shipping_fee_deduction -shipping_fee_deduction_platform | ShippingSalePrice (No Change) |
| > | distance_shipping_fee | string | Distance shipping fee is fee that is charged by our logistics partner and covers the separate distance-based cost for deliveries outside Java island as a part of Horizon+ Program. Only applicable in ID Market. | take from SkuPriceLogisticsAmount |
| > | distance_fee | string | Total distance fee for Horizon+ Program. Only applicable for ID market | SKUFreightEmbedAmount |
| line_items | []object | Each object is the same as the "data" field (line 5) without "line_items". | ||
| > | subtotal | string | Total promotional sale price of the products including tax. Calculation: sku_sale_price + subtotal_tax_amount | Confirm to RD |
| > | sku_list_price | string | Total MSRP price of the products. | if hidden fee, then it shows SKUOriginListPrice, but if normal order then it shows SKUlistprice value |
| > | sku_sale_price | string | Total promotional sale price of the products. Calculation: sku_list_price - subtotal_deduction_seller - subtotal_deduction_platform For ID market, if order included in the horizon+ program, the saleprice is equal to final sale product without the distance fee | Item subtotal after discount |
| > | shipping_list_price | string | Original shipping price | ShippingListPrice (No change) |
| > | shipping_sale_price | string | Promotional shipping price Calculation: shipping_list_price - shipping_fee_deduction -shipping_fee_deduction_platform | ShippingSalePrice (No Change) |
| > | distance_shipping_fee | string | Distance shipping fee is fee that is charged by our logistics partner and covers the separate distance-based cost for deliveries outside Java island as a part of Horizon+ Program. Only applicable in ID Market. | take from SkuPriceLogisticsAmount |
| > | distance_fee | string | Total distance fee for Horizon+ Program. Only applicable for ID market | SKUFreightEmbedAmount |
- Statement APIs changes
| API name | changes | Screenshot |
|---|---|---|
| Get Statements (https://patner.tiktokshop.com/docv2/page/get-statements-202309) | * fee_amount will add distant_shipping_fee value * revenue_amount will add distant_item_fee value | Image |
| Get Transactions by Order (https://partner.tiktokshop.com/docv2/page/get-transactions-by-order-202501) | * shipping_cost_amount will add distant_shipping_fee value * revenue_amount will add distant_item_fee value * A new field “distant_shipping_fee” will be shown under shipping_cost_breakdown object * A new field “distant_item_fee” will be shown under revenue_breakdown object | Image |
| Get Transactions by Statement (https://patner.tiktokshop.com/docv2/page/get-transactions-by-statement-202501) | * total_settlement_amount will add distant_shipping_fee value * total_shipping_cost_amount will add distant_shipping_fee value * shipping_cost_amount will add distant_shipping_fee value * revenue_amount will add distant_item_fee value * A new field “distant_shipping_fee” will be shown under shipping_cost_breakdown object * A new field “distant_item_fee” will be shown under revenue_breakdown object | Image Image |
| Get Unsettled Transactions (https://partner.tiktokshop.com/docv2/page/get-unsettled-transactions-202507) | * sum_est_fee_amount will add distant_shipping_fee value * sum_est_revenue_amount will add distant_item_fee value * est_revenue_amount will add distant_item_fee value * est_shipping_cost_amount will add distant_shipping_fee value * A new field “distant_shipping_fee” will be shown under shipping_cost_breakdown object * A new field “distant_item_fee” will be shown under revenue_breakdown object | Image Image |
§2 Which markets are affected?
The updates of the requirements apply to the Local to Local sellers for the Indonesian market.
§3 Who is affected?
Developers with applications that use APIs shown above
§4 Which version is applicable?
The updates of the requirements apply to the versions shown above.
§5 What action is required?
Developers need to check whether to use APIs shown above and handle the related error messages.