# 积分明细查询

# 接口地址

/marketing/points/log/listByCustomerId

# 入参

# 字段说明

名称 类型 必填 示例 描述
idCustomerList Number[] [15944592175883362324,10545360219000304622] 客户 ID 列表,最多支持 50 个
beginCreationTime String "2023-10-01 00:00:00" 时间查询范围的开始,格式:yyyy-MM-dd HH:mm:ss
endCreationTime String "2023-10-31 23:59:59" 时间查询范围的结束,格式:yyyy-MM-dd HH:mm:ss。最大时间区间1个月
currentPage Number 1 页码。取值范围:大于 0 的整数。默认值为 1
pageSize Number 10 每页条数。取值范围:大于 0 的整数。最大值 100,默认值为 10。

# JSON示例

{
    "paramValues": [
        {
            "idCustomerList": [
              15944592175883362324,
              10545360219000304622
            ],
            "beginCreationTime": "2023-10-01 00:00:00",
            "endCreationTime": "2023-10-31 23:59:59",
            "currentPage": 1,
            "pageSize": 10
        }
    ]
}

# 出参

# 字段说明

名称 类型 示例 描述
id Number 4860531 明细行 ID,可忽略不处理
sourceType Number 3 来源类型/操作类型
1:工单结算产生积分
2:工单取消结算返还积分
3:积分充值
4:会员卡冲销增加积分
5:车辆合并增加积分
6:活动赠送积分
-1:工单结算使用积分
-2:工单取消结算回收积分
-3:积分扣减
sourceId Number 16024282004669341742 工单 ID,当 sourceType in [1,2,-1,-2] 时该字段返回工单 ID,否则返回 0
idCustomer Number 15944592175883362324 客户 ID
points Number 99 积分变化值
prePoints Number 100 变化前的积分
tocRemark String 备注信息,会对 C 端透出展示
tobRemark String 备注信息,只对 B 端透出展示
idEmployee Number 10545360219000304622 操作员工 ID
creationTime String "2023-10-20 13:59:59" 操作时间,格式:yyyy-MM-dd HH:mm:ss

# JSON示例

{
  "code": 200,
  "message": "OK",
  "data": {
    "total": 2,
    "list": [
      {
        "id": 4860531,
        "sourceType": 3,
        "sourceId": 0,
        "idCustomer": 15944592175883362324,
        "points": 22.00,
        "prePoints": 0.00,
        "tocRemark": "",
        "tobRemark": "",
        "idEmployee": 10545360219000304622,
        "creationTime": "2023-10-13 10:39:46"
      },
      {
        "id": 4861547,
        "sourceType": 1,
        "sourceId": 16024282004669341742,
        "idCustomer": 15944592175883362324,
        "points": 62.00,
        "prePoints": 22.00,
        "tocRemark": "",
        "tobRemark": "",
        "idEmployee": 10545360219000304622,
        "creationTime": "2023-10-27 11:58:16"
      }
    ]
  }
}