商品SKU sku

模块 sku：共 9 个接口 —— 9 个被前端调用（在用），0 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

SkuController 9/9 在用

POST /sku/addSku 在用管理后台 #
Sku-新增 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#addSku
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#addSku
转换BeanUtils.map → Sku ⇒ 表 sku
ServiceSkuService#add （SkuServiceImpl）
MapperSkuMapper#insert ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/addSku
uathttps://dscp-uat.hn12301.net/manage-api/sku/addSku
prohttps://dscp-uat.hn12301.net/manage-api/sku/addSku （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuAddRequest
字段类型必填取值/校验表 / 列说明
goodsIdLong是必填sku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
skuNameString是必填sku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
skuEntranceListList<SkuEntrance>—景区入口
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
cardNumInteger否可选(@MvcOptional)sku.card_num发卡数量，仅旅游卡商品
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SkuResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongsku.id商品SKUID，主键
goodsIdLongsku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
skuNameStringsku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
cardNumIntegersku.card_num发卡数量，仅旅游卡商品
skuEntranceListList<SkuEntrance>—景区入口列表
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
示例
请求示例 （自动生成，仅结构参考）
POST /sku/addSku
{
  "body": {
    "goodsId": 1,
    "goodsChannelId": 1,
    "skuName": "",
    "showPrice": 0,
    "buyPrice": 0,
    "costPrice": 0,
    "buyCount": 0,
    "stock": 0,
    "isLogistic": false,
    "carriageId": 1,
    "mold": "1",
    "isDistributes": false,
    "commission": 0,
    "isPreferential": false,
    "isUseScore": false,
    "isAddScore": false,
    "useScoreRate": 0,
    "addScoreRate": 0,
    "skuEntranceList": [
      {
        "id": 1,
        "skuId": 1,
        "entranceName": "",
        "merchantId": 1,
        "shopId": 1,
        "goodsId": 1,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "cardNum": 0
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsId": 1,
    "goodsChannelId": 1,
    "skuName": "",
    "showPrice": 0,
    "buyPrice": 0,
    "costPrice": 0,
    "buyCount": 0,
    "stock": 0,
    "isLogistic": false,
    "carriageId": 1,
    "mold": "1",
    "isDistributes": false,
    "commission": 0,
    "isPreferential": false,
    "isUseScore": false,
    "isAddScore": false,
    "useScoreRate": 0,
    "addScoreRate": 0,
    "cardNum": 0,
    "skuEntranceList": [
      {
        "id": 1,
        "skuId": 1,
        "entranceName": "",
        "merchantId": 1,
        "shopId": 1,
        "goodsId": 1,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ]
  }
}
处理逻辑
操作日志sku / 新增商品SKU
逻辑摘要新增（skuService.add）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方
dscp-html-manage addSku exact
POST /sku/deleteSku 在用管理后台 #
Sku-删除 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#deleteSku
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#deleteSku
ServiceSkuService#delete （SkuServiceImpl）
MapperSkuMapper#deleteById ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/deleteSku
uathttps://dscp-uat.hn12301.net/manage-api/sku/deleteSku
prohttps://dscp-uat.hn12301.net/manage-api/sku/deleteSku （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填sku.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /sku/deleteSku
{
  "body": {
    "id": 1
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志sku / 删除商品SKU
逻辑摘要删除（skuService.delete）
前端调用方
dscp-html-manage deleteSku exact
POST /sku/getSku 在用管理后台 #
Sku-详情 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#getSku
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#getSku
ServiceSkuService#get （SkuServiceImpl）
MapperSkuMapper#selectById ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/getSku
uathttps://dscp-uat.hn12301.net/manage-api/sku/getSku
prohttps://dscp-uat.hn12301.net/manage-api/sku/getSku （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填sku.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SkuResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongsku.id商品SKUID，主键
goodsIdLongsku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
skuNameStringsku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
cardNumIntegersku.card_num发卡数量，仅旅游卡商品
skuEntranceListList<SkuEntrance>—景区入口列表
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
示例
请求示例 （自动生成，仅结构参考）
POST /sku/getSku
{
  "body": {
    "id": 1
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "goodsId": 1,
    "goodsChannelId": 1,
    "skuName": "",
    "showPrice": 0,
    "buyPrice": 0,
    "costPrice": 0,
    "buyCount": 0,
    "stock": 0,
    "isLogistic": false,
    "carriageId": 1,
    "mold": "1",
    "isDistributes": false,
    "commission": 0,
    "isPreferential": false,
    "isUseScore": false,
    "isAddScore": false,
    "useScoreRate": 0,
    "addScoreRate": 0,
    "cardNum": 0,
    "skuEntranceList": [
      {
        "id": 1,
        "skuId": 1,
        "entranceName": "",
        "merchantId": 1,
        "shopId": 1,
        "goodsId": 1,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ]
  }
}
处理逻辑
逻辑摘要查询详情（skuService.get）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方
dscp-html-manage getSku exact
POST /sku/queryCardResourceSkuCascadeList 在用管理后台 #
Sku-卡种资源列表级联查询 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#queryCardResourceSkuCascadeList
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表shop
ControllerSkuController#queryCardResourceSkuCascadeList
ServiceShopService#queryList （ShopServiceImpl）
MapperShopMapper#selectList ⇒ 表 shop
ServiceShopService#shopIdsCascadeListByMerchant （ShopServiceImpl）
MapperShopMapper#shopIdsCascadeListByMerchant ⇒ 表 shop
ServiceShopService#shopIdsCascadeListByShop （ShopServiceImpl）
MapperShopMapper#shopIdsCascadeListByShop ⇒ 表 shop
其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3
SessionUserService.isPlatformUserSessionUserService.isMerchantSessionUserService.isShop

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/queryCardResourceSkuCascadeList
uathttps://dscp-uat.hn12301.net/manage-api/sku/queryCardResourceSkuCascadeList
prohttps://dscp-uat.hn12301.net/manage-api/sku/queryCardResourceSkuCascadeList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuResourceListRequest
字段类型必填取值/校验表 / 列说明
merchantIdLongshop.merchant_id商户id
shopIdLong—商铺id
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<CascadeOption>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
valueObject—值
labelString—显示名称
childrenList<CascadeOption>—子列表
children[].…（循环引用，已折叠）—
示例
请求示例 （自动生成，仅结构参考）
POST /sku/queryCardResourceSkuCascadeList
{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "value": "",
      "label": "",
      "children": [
        {}
      ]
    }
  ]
}
处理逻辑
逻辑摘要调用 isPlatformUser（sessionService.isPlatformUser）；列表查询（shopService.queryList）；调用 isMerchant（sessionService.isMerchant）
内联注释
  • 平台用户可查询所有商铺数据
  • 查询当前登录用户商户下的商铺及签约商铺
  • 查询当前登录用户商铺所属商铺及签约商铺
  • 设置第一级商铺信息
  • 设置第二级商铺商品信息
前端调用方
dscp-html-manage queryCardResourceSkuCascadeList exact
POST /sku/querySkuCascadeList 在用管理后台 #
卡种资源列表级联查询 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#querySkuCascadeList
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）
调用链路（控制器方法内未解析到 Service/Mapper 调用，可能为接口声明或简单转发）
环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/querySkuCascadeList
uathttps://dscp-uat.hn12301.net/manage-api/sku/querySkuCascadeList
prohttps://dscp-uat.hn12301.net/manage-api/sku/querySkuCascadeList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuRequest
字段类型必填取值/校验表 / 列说明
shopIdLong—商铺id
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<CascadeOption>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
valueObject—值
labelString—显示名称
childrenList<CascadeOption>—子列表
children[].…（循环引用，已折叠）—
示例
请求示例 （自动生成，仅结构参考）
POST /sku/querySkuCascadeList
{
  "body": {
    "shopId": 1,
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "value": "",
      "label": "",
      "children": [
        {}
      ]
    }
  ]
}
处理逻辑
逻辑摘要见下方调用链
前端调用方
dscp-html-manage querySkuCascadeList exact
POST /sku/querySkuList 在用管理后台 #
Sku-列表查询 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#querySkuList
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#querySkuList
转换BeanUtils.map → SkuQuery
ServiceSkuService#queryList （SkuServiceImpl）
MapperSkuMapper#selectList ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/querySkuList
uathttps://dscp-uat.hn12301.net/manage-api/sku/querySkuList
prohttps://dscp-uat.hn12301.net/manage-api/sku/querySkuList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuListRequest
字段类型必填取值/校验表 / 列说明
merchantIdLongsku.merchant_id商户id
shopIdLongsku.shop_id商铺id
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<SkuResponse>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
idLongsku.id商品SKUID，主键
goodsIdLongsku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
skuNameStringsku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
cardNumIntegersku.card_num发卡数量，仅旅游卡商品
skuEntranceListList<SkuEntrance>—景区入口列表
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
示例
请求示例 （自动生成，仅结构参考）
POST /sku/querySkuList
{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "goodsId": 1,
      "goodsChannelId": 1,
      "skuName": "",
      "showPrice": 0,
      "buyPrice": 0,
      "costPrice": 0,
      "buyCount": 0,
      "stock": 0,
      "isLogistic": false,
      "carriageId": 1,
      "mold": "1",
      "isDistributes": false,
      "commission": 0,
      "isPreferential": false,
      "isUseScore": false,
      "isAddScore": false,
      "useScoreRate": 0,
      "addScoreRate": 0,
      "cardNum": 0,
      "skuEntranceList": [
        {
          "id": 1,
          "skuId": 1,
          "entranceName": "",
          "merchantId": 1,
          "shopId": 1,
          "goodsId": 1,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00"
        }
      ]
    }
  ]
}
处理逻辑
逻辑摘要列表查询（skuService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方
dscp-html-manage querySkuList exact
POST /sku/querySkuPage 在用管理后台 #
Sku-分页查询 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#querySkuPage
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#querySkuPage
转换BeanUtils.map → SkuQuery
ServiceSkuService#queryPage （SkuServiceImpl）
MapperSkuMapper#selectPage ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/querySkuPage
uathttps://dscp-uat.hn12301.net/manage-api/sku/querySkuPage
prohttps://dscp-uat.hn12301.net/manage-api/sku/querySkuPage （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuPageRequest
字段类型必填取值/校验表 / 列说明
pageNumInteger否—页码（继承自框架分页基类 AbstractPageRequest）
pageSizeInteger否—每页条数（继承自框架分页基类 AbstractPageRequest）
goodsIdLong否可选(@MvcOptional)sku.goods_id商品ID，关联商品表id
goodsChannelIdLong否可选(@MvcOptional)sku.goods_channel_id关联商品渠道id
skuNameString否可选(@MvcOptional)sku.sku_namesku名称
showPriceInteger否可选(@MvcOptional)sku.show_price商品挂牌价
buyPriceInteger否可选(@MvcOptional)sku.buy_price商品实际售价
costPriceInteger否可选(@MvcOptional)sku.cost_price商品成本价
buyCountInteger否可选(@MvcOptional)sku.buy_count单次可购买数量
stockInteger否可选(@MvcOptional)sku.stock库存数量
isLogisticBoolean否可选(@MvcOptional)sku.is_logistic是否需要物流
carriageIdLong否可选(@MvcOptional)sku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold否1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBoolean否可选(@MvcOptional)sku.is_distributes是否可分销
commissionInteger否可选(@MvcOptional)sku.commission分销佣金
isPreferentialBoolean否可选(@MvcOptional)sku.is_preferential是否可使用优惠券
isUseScoreBoolean否可选(@MvcOptional)sku.is_use_score是否可使用积分抵扣
isAddScoreBoolean否可选(@MvcOptional)sku.is_add_score购买后是否产生积分
useScoreRateBigDecimal否可选(@MvcOptional)sku.use_score_rate抵扣积分倍率
addScoreRateBigDecimal否可选(@MvcOptional)sku.add_score_rate产生积分倍率
idListList<Long>否可选(@MvcOptional)—id列表
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　PageInfo<SkuResponse>　（page）
字段类型必填取值/校验表 / 列说明
list / recordsarray—分页列表，元素结构见下
totallong—总条数（PageInfo）
idLongsku.id商品SKUID，主键
goodsIdLongsku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
skuNameStringsku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
cardNumIntegersku.card_num发卡数量，仅旅游卡商品
skuEntranceListList<SkuEntrance>—景区入口列表
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
示例
请求示例 （自动生成，仅结构参考）
POST /sku/querySkuPage
{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "goodsId": 1,
    "goodsChannelId": 1,
    "skuName": "",
    "showPrice": 0,
    "buyPrice": 0,
    "costPrice": 0,
    "buyCount": 0,
    "stock": 0,
    "isLogistic": false,
    "carriageId": 1,
    "mold": "1",
    "isDistributes": false,
    "commission": 0,
    "isPreferential": false,
    "isUseScore": false,
    "isAddScore": false,
    "useScoreRate": 0,
    "addScoreRate": 0,
    "idList": "",
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "goodsId": 1,
        "goodsChannelId": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "cardNum": 0,
        "skuEntranceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "total": 0
  }
}
处理逻辑
逻辑摘要分页查询（skuService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方
dscp-html-manage querySkuPage exact
POST /sku/querySkuResourceList 在用管理后台 #
Sku-资源列表查询 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#querySkuResourceList
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表skugoods_channel
ControllerSkuController#querySkuResourceList
ServiceSkuService#queryResourceList （SkuServiceImpl）
转换BeanUtils.mapList → SkuResourceResponse
MapperSkuMapper#queryList ⇒ 表 sku
ServiceGoodsChannelService#queryList （GoodsChannelServiceImpl）
MapperGoodsChannelMapper#selectList ⇒ 表 goods_channel

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/querySkuResourceList
uathttps://dscp-uat.hn12301.net/manage-api/sku/querySkuResourceList
prohttps://dscp-uat.hn12301.net/manage-api/sku/querySkuResourceList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuResourceListRequest
字段类型必填取值/校验表 / 列说明
merchantIdLongsku.merchant_id商户id
shopIdLongsku.shop_id商铺id
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<SkuResourceResponse>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
idLongsku.id商品skuId
skuNameStringsku.sku_namesku名称
示例
请求示例 （自动生成，仅结构参考）
POST /sku/querySkuResourceList
{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "skuName": ""
    }
  ]
}
处理逻辑
逻辑摘要列表查询（skuService.queryResourceList）
前端调用方
dscp-html-manage querySkuResourceList exact
POST /sku/updateSku 在用管理后台 #
Sku-更新 · SkuController
基本信息
控制器com.jxxx.dscp.api.controller.sku.SkuController#updateSku
所属模块商品SKU sku
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sku
ControllerSkuController#updateSku
转换BeanUtils.map → Sku ⇒ 表 sku
ServiceSkuService#update （SkuServiceImpl）
MapperSkuMapper#updateById ⇒ 表 sku

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sku/updateSku
uathttps://dscp-uat.hn12301.net/manage-api/sku/updateSku
prohttps://dscp-uat.hn12301.net/manage-api/sku/updateSku （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SkuUpdateRequest
字段类型必填取值/校验表 / 列说明
goodsIdLong是必填sku.goods_id商品ID，关联商品表id
goodsChannelIdLongsku.goods_channel_id关联商品渠道id
shopIdLongsku.shop_id
idLongsku.id商品id，主键
skuNameString是必填sku.sku_namesku名称
showPriceIntegersku.show_price商品挂牌价
buyPriceIntegersku.buy_price商品实际售价
costPriceIntegersku.cost_price商品成本价
buyCountIntegersku.buy_count单次可购买数量
stockIntegersku.stock库存数量
isLogisticBooleansku.is_logistic是否需要物流
carriageIdLongsku.carriage_id物流模版ID，关联carriage表id
moldGoodsMold是1实物商品2虚拟商品3电子卡券sku.mold商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
isDistributesBooleansku.is_distributes是否可分销
commissionIntegersku.commission分销佣金
isPreferentialBooleansku.is_preferential是否可使用优惠券
isUseScoreBooleansku.is_use_score是否可使用积分抵扣
isAddScoreBooleansku.is_add_score购买后是否产生积分
useScoreRateBigDecimalsku.use_score_rate抵扣积分倍率
addScoreRateBigDecimalsku.add_score_rate产生积分倍率
skuEntranceListList<SkuEntrance>—景区入口
skuEntranceList[].idLongsku.idID，主键
skuEntranceList[].skuIdLong—所属关联sku表id
skuEntranceList[].entranceNameString—景区入口名称
skuEntranceList[].merchantIdLongsku.merchant_id所属商户id
skuEntranceList[].shopIdLongsku.shop_id所属商铺id
skuEntranceList[].goodsIdLongsku.goods_id商品ID，关联商品表id
skuEntranceList[].createdByStringsku.created_by创建人id
skuEntranceList[].createdTimeDatesku.created_time创建时间
cardNumInteger否可选(@MvcOptional)sku.card_num发卡数量，仅旅游卡商品
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /sku/updateSku
{
  "body": {
    "goodsId": 1,
    "goodsChannelId": 1,
    "shopId": 1,
    "id": 1,
    "skuName": "",
    "showPrice": 0,
    "buyPrice": 0,
    "costPrice": 0,
    "buyCount": 0,
    "stock": 0,
    "isLogistic": false,
    "carriageId": 1,
    "mold": "1",
    "isDistributes": false,
    "commission": 0,
    "isPreferential": false,
    "isUseScore": false,
    "isAddScore": false,
    "useScoreRate": 0,
    "addScoreRate": 0,
    "skuEntranceList": [
      {
        "id": 1,
        "skuId": 1,
        "entranceName": "",
        "merchantId": 1,
        "shopId": 1,
        "goodsId": 1,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "cardNum": 0
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志sku / 更新商品SKU
逻辑摘要更新（skuService.update）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方
dscp-html-manage updateSku exact