接口描述:

  • 收银端首页 商品列表

接口版本:

版本号 制定人 制定日期 修订日期
1.0.0 庞晓宇 2021-07-16 2021-07-16

请求URL:

  • 商户接口URL:/api/mchGoods/list

请求方式:

  • GET
  • POST

请求参数:

参数名 是否必须 类型 说明
page string 页号
limit string 页码 是否查询全部列表(-1)
industryType string 固定值-4
cashSearchData string 商品名称或条码
categoryId string 商品分类ID
industryType string 4-线下餐饮 5-线下零售(门店类型StoreType为1-餐饮 对应参数4, 2-零售 对应参数5)

返回参数说明:

参数名 类型 说明
code int 0
msg string success
data json 查询成功返回list数据

返回数据说明:

参数名 类型 说明
goodsId long 商品ID
goodsName string 商品名称
categoryId string 分类ID
categoryName string 分类名称
subGoodsId string 子商品ID
industryType byte 所属行业:1-餐饮商品 2-电商商品
goodsType byte 商品类型: 1-单一商品 2-电商商品
goodsModule byte 商品所属模块,0-普通商品 1-新品 2-热卖 3-促销 4-限时抢购 5-会员专享
goodsDesc string 商品描述
graphicDesc string 图文详情
cellingPrice long 商品原价 单位:分
currentPrice long 商品现价 单位:分
buyingPrice long 商品进价 单位:分
memberPrice long 会员价 单位:分
unit string 单位
stockLimitType byte 是否限制库存 1-不限库存 2-限制
stockNum long 库存数量
actualSaleNum long 实际销量
virtualSaleNum long 虚拟销量
browseNumber long 浏览量
evaluationNumber long 评价数
producedBeginTime date 生产日期
expiration int 保质期,单位:天
supplier string 供应商
imgPathMain string 主图图片路径
imgPathMore string 其他图片路径,最多四张
status byte 状态 0-下架 1-上架 2-售罄
brand string 品牌
goodsTag string 商品标签
barCode string 商品条码
isRecommend byte 是否为精品推荐商品,0-否 1-是
recommendSort int 精品推荐商品排序值
goodsPropsType byte 是否添加属性 0-未添加 1-已添加,详见属性关联表
storeLimitType byte 是否限制门店 0-不限门店 1-限制门店,详见门店关联表
miniGoodsId long 小程序商品库的商品ID
miniAuditId long 小程序商品库的商品审核单ID
mchId long 商户ID
isvId long 服务商ID
remark string
createTime string 创建时间
updateTime string 更新时间

返回示例:

{
  "code" : 0,
  "msg" : "success",
  "data" : [ {
    "ps" : null,
    "goodsId" : 1,
    "goodsName" : "清蒸鱼",
    "categoryId" : 3,
    "categoryName" : "主食",
    "subGoodsId" : "",
    "industryType" : 1,
    "goodsType" : 1,
    "goodsModule" : "0,1",
    "goodsDesc" : "清脆可口",
    "graphicDesc" : "<p style=\"text-align: center;\"><span style=\"text-align: start;\">清脆可口</span></p><p style=\"text-align: center;\"><span style=\"text-align: start;\"><img src=\"http://127.0.0.1:8204/imgs/goods/fe35b16c-66ac-455b-8d2a-6afdd861d003.jpg\" alt=\"undefined\"></span></p>",
    "cellingPrice" : 18800,
    "currentPrice" : 14900,
    "buyingPrice" : 5000,
    "memberPrice" : null,
    "unit" : "1",
    "stockLimitType" : 1,
    "stockNum" : null,
    "actualSaleNum" : 0,
    "virtualSaleNum" : 398,
    "browseNumber" : 0,
    "evaluationNumber" : 0,
    "producedBeginTime" : "2021-07-13 00:00:00",
    "expiration" : 180,
    "supplier" : "鱼酷",
    "imgPathMain" : "http://127.0.0.1:8204/imgs/goods/42ebfcb2-2c17-44d6-9eed-0f33837587e7.jpg",
    "imgPathMore" : "http://127.0.0.1:8204/imgs/goods/2c5ccf91-d6b1-412a-a3d0-6c6f16506701.jpg",
    "status" : 1,
    "brand" : "鱼酷烤鱼",
    "goodsTag" : "鱼,无刺",
    "barCode" : null,
    "isRecommend" : 1,
    "recommendSort" : 1000000,
    "goodsPropsType" : 0,
    "storeLimitType" : 0,
    "mchId" : 20000008,
    "isvId" : 40000003,
    "remark" : "",
    "createTime" : "2021-07-13 11:08:50",
    "updateTime" : "2021-07-15 17:16:09",
    "miniGoodsId" : null,
    "miniAuditId" : null
  } ],
  "count" : 1
}
文档更新时间: 2021-10-25 17:41   作者:刘正阳