Search Goods Hazmat And Expiration Info

POST

/fbt/202603/goods/hazmat_and_expiration_info/search

Search hazmat and expiration information for goods by TikTok Shop SKU IDs.

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

tts_sku_ids

required

Identifier for Stock Keeping Unit (SKU) generated by TikTok Shop system

Array<string>

Example

{
  "tts_sku_ids": [
    "723456789012345678"
  ]
}

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

hazmat_and_expiration_info

Container for per-SKU hazmat, lot-control, and expiration-management results.

object

hazmat_and_expiration_dto_list

Per-SKU hazmat, lot-control, and expiration-management results. Correlate each entry with the requested SKU using tts_sku_id.

Array<object>

object

tts_sku_id

Identifier for Stock Keeping Unit (SKU) generated by TikTok Shop system

string

is_hazmat

Indicates whether the product is classified as hazardous material under FBT rules.

• true: The product is classified as hazardous material. Provide the required hazmat declaration through hazmat_info when calling Create FBT Goods or Update FBT Goods Info.
• false: The product is not classified as hazardous material.

boolean

is_lot_code

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

boolean

is_expiration_management

Indicates whether the product requires expiration management based on the FBT category rule. TRUE: this product requires expiration management. FALSE: this product does not require expiration management.

boolean

exp_base_info

Expiration-management thresholds for the product associated with the SKU when is_expiration_management is true.

object

inbound_cutoff_days

The period before a product’s expiration date when the warehouse will stop accepting inbound shipments.For example, if the product expiration date is December 1, 2024, and the inbound cutoff days are 20 days, then the warehouse will stop accepting inbound shipments for this product after November 11, 2024 (20 days before expiration)

integer format: int64

expiration_alert_days

The period of time before expiration in which the platform will send expiration alerts.

integer format: int64

sales_cutoff_days

The period before a product’s expiration date when the inventory will no longer be available for sale. For example, if the product expiration date is December 1, 2024, and the sales cutoff days are 20 days, then the inventory will stop being available for sale after November 11, 2024 (20 days before expiration).

integer format: int64

Example

{
  "code": 0,
  "data": {
    "hazmat_and_expiration_info": {
      "hazmat_and_expiration_dto_list": [
        {
          "tts_sku_id": "723456789012345678",
          "is_hazmat": false,
          "is_lot_code": true,
          "is_expiration_management": true,
          "exp_base_info": {
            "inbound_cutoff_days": 90,
            "expiration_alert_days": 80,
            "sales_cutoff_days": 70
          }
        }
      ]
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}