API开放平台

TIP

# 任务激励接口

# 发送任务激励积分

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

{
	"id": "6630448873309744417",
	"points": "50",
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id INT 是 积分发放流水ID
points NUMERIC(18) 是 发送积分
remarks VARCHAR(3000) 否 备注

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
	"id": "6630448873309744417",    
	"points": "40"
}

参数说明：

参数 类型 说明
id INT8 积分发放流水ID
points NUMERIC(18) 实际发送积分

# 查询任务激励方案

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

{
  "name":"",
  "createDateStart":"2024-03-27",
  "createDateEnd":"2024-12-27",
  "page":1,
  "rows":2
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
name VARCHAR(32) 否 任务激励方案名称
createDateStart VARCHAR(32) 否 创建时间开始(格式:yyyy-MM-dd)
createDateEnd VARCHAR(32) 否 创建时间结束(格式:yyyy-MM-dd)
page INT 否 页数，默认为1
rows INT 否 每页行数，默认为100

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
  "id": "8441987840049464056",
  "name": "任务未开启测试",
  "rule_desc": "任务未开启测试",
  "start_date": "2024-04-15",
  "end_date": "2024-04-30",
  "employee_range": "全公司",
  "main_task_code": "BAS_CM_CUSTOMER_ADD_TASK",
  "task_code": "BAS_CM_STORE_ADD_SUB_TASK",
  "task_name": "新增终端",
  "points_send_target_code": "manager",
  "points_send_target": "客户经理",
  "creator": "孙君君",
  "create_time": "2024-03-28 13:03",
  "setting_status": "0"
}

参数说明：

参数 类型 说明
id VARCHAR() 任务激励方案id
name VARCHAR() 任务激励方案名称
rule_desc VARCHAR() 规则说明
start_date VARCHAR() 生效时间开始(yyyy-MM-dd)
end_date VARCHAR() 生效时间结束(yyyy-MM-dd)
employee_range VARCHAR() 适用员工范围
main_task_code VARCHAR() 触发行为分组编码
task_code VARCHAR() 触发行为编码
task_name VARCHAR() 触发行为
points_send_target_code VARCHAR() 发放对象编码
points_send_target VARCHAR() 发放对象
creator VARCHAR() 创建人
create_time VARCHAR() 创建时间(yyyy-MM-dd HH:mm)
setting_status VARCHAR() 状态 -1:未开始;0:已结束;1:进行中;2:草稿;3:审批中

# 查询任务激励方案积分发放明细

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

{
  "settingId":"5322955681668416908",
  "sendTimeStart":"2024-03-27",
  "sendTimeEnd":"2024-03-28",
  "page":1,
  "rows":10
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
settingId VARCHAR(32) 是 任务激励方案名称
sendTimeStart VARCHAR(32) 否 积分发放时间开始(格式:yyyy-MM-dd)
sendTimeEnd VARCHAR(32) 否 积分发放时间结束(格式:yyyy-MM-dd)
page INT 否 页数，默认为1
rows INT 否 每页行数，默认为100，最大为1000

响应示例：

{
    "return_code": "0", 
    "return_msg": null,
    "msg_id": null,
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
  "setting_name": "新增终端发5积分--简易版2",
  "setting_id": "5322955681668416908",
  "emp_code": "sjj",
  "emp_name": "孙君君",
  "emp_id": "5052943648704112943",
  "send_time": "2024-03-28 19:42",
  "points": "0",
  "main_task_code": "BAS_CM_CUSTOMER_ADD_TASK",
  "task_code": "BAS_CM_STORE_ADD_SUB_TASK",
  "task_name": "新增终端",
  "data_id": "4834071794750912943"
}

参数说明：

参数 类型 说明
setting_name VARCHAR() 任务激励方案名称
setting_id VARCHAR() 任务激励激励方案id
emp_code VARCHAR() 登录账号
emp_name VARCHAR() 参与人员名称
emp_id VARCHAR() 参与人员id
send_time VARCHAR() 奖励发放时间，格式：yyyy-MM-dd HH:mm
points VARCHAR() 发放积分
main_task_code VARCHAR() 触发行为分组编码
task_code VARCHAR() 触发行为编码
task_name VARCHAR() 触发行为
data_id VARCHAR() 对应业务数据id，例如触发行为为铺货上报，则对应为铺货记录的数据id，拜访子任务对应拜访子任务的数据id

← 任务激励数据推送 →