获取客户档案列表_API接口文档

获取客户档案列表

请求方式：

GET

请求地址：

https://api.eshouhou.cn/open/v2/Customer/GetCustomers?access_token=eXNoNTRkZDRmOGFyaW5meCY2YTgyNTFiYS1jZTY0LTQ2YjctYTUwNS1hNGU1NjAwMzI3MDYmMTIw

请求参数：

参数	类型	必填	名称	备注
serviceSpaceId	string	是	服务空间id
serviceNetworkId	string	是	服务网点id
serviceNetworkType	int	是	网点类型	网点类型（1总部，2网点）；默认1
condition	String	否	条件	Json字符串，例如： " { "sys_number":"", "sys_name":"", "sys_contact":"", "sys_telephone":"", "sys_startdate":"", "sys_enddate":"", "sys_startservicedate":"", "sys_endservicedate":"", "sys_labellist":[] }" 详解： sys_number：编号 sys_name：名称 sys_contact：联系人姓名 sys_telephone：联系电话 sys_startdate：创建开始日期 sys_enddate：创建结束日期 sys_startservicedate：最近服务开始日期 sys_endservicedate：最近服务结束日期 sys_labellist：标签id集合，可以通过《获取客户标签列表》接口获取。注：区分大小写
searchKey	String	否	关键字
pageSize	String	否	每页记录数	默认10
pageIndex	String	否	页码	默认1

返回参数：

参数	类型	必填	名称
ResultCode	String	是	返回编码
ErrorMsg	String	否	返回信息
ResultValue	Array	否	返回对象集合

ResultValue对象：

参数	类型	必填	名称	备注
ID	string	是	客户id
Number	string	是	客户编号
ServiceSpaceID	string	是	服务空间id
ServiceNetworkID	string	是	服务网点id
ContactID	String	否	客户联系人id
Name	string	否	客户名称
Contact	String	否	客户联系人名称
isMainContact	Bool	是	是否是主联系人
Gender	Int	否	性别	0默认，1男，2女
Telephone	String	是	手机号
Mobile	String	是	联系电话
Mail	String	否	邮箱
WeChat	String	否	微信号
HeadImg	String	否	头像
UserName	String	是	账号
Password	String	否	密码	暂时不用
CompanyName	String	否	企业名称
Area	String	否	所属区域	所属区域格式为“北京市-北京市-朝阳区”
Address	String	否	详细地址
LabelIDs	String	否	标签id	多个用“、”分隔
LabelNames	String	否	客户标签	多个用“、”分隔
CreateTime	String	否	创建时间
RecentService	String	否	最近服务时间
UpdateTime	String	否	最近服务时间
CustomFields	array	否	自定义字段集合	暂时不用
Country	String	否	国家
Dial	String	否	区号
Longitude	decimal	否	经度
Latitude	decimal	否	纬度
AreaAddress	string	否	区域地址	已经处理过的区域地址例如："北京市通州区东郊森林公园-华北树木园"

请求示例：

https://api.eshouhou.cn/open/v2/Customer/GetCustomers?serviceSpaceId=6a8251ba-ce64-46b7-a505-a4e560032706& serviceNetworkId=bd7fc093-0ccf-4335-9daf-10931b4e7c7d&serviceNetworkType=1

返回成功示例：

{

"ResultCode": 0,

"ErrorMsg": "",

"ResultValue": [

{

"ID": "dc540ce7-5bc5-4275-b8fa-2004eb5839e3",

"Number": "CF00000179",

"ServiceSpaceID": "6a8251ba-ce64-46b7-a505-a4e560032706",

"ServiceNetworkID": null,

"ContactID": "29ef900b-a360-4fa1-96cf-1be9b5a3aeea",

"Name": "胡效鑫1",

"Contact": "胡效鑫1",

"isMainContact": false,

"Gender": 1,

"Telephone": "18539622352",

"Mobile": "18539622352",

"Mail": "903146517@qq.com",

"WeChat": "",

"HeadImg": null,

"UserName": null,

"Password": null,

"CompanyName": "",

"Area": "北京市-北京市-通州区",

"Address": "东郊森林公园-华北树木园",

"LabelIDs": "1、2、19410、",

"LabelNames": "普通客户、VIP客户、高级客户",

"CreateTime": "2022-01-15",

"RecentService": "2023-03-07",

"UpdateTime": null,

"CustomFields": null,

"Country": "中国",

"Dial": "+86",

"Longitude": 116.672099,

"Latitude": 39.989688,

"AreaAddress": "北京市通州区东郊森林公园-华北树木园"

}

]

}

开放平台

获取客户档案列表