拜访记录查询

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/cusVisit/v1/queryCusVisitRecord/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "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_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 TIMESTAMP 拜访记录创建时间 格式:yyyy-mm-dd hh24:mi:ss
modifyier_id VARCHAR(32) 拜访记录修改人ID
modifyier_name VARCHAR(100) 拜访记录修改人姓名
modifyier_sourcecode VARCHAR(32) 拜访记录修改人外部source_code
modify_time TIMESTAMP 拜访记录修改时间 格式:yyyy-mm-dd hh24:mi: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协访计划
flow_type VARCHAR(1) 流程类型 1:拜访,2:车销,3:车铺
plan_source VARCHAR(1) 流程类型 0:手机端计划,1:新增计划,2:导入计划,3:按频率生成计划,4:按周生成计划,5:按线路生成计划
total_score VARCHAR(32) 总分
full_marks VARCHAR(32) 满分
approval_status VARCHAR(1) 审批状态 0:未审批,1:已审批
customer VARCHAR(32) 拜访客户ID
customer_name VARCHAR(100) 客户名称
customer_sourcecode VARCHAR(32) 客户外部source_code
manager_code VARCHAR(200) 客户经理编码
manager_name VARCHAR(200) 客户经理名称
visit_date TIMESTAMP 拜访日期 预定拜访日期,格式:yyyy-mm-dd hh24:mi:ss
visit_time TIMESTAMP 拜访时间 实际拜访时间,格式:yyyy-mm-dd hh24:mi: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 TIMESTAMP 失访登记时间 格式:yyyy-mm-dd hh24:mi: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 TIMESTAMP 到店时间 格式:yyyy-mm-dd hh24:mi: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 TIMESTAMP 离店时间 格式:yyyy-mm-dd hh24:mi: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 TIMESTAMP 拜访总结时间 格式:yyyy-mm-dd hh24:mi:ss
del_person VARCHAR(32) 删除人ID
del_person_name VARCHAR(200) 删除人姓名
del_time TIMESTAMP 删除时间 格式:yyyy-mm-dd hh24:mi: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 }
请求包体:


{
    "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 TIMESTAMP 发布时间 格式:yyyy-mm-dd hh24:mi: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 }
请求包体:

{
    "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) 记录创建时间
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) 子表数据创建时间
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 }
请求包体:


{
	"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) 创建时间
modifyierId VARCHAR(32) 修改人
modifyTime VARCHAR(32) 修改时间
customer VARCHAR(32) 拜访客户
visitor VARCHAR(32) 拜访人
customer VARCHAR(32) 拜访客户
startDate VARCHAR(32) 开始日期
endDate VARCHAR(32) 结束日期
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) 创建时间
items.modifyierId VARCHAR(32) 修改人
items.modifyTime VARCHAR(32) 修改时间
items.planId VARCHAR(32) 客户周期计划id
items.startDate VARCHAR(32) 周期开始日期
items.endDate VARCHAR(32) 周期结束日期
items.sequ VARCHAR(32) 排序
items.content VARCHAR(4000) 计划内容

拜访任务评价记录查询

请求方式: 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":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) 提交时间
approve_status VARCHAR(1) 评价状态:0 未评价 1 已评价
approver_name VARCHAR(32) 评价人姓名
approve_time VARCHAR(32) 评价时间
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":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":""
        }
    ]
}   

响应信息

参数 类型 必填 说明
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 备注