将商品及其全部 SKU 设置为不可销售状态。

9.1 请求

POST /openapi/products/{spuId}/actions/offline
{
  "reason": "供应商停止销售"
}
字段 类型 必填 说明
reason string 否 下架原因,最多 500 个字符

9.2 成功响应

HTTP 状态码:200 OK

{
  "code": "SUCCESS",
  "message": "商品已下架",
  "data": {
    "spuId": "spu-100001",
    "productCode": "P-100001",
    "offlineTime": "2026-08-26T10:30:00+08:00"
  }
}

9.3 业务规则

  • 使用“当前供应商 + spuId”定位商品。
  • 商品下架后,其全部 SKU 同时变为不可销售。
  • 下架操作应同步更新商品目录、搜索结果和购物车中的商品可售状态。
  • 下架不会删除商品、SKU 或历史订单数据。
  • 已下架商品重复调用该接口按成功处理。
  • 本期不开放第三方供应商直接上架;商品重新上架仍需遵循平台审核流程。
作者:吴群杰  创建时间:2026-10-10 16:17
最后编辑:吴群杰  更新时间:2026-10-10 17:37