TIP

• KOL活动商品明细查询

KOL活动商品明细接口

KOL活动商品明细查询

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

{
  "status": "1",
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_t648t__cbjfc8c",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c1u5edm",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}

说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
status	CHAR(1)	否	记录状态。0：已删除，1：正常。
page	INT	是	页数，默认值为1。
rows	INT	是	条数，默认值为100。
sorts	List	是	排序，默认按创建时间倒序排序。
sorts.field_key	VARCHAR(30)	是	排序字段。
sorts.type	VARCHAR(4)	是	排序类型：asc 正序，desc 倒序。
query_group	List	是	查询条件列表
query_group.connector	List	是	组内查询条件，条件AND或OR
query_group.filters	VARCHAR(4)	是	组内查询条件
query_group.filters.field_key	VARCHAR(32)	是	字段key
query_group.filters.operator	VARCHAR(10)	是	操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values	List	是	字段值集合

响应示例：

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

数据DATA示例:

[
  {
    "id": "6766043018295280001",
    "status": "1",
    "source_type": "1",
    "source_type_name": "自建",
    "name": "joinactivity2024082000000011",
    "department_id": "5262808538255530059",
    "department_name": "SFA开发部",
    "kol_activity_id": "7826235193828565717",
    "kol_activity_name": "自测活动001",
    "linkgoods_id": "6881617754525549323",
    "linkgoods_name": "端午礼盒",
    "linkgoods_unit": "箱",
    "linkgoods_code": "huojia_didui_202205_1m2",
    "amount": "10",
    "owner_id": "998",
    "owner_name": "外部系统",
    "creator_id": "8250035712611830714",
    "creator_name": "许周",
    "create_time": "2024-08-20 00:00:00",
    "modifyier_id": "998",
    "modifyier_name": "外部系统",
    "modify_time": "",
    "lock_status": "0",
    "approval_status": "1",
    "exts": {
      "field_kig9p__c": "10000.00",
      "field_db3nn__c": {
        "format": "YYYY-MM-DD",
        "value": "2024-07-26"
      },
      "field_dacfk__c": "1214123412341234",
      "field_puezh__c": "12341234125463457634567",
      "field_hlwzg__c": [
        {
          "path": "kol/202407/20240726105836448.jpg",
          "name": "",
          "url": "http://image-test.waiqin365.com/6928113655533238100/kol/202407/20240726105836448.jpg"
        },
        {
          "path": "kol/202407/20240726105839142.jpg",
          "name": "",
          "url": "http://image-test.waiqin365.com/6928113655533238100/kol/202407/20240726105839142_88364b70.jpg"
        }
      ],
      "field_xvw5t__c": {
        "code": "j8gKhgpu",
        "label": "选项1",
        "status": ""
      },
      "field_xwbzr__c": [
        {
          "path": "kol/202407261051786.zip",
          "name": "slidingscreen.zip",
          "url": "http://image-test.waiqin365.com/6928113655533238100/kol/202407261051786.zip"
        },
        {
          "path": "kol/202407261051258.jpg",
          "name": "R-C.jpg",
          "url": "http://image-test.waiqin365.com/6928113655533238100/kol/202407261051258.jpg"
        }
      ],
      "field_swe5j__c": [
        {
          "code": "xA62mwYV",
          "label": "选项2",
          "status": ""
        },
        {
          "code": "QlmleNPY",
          "label": "选项1",
          "status": ""
        }
      ]
    }
  }
]

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	否	KOL活动商品明细id
status	CHAR(1)	是	KOL活动商品明细删除状态。0：删除，1：正常
source_type	VARCHAR(32)	否	KOL活动商品明细数据来源。
source_type_name	VARCHAR(32)	否	KOL活动商品明细数据来源名称。
name	VARCHAR(100)	是	活动商品明细编码
department_id	VARCHAR(100)	否	数据所属部门ID，来源于勤策部门唯一ID
department_name	VARCHAR(100)	否	数据所属部门名称，来源于勤策部门名称
kol_activity_id	VARCHAR(100)	否	KOL活动管理ID
kol_activity_name	VARCHAR(100)	否	KOL活动管理
linkgoods_id	VARCHAR(100)	否	商品id
linkgoods_name	VARCHAR(100)	否	商品名称
linkgoods_unit	VARCHAR(100)	否	商品单位
linkgoods_code	VARCHAR(100)	否	商品编码
amount	VARCHAR(100)	否	数量
owner_id	VARCHAR(100)	否	负责人id，来源勤策的唯一ID
owner_name	VARCHAR(100)	否	负责人名称
creator_id	VARCHAR(100)	否	创建人id，来源勤策的唯一ID
creator_name	VARCHAR(100)	否	创建人名称
create_time	CHAR(19)	是	创建时间。格式：yyyy-MM-dd HH:mm:ss
modifyier_id	VARCHAR(100)	否	修改人id，来源勤策的唯一ID
modifyier_name	VARCHAR(100)	否	修改人名称
modify_time	VARCHAR(100)	否	修改时间。格式：yyyy-MM-dd hh:mm:ss
lock_status	VARCHAR(100)	否	锁定状态
approval_status	VARCHAR(100)	否	新增审批状态
exts	Map	否	客户信息扩展字段集合。json数据格式为{"ext_keyA": "ext_valueA"}。参数格式参考 (opens new window)
exts.key	VARCHAR(100)	否	客户信息扩展字段key。对象自定义字段key。
exts.value	VARCHAR(100)	否	客户信息扩展字段value。对象自定义字段值。 单行文本/多行文本/数值字段，值为字符串； 日期字段，值为{"format":"YYYY-MM-DD","value":"2024-07-26"}； 单选字段，值为{"code":"","label":"","status":""}； 多选字段，值为[{"code":"","label":"","status":""}]； 图片/附件字段，值为[{"path":"","fileSize":1,"name":"","url":""}]