Update FBT Goods Info

Update FBT goods information, including goods name, image URL, dimensions, hazmat details, shelf-life attributes, and return address information.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Possible values:
- RESTOCK_SELLABLE_DISPOSE_UNSELLABLE
- DISPOSAL_WITHOUT_INSPECTION
- RETURN_WITHOUT_INSPECTION
- RESTOCK_SELLABLE_RETURN_UNSELLABLE  |

^dimension_and_weight_base_info |object |Y | |dimension and weight info | ^^weight_value |string |Y |500 |Weight of the goods in the specified weight_unit. | ^^length_value |string |Y |40 |Length of the goods in the specified dimension_unit. | ^^width_value |string |Y |20 |Width of the goods in the specified dimension_unit. | ^^height_value |string |Y |30 |Height of the goods in the specified dimension_unit. | ^^weight_unit |string |Y |GRAM |Weight unit.Possible values:- MILLIGRAM - GRAM- KILOGRAM - POUND - OUNCE | ^^dimension_unit |string |Y |CENTIMETER |Dimension unit. Possible values:

• MILLIMETER
• CENTIMETER
• METER
• FOOT
• INCH | ^is_hazmat |bool |Y |false |whether is hazmat goods | ^hazmat_info |object |N | |Hazmat information for the goods. | ^^hazmat_type |string |Y |BATTERY |hazardous goods type Possible values: -MAGNETIZED -BATTERY -FLAMMABLE_LIQUID -AEROSOLS | ^^battery_extra_info |object |N | |Additional battery information for hazmat goods. | ^^^battery_type |string |Y |LITHIUM_ION |Battery type Possible values: LITHIUM_ION LITHIUM_METAL OTHER | ^^^battery_packaging_type |string |Y |STANDALONE |Battery packaging type,possible values: -STANDALONE -IN_EQUIPMENT -WITH_EQUIPMENT | ^^^total_battery_weight |string |Y |10 |total battery weight | ^^^total_battery_weight_unit |string |Y |GRAM |total battery weight unit, possible value:GRAM | ^^^total_battery_capacity |string |Y |2 |capacity | ^^^total_battery_capacity_unit |string |Y |WATTHOUR |total battery capacity unit,possible value:WATTHOUR | ^^^is_need_un_38_3_test |bool |Y |false |UN38.3 testing ensures that batteries meet specific safety criteria. Please send the report in the field if it's not included in the MSDS. | ^^^un_38_3_test_file_url |string |N |https://example.com/fbt/un38-3-test-report.pdf |UN38.3 testing file URL | ^^^battery_count_per_package |string |N |3 |per package battery count | ^^flammable_liquids_extra_info |object |N | |flammable_liquids_extra_info | ^^^flammable_liquids_type |string |Y |PAINT |Flammable liquid type, possible values -Paints -Perfumery products -Alcohols -Other | ^^^flammable_liquids_volume |string |Y |1 |Flammable liquid volume, | ^^^volume_unit |string |N |MILLILITERS |volume unit | ^^dg_class |string |Y |CLASS_3 |Hazmat class Possible values: -CLASS_2 -CLASS_3 -CLASS_9 | ^^dg_uncode |string |Y |UN2807 |UN number or UN ID is a 4-digit number that identifies hazardous substances possible values -UN2807 -UN3480 -UN3090 -UN3481 -UN3091 -UN1263 -UN1266 -UN3065 -OTHER | ^^msds_file_url |string |Y |https://example.com/fbt/msds-report.pdf |Material safety data sheet of the hazmat goods to support review the goods' safety compliance in FBT | ^^aerosol_extra_info |object |N | |Aeroslo Info | ^^^volume |string |N |1 |aeroslo volume | ^^^volume_unit |string |N |MILLILITERS |aeroslo volume unit | ^is_lot_code |bool |Y |false |if the product requires lot management based on FBT category rule TRUE:this product requires lot control FALSE:this product does not require lot control | ^is_expiration_management |bool |Y |false |Whether the goods require expiration management. | ^shelf_life_attribute_info |object |N | |Shelf-life attributes for the goods. | ^^shelf_life |int |N |10 |The goods shelf life (days) | ^^inbound_cutoff_days |int |Y |90 |The goods inbound cutoff days before expiration, represent the time period before the product's expiration when the warehouse will no longer accept inbound shipments. | ^^expiration_alert_days |int |Y |80 |The goods alert days before expired, represent the period of time before platform send expiration reminder alerts to the merchant. | ^^sales_cutoff_days |int |Y |70 |The goods sales cutoff days before expiration, representing the period before expiration when the goods will no longer be available for sale. | ^^handling_method_expired_goods |string |N |DISPOSE |The handling method for expired inventory. Possible values: STORE_UNITS RETURN_TO_SELLER DISPOSE | ^is_sioc |bool |N |false |whether sioc | ^sioc_attribute |object |N | |sioc info | ^^sioc_files |[]object |N | |sioc files | ^^^sioc_certification_url |string |N |https://p-boei18n.byted.org/tos-boei18n-i-0euhj0x6u9/beec7f914a044902a0c5dc929b97d064~tplv-k3ldphp9j8-origin-jpeg.jpeg? |sico attachment url | ^^^sioc_file_type |string |N |PHOTO |sioc attachment type:
• PHOTO
• DOCUMENT
• DROP_TEST_VIDEO | ^bulky_item_attribute |object |N | |bulky item info | ^^is_bulky_item_accessories |bool |N |false |whether the goods is bulky accessories | ^goods_safety_attributes |object |N | |safety attribute info | ^^is_fragile |bool |N |false |whether fragile | ^^is_liquid |bool |N |false |whether liquid | ^^is_sharp |bool |N |false |whether sharp |

Query

https://open-api.tiktokglobalshop.com/fbt/202607/goods/update_goods_info?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY

Body

{"update_goods_dto":{"tts_goods_id":"8839232030","goods_name":"Wireless Charging Cable","goods_image_url":"https://example.com/fbt/goods-image.jpg","reference_code":"ABDK999d","barcode_infos":[{"barcode_type":"UPC","barcode_value":"223333"}],"return_handling_method":"RESTOCK_SELLABLE_DISPOSE_UNSELLABLE","dimension_and_weight_base_info":{"weight_value":"500","length_value":"40","width_value":"20","height_value":"30","weight_unit":"GRAM","dimension_unit":"CENTIMETER"},"is_hazmat":false,"hazmat_info":{"hazmat_type":"BATTERY","battery_extra_info":{"battery_type":"LITHIUM_ION","battery_packaging_type":"STANDALONE","total_battery_weight":"10","total_battery_weight_unit":"GRAM","total_battery_capacity":"2","total_battery_capacity_unit":"WATTHOUR","is_need_un_38_3_test":false,"un_38_3_test_file_url":"https://example.com/fbt/un38-3-test-report.pdf","battery_count_per_package":"3"},"flammable_liquids_extra_info":{"flammable_liquids_type":"PAINT","flammable_liquids_volume":"1","volume_unit":"MILLILITERS"},"dg_class":"CLASS_3","dg_uncode":"UN2807","msds_file_url":"https://example.com/fbt/msds-report.pdf","aerosol_extra_info":{"volume":"1","volume_unit":"MILLILITERS"}},"is_lot_code":false,"is_expiration_management":false,"shelf_life_attribute_info":{"shelf_life":10,"inbound_cutoff_days":90,"expiration_alert_days":80,"sales_cutoff_days":70,"handling_method_expired_goods":"DISPOSE"},"is_sioc":false,"sioc_attribute":{"sioc_files":[{"sioc_certification_url":"https://p-boei18n.byted.org/tos-boei18n-i-0euhj0x6u9/beec7f914a044902a0c5dc929b97d064~tplv-k3ldphp9j8-origin-jpeg.jpeg?","sioc_file_type":"PHOTO"}]},"bulky_item_attribute":{"is_bulky_item_accessories":false},"goods_safety_attributes":{"is_fragile":false,"is_liquid":false,"is_sharp":false}}}

{"code":0,"data":{"update_result_info":{"tts_goods_id":"1233444","is_success":true,"fail_reason":"Goods update failed."}},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code