> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 商品

## 事件列表

| **事件名称** | **事件类型** | **触发时机** | **通知数据结构** |
| - | - | - | - |
| 商品新建通知 | v2.product.created | 商品创建成功时 | [Product](#事件对象) |
| 商品更新通知 | v2.product.updated | 商品信息或状态更新成功时 | [Product](#事件对象) |
| 商品删除通知 | v2.product.deleted | 商品删除成功时 | [Product](#事件对象) |

> [!NOTE]
>
> 通知数据仅包含商品的标识与状态信息。如需商品详情，请使用 `product_id` 调用 [获取商品](https://docs.subotiz.com/zh/api/v1-product-get-product.md) 接口查询。

## 事件对象

| **属性** | **类型** | **描述** | **示例** |
| - | - | - | - |
| merchant\_id | string | 商户 ID | 100010 |
| product\_id | string | Subotiz 商品 ID | 583564652533787306 |
| merchant\_product\_id | string | 商户侧商品 ID | sku\_basic\_001 |
| product\_version\_id | string | 商品版本 ID | 583564652533787307 |
| status | string | 商品状态： `draft` - 草稿 `active` - 已激活 `disabled` - 已停用 | active |
| source | string | 操作来源 | openapi |
| operated\_at | string | 操作时间（RFC3339） | 2026-11-19T08:00:00Z |

> [!TIP]
>
> Webhook 可能因重试等原因乱序到达。请以 `operated_at` 判断事件先后，避免旧事件覆盖新状态。

## 示例

```json v2.product.created theme={null}
{
  "id": "583564652533787401",
  "type": "v2.product.created",
  "created": "2026-11-19T08:00:00Z",
  "data": {
    "merchant_id": "100010",
    "product_id": "583564652533787306",
    "merchant_product_id": "sku_basic_001",
    "product_version_id": "583564652533787307",
    "status": "draft",
    "source": "openapi",
    "operated_at": "2026-11-19T08:00:00Z"
  }
}
```

```json v2.product.updated theme={null}
{
  "id": "583564652533787402",
  "type": "v2.product.updated",
  "created": "2026-11-19T09:00:00Z",
  "data": {
    "merchant_id": "100010",
    "product_id": "583564652533787306",
    "merchant_product_id": "sku_basic_001",
    "product_version_id": "583564652533787308",
    "status": "active",
    "source": "openapi",
    "operated_at": "2026-11-19T09:00:00Z"
  }
}
```

```json v2.product.deleted theme={null}
{
  "id": "583564652533787403",
  "type": "v2.product.deleted",
  "created": "2026-11-19T10:00:00Z",
  "data": {
    "merchant_id": "100010",
    "product_id": "583564652533787306",
    "merchant_product_id": "sku_basic_001",
    "product_version_id": "583564652533787308",
    "status": "disabled",
    "source": "openapi",
    "operated_at": "2026-11-19T10:00:00Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.