来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Summary
Version 202607 of the Create FBT Goods and Update FBT Goods Info APIs adds four groups of optional request-body fields — SIOC (Ships In Own Container), bulky-item accessory, goods safety attributes, and aerosol hazmat info — and removes the return cycle (return_cycle) and return address (return_address_info) fields under shelf_life_attribute_info, to support more granular product compliance and delivery-attribute input. Staying on 202603 requires no changes; migrating to 202607 requires the adjustments below.
§2 Impact Scope
Impact Scope
| Affected endpoints | POST /fbt/202607/goods/create_goods POST /fbt/202607/goods/update_goods_info (Legacy endpoints: /fbt/202603/goods/create_goods, /fbt/202603/goods/update_goods_info) |
|---|---|
| Affected APIs | Create FBT Goods, Update FBT Goods Info |
| App / scope | Apps that call the FBT (Fulfilled by TikTok) goods APIs and are authorized with scope seller.fbt.info |
| Markets | Markets where FBT is enabled (subject to FBT availability) |
| Effective version | 202607 (legacy version 202603 remains callable) |
The field changes are identical for both APIs. Field paths are relative to the goods object: under create_goods_dto_list[] for Create, and under update_goods_dto for Update. Header/Query parameters and the Response structure are unchanged.
§3 What You Need to Do
What You Need to Do
| Scenario | Action type | What to do |
|---|---|---|
| Stay on 202603 | No action | Existing integration is unaffected; no changes needed. |
| Migrate to 202607 | Required | 1) Change endpoint to /fbt/202607/...; 2) Remove shelf_life_attribute_info.return_cycle and the entire return_address_info from the request body; 3) Confirm the alternative handling for return address / return processing. |
| Adopt new capabilities (SIOC / bulky item / goods safety / aerosol) | Recommended | After migrating to 202607, fill in the corresponding optional fields as needed. |
§4 Field-level Diff (Old → New)
Field-level Diff (Old → New)
This release only adds and removes fields; the name, type, values, default, and nullability of retained fields are unchanged.
§5 Added Fields
Added Fields
| Field path | Change | Type (old → new) | Values / enum (old → new) | Default (old → new) | Nullable (old → new) |
|---|---|---|---|---|---|
is_sioc | Added | — → bool | — → true / false | — → none | — → Optional |
sioc_attribute | Added | — → object | — | — → none | — → Optional |
sioc_attribute.sioc_files | Added | — → []object | — | — → none | — → Optional |
sioc_attribute.sioc_files.sioc_certification_url | Added | — → string | — → SIOC attachment URL | — → none | — → Optional |
sioc_attribute.sioc_files.sioc_file_type | Added | — → string | — → PHOTO / DOCUMENT / DROP_TEST_VIDEO | — → none | — → Optional |
bulky_item_attribute | Added | — → object | — | — → none | — → Optional |
bulky_item_attribute.is_bulky_item_accessories | Added | — → bool | — → true / false | — → none | — → Optional |
goods_safety_attributes | Added | — → object | — | — → none | — → Optional |
goods_safety_attributes.is_fragile | Added | — → bool | — → true / false (is fragile) | — → none | — → Optional |
goods_safety_attributes.is_liquid | Added | — → bool | — → true / false (is liquid) | — → none | — → Optional |
goods_safety_attributes.is_sharp | Added | — → bool | — → true / false (is sharp) | — → none | — → Optional |
hazmat_info.aerosol_extra_info | Added | — → object | — | — → none | — → Optional |
hazmat_info.aerosol_extra_info.volume | Added | — → string | — → aerosol volume | — → none | — → Optional |
hazmat_info.aerosol_extra_info.volume_unit | Added | — → string | — → aerosol volume unit | — → none | — → Optional |
§6 Removed Fields
Removed Fields
| Field path | Change | Type (old → new) | Values / enum (old → new) | Default (old → new) | Nullable (old → new) |
|---|---|---|---|---|---|
shelf_life_attribute_info.return_cycle | Removed | string → — | ONCE_A_WEEK / ONCE_A_MONTH / ONCE_A_QUARTER → — | none → — | Optional → — |
shelf_life_attribute_info.return_address_info | Removed | object → — | Return address info → — | none → — | Optional → — |
return_address_info.name | Removed | string → — | Contact name → — | none → — | Required → — |
return_address_info.phone_number | Removed | string → — | Contact phone → — | none → — | Required → — |
return_address_info.postal_code | Removed | string → — | Postal / zip code → — | none → — | Required → — |
return_address_info.region_code | Removed | string → — | ISO 3166-1 alpha-2 region code → — | none → — | Required → — |
return_address_info.state | Removed | string → — | State / province → — | none → — | Required → — |
return_address_info.district | Removed | string → — | District / county → — | none → — | Required → — |
return_address_info.city | Removed | string → — | City → — | none → — | Required → — |
return_address_info.address_line1 | Removed | string → — | Address line 1 → — | none → — | Required → — |
return_address_info.address_line2 | Removed | string → — | Address line 2 → — | none → — | Optional → — |
After removal, shelf_life_attribute_info retains only shelf_life (int, shelf life in days). The return_handling_method field is retained with unchanged enum values: RESTOCK_SELLABLE_DISPOSE_UNSELLABLE, DISPOSAL_WITHOUT_INSPECTION, RETURN_WITHOUT_INSPECTION, RESTOCK_SELLABLE_RETURN_UNSELLABLE.
§7 Migration Example (shelf_life_attribute_info)
Migration Example (shelf_life_attribute_info)
Before (202603)
"shelf_life_attribute_info": {
"shelf_life": 180,
"return_cycle": "ONCE_A_MONTH",
"return_address_info": {
"name": "John",
"phone_number": "1000000",
"postal_code": "94000",
"region_code": "US",
"state": "CA",
"district": "Santa Clara",
"city": "San Jose",
"address_line1": "xxx St",
"address_line2": ""
}
}
After (202607)
"shelf_life_attribute_info": {
"shelf_life": 180
},
"is_sioc": true,
"sioc_attribute": {
"sioc_files": [
{
"sioc_certification_url": "https://...",
"sioc_file_type": "DROP_TEST_VIDEO"
}
]
},
"goods_safety_attributes": {
"is_fragile": true,
"is_liquid": false,
"is_sharp": false
}
§8 Validation
Validation
- Use the in-page API Testing Tool to call the 202607 API.
- Confirm the request is accepted and returns
code = 0after removingreturn_cycle/return_address_info. - Confirm the new optional fields are written as expected before going live.