(24) FBT inventory update

POST

This webhook is triggered when the FBT inventory updates.

Prerequisite: The Fulfilled by TikTok(FBT) Info API scope is enabled in Partner Center. For more information, refer to Access Scope.

Authorizations

• webhookSignature

Request Body^required

Media typeapplication/json

object

type

required

The ID of the webhook type.

integer

Allowed value: 24

tts_notification_id

The ID of this webhook notification.

string

seller_open_id

The open_id of the seller. For more information, refer to Authorization overview.

string

timestamp

The time when this webhook is triggered. Unix timestamp.

integer format: int64

data

object

goods_id

FBT goods ID.

string

sku_id

TikTok Shop SKU ID.

string

fbt_warehouse_inventory

Inventory in different FBT warehouses.

Array<object>

object

fbt_warehouse_id

ID of the FBT warehouse.

string

on_hand_detail

The number of units physically in the warehouse, excluding those in transit or damaged.

object

total_quantity

The total number of units.

integer format: int64

reserved_quantity

The number of units reserved for confirmed orders and yet to be outbound.

integer format: int64

available_quantity

The number of units available for sale. This does not include reserved units.

integer format: int64

update_time

The time when the action occurred. Unix timestamp.

integer format: int64

Example

{
  "type": 24,
  "seller_open_id": "VIyStQAAAADCBQ40s4TzOSSOEIW-bM5O9cod3vK8OytW8m-bnBYlXw",
  "tts_notification_id": "7327112393057371910",
  "timestamp": 1644412885,
  "data": {
    "goods_id": "732357708734418520388",
    "sku_id": "123513234",
    "fbt_warehouse_inventory": [
      {
        "fbt_warehouse_id": "73823232239293999999",
        "on_hand_detail": {
          "total_quantity": 7,
          "reserved_quantity": 5,
          "available_quantity": 2
        }
      }
    ],
    "update_time": 1644412845
  }
}

Responses

200

Return HTTP 200 to acknowledge receipt.