API开放平台

TIP

# 查询品类铺货标准接口

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/new_sku/v1/queryNewSkuByType/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
	"page_number": 1,
	"page_length": 1000,
	"status": "1",
	"start_create_date":"2021-08-29",
	"end_create_date":"2021-09-29",
	"start_modify_date":"2021-08-29",
	"end_modify_date":"2021-09-29"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number INT 是 页码默认1，每页默认1000条
page_length INT 否 分页数量，最大是1000条，默认1000条
status CHAR(1) 否 状态。1：启用，2：停用，默认全部
start_create_date VARCHAR(32) 否 创建时间开始。格式：yyyy-MM-dd
end_create_date VARCHAR(32) 否 创建时间结束。格式：yyyy-MM-dd
start_modify_date VARCHAR(32) 否 修改时间开始。格式：yyyy-MM-dd
end_modify_date VARCHAR(32) 否 修改时间结束。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "master_id": "6270900616654265506",
    "creator_code": "ssl",
    "end_date": "2025-08-31",
    "sequ": 9,
    "create_time": "2025-08-02 15:35:50",
    "choose_groups": [
      {
        "mode": "2",
        "condition": "1",
        "sequ": 0,
        "total_row_num": null,
        "total_product_num": null,
        "name": "选铺一",
        "remark": "选铺一",
        "id": "8275288094105939508",
        "report_type": "1",
        "indicators": "1,2,5,6",
        "choose_details": [
          {
            "shelf_num": 1,
            "target_code": "",
            "sequ": 0,
            "target_name": "请问few祈福祈福祈福祈福祈福祈福",
            "pile_head_num": null,
            "target_id": "5199086873577001847",
            "product_num": 0,
            "id": "6030397014687203356",
            "row_num": 1,
            "pile_head_check": null,
            "special_display": "1",
            "shelf_check": "1"
          },
          {
            "shelf_num": 1,
            "target_code": "",
            "sequ": 1,
            "target_name": "删除测试",
            "pile_head_num": null,
            "target_id": "7773062681651635297",
            "product_num": 0,
            "id": "9016058010867317471",
            "row_num": 1,
            "pile_head_check": null,
            "special_display": "1",
            "shelf_check": "1"
          }
        ],
        "choose_num": 1
      }
    ],
    "modify_time": "2025-08-02 15:35:50",
    "remark": "铺货标准测试09",
    "must_group": {
      "mode": "3",
      "condition": "1",
      "total_row_num": 20,
      "must_num": 4,
      "total_product_num": 10,
      "name": "必铺",
      "remark": "必铺",
      "report_type": "0",
      "indicators": "3,4",
      "must_details": [
        {
          "shelf_num": null,
          "target_code": "",
          "sequ": 3,
          "target_name": "测试品牌",
          "pile_head_num": null,
          "target_id": "5221746067340618242",
          "product_num": 1,
          "id": "8399325020542078681",
          "row_num": 1,
          "pile_head_check": null,
          "special_display": null,
          "shelf_check": null
        },
        {
          "shelf_num": null,
          "target_code": "",
          "sequ": 2,
          "target_name": "默认品牌",
          "pile_head_num": null,
          "target_id": "7564823278841144510",
          "product_num": 1,
          "id": "6153651835080320188",
          "row_num": 1,
          "pile_head_check": null,
          "special_display": null,
          "shelf_check": null
        }
      ]
    },
    "modifyier_source_code": null,
    "creator_source_code": null,
    "cus_range_id": "7612316132391419416",
    "modifyier_id": "5918472523737551764",
    "creator_id": "5918472523737551764",
    "name": "铺货标准测试09",
    "creator_name": "桑绍亮",
    "modifyier_name": "桑绍亮",
    "modifyier_code": "ssl",
    "status": "1",
    "start_date": "2025-08-01"
  }
]

参数说明：

参数 类型 必填 说明
master_id VARCHAR(32) 是 规则ID
status VARCHAR(1) 是 是否启用。0：删除，1：启用，2停用
creator_id VARCHAR(32) 是 创建人ID
creator_name VARCHAR(100) 是 创建人名称
creator_code VARCHAR(100) 是 创建人编码
creator_source_code VARCHAR(100) 否 创建人source_code
create_time VARCHAR(32) 是 创建时间。格式：yyyy-mm-dd hh24:mi:ss
modifyier_id VARCHAR(32) 否 修改人ID
modifyier_name VARCHAR(100) 否 修改人名称
modifyier_code VARCHAR(100) 否 修改人编码
modifyier_source_code VARCHAR(100) 否 修改人source_code
modify_time VARCHAR(32) 否 修改时间。格式：yyyy-mm-dd hh24:mi:ss
name VARCHAR(100) 是 铺货标准名称
remark VARCHAR(4000) 否 铺货标准描述
sequ NUMERIC(20,2) 否 排序号
cus_range_id VARCHAR(32) 是 客户范围动态字段
start_date VARCHAR(32) 否 标准开始日期。格式：yyyy-mm-dd
end_date VARCHAR(32) 否 标准结束日期。格式：yyyy-mm-dd
must_group Map 是 必铺组数据
must_group.name VARCHAR(100) 是 必铺名称
must_group.report_type VARCHAR(32) 是 必铺铺货上报方式。0：按商品上报，1：按商品类型上报
must_group.indicators VARCHAR(32) 是 必铺铺货指标。
按商品上报时，1：单条商品类型排面数达标，2：单条商品类型品项数达标，3：所有商品类型总排面数达标，4：所有商品类型总品项数达标
按商品类型上报时，1：货架数，2：货架自查，3：堆头数，4：堆头自查，5：现场拍照，6：特殊陈列
must_group.mode VARCHAR(32) 是 指定商品类型。1：指定商品，2：按商品类型，3：按商品品牌
must_group.must_details List 是 必铺商品列表
must_group.must_details.id VARCHAR(32) 是 必铺商品子表ID
must_group.must_details.target_id VARCHAR(32) 是 商品ID/商品类型ID/商品品牌ID
must_group.must_details.target_name VARCHAR(32) 是 商品名称/商品类型名称/商品品牌名称
must_group.must_details.target_code VARCHAR(32) 是 商品编码/商品类型编码/商品品牌编码
must_group.must_details.row_num NUMERIC(20,2) 否 排面数
must_group.must_details.product_num NUMERIC(20,2) 否 品项数
must_group.must_details.shelf_num NUMERIC(20,2) 否 货架数
must_group.must_details.shelf_check List 否 货架自查列表
must_group.must_details.shelf_check.title VARCHAR(32) 否 货架自查标题
must_group.must_details.shelf_check.description TEXT 否 货架自查详细说明
must_group.must_details.shelf_check.pictures TEXT 否 货架自查样图
must_group.must_details.shelf_check.sequ NUMERIC(20,2) 否 货架自查排序号
must_group.must_details.pile_head_num NUMERIC(20,2) 否 堆头数
must_group.must_details.pile_head_check List 否 堆头自查列表
must_group.must_details.pile_head_check.title VARCHAR(32) 否 堆头自查标题
must_group.must_details.pile_head_check.description TEXT 否 堆头自查详细说明
must_group.must_details.pile_head_check.pictures TEXT 否 堆头自查样图
must_group.must_details.pile_head_check.sequ NUMERIC(20,2) 否 堆头自查排序号
must_group.must_details.special_display VARCHAR(32) 否 特殊陈列。0：未勾选，1：勾选
must_group.must_details.sequ NUMERIC(20,2) 是 必铺商品排序号
must_group.must_num NUMERIC(20,2) 是 要求必铺数量
must_group.total_row_num NUMERIC(20,2) 否 总排面数
must_group.total_product_num NUMERIC(20,2) 否 总品项数
must_group.condition VARCHAR(32) 否 条件类型。1：且，2：或
must_group.remark VARCHAR(32) 否 必铺描述
choose_groups List 否 选铺组数据列表
choose_groups.id VARCHAR(32) 是 选铺组ID
choose_groups.name VARCHAR(100) 是 选铺组名称
choose_groups.report_type VARCHAR(32) 是 选铺铺货上报方式。0：按商品上报，1：按商品类型上报
choose_groups.indicators VARCHAR(32) 是 选铺铺货指标。
按商品上报时，1：单条商品类型排面数达标，2：单条商品类型品项数达标，3：所有商品类型总排面数达标，4：所有商品类型总品项数达标
按商品类型上报时，1：货架数，2：货架自查，3：堆头数，4：堆头自查，5：现场拍照，6：特殊陈列
choose_groups.mode VARCHAR(32) 是 指定商品类型。1：指定商品，2：按商品类型，3：按商品品牌
choose_groups.choose_details List 是 选铺商品列表
choose_groups.choose_details.id VARCHAR(32) 是 选铺商品子表ID
choose_groups.choose_details.target_id VARCHAR(32) 是 商品ID/商品类型ID/商品品牌ID
choose_groups.choose_details.target_name VARCHAR(32) 是 商品名称/商品类型名称/商品品牌名称
choose_groups.choose_details.target_code VARCHAR(32) 是 商品编码/商品类型编码/商品品牌编码
choose_groups.choose_details.row_num NUMERIC(20,2) 否 排面数
choose_groups.choose_details.product_num NUMERIC(20,2) 否 品项数
choose_groups.choose_details.shelf_num NUMERIC(20,2) 否 货架数
choose_groups.choose_details.shelf_check List 否 货架自查列表
choose_groups.choose_details.shelf_check.title VARCHAR(32) 否 货架自查标题
choose_groups.choose_details.shelf_check.description TEXT 否 货架自查详细说明
choose_groups.choose_details.shelf_check.pictures TEXT 否 货架自查样图
choose_groups.choose_details.shelf_check.sequ NUMERIC(20,2) 否 货架自查排序号
choose_groups.choose_details.pile_head_num NUMERIC(20,2) 否 堆头数
choose_groups.choose_details.pile_head_check List 否 堆头自查列表
choose_groups.choose_details.pile_head_check.title VARCHAR(32) 否 堆头自查标题
choose_groups.choose_details.pile_head_check.description TEXT 否 堆头自查详细说明
choose_groups.choose_details.pile_head_check.pictures TEXT 否 堆头自查样图
choose_groups.choose_details.pile_head_check.sequ NUMERIC(20,2) 否 堆头自查排序号
choose_groups.choose_details.special_display VARCHAR(32) 否 特殊陈列。0：未勾选，1：勾选
choose_groups.choose_details.sequ NUMERIC(20,2) 是 选铺商品排序号
choose_groups.choose_num NUMERIC(20,2) 是 要求选铺数量
choose_groups.total_row_num NUMERIC(20,2) 否 总排面数
choose_groups.total_product_num NUMERIC(20,2) 否 总品项数
choose_groups.condition VARCHAR(32) 否 条件类型。1：且，2：或
choose_groups.remark VARCHAR(32) 否 选铺描述
choose_groups.sequ NUMERIC(20,2) 是 选铺排序号

← 品类铺货记录接口 →