TIP

# 整改任务接口

# 整改任务信息查询接口

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

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

参数说明：

参数	类型	必填	说明
create_date_from	VARCHAR(32)	否	任务创建开始时间。格式：yyyy-MM-dd
create_date_to	VARCHAR(32)	否	任务创建截止时间。格式：yyyy-MM-dd
modify_date_from	VARCHAR(32)	否	最后一次修改开始时间。格式：yyyy-MM-dd
modify_date_to	VARCHAR(32)	否	最后一次修改截止时间。格式：yyyy-MM-dd
page	VARCHAR(32)	否	数据页码，默认页码为1
rows	VARCHAR(32)	否	每页数据显示条数，最大1000，默认为1000

响应示例：

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

数据DATA示例:

[
    {
        "status": 1,
        "task_status": "1",
        "create_time": "2020-11-19 10:33",
        "execute_demand": "1",
        "feedback_deadline": "2020-11-25 10:10",
        "modify_time": "2020-12-09 15:02",
        "latest_feedback_content": "最后一次反馈内容",
        "task_id": "10001",
        "task_source_name": "任务来源1",
        "task_source_id": "10001",
        "visit_implement_id": "10001",
        "latest_feedback_time": "2020-11-19 10:33",
        "task_type_id": "10001",
        "receivers": [
            {
                "name": "lm",
                "id": "4622857986008792650"
            }
        ],
        "creator": {
            "name": "lm",
            "id": "4622857986008792650"
        },
        "task_content": "任务内容",
        "customer_id": "7269195022934925565",
        "feedback_detail": [
          {
            "feedback_content": "第一次反馈",
            "feedback_visit_id": "6881395042783735132",
            "feedback_time": "2023-04-28 11:21"
          }, {
            "feedback_content": "第二次反馈",
            "feedback_visit_id": "6424234433752332003",
            "feedback_time": "2023-04-28 11:22"
          }
        ]
    }
]

参数说明：

参数	类型	说明
task_id	VARCHAR(32)	任务唯一ID
creator.id	VARCHAR(32)	创建人唯一ID
creator.name	VARCHAR(32)	创建人姓名
creator.source_code	VARCHAR(32)	创建人外部source_code
create_time	VARCHAR(32)	创建时间。格式：yyyy-MM-dd HH:mm
task_type_id	VARCHAR(32)	任务类型ID
task_source_id	VARCHAR(32)	任务来源ID
task_source_name	VARCHAR(32)	任务来源名称
execute_demand	VARCHAR(32)	是否要求现场反馈。0: 非现场执行 1: 强制现场执行 2: 无要求
task_content	VARCHAR(32)	任务内容
receivers	List	列表
receivers.id	VARCHAR(32)	接收人唯一ID
receivers.name	VARCHAR(32)	接收人姓名
receivers.source_code	VARCHAR(32)	接收人外部source_code
latest_feedback_time	VARCHAR(32)	最后一次反馈时间。格式：yyyy-MM-dd HH:mm：
latest_feedback_content	VARCHAR(32)	最后一次反馈内容
modify_time	VARCHAR(32)	最后一次修改时间。格式：yyyy-MM-dd HH:mm
feedback_deadline	VARCHAR(32)	反馈限期。格式：yyyy-MM-dd HH:mm
task_status	VARCHAR(32)	任务状态。0：待反馈，1：已反馈，2：验收通过，3：需重新反馈
status	VARCHAR(32)	删除状态：0 删除，1 正常
task_achievement	VARCHAR(32)	任务完成情况
visit_implement_id	VARCHAR(32)	新增任务时关联的拜访记录ID
visit_function_id	VARCHAR(32)	新增任务时关联的拜访子任务记录ID
customer_id	VARCHAR(32)	客户唯一ID
feedback_detail	List	反馈明细
feedback_detail.feedback_content	TEXT	反馈内容
feedback_detail.feedback_visit_id	VARCHAR(32)	反馈任务时关联的拜访记录ID
feedback_detail.feedback_time	VARCHAR(32)	反馈时间。格式：yyyy-MM-dd HH:mm

# 任务类型查询接口

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

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

参数说明：

参数	类型	必填	说明
type_ids	List	否	任务类型ID

响应示例：

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

数据DATA示例:

[
    {
        "receiver_limit": "0",
        "type_name": "test-不允许从相册选取",
        "modifier_name": "zhoukun",
        "create_time": "2021-04-08 16:28",
        "type_id": "6067108969643484875",
        "execute_demand": "2",
        "modify_time": "2021-04-08 16:29",
        "feedback_picture_required": "0",
        "remark": "",
        "is_album_permitted": "0",
        "modifier_id": "6327808947511856653",
        "creator_id": "6327808947511856653",
        "creator_name": "zhoukun",
        "publish_status": "1",
        "status": "1"
    }
]

参数说明：

参数	类型	说明
type_id	VARCHAR(32)	任务类型ID
type_name	VARCHAR(32)	任务类型名称
status	CHAR(1)	状态。0：已停用，1：启用中，2：已删除
publish_status	VARCHAR(32)	发布状态。0:未发布，1:已发布
creator_id	VARCHAR(32)	创建人唯一ID
creator_name	VARCHAR(32)	创建人姓名
create_time	VARCHAR(32)	创建时间。格式：yyyy-MM-dd HH:mm
modifier_id	VARCHAR(32)	修改人唯一ID
modifier_name	VARCHAR(32)	修改人姓名
modify_time	VARCHAR(32)	最后一次修改时间。格式：yyyy-MM-dd HH:mm
execute_demand	VARCHAR(32)	是否要求现场反馈。0: 非现场执行，1: 强制现场执行，2: 无要求
receiver_limit	VARCHAR(32)	接收人限制。0：仅限客户经理，1：不限
feedback_picture_required	VARCHAR(32)	反馈照片必填限制。0：不必填，1：必填
is_album_permitted	VARCHAR(32)	反馈照片从相册选取。0：禁止，1：允许
remark	TEXT	备注

# 整改任务新增接口

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

{
    "customerCode": "CM001",
    "typeId": "987654321",
    "taskSourceId": "111222333",
    "recipientLoginNames": "zhangsan,lisi",
    "taskContent": "请于期限内完成门店陈列整改，确保产品陈列符合标准",
    "feedbackDeadline": "2026-05-20 18:00",
    "liveFeedbackRequired": "1",
    "acceptorLoginName": "wangwu",
    "copyToLoginNames": "zhaoliu"
}

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

参数说明：

参数	类型	必填	说明
customerCode	VARCHAR(32)	是	客户编码
typeId	VARCHAR(32)	是	任务类型ID
taskSourceId	VARCHAR(32)	是	任务来源ID
recipientLoginNames	VARCHAR(32)	是	接收人登录账号，多个用英文逗号分隔。若任务类型限制仅客户经理，则只能传入客户经理登录账号
taskContent	TEXT	是	任务内容
feedbackDeadline	VARCHAR(32)	是	反馈期限。格式：yyyy-MM-dd HH:mm
liveFeedbackRequired	CHAR(1)	是	是否要求现场反馈。0：否，1：是
acceptorLoginName	VARCHAR(32)	是	验收人登录账号
copyToLoginNames	VARCHAR(32)	否	抄送人登录账号，多个用英文逗号分隔

响应示例：

{
    "return_code": "0",
    "return_msg": "新增成功",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
    "id": "123456789012345678"
}

参数说明：

参数	类型	说明
id	VARCHAR(32)	新增任务的唯一ID

# 任务来源查询接口

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

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

参数说明：

参数	类型	必填	说明
taskSourceId	VARCHAR(32)	否	任务来源ID

响应示例：

{
    "return_code": "0",
    "return_msg": "查询成功",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    { "id": "111222333", "sourceName": "日常巡检" },
    { "id": "111222334", "sourceName": "客户投诉" },
    { "id": "111222335", "sourceName": "专项整改" }
]

参数说明：

参数	类型	说明
id	VARCHAR(32)	任务来源ID
sourceName	VARCHAR(32)	任务来源名称

← 客户联系人接口行政区划属性 →