API开放平台

TIP

# 新增常规拜访计划

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

[
  {
    "visitDate":"2023-2-23",
    "visitor":"5052943648704112943",
    "customer":"4616243321630416388",
    "planContent":"测试新增5"
  },{
  "visitDate":"2023-2-23",
  "visitor":"",
  "customer":"4616243321630416388",
  "planContent":"测试新增"
},{
  "visitDate":"2023-2-23",
  "visitor":"5052943648704112943",
  "customer":"",
  "planContent":"测试新增"
},{
  "visitDate":"",
  "visitor":"5052943648704112943",
  "customer":"4616243321630416388",
  "planContent":"测试新增"
}
]
**参数说明：**
参数 类型 必填 说明
visitDate VARCHAR(10) 是 拜访日期。格式YYYY-MM-DD
visitor VARCHAR(10) 是 拜访人ID
customer VARCHAR(10) 是 拜访客户ID
planContent String 否 拜访内容

响应示例：

{
  "return_code": "0",
  "return_msg": "失败",
  "msg_id": "90b4b267dd3d49aeace879038b1e7291",
  "response_data": "[{\"customer\":\"4616243321630416388\",\"planContent\":\"测试新增5\",\"visitDate\":\"2023-2-23\",\"visitor\":\"5052943648704112943\",\"wrongReason\":\"日期只能选择今日和今日之后的日期。\"},{\"customer\":\"4616243321630416388\",\"planContent\":\"测试新增\",\"visitDate\":\"2023-2-23\",\"visitor\":\"\",\"wrongReason\":\"日期只能选择今日和今日之后的日期。\"},{\"customer\":\"\",\"planContent\":\"测试新增\",\"visitDate\":\"2023-2-23\",\"visitor\":\"5052943648704112943\",\"wrongReason\":\"日期只能选择今日和今日之后的日期。\"},{\"customer\":\"4616243321630416388\",\"planContent\":\"测试新增\",\"visitDate\":\"\",\"visitor\":\"5052943648704112943\",\"wrongReason\":\"请填写日期。\"}]"
}

参数说明：

参数 说明
return_code 响应编码。0:成功，1:失败。其他详见附录错误码说明
return_msg 响应说明
msg_id 请求消息id
response_data 数据data

response_data相应信息：

参数 类型 说明
id VARCHAR(30) 拜访计划Id
visitDate VARCHAR(10) 拜访日期。格式YYYY-MM-DD
visitor VARCHAR(10) 拜访人ID
customer VARCHAR(10) 拜访客户ID
planContent String 拜访内容
wrongReason String 错误原因

# 删除常规拜访计划

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

{
  "id":"8751028172904504981,5365307272442366966,6776609427490214574,4801719888431571710"
}

参数说明：

参数 类型 必填 说明
id String 是 拜访计划ID。多个用英文逗号隔开

响应示例：

{
  "return_code": "0",
  "return_msg": "失败",
  "msg_id": "90b4b267dd3d49aeace879038b1e7291",
  "response_data": "[{\"wrongReason\":\"拜访计划ID错误\"},{\"wrongReason\":\"拜访计划ID错误\"},{\"wrongReason\":\"拜访计划ID错误\"},{}]"
}

参数说明：

参数 说明
return_code 响应编码。0:成功，1:失败。其他详见附录错误码说明
return_msg 响应说明
msg_id 请求消息id
response_data 数据data

← 客户签到接口 →