# 任务执行记录

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

{
    "id":"7207490680071516631",
    "date_start": "2017-01-10",
    "date_end": "2017-01-20",
    "page":"1",
    "rows":"1000"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
id VARCHAR(32) 拜访id,传入此id时,可不传日期,若不传入该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":"8336850706919142842",
        "customer": "6313529032719815457",
        "customer_name": "门店",
        "customer_code": "CUS01867",
        "customer_sourcecode": "mendian",
        "manager_code":"ABC",	
        "manager_name":"123",
        "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_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.waiqin365.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.waiqin365.com/api/cusVisit/v1/queryCusVisitDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "function_id": "4622631669645698414",
    "date_start": "2017-01-10",
    "date_end": "2017-01-20",
    "page":"1",
    "rows":"1000"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
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.waiqin365.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
    }
]

参数说明:

参数 类型 必填 说明
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
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.waiqin365.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",
        "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
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.waiqin365.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 线路序号