# 拜访记录查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cusVisit/v1/queryCusVisitRecord/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "date_start": "2017-01-10",
    "date_end": "2017-01-20",
    "page":"1",
    "rows":"1000"
}

请求信息

参数 类型 必填 说明
date_start VARCHAR(10) 查询拜访日期起,格式:“yyyy-MM-dd”
date_end VARCHAR(10) 查询拜访日期止,格式:“yyyy-MM-dd”
page VARCHAR(10) 数据页码
rows VARCHAR(10) 每页数据显示条数(最大1000)

返回结果:

{
    "msg_id": "YY698688888",
    "response_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"
    }],
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数 类型 名称 备注
id VARCHAR(32) id 拜访记录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
visit_time VARCHAR(32) 拜访时间 实际拜访时间,格式:yyyy-MM-dd HH:mm:ss
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 } 在线调试 (opens new window)
请求包体:


{
    "msg_id": "YY698688888",
    "response_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",
                        }
                    ]
                }
            ]
    }],
    "return_code": 0,
    "return_msg": ""
}

请求信息

参数 类型 必填 说明

响应信息

参数 类型 名称 备注
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) 子表字段名称

# 拜访任务明细查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cusVisit/v1/queryCusVisitDetail/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "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)

返回结果:

{
    "msg_id": "YY698688888",
    "response_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",
                     }
                 ]
             }
         ]
}],
    "return_code": 0,
    "return_msg": ""
}

响应信息

参数 类型 名称 备注
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 ID
sts.rows.slfdf_XXXXXXXXXX VARCHAR(4000) 子表自定义字段数据 slfdf_XXXXXXXXXX含义详见任务功能配置查询

# 客户周期计划查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cusVisit/v1/queryCusVisitCyclePlan/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
	"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": null,
  "msg_id": "90b4b267dd3d49aeace879038b1e7291",
  "response_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) 计划内容

# 拜访任务评价记录查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cusVisit/v1/getVisitRecordApprovalData/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:


{
	"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":null,
    "msg_id":"queryCusVisitDetail_v1",
    "response_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 } 在线调试 (opens new window)
请求包体:


{
	"page":"1",
	"rows":"5"
}

请求信息

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

返回结果:

      
{
    "return_code":"0",
    "return_msg":null,
    "msg_id":"",
    "response_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 线路序号