API开放平台

TIP

# 任务执行记录

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

{
    "id":"7207490680071516631",
    "date_start": "2017-01-10",
    "date_end": "2017-01-20",
    "modify_start": "2017-01-10",
    "modify_end": "2017-01-20",
    "visit_time_start": "2017-01-10 11:00:00",
    "visit_time_end": "2017-01-20 14:00:00",
    "visitor_code": "",
    "visit_type": "",
    "page":"1",
    "rows":"1000"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 拜访id,传入此id时，可不传日期，若不传入该id，则日期为必传项
date_start VARCHAR(10) 是 查询拜访日期起。格式：yyyy-MM-dd
date_end VARCHAR(10) 是 查询拜访日期止。格式：yyyy-MM-dd
modify_start VARCHAR(10) 否 查询修改日期起。格式：yyyy-MM-dd
modify_end VARCHAR(10) 否 查询修改日期止。格式：yyyy-MM-dd
visit_time_start VARCHAR(20) 否 查询实际拜访时间起。格式：yyyy-MM-dd HH:mm:ss
visit_time_end VARCHAR(20) 否 查询实际拜访时间止。格式：yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 是 数据页码
rows VARCHAR(10) 是 每页数据显示条数，最多显示1000条
visitor_code VARCHAR(32) 否 拜访人员工账号
visit_type VARCHAR(1) 否 计划类型。1：常规拜访（拜访计划），2：临时拜访，3：线路拜访（线路计划），4：周期计划，5：检核计划，6：协访计划，7：临时检核，8：临时协访

响应示例：

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

数据DATA示例:

[
    {
        "id":"8336850706919142842",
        "customer": "6313529032719815457",
        "customer_name": "门店",
        "customer_code": "CUS01867",
        "customer_sourcecode": "mendian",
        "manager_code":"ABC",	
        "manager_name":"123",
        "visit_manager_name":"EFG",
        "visit_manager_code":"456",
        "visitor":"7986507193511966864",
        "visitor_name":"东东",
        "visitor_sourcecode":"dongdong",
        "visit_date":"2016-08-17 00:00:00",
        "sequence":"4",
        "visit_status":"0",
        "summary": "总结",
        "leave_time": "2016-07-01 13:53:02",
        "plan_content":"1",
        "visit_type":"1",
        "creator_id":"6611925934866977709",
        "creator_name":"小明",
        "creator_sourcecode":"CODE93486697",
        "create_time":"2016-08-17 15:30:02",
        "modifyier_id":"-1",
        "modify_time":"",
        "total_score":"60",
        "full_marks":"100",
        "task_type": "1"
    }
]

参数说明：

参数 类型 说明
id VARCHAR(32) 拜访记录ID
status VARCHAR(1) 数据状态。0：已删除，1：正常
creator_id VARCHAR(32) 拜访记录创建人ID
creator_name VARCHAR(100) 拜访记录创建人姓名
creator_sourcecode VARCHAR(32) 拜访记录创建人外部source_code
create_time VARCHAR(32) 拜访记录创建时间。格式：yyyy-MM-dd HH:mm:ss
modifyier_id VARCHAR(32) 拜访记录修改人ID
modifyier_name VARCHAR(100) 拜访记录修改人姓名
modifyier_sourcecode VARCHAR(32) 拜访记录修改人外部source_code
modify_time VARCHAR(32) 拜访记录修改时间。格式：yyyy-MM-dd HH:mm:ss
visitor VARCHAR(32) 拜访人ID
visitor_name VARCHAR(100) 拜访人姓名
visitor_sourcecode VARCHAR(32) 拜访人外部source_code
visit_type VARCHAR(1) 计划类型。1：常规拜访，2：临时拜访，3：线路拜访，4：周期计划，5：检核计划，6：协访计划，7：临时检核，8：临时协访
flow_type VARCHAR(1) 流程类型。1：拜访，2：车销，3：车铺
plan_source VARCHAR(1) 流程类型。 0：手机端计划，1：新增计划，2：导入计划，3：按频率生成计划，4：按周生成计划，5：按线路生成计划，10：导入检核协访计划
total_score VARCHAR(32) 总分
full_marks VARCHAR(32) 满分
approval_status VARCHAR(1) 审批状态。0:未审批，1:已审批
customer VARCHAR(32) 拜访客户ID
customer_name VARCHAR(100) 客户名称
customer_code VARCHAR(100) 客户编码
customer_sourcecode VARCHAR(32) 客户外部source_code
manager_code VARCHAR(200) 客户经理编码
manager_name VARCHAR(200) 客户经理名称
visit_manager_code VARCHAR(200) 拜访时客户经理编码
visit_manager_name VARCHAR(200) 拜访时客户经理名称
visit_date VARCHAR(32) 预定拜访日期。格式：yyyy-MM-dd HH:mm:ss，如2021-07-30 00:00:00。与visit_time是同一天，查询拜访日期起、止根据本字段查询出来
visit_time VARCHAR(32) 实际拜访时间。格式：yyyy-MM-dd HH:mm:ss，如2021-07-30 15:40:15。与visit_date是同一天
sequence NUMERIC 拜访序号
visit_status VARCHAR(1) 拜访状态。0：未拜访，1：已拜访，2：失访
flow_set_id VARCHAR(32) 拜访流程ID。对应拜访流程设置表id,拜访执行的时候所使用的流程id
flow_set_name VARCHAR(200) 拜访流程名称
missed_type VARCHAR(32) 失访原因id
missed_type_name VARCHAR(200) 失访原因名称
missed_regtime VARCHAR(32) 失访登记时间。格式：yyyy-MM-dd HH:mm:ss
missed_reason VARCHAR(4000) 失访备注
missed_picture_path VARCHAR(200) 失访拍照照片路径。照片完整路径，多张图片以','分隔
missed_lla VARCHAR(200) 失访地标信息。纠偏后的定位数据转换得到的地标信息
is_finished VARCHAR(1) 必做流程是否完成。0：未完成，1：完成
plan_content VARCHAR(5000) 计划内容
arrive_time VARCHAR(32) 到店时间。格式：yyyy-MM-dd HH:mm:ss
arrive_lla VARCHAR(200) 到店地标信息。纠偏后的定位数据转换得到的地标信息
arrive_rg_type VARCHAR(1) 到店定位类型。1：GPS定位，2：基站定位
arrive_pos_offset NUMERIC（20,2） 到店偏差距离。纠偏后的位置和客户纠偏后的位置的差值
arrive_picture_path VARCHAR(4000) 到店照片路径。照片完整路径，多张图片以','分隔
arrive_remarks VARCHAR(4000) 到店备注
leave_time VARCHAR(32) 离店时间。格式：yyyy-MM-dd HH:mm:ss
leave_lla VARCHAR(200) 离店地标信息。纠偏后的定位数据转换得到的地标信息
leave_rg_type VARCHAR(1) 离店定位类型。1：GPS定位，2：基站定位
leave_pos_offset NUMERIC（20,2） 离店偏差距离。 纠偏后的位置和客户纠偏后的位置的差值
leave_picture_path VARCHAR(4000) 离店照片路径。照片完整路径，多张图片以','分隔
leave_remarks VARCHAR(4000) 离店备注
time_consume NUMERIC（20,2） 拜访用时
summary VARCHAR(4000) 拜访总结内容
summary_pictures VARCHAR(4000) 拜访总结图片。照片完整路径，多张图片以','分隔
summary_time VARCHAR(32) 拜访总结时间。格式：yyyy-MM-dd HH:mm:ss
del_person VARCHAR(32) 删除人ID
del_person_name VARCHAR(200) 删除人姓名
del_time VARCHAR(32) 删除时间。格式：yyyy-MM-dd HH:mm:ss
check_emp_name VARCHAR(200) 被检核协访人
task_type VARCHAR(1) 任务类型。1：拜访，2：协访，3：检核

# 查询物理删除的拜访计划

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

{
  "page":"1",
  "rows":"1000",
  "id":"",
  "visitor_code":"cjj_001",
  "date_start":"2024-02-01",
  "date_end":"2024-02-28",
  "del_date_start":"2024-02-06",
  "del_date_end":"2024-02-06"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 拜访id,传入此id时，可不传日期，若不传入该id，则日期为必传项
date_start VARCHAR(10) 是 查询拜访日期起。格式：yyyy-MM-dd
date_end VARCHAR(10) 是 查询拜访日期止。格式：yyyy-MM-dd
del_date_start VARCHAR(10) 是 查询删除日期起。格式：yyyy-MM-dd
del_date_end VARCHAR(10) 是 查询删除日期止。格式：yyyy-MM-dd
page VARCHAR(10) 是 数据页码
rows VARCHAR(10) 是 每页数据显示条数，最多显示1000条
visitor_code VARCHAR(32) 否 根据拜访人员工账号精确查询
visitor_id VARCHAR(32) 否 根据来源勤策的员工唯一标识精确查询
visitor_name VARCHAR(32) 否 根据拜访人姓名模糊查询
visitor_status VARCHAR(32) 否 根据员工状态查询，0销户 1正常 2停用

响应示例：

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

数据DATA示例:

[
  {
    "create_time": "2024-02-06 16:40:28",
    "modify_time": "2024-02-06 16:40:35",
    "visitor_name": "陈",
    "modifyier_id": "4890368659913396089",
    "creator_id": "4890368659913396089",
    "creator_name": "余",
    "id": "4621776640294235726",
    "customer_name": "商场",
    "visitor": "9049286687974062498",
    "modifyier_name": "余",
    "customer_code": "POS000013",
    "visit_date": "2024-02-22",
    "customer": "7641280831795925301"
  }
]

参数说明：

参数 类型 说明
id VARCHAR(32) 拜访计划ID
creator_id VARCHAR(32) 拜访计划创建人ID
creator_name VARCHAR(100) 拜访计划创建人姓名
create_time VARCHAR(32) 拜访计划创建时间。格式：yyyy-MM-dd HH:mm:ss
modifyier_id VARCHAR(32) 拜访计划删除人ID
modifyier_name VARCHAR(100) 拜访计划删除人姓名
modify_time VARCHAR(32) 拜访计划删除时间。格式：yyyy-MM-dd HH:mm:ss
visitor VARCHAR(32) 拜访人ID
visitor_name VARCHAR(100) 拜访人姓名
customer VARCHAR(32) 拜访客户ID
customer_code VARCHAR(100) 拜访客户编码
customer_name VARCHAR(100) 拜访客户名称
visit_date VARCHAR(32) 拜访日期。格式：yyyy-MM-dd

# 子任务设置

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

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

参数说明：

参数 类型 必填 说明
无

响应示例：

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

数据DATA示例:

[
    {
        "function_id":"8012364236566436401",
        "function_name": "终端形象采集",
        "function_alias": "终端形象采集描述",
        "table_name": "slfdf_160624001",
        "release_time": "2017-11-20 13:32:22",
        "columns": [
                    {
                        "col_name": "",
                        "col_code": "id",
                        "group_id": "5310624925353881186",
                        "group_name": "分组A"
                    }
        ],
        "sts": [
                {
                    "table_name": "slfdf_1606240015",
                    "table_name_cn": "表名",
                    "columns": [
                        {
                            "col_name": "",
                            "col_code": "id"
                        },
                        {
                            "col_name": "",
                            "col_code": "creator_id"
                        },
                        {
                            "col_name": "",
                            "col_code": "create_time"
                        },
                        {
                            "col_name": "姓名",
                            "col_code": "slfdf_1606240016"
                        },
                        {
                            "col_name": "年龄",
                            "col_code": "slfdf_1606240017"
                        }
                    ]
                }
            ]
    }
]

参数说明：

参数 类型 说明
function_id VARCHAR(32) 任务ID
function_name VARCHAR(200) 任务名称
function_alias VARCHAR(200) 任务描述信息
table_name VARCHAR(32) 该任务的表名
release_time VARCHAR(32) 发布时间。格式：yyyy-MM-dd HH:mm:ss
columns list 任务自定义表单各字段集合
columns.col_code VARCHAR(32) 字段编码
columns.col_name VARCHAR(32) 字段名称
columns.col_type VARCHAR(32) 字段类型。0：数字，1：文本，2：日期
columns.group_id VARCHAR(32) 分组ID
columns.group_name VARCHAR(32) 分组名称
sts list 任务子表集合
sts.table_name VARCHAR(32) 子表编码
sts.table_name_cn VARCHAR(32) 子表名称
sts.columns list 自定义表单子表各字段集合
sts.columns.col_code VARCHAR(32) 子表字段编码
sts.columns.col_type VARCHAR(32) 字段类型。0：数字，1：文本，2：日期
sts.columns.col_name VARCHAR(32) 子表字段名称

# 子任务执行记录

接口说明：参数function_id使用的是 子任务设置 接口返回的function_id

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

{
    "visit_implement_id":"7151216392931634895",
    "function_id": "4622631669645698414",
    "date_start": "2017-01-10",
    "date_end": "2017-01-20",
    "page":"1",
    "rows":"1000"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
visit_implement_id VARCHAR(32) 否 拜访记录id
function_id VARCHAR(32) 是 拜访任务功能配置查询结果中的任务id(function_id)
date_start VARCHAR(10) 是 查询任务执行日期起。格式：yyyy-MM-dd
date_end VARCHAR(10) 是 查询任务执行日期止。格式：yyyy-MM-dd
page VARCHAR(10) 是 数据页码
rows VARCHAR(10) 是 每页数据显示条数，每页显示最大1000条

响应示例：

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

数据DATA示例:

[
    {
         "id": "4622631669645698414",
         "slfdf_1606240016": "张三",
         "slfdf_1606240017": "26",
         "create_time": "2016-07-01 13:51:26",
         "score":"60",
         "full_marks":"100",
         "visit_implement_id": "7158134644391369579",
         "sts": [
             {
                 "table_name": "slfdf_1606240015",
                 "rows": [
                     {
                         "id": "5542631669645698323",
                         "slfdf_1606240020": "李四",
                         "slfdf_1606240021": "30",
                         "create_time": "2016-07-01 13:51:26",
                         "master_id": "4622631669645698414"
                     }
                 ]
             }
         ]
    }
]

参数说明：

参数 类型 说明
id VARCHAR(32) 记录ID
create_time VARCHAR(32) 记录创建时间。格式：yyyy-MM-dd hh:mm:ss
score VARCHAR(32) 得分
full_marks VARCHAR(32) 满分
visit_implement_id VARCHAR(32) 高级拜访主数据ID
slfdf_XXXXXXXXXX VARCHAR(4000) 自定义字段数据。slfdf_XXXXXXXXXX含义详见任务功能配置查询
sts list 子表集合
sts.table_name VARCHAR(32) 子表名
sts.rows list 子表数据集合
sts.rows.id VARCHAR(32) 子表数据ID
sts.rows.create_time VARCHAR(32) 子表数据创建时间。格式：yyyy-MM-dd hh:mm:ss
sts.rows.master_id VARCHAR(32) 主数据ID
sts.rows.slfdf_XXXXXXXXXX VARCHAR(4000) 子表自定义字段数据。 slfdf_XXXXXXXXXX含义详见任务功能配置查询

# 常规拜访计划

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


{
	"startDate":"2018-12-07 13:41:55",
	"endDate":"2019-01-14 13:41:55",
	"page":"1",
	"rows":"5"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
startDate VARCHAR(32) 是 开始时间。格式：yyyy-MM-dd HH:mm:ss
endDate VARCHAR(32) 是 结束时间。格式：yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 否 数据页码，默认为1
rows VARCHAR(10) 否 每页数据显示条数，每页显示最大1000条，默认为1000条

响应示例：

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

数据DATA示例:

[ {
  "approvalStatus": "已审批",
  "createTime": "2025-07-07 19:04:43",
  "creatorCode": "sun",
  "creatorId": 6090674608962079732,
  "creatorName": "sun",
  "customerCode": "1028",
  "customerName": "1028",
  "deptCode": "sunflower",
  "deptFullName": "/sun",
  "deptId": 10,
  "deptName": "sun",
  "id": 4954055173451532162,
  "keyid": "4954055173451532162",
  "lines": [{
    "lineId": 6604615791341407937,
    "lineName": "超多客户"
  }],
  "planContent": "",
  "planStatus": "未拜访",
  "status": "1",
  "visitDate": "2025-07-07",
  "visitType": "常规计划",
  "visitor": 6090674608962079732,
  "visitorCode": "sun",
  "visitorName": "sun"
}]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 客户常规计划表id
status CHAR(1) 否 状态
visitDate VARCHAR(32) 否 计划拜访日期。格式：yyyy-MM-dd
visitorName VARCHAR(32) 否 拜访人姓名
visitorCode VARCHAR(32) 否 拜访人账号
visitor VARCHAR(32) 否 拜访人ID
deptName VARCHAR(32) 否 部门名称
deptCode VARCHAR(32) 否 部门编码
deptId VARCHAR(32) 否 部门ID
deptFullName VARCHAR(32) 否 部门全路径
visitType VARCHAR(32) 否 计划类型
customerName VARCHAR(32) 否 客户名称
customerCode VARCHAR(32) 否 客户编码
customer VARCHAR(32) 否 客户ID
approvalStatus VARCHAR(32) 否 审批状态
planStatus VARCHAR(32) 否 计划状态
planContent VARCHAR(32) 否 计划内容
creatorName VARCHAR(32) 否 创建人姓名
creatorCode VARCHAR(32) 否 创建人账号
creatorId VARCHAR(32) 否 创建人
createTime VARCHAR(32) 否 创建时间。格式：yyyy-MM-dd hh:mm:ss
lines List 否 所属线路集合
lines.lineId VARCHAR(32) 否 所属线路名称
lines.lineName CHAR(1) 否 线路ID

# 周期计划

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


{
	"startDate":"2018-12-07 13:41:55",
	"endDate":"2019-01-14 13:41:55",
	"page":"1",
	"rows":"5"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
startDate VARCHAR(32) 是 开始时间。格式：yyyy-MM-dd HH:mm:ss
endDate VARCHAR(32) 是 结束时间。格式：yyyy-MM-dd HH:mm:ss
page VARCHAR(10) 否 数据页码，默认为1
rows VARCHAR(10) 否 每页数据显示条数，每页显示最大1000条，默认为1000条

响应示例：

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

数据DATA示例:

[
    {
        "createTime": "2018-12-27 14:33:05",
        "creatorId": 7305659127525941876,
        "customer": 6675954821891532093,
        "endDate": "2018-12-30 00:00:00",
        "freqName": "四天1次",
        "freqNum": "4",
        "freqType": "1",
        "id": 4747842275093460113,
        "items": [
          {
            "content": "",
            "createTime": "2018-12-27 14:33:05",
            "creatorId": 7305659127525941876,
            "endDate": "2018-12-30 00:00:00",
            "id": 4997449653669851936,
            "modifyTime": "",
            "modifyierId": "",
            "planId": 4747842275093460113,
            "sequ": 1,
            "startDate": "2018-12-28 00:00:00",
            "status": "1"
          }
        ],
        "keyid": "4747842275093460113",
        "modifyTime": "",
        "modifyierId": "",
        "startDate": "2018-12-28 00:00:00",
        "status": "1",
        "visitor": 7894822868672331482,
        "name": "111"
    }
]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 否 客户周期计划表id
status CHAR(1) 否 状态
creatorId VARCHAR(32) 否 创建人
createTime VARCHAR(32) 否 创建时间。格式：yyyy-MM-dd hh:mm:ss
modifyierId VARCHAR(32) 否 修改人
modifyTime VARCHAR(32) 否 修改时间。格式：yyyy-MM-dd hh:mm:ss
planName VARCHAR(32) 否 周期计划名称
customer VARCHAR(32) 否 拜访客户
visitor VARCHAR(32) 否 拜访人
customer VARCHAR(32) 否 拜访客户
startDate VARCHAR(32) 否 开始日期。格式：yyyy-MM-dd hh:mm:ss
endDate VARCHAR(32) 否 结束日期。格式：yyyy-MM-dd hh:mm:ss
freqType VARCHAR(200) 否 频率类型
freqNum VARCHAR(200) 否 频率间隔
freqName VARCHAR(200) 否 频率名称
keyid VARCHAR(32) 否 分页实体标识
items List 否 客户周期及换频率段表集合
items.id VARCHAR(32) 否 客户周期及换频率段表id
items.status CHAR(1) 否 状态
items.creatorId VARCHAR(32) 否 创建人
items.createTime VARCHAR(32) 否 创建时间。格式：yyyy-MM-dd hh:mm:ss
items.modifyierId VARCHAR(32) 否 修改人
items.modifyTime VARCHAR(32) 否 修改时间。格式：yyyy-MM-dd hh:mm:ss
items.planId VARCHAR(32) 否 客户周期计划id
items.startDate VARCHAR(32) 否 周期开始日期。格式：yyyy-MM-dd hh:mm:ss
items.endDate VARCHAR(32) 否 周期结束日期。格式：yyyy-MM-dd hh:mm:ss
items.sequ VARCHAR(32) 否 排序
items.content VARCHAR(4000) 否 备注

# 按任务记录评价

接口说明：参数function_id使用的是 子任务设置 接口返回的function_id

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

{
	"function_id":"1111123123123",
	"create_date_start":"2018-12-07",
	"create_date_end":"2019-01-14",
	"approve_date_start":"2018-12-07",
	"approve_date_end":"2019-01-14",
	"page":"1",
	"rows":"5"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
function_id VARCHAR(32) 是 拜访任务ID
create_date_start VARCHAR(32) 否 提交开始时间。格式：yyyy-MM-dd
create_date_end VARCHAR(32) 否 提交结束时间。格式：yyyy-MM-dd
approve_date_start VARCHAR(32) 否 评价开始时间。格式：yyyy-MM-dd
approve_date_end VARCHAR(32) 否 评价结束时间。格式：yyyy-MM-dd
page VARCHAR(10) 是 数据页码，默认为1
rows VARCHAR(10) 否 每页数据显示条数。每页显示最大1000条，默认为1000条

响应示例：

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

数据DATA示例:

[
    {
        "approver_name":"18655115152",
        "visit_data_id":"6873275936437481327",
        "approval_data_id":"5866032376523455107",
        "approve_time":"2019-10-24 13:47:21",
        "visit_id":"5810261165939956719",
        "id":"6718542681384700500",
        "visit_form_id":"6821713303601969233",
        "approval_form_id":"5935116541669118198",
        "approve_status":"1",
        "approver_name":"评价人",
        "creator_name":"提交人",
        "create_time":"2019-10-24 13:47:21",
        "extract_status":"1"
    }
]

参数说明：

参数 类型 必填 说明
creator_name VARCHAR(32) 否 提交人姓名
create_time VARCHAR(32) 否 提交时间。格式：yyyy-MM-dd HH:mm:ss
approve_status VARCHAR(1) 否 评价状态：0 未评价 1 已评价
approver_name VARCHAR(32) 否 评价人姓名
approve_time VARCHAR(32) 否 评价时间。格式：yyyy-MM-dd HH:mm:ss
id VARCHAR(32) 否 评价记录ID
visit_id VARCHAR(32) 否 拜访ID
visit_form_id VARCHAR(32) 否 拜访任务ID
visit_data_id VARCHAR(32) 否 拜访任务数据ID
approval_form_id VARCHAR(32) 否 评价表单ID
approval_data_id VARCHAR(32) 否 评价表单数据ID
extract_status VARCHAR(32) 否 抽取状态。0：未抽取，1：已抽取

# 拜访评价记录

接口说明：

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

{
    "visit_id":"1111123123123",
    "visit_start_date":"2018-12-07",
    "visit_end_date":"2019-01-14",
    "approval_start_date":"2018-12-07",
    "approval_end_date":"2019-01-14",
    "status": 1,
    "page": 1,
    "rows": 100
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
visit_id VARCHAR(32) 是 拜访ID。拜访ID、拜访日期、评价日期有且必须只有一个必填
visit_start_date VARCHAR(32) 否 拜访开始日期。格式：yyyy-MM-dd
visit_end_date VARCHAR(32) 否 拜访结束日期。格式：yyyy-MM-dd
approval_start_date VARCHAR(32) 否 评价开始日期。格式：yyyy-MM-dd
approval_end_date VARCHAR(32) 否 评价结束日期。格式：yyyy-MM-dd
status VARCHAR(1) 否 状态。0：已删除，1：正常，不传则查询全部
page VARCHAR(10) 是 数据页码，默认为1
rows VARCHAR(10) 否 每页数据显示条数。每页显示最大1000条，默认为1000条

响应示例：

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

数据DATA示例:

[
  {
    "task_name":"Jack",
    "appraiser_source_code":null,
    "appraise_time":null,
    "modifier_name":null,
    "modify_time":null,
    "visitor_id":6327808947511856653,
    "appraiser_id":null,
    "visitor_source_code":null,
    "visit_type":"2",
    "task_id":5291554137657661293,
    "appraise_form_id":7459853140909284722,
    "appraise_record_id":8667640067737489939,
    "visit_use_time":1586238365012,
    "sub_task_name":"测试智能拍照",
    "customer_code":"STORE2021081210765",
    "leave_time":null,
    "appraiser_name":null,
    "modifier_source_code":null,
    "visitor_name":"zhoukun",
    "arrive_time":1586238365012,
    "arrive_pos_offset":14.83,
    "appraise_status":"1",
    "appraise_use_time":null,
    "sub_task_id":5467696442605305152,
    "modifier_id":null,
    "modifier_code":null,
    "appraiser_code":null,
    "customer_name":"lm测试",
    "visit_id":5221838591659429515,
    "customer_id":6193318747750340827,
    "visit_date":1586188800000,
    "leave_pos_offset":null
  }
]

参数说明：

参数 类型 必填 说明
id VARCHAR(32) 是 评价记录id
visit_date VARCHAR(32) 否 拜访时间。格式：yyyy-MM-dd
visitor_name VARCHAR(1) 否 拜访人名称
visitor_id VARCHAR(32) 否 拜访人id
visitor_code VARCHAR(32) 否 拜访人编码
visitor_source_code VARCHAR(32) 否 拜访人source_code
arrive_time VARCHAR(32) 否 抵达时间。格式：yyyy-MM-dd HH:mm:ss
arrive_pos_offset VARCHAR(32) 否 抵达登记偏差（米）
leave_time VARCHAR(32) 否 离开时间。格式：yyyy-MM-dd HH:mm:ss
leave_pos_offset VARCHAR(32) 否 离开登记偏差（米）
visit_type VARCHAR(32) 否 计划类型
customer_name VARCHAR(32) 否 拜访客户名称
customer_id VARCHAR(32) 否 拜访客户id
customer_code VARCHAR(32) 否 拜访客户编码
customer_source_code VARCHAR(32) 否 拜访客户source_code
visit_use_time VARCHAR(32) 否 拜访用时
visit_id VARCHAR(32) 否 拜访id
task_id VARCHAR(32) 否 拜访任务id
task_name VARCHAR(32) 否 拜访任务名称
sub_task_id VARCHAR(32) 否 拜访子任务id
sub_task_name VARCHAR(32) 否 拜访子任务名称
appraise_form_id VARCHAR(32) 否 评价表单id
appraiser_id VARCHAR(32) 否 评价人id
appraiser_name VARCHAR(32) 否 评价人
appraiser_code VARCHAR(32) 否 评价人编码
appraiser_source_code VARCHAR(32) 否 评价人source_code
appraise_time VARCHAR(32) 否 评价时间。格式：yyyy-MM-dd HH:mm:ss
modifier_id VARCHAR(32) 否 修改人id
modifier_name VARCHAR(32) 否 修改人
modifier_code VARCHAR(32) 否 修改人编码
modifier_source_code VARCHAR(32) 否 修改source_code
modify_time VARCHAR(32) 否 修改时间。格式：yyyy-MM-dd HH:mm:ss
appraise_status VARCHAR(32) 否 评价状态
appraise_use_time VARCHAR(32) 否 评价耗时

# 拜访线路查询

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

{
	"page":"1",
	"rows":"5"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page VARCHAR(10) 否 数据页码，默认为1
rows VARCHAR(10) 否 每页数据显示条数，每页显示最大1000条，默认为1000条

响应示例：

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

数据DATA示例:

[
    {
        "emp_id":"9002924154593040466",
        "emp_code":"mdx",
        "emp_name":"mdx",
        "route_id":"5409590634813260488",
        "route_name":"线路1",
        "cus_num":"2",
        "cus_id":"5988775653915770365,6171773607953380568",
        "cus_name":"CUS01075:测试,CUS0614:测试",
        "note":"",
        "sequence":"1.00"
    }
]

参数说明：

参数 类型 必填 说明
emp_id VARCHAR(32) 是 员工id
emp_code VARCHAR(100) 是 员工编码
emp_name VARCHAR(100) 是 员工姓名
route_id VARCHAR(100) 是 线路id
route_name VARCHAR(100) 是 线路名称
cus_num int 是 线路客户数
cus_id VARCHAR(1000) 是 线路中客户id，以","分隔
cus_name VARCHAR(1000) 是 线路中客户名称，以","分隔
note VARCHAR(1000) 否 备注
sequence NUMERIC 是 线路序号

# 任务整体评价

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

[{
  "data_id":"8894323874254105539",
  "acceptance_id":"8094761837554756455",
  "approver_code":"cjj",
  "audit_date_time":"",
  "remark":"111"
},
  {
    "data_id":"7517569961627272184",
    "acceptance_id":"8094761837554756455",
    "approver_code":"cjj",
    "audit_date_time":"",
    "remark":"111"
}]

参数说明：

参数 类型 必填 说明
data_id VARCHAR(100) 是 记录ID
acceptance_id VARCHAR(100) 是 评价结果，必须是系统里配置的评价项
approver_code VARCHAR(100) 是 员工账号，必须是启用状态的员工账号
audit_date_time VARCHAR(100) 否 格式：yyyy-MM-dd hh:mm:ss，如果没有填写则取实际入库时间
remark VARCHAR() 否 评价备注

响应示例：

{
  "return_code": "0",
  "return_msg": null,
  "msg_id": "90b4b267dd3d49aeace879038b1e7291",
  "response_data": "[{\"code\":1,\"dataId\":8894323874254105539,\"message\":\"成功\"},{\"code\":1,\"dataId\":7517569961627272184,\"message\":\"成功\"}]"
}

参数说明：

参数 类型 说明
code VARCHAR(100) 处理结果 0失败 1成功
dataId VARCHAR(100) 记录ID
message VARCHAR() 处理结果信息

← 客户拜访数据推送 →