Sugumart Issues

Appearance

露天商品已关联店铺分类，但前台未展示 ​

问题概述 ​

店铺 cn_yorknewcity 的商品 72635468557075 已成功上架，露天商品详情 API 也返回了店铺分类 6587714。同一店铺的分类列表中确实存在这个分类，但在露天前台没有按该店铺分类展示商品。

本文只整理 2026-08-24 生产环境只读查询确认的关键事实，用于说明问题。现有证据能够确认商品与分类的数据关系，不足以判断露天前台未展示的具体技术根因。

打入露天的数据 ​

商品通过以下露天商品接口写入：

http
POST https://partner.ruten.com.tw/api/v1/product/item

提交的商品资料如下。与分类展示问题直接相关的是 store_class_id：请求中已经明确传入 6587714，不是商品上架后才在本地补记的分类编号。

json
{
  "name": "897993-BBK Skechers斯凱奇 MEMORY FOAM 舒適 減震透氣輕便 低幫 生活休閒鞋 女款 黑色",
  "class_id": "00180033001000090007",
  "has_spec": true,
  "location": "海外地區",
  "condition": 1,
  "spec_info": [
    {
      "qty": 3,
      "price": 1746,
      "status": true,
      "custom_no": "897993-BBK-917454052",
      "spec_name": "EUR36/US6/23.0cm"
    },
    {
      "qty": 3,
      "price": 1746,
      "status": true,
      "custom_no": "897993-BBK-917454049",
      "spec_name": "EUR36.5/US6.5/23.5cm"
    },
    {
      "qty": 3,
      "price": 1746,
      "status": true,
      "custom_no": "897993-BBK-917454050",
      "spec_name": "EUR37/US7/24.0cm"
    },
    {
      "qty": 3,
      "price": 1746,
      "status": true,
      "custom_no": "897993-BBK-917454055",
      "spec_name": "EUR37.5/US7.5/24.5cm"
    }
  ],
  "description": "<style type=\"text/css\"><!--div.ruten-seller-description {width: 100%;}div.ruten-seller-description img {max-width: 100%; height: auto; display: block;}--></style><div class=\"ruten-seller-description\"><div class=\"ruten-seller-description-body\"><div style=\"text-align:center;margin:0;padding:0;\"><img src=\"https://static.sugumart.com/public/openapi/products/00c7a91e-06a1-4b91-b908-84f18b99bcb4/ef18ad98-9834-4cf8-bdd1-66ff6582aacd/detail/b687e35c-78fa-4cd3-a742-c9eceea096bb.png\" style=\"width:100%;max-width:900px;display:block;margin:0 auto;\"></div><div style=\"text-align:center;margin:0;padding:0;\"><img src=\"https://static.sugumart.com/public/openapi/products/00c7a91e-06a1-4b91-b908-84f18b99bcb4/ef18ad98-9834-4cf8-bdd1-66ff6582aacd/detail/b7c44cf8-0e48-4254-9b3b-f7ee7be1f499.png\" style=\"width:100%;max-width:900px;display:block;margin:0 auto;\"></div><div style=\"text-align:center;margin:0;padding:0;\"><img src=\"https://static.sugumart.com/public/openapi/products/00c7a91e-06a1-4b91-b908-84f18b99bcb4/9eba9066-4885-41f6-86b8-5265b0d80b80/detail/9d3d9ff7-98bc-4917-a7a6-9b1e5a04ddcd.png\" style=\"width:100%;max-width:900px;display:block;margin:0 auto;\"></div><p>897993-BBK Skechers斯凱奇 MEMORY FOAM 舒適 減震透氣輕便 低幫 生活休閒鞋 女款 黑色（897993-BBK）。全新正品，跨境直送，專業鑑別後防偽包裝出貨。</p></div></div>",
  "stock_status": "7DAY",
  "is_goods_sale": false,
  "location_type": 2,
  "store_class_id": "6587714",
  "shipping_setting": "1"
}

商品关键信息 ​

项目API 返回值通俗说明
露天商品编号72635468557075本次出现分类展示问题的商品
商品状态online商品目前处于上架状态
商品名称897993-BBK Skechers斯凱奇 MEMORY FOAM 舒適 減震透氣輕便 低幫 生活休閒鞋 女款 黑色Skechers 女款黑色休闲鞋
露天类目00180033001000090007商品刊登使用的露天平台类目
店铺分类6587714商品详情明确返回的卖场自订分类
是否多规格true商品使用多规格销售

查询接口：

http
GET https://partner.ruten.com.tw/api/v1/product/item/72635468557075

接口返回 HTTP 200、业务状态 success。与问题直接相关的响应如下：

json
{
  "item_id": "72635468557075",
  "item_status": "online",
  "name": "897993-BBK Skechers斯凱奇 MEMORY FOAM 舒適 減震透氣輕便 低幫 生活休閒鞋 女款 黑色",
  "class_id": "00180033001000090007",
  "store_class_id": "6587714",
  "has_spec": true
}

店铺分类关键信息 ​

该店铺的露天分类列表共有 92 个分类，其中包含商品使用的 store_class_id=6587714：

项目API 返回值通俗说明
店铺分类编号6587714与商品详情中的分类编号完全一致
分类名称Skechers 休閒鞋分类内容与商品品牌和鞋款相符
商品排序方式new分类内按最新刊登排序
显示顺序60该分类在店铺分类列表中的展示顺序

查询接口：

http
GET https://partner.ruten.com.tw/api/v1/product/store_class/list

接口返回 HTTP 200、业务状态 success。匹配到的分类如下：

json
{
  "store_class_id": "6587714",
  "store_class_name": "Skechers 休閒鞋",
  "item_sort_mode": "new",
  "display_sort": 60
}

当前结论 ​

两次查询使用的是同一店铺的露天 API 凭证，结果可以互相对应：

  1. 商品已经上架，状态为 online。
  2. 商品详情明确关联店铺分类 6587714。
  3. 当前店铺分类列表中存在 6587714，名称为 Skechers 休閒鞋。
  4. 商品品牌、类型与分类名称相符。

因此，目前可以确认商品和店铺分类在 API 数据层已经建立关系。问题现象是露天前台没有按该分类展示商品，后续需要针对露天前台的分类收录或展示链路继续定位；本文不把尚未验证的可能性写成根因。