POST/cqy/goodsList开放/回调

对接方 CQY（代号待业务确认）-product列表 · productList 推断名·方法名推断

开放与对接 / 对接方 CQY（代号待业务确认）· OpenapiCqyRecordController#productList

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/open-api/cqy/goodsList
请求方式POST
暴露渠道开放/回调　前缀 /open-api
名称来源方法名推断　补 javadoc 后自动转正
调用方已确认在用 · 湘工惠商城（1 个前端）
需求上下文春秋游&卡包接口&交行
维护人 / 最后改动liuxu　2026-03-18　最近提交：春秋游&卡包接口&交行
读写数据表goods、goods_info、sku、sku_entrance、goods_relation、shop、region　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#productList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/OpenapiCqyRecordController.java:266
判定依据1 个调用点：xghmall/common/http.api.js

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 List<GoodsResponse>

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	商品id，主键 → shop.id
merchantId	…	否	Long	所属商户id，关联merchant表id → shop.merchant_id
shopId	…	否	Long	所属商铺id，关联shop表id → sku.shop_id
name	…	否	String	商品名称 → shop.name
mainPic	…	否	String	商品主图 → shop.main_pic
typeId	…	否	String	商品大类id → shop.type_id
cardModelId	…	否	Long	卡种id → goods.card_model_id
subTypeId	…	否	String	商品小类id → shop.sub_type_id
grade	…	否	String	商品等级 → goods.grade
status	…	否	GoodsStatus	商品状态，1正常，2编辑中，3已下架 → shop.status 1＝已上架 2＝编辑中 3＝已下架
qrcode	…	否	String	商品二维码 → goods.qrcode
shopsName	…	否	String	商铺名称
shortName	…	否	String	商品简称 → region.short_name
weight	…	否	Integer	商品权重 → goods_info.weight
tags	…	否	String	商品标签 → shop.tags
buyPrice	…	否	Integer	商品实际售价 → sku.buy_price
salesAmount	…	否	Integer	累计销售金额
recommendReason	…	否	String	推荐理由 → goods_info.recommend_reason
introduction	…	否	String	简介 → shop.introduction
propagatePic	…	否	String	宣传图片url地址 → shop.propagate_pic
video	…	否	String	宣传视频url地址 → shop.video
notice	…	否	String	购买须知 → goods_info.notice
tips	…	否	String	温馨提示 → shop.tips
skuList	…	否	List<SkuResponse>	sku列表
id	…	否	Long	商品SKUID，主键 → shop.id
goodsId	…	否	Long	商品ID，关联商品表id → sku.goods_id
goodsChannelId	…	否	Long	关联商品渠道id → sku.goods_channel_id
skuName	…	否	String	sku名称 → sku.sku_name
showPrice	…	否	Integer	商品挂牌价 → sku.show_price
buyPrice	…	否	Integer	商品实际售价 → sku.buy_price
costPrice	…	否	Integer	商品成本价 → sku.cost_price
buyCount	…	否	Integer	单次可购买数量 → sku.buy_count
stock	…	否	Integer	库存数量 → sku.stock
isLogistic	…	否	Boolean	是否需要物流 → sku.is_logistic
carriageId	…	否	Long	物流模版ID，关联carriage表id → sku.carriage_id
mold	…	否	GoodsMold	商品状态，1实物商品，2虚拟商品，3电子卡券 → sku.mold 1＝实物商品 2＝虚拟商品 3＝电子卡券
isDistributes	…	否	Boolean	是否可分销 → sku.is_distributes
commission	…	否	Integer	分销佣金 → sku.commission
isPreferential	…	否	Boolean	是否可使用优惠券 → sku.is_preferential
isUseScore	…	否	Boolean	是否可使用积分抵扣 → sku.is_use_score
isAddScore	…	否	Boolean	购买后是否产生积分 → sku.is_add_score
useScoreRate	…	否	BigDecimal	抵扣积分倍率 → sku.use_score_rate
addScoreRate	…	否	BigDecimal	产生积分倍率 → sku.add_score_rate
cardNum	…	否	Integer	发卡数量，仅旅游卡商品 → sku.card_num
skuEntranceList	…	否	List<SkuEntrance>	景区入口列表
id	…	否	Long	ID，主键 → shop.id
skuId	…	否	Long	所属关联sku表id → sku_entrance.sku_id
entranceName	…	否	String	景区入口名称 → sku_entrance.entrance_name
merchantId	…	否	Long	所属商户id → shop.merchant_id
shopId	…	否	Long	所属商铺id → sku.shop_id
goodsId	…	否	Long	商品ID，关联商品表id → sku.goods_id
createdBy	…	否	String	创建人id → shop.created_by
createdTime	…	否	Date	创建时间 → shop.created_time
relationList	…	否	List<GoodsRelationResponse>
id	…	否	Long	id → shop.id
goodsId	…	否	Long	goodsId → sku.goods_id
channelType	…	否	ChannelType	类型 → goods_relation.channel_type
thirdId	…	否	String	第三方id → shop.third_id
thirdName	…	否	String	第三方名称 → shop.third_name
createdTime	…	否	Date	创建时间 → shop.created_time
updatedTime	…	否	Date	修改时间 → shop.updated_time
businessTime	…	否	String	营业时间 → shop.business_time
thirdId	…	否	String	第三方id → shop.third_id
thirdName	…	否	String	第三方名称 → shop.third_name
expireDate	…	否	Date	→ goods_info.expire_date
isRefund	…	否	Boolean	→ goods_info.is_refund
areaInfo	…	否	String
shop	…	否	Shop
id	…	否	Long	商铺id，主键 → shop.id
merchantId	…	否	Long	所属商户id，关联merchant表id → shop.merchant_id
merchantType	…	否	MerchantType	商户类型 → shop.merchant_type 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方
name	…	否	String	商铺名称 → shop.name
logo	…	否	String	商铺LOGO图片url地址 → shop.logo
typeId	…	否	Long	商铺大类 → shop.type_id
subTypeId	…	否	Long	商铺小类ID → shop.sub_type_id
status	…	否	ShopStatus	商铺状态，1正常运营，2审核中，3暂停运营，4已关店 → shop.status 1＝正常运营 2＝审核中 3＝暂停运营 4＝已关店
provinceId	…	否	String	省id → shop.province_id
cityId	…	否	String	市id → shop.city_id
districtId	…	否	String	区县id → shop.district_id
address	…	否	String	商铺地址 → shop.address
mobile	…	否	String	客服电话 → shop.mobile
linkman	…	否	String	商户联系人 → shop.linkman
linkphone	…	否	String	商户联系人手机 → shop.linkphone
manager	…	否	String	专属客户经理 → shop.manager
level	…	否	String	等级 → shop.level
lng	…	否	String	经度 → shop.lng
lat	…	否	String	纬度 → shop.lat
introduction	…	否	String	简介 → shop.introduction
businessTime	…	否	String	营业时间 → shop.business_time
tags	…	否	String	商铺标签 → shop.tags
mainPic	…	否	String	景区主图url地址 → shop.main_pic
propagatePic	…	否	String	宣传图片url地址 → shop.propagate_pic
video	…	否	String	景区视频url地址 → shop.video
poster	…	否	String	分享海报url地址 → shop.poster
propagateContent	…	否	String	宣传语 → shop.propagate_content
description	…	否	String	图文详情 → shop.description
ticketInfo	…	否	String	门票信息 → shop.ticket_info
trafficInfo	…	否	String	交通信息 → shop.traffic_info
tips	…	否	String	温馨提示 → shop.tips
isDeleted	…	否	Boolean	是否删除 → shop.is_deleted
createdBy	…	否	String	创建人id → shop.created_by
createdTime	…	否	Date	创建时间 → shop.created_time
updatedBy	…	否	String	更新人id → shop.updated_by
updatedTime	…	否	Date	修改时间 → shop.updated_time
thirdId	…	否	String	第三方id → shop.third_id
thirdName	…	否	String	第三方名称 → shop.third_name

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "merchantId": "1",
    "shopId": "1",
    "name": "\"string\"",
    "mainPic": "\"string\"",
    "typeId": "\"string\"",
    "cardModelId": "1",
    "subTypeId": "\"string\"",
    "grade": "\"string\"",
    "status": "1",
    "qrcode": "\"string\"",
    "shopsName": "\"string\""
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：goods、goods_info、sku、sku_entrance、goods_relation、shop、region　反查全部引用接口 →

OpenapiCqyRecordController#productList
GoodsService#queryList（GoodsServiceImpl）
GoodsMapper#queryList
GoodsInfoService#mustGet（GoodsInfoServiceImpl）
GoodsInfoMapper#mustGet
SkuService#queryList（SkuServiceImpl）
SkuMapper#queryList
SkuEntranceService#queryList（SkuEntranceServiceImpl）
SkuEntranceMapper#queryList
GoodsRelationService#queryList（GoodsRelationServiceImpl）
GoodsRelationMapper#queryList
BeanUtils.map → GoodsResponse
BeanUtils.mapList → SkuResponse
BeanUtils.mapList → GoodsRelationResponse

其它依赖：GoodsInfoService.mustGet

逻辑摘要：列表查询（goodsService.queryList）；查询详情（goodsService.get）；调用 mustGet（goodsInfoService.mustGet）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

查询商品信息
查询sku
查询relation

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

xghmall/common/http.api.js:76　湘工惠商城 · goodsListUrl