开发前必读
概述
开发者使用指南
开发者使用流程
通信说明
开发者工具
更新日志
基础能力接口
获取token接口
外部系统单点登录
单点登录使用说明
获取单点登录用户信息
通讯录管理
获取部门列表
新增部门
修改部门
删除部门
新增用户
修改用户
删除用户
获取用户列表
通讯录变更同步
获取标签信息
新增标签
修改标签
删除标签
获取标签成员列表
添加标签成员
删除标签成员
按部门查询标签
按用户查询标签
离职用户
获取离职信息
用户复职
获取自定列表信息
第三方消息推送
推送文本消息
推送图文消息
推送消息附录
统一消息推送(回调)
图片附件上传
图片附件下载
图片附件单个下载
图片附件批量下载
应用数据接口
表单流程/七巧
新增表单
获取表单模板信息
推送数据
修改表单数据
删除表单数据
数据源
数据回调
导出表单流程数据
获取填写情况详细数据(新)
通过ID获取填写详细数据(新)
流程干预
获取填写情况详细数据(旧)
通过ID获取填写详细数据(旧)
获取应用填写详细数据(待办、已办等)
发票识别接口
发票验真接口
附录
考勤打卡
获取考勤规则列表
获取考勤详细信息
获取考勤日报信息
注册考勤服务
新增虚拟考勤机
删除虚拟考勤机
考勤机打卡
获取考勤排班明细
获取考勤异常申诉记录
请假出差
获取请假信息列表
获取请假类型列表
假期管理
获取请假详情信息
新闻公告
获取新闻动态类型
新增新闻动态
获取新闻列表
获取新闻详情
获取个人新闻列表
费控报销
获取报销信息列表
获取成本中心信息列表
导入成本中心
获取预算明细
获取发票信息列表
获取借款信息列表
获取用户可见范围内成本中心
获取用户可见范围内科目
获取超额预算
费控预算操作
企业用车
获取车辆申请列表
任务分派
获取任务分派信息列表
获取任务类型信息接口
新建任务接口
移动CRM
获取客户信息列表
获取客户字段
新增客户
更新客户
获取客户详情
获取客户类别
获取所有公海池
获取所有行业信息
获取联系人信息列表
获取联系人字段
新增联系人
更新联系人
获取联系人详情
获取商机信息列表
获取商机字段
新增商机
更新商机
获取商机详情
获取商机阶段或商机类型
修改商机阶段
获取拜访信息列表
获取合同信息列表
获取合同字段
新增合同
更新合同
获取合同详情
获取公海池客户信息列表
获取公海池客户详情
培训考试
获取考试成绩列表
获取考试统计信息列表
获取考试人员明细
获取学习统计信息列表
获取个人学习档案信息列表
获取课程统计信息列表
获取课程人员明细
获取个人学分明细
获取讲师信息列表
获取题库试题明细
新增题库试题
删除题库试题
移动外勤
获取签到信息列表
会议管家
获取会议详情
获取会议纪要详情
获取会议室详情
获取区域列表
获取会议室列表
获取会议详情列表

获取客户详情

开发说明

功能说明:获取客户详情
请求方式:POST(HTTPS)
请求地址:https://qwif.do1.com.cn/qwcgi/api/crm/client/getClientDetail.do?token=token&corpId=corpId

请求包体:

{
  "clientId":"c5c17525-0ff2-4425-a57b-b075290f738f"
}

请求参数说明:

参数 说明 类型 是否必填 备注
clientId 客户Id String

SDK调用示例:

        // 创建请求参数
        CrmClientDetailReqVO vo = new CrmClientDetailReqVO();
        // 设置获取类型
        vo.setClientId("bf6af4f7-1a7d-468c-bb66-cf3f18a28869");
        System.out.println(JSONUtil.stringify(vo));
        CrmApi api = QwSdkUtil.getInter(CrmApi.class);
        // 调用接口
        ApiCrmClientDetailsResultVO clientInfo = api.getClientDetail(
                QwSdkUtil.getCacheToken(), vo);
        System.out.println(JSONUtil.stringify(clientInfo));
        

返回结果:

{
	"code":"0",
	"data":
	{
		"clientInfo":
		{
			"address":"广东省广州市天河区员村一横路3号华颖轩1-2层",
			"areaCode":"天河区",
			"chargePersons":
			[
				{
					"id":"2a442250fe1d4c178a7e22e1e3794317",
					"name":"刘先生"
				}

			],
			"cityCode":"广州市",
			"clientCode":"2019062520190619000108",
			"clientName":"道一",
			"createTime":"2019-06-25 10:30:00",
			"creator":"张三",
			"customFields":
			[
				{
					"fieldName":"其他号码",
					"fieldValue":"13355556666"
				},
				{
					"fieldName":"百分数",
					"fieldValue":"20%"
				},
				{
					"fieldName":"日期",
					"fieldValue":"2019-06-07 10:00"
				},
				{
					"fieldName":"文本",
					"fieldValue":"qweasdzxc123"
				},
				{
					"fieldName":"整数",
					"fieldValue":"100000"
				},
				{
					"fieldName":"小数",
					"fieldValue":"123.45"
				}

			],
			"email":"123456789@do1.com.cn",
			"industryList":"计算机软件,移动互联网",
			"latitude":"23.128263",
			"longitude":"113.359385",
			"phone":"13333333333",
			"pool":"默认公海",
			"provinceCode":"广东省",
			"relativePersons":
			[
				{
					"id":"2a442250fe1d4c178a7e22e1e3794317",
					"name":"张小姐"
				},
				{
					"id":"7f15f5b13d254ed7a46a42e1ca0ca225",
					"name":"李先生"
				}

			],
			"remark":"这是备注",
			"seniorFields":
			[
				{
					"fieldName":"(表单)单行文字",
					"fieldType":"TextField",
					"fieldValue":"(表单)单行文字"
				},
				{
					"fieldName":"(表单)邮箱",
					"fieldType":"EmailField",
					"fieldValue":"baidu@163.com"
				},
				{
					"fieldName":"(表单)数字",
					"fieldType":"NumberField",
					"fieldValue":"17"
				},
				{
					"fieldName":"(表单)电话",
					"fieldType":"TelephoneField",
					"fieldValue":"13212345679"
				},
				{
					"fieldName":"(表单)手机",
					"fieldType":"MobileField",
					"fieldValue":"13212345688"
				},
				{
					"fieldName":"(表单)多行文字",
					"fieldType":"TextArea",
					"fieldValue":"(表单)多行文字\n(表单)多行文字\n(表单)多行文字"
				},
				{
					"fieldName":"(表单)日期",
					"fieldType":"DateField",
					"fieldValue":"2019-12-04"
				},
				{
					"fieldName":"(表单)时间",
					"fieldType":"TimeField",
					"fieldValue":"16:01"
				},
				{
					"fieldName":"(表单)日期时间",
					"fieldType":"DateTimeField",
					"fieldValue":"2019-12-04 16:01"
				},
				{
					"fieldName":"(表单)单项选择",
					"fieldType":"RadioButton",
					"fieldValue":"选项2"
				},
				{
					"fieldName":"(表单)多项选择",
					"fieldType":"CheckBox",
					"fieldValue":
					[
						"选项1",
						"选项3"
					]

				},
				{
					"fieldName":"(表单)下拉框",
					"fieldType":"DropDown",
					"fieldValue":"选项2"
				},
				{
					"fieldName":"(表单)评分",
					"fieldType":"RatingField",
					"fieldValue":"3"
				},
				{
					"fieldName":"(表单)地理位置",
					"fieldType":"GeoField"
				},
				{
					"fieldName":"(表单)说明项",
					"fieldType":"ImageCheckBox"
				},
				{
					"fieldName":"(表单)分节",
					"fieldType":"SectionBreak"
				},
				{
					"fieldName":"(表单)图片",
					"fieldType":"ImageField",
					"fieldValue":
					[
						{
							"fileExt":"JPEG",
							"fileName":"test12_20191204160143178_364.JPEG",
							"fileSizeStr":"22.21 K",
							"id":"fo03a32cded98b45f0802326e78a3422aa",
							"url":"/upload/img/b17efb43292e4cc9ac5d0b46bce059c4/20191204/b565131ef6364b68b5202b7e3a2ea596.jpeg"
						}

					]

				},
				{
					"fieldName":"(表单)省市区",
					"fieldType":"CityField",
					"fieldValue":"北京市:北京市:西城区"
				},
				{
					"fieldName":"(表单)计算式",
					"fieldType":"EquationField",
					"fieldValue":"17"
				},
				{
					"fieldName":"(表单)两级下拉框",
					"fieldType":"CascadeDropDown",
					"fieldValue":"选项1:二级选项1"
				},
				{
					"fieldName":"(表单)微信扫码",
					"fieldType":"ImageRadioButton"
				},
				{
					"fieldName":"(表单)流水号",
					"fieldType":"SerialNumberField",
					"fieldValue":"0003"
				},
				{
					"fieldName":"(表单)手写签名",
					"fieldType":"HandWrittenField"
				},
				{
					"fieldName":"(表单)通讯录成员",
					"fieldType":"MEMBERCustomerField",
					"fieldValue":
					[
						{
							"deptFullName":"开发小组1",
							"deptId":"8f68dfcc400dcbcea2c02b92de29fc4",
							"headPic":"http://shp.qpic.cn/bizmp/ck4hSGq23RjMhicqucxwgwOb1n45wJCODzsLL87zrDAwBEAFia3Fb2yg/100",
							"mobile":"13212345678",
							"orgId":"df3-292e-4cc9-ac5d-0b46bce059c4",
							"personName":"张三",
							"userId":"dsdd67f34b68ae590ccaadcbf49c0ad",
							"userNo":"001",
							"wxUserId":"zhangsan"
						},
						{
							"deptFullName":"开发小组2",
							"deptId":"2c81deb6288576399ff52671b9fbb875",
							"headPic":"http://shp.qpic.cn/bizmp/ck4hSGq23RgbOh6S2MzkhGNyJTLmqHgMNCib3bJqiaZXeK7fZ9LhGTtQ/100",
							"mobile":"13412345678",
							"orgId":"df3-292e-4cc9-ac5d-0b46bce059c4",
							"personName":"李四",
							"userId":"dfsddf33d51ddc3c39bc5571bf8",
							"userNo":"002",
							"wxUserId":"lisi"
						}

					]

				},
				{
					"fieldName":"(表单)部门",
					"fieldType":"DEPTCustomerField",
					"fieldValue":
					[
						{
							"departmentName":"部门1",
							"id":"1251fc59231faf44bd47fb68c834704"
						},
						{
							"departmentName":"部门2",
							"id":"fdsc47932215f1019856bc4d55ade80f"
						},
						{
							"departmentName":"部门3",
							"id":"67fdb35fc3ddb7bfefe41440411dbe16"
						}

					]

				}

			],
			"types":"VIP客户,测试用户",
			"updateTime":"2019-06-25 10:30:00",
			"website":"www.do1.com.cn"
		}

	},
	"desc":"成功"
}

返回参数说明:

clientInfo参数


参数

说明

备注

clientCode

客户编码

 

clientName

客户名

 

types

客户类型

 

pool

所属公海

 

provinceCode

省份

 

cityCode

市区

 

areaCode

地区

 

address

具体地址

 

latitude

纬度

 

longitude

经度

 

industryList

行业

 

phone

联系电话

 

email

邮箱

 

website

网站

 

remark

备注

 

chargePersons

负责人

 

relatviePersons

相关人

 

submitType

通知类型

 

customFields

自定义字段

 

seniorFields
表单字段

creator

创建人

 

createTime

创建日期

 

updateTime

更新日期


seniorFields参数


参数
说明 备注
fieldName
字段名称
fieldType
类型

TextField(单行文字)、EmailField(邮箱)、NumberField(数字)、TelephoneField(电话)、MobileField(手机)、
TextArea(多行文字)、DateField(日期)、TimeField(时间)、DateTimeField(日期时间)、RadioButton(单项选择)、
CheckBox(多项选择)、DropDown(下拉框)、RatingField(评分)、GeoField(地理位置)、ImageCheckBox(说明项)、
SectionBreak(分节)、ImageField(图片)、CityField(省市区)、EquationField(计算式)、CascadeDropDown(两级下拉框)、

ImageRadioButton(微信扫码)、SerialNumberField(流水号)、HandWrittenField(手写签名)、MEMBERCustomerField(通讯录成员)、

DEPTCustomerField(部门)

fieldValue
字段值

(1) 如果是图片类型,则是一个图片对象,包括fileName(文件名)、fileSizeStr(文件大小)、id(文件id)、fileExt(文件类型)、url(文件地址);

(2) 如果是通讯录类型,则是一个通讯录用户对象,包括personName(用户名)、wxUserId(用户微信id)、userNo(用户编号)、deptId(部门id)、

mobile(联系方式)、departmentNo(部门编号)、headPic(头像地址)、userId(用户id)、orgId(机构id)、deptFullName(部门全称);

(3) 如果是部门类型则是一个部门对象,包括departmentName(部门名称)、id(部门id);