Update Goods-SKU Relations

POST

/fbt/202603/goods/update_goods_sku_relation

Bind or unbind TikTok Shop SKUs to FBT goods.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body^required

Media typeapplication/json

object

operate_goods_sku_relation_list

required

List of goods and SKU relations to bind or unbind.

Array<object>

object

tts_goods_id

required

Identifier for goods generated by Fulfilled by TikTok system

string

tts_sku_ids

required

Identifiers of the TikTok Shop SKUs to bind to or unbind from the specified FBT goods.

Array<string>

operation_type

required

Operation type for the goods-SKU relation. Possible values: BIND (bind the listed SKUs to the goods); UN_BIND (unbind the listed SKUs from the goods).

string

Allowed values: BIND UN_BIND

Example

{
  "operate_goods_sku_relation_list": [
    {
      "tts_goods_id": "334556677",
      "tts_sku_ids": [
        "723456789012345678"
      ]
    }
  ],
  "operation_type": "BIND"
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

operate_goods_sku_relation_info

Results of the requested bindings or unbindings between TikTok Shop SKUs and FBT goods.

object

operate_result_list

Goods-SKU relation results, including the goods ID, SKU ID, success status, and failure reason when applicable.

Array<object>

object

tts_goods_id

Identifier for goods generated by Fulfilled by TikTok system

string

tts_sku_id

Identifier for SKU generated by TikTok Shop system

string

is_success

Whether the goods-SKU relation operation succeeded.

boolean

fail_reason

Reason the goods-SKU relation operation failed.

string

Example

{
  "code": 0,
  "data": {
    "operate_goods_sku_relation_info": {
      "operate_result_list": [
        {
          "tts_goods_id": "9988776655",
          "tts_sku_id": "723456789012345678",
          "is_success": false,
          "fail_reason": "SKU does not exist."
        }
      ]
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}