知客CRM开发者接口_API接口文档

参数名称	描述
IsSuccess	是否成功
Message	详细描述
Data	返回内容（部分接口不返回该参数）

2.1 获取日程安排信息

为必填字段，非必填字段可不传；获取日程安排信息时必须指定日期。

字段名

描述

Category

标识需要进行的操作，当前调用为：GetCalendar

Key

身份验证秘钥

Data

获取日程所需要传递的信息

字段名	描述
Date	指定某一天的日程，格式要求为yyyy-MM-dd
User	指定某个人员的日程
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category":"GetCalendar",
	"Key":"",
	"Data":{
		"Date":"2021-09-14", 
		"User":"",
		"Page":1,
		"PageSize":10
	}
}

返回内容的Data说明

字段名	描述
Id	日程ID
User	人员名称
Subject	主题
Memo	详细内容
StartTime	日程开始时间
EndTime	日程结束时间

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "399",
		"User": "谭朗",
		"Subject": "应收提醒-某某公司",
		"Memo": "第二笔款项已到应收期，请及时联系",
		"StartTime": "2021-11-12 00:00",
		"EndTime": "2021-11-13 00:00"
	}, {
		"Id": "398",
		"User": "谭朗",
		"Subject": "对至诚公司进行回访",
		"Memo": "上一次是在2021-11-09联系了苏经理，上次的行动内容：客户在出差，让我3天后再进行详细沟通",
		"StartTime": "2021-11-12 09:00",
		"EndTime": "2021-11-12 11:00"
	}]
}

2.2 保存日程安排信息

为必填字段，非必填字段可不传；日程安排信息中的Id为必填字段，若为新增日程，则传递0，否则则按照Id值进行日程的修改。

字段名

描述

Category

标识需要进行的操作，当前调用为：SaveCalendar

Key

身份验证秘钥

Data

需要保存的日程安排信息

字段名	描述
Id	日程安排ID
User	人员（此处的人员名称需与员工表中的名称保持一致）
Subject	主题
Memo	详细内容（若不传递该参数，则详细内容与主题一致）
StartTime	开始时间（yyyy-MM-dd HH:mm）
EndTime	结束时间（yyyy-MM-dd HH:mm）
Completed	是否已完成（0或者1，如不需要做出修改，该参数可不传递）

Json示例

{
	"Category": "SaveCalendar",
	"Key": "",
	"Data": {
		"Id": 0,
		"User": "唐逍",
		"Subject": "客户拜访",
		"Memo": "下午3点40分到客户公司进行需求沟通",
		"StartTime": "2021-12-17 15:40",
		"EndTime": "2021-12-17 17:30",
		"Completed": "0"
	}
}

2.3 获取客户列表

为必填字段，非必填字段可不传；获取客户信息时必须指定筛选字段和关键字，如需要查找公司名称包含“上古软件”的客户，则FilterField传递Name，Keyword传递“上古软件”。

字段名

描述

Category

标识需要进行的操作，当前调用为：GetCustomer

Key

身份验证秘钥

Data

获取客户所需要传递的信息

字段名	描述
FilterField	进行筛选的字段，多个条件用半角逗号隔开，如 Province,User 查看字段
Keyword	筛选的关键字，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如福建,谭朗
Fields	需要获取的字段，若不传递则显示默认字段，传递内容示例：Id,Name,Number,Mobile,Tel
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category":"GetCustomer",
	"Key":"",
	"Data":{
		"FilterField":"Name", 
		"Keyword":"华为",
		"Page":1,
		"PageSize":10
	}
}

返回内容的Data说明

字段名	描述
Id	客户ID
Number	客户编号
Name	客户名称
Contact	主联系人
Tel	电话
Mobile	手机号码
Email	邮箱地址
Type	客户类型
Province	省份
City	城市
Address	地址
User	客户的业务员

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "53897",
		"Number": "C00053897",
		"Name": "厦门上古软件有限公司",
		"Contact": "",
		"Mobile": "",
		"Tel": "",
		"Email": "",
		"Type": "重点关注",
		"Province": "福建",
		"City": "厦门市",
		"Address": "",
		"User": ""
	}, {
		"Id": "53898",
		"Number": "C00053898",
		"Name": "长沙上古软件有限公司",
		"Contact": "",
		"Mobile": "",
		"Tel": "",
		"Email": "",
		"Type": "成交客户",
		"Province": "湖南",
		"City": "长沙市",
		"Address": "",
		"User": ""
	}]
}

2.4 保存客户信息

为必填字段，非必填字段可不传；接口调用动作默认为新增客户，当客户信息中的客户编号（Number）字段进行了传递且该编号的客户已存在系统中时，当前调用将更改为更新客户。

字段名

描述

Category

标识需要进行的操作，当前调用为：SaveCustomer

Key

身份验证秘钥

Data

需要保存的客户信息

字段名

描述

Number

客户编号

Name

客户名称

Contact

联系人

Tel

电话号码

Mobile

手机号码

Email

邮箱地址

Type

客户类型，该字段内容必须保持与字典表一致，否则该字段无法保存

Origin

客户来源，该字段内容必须保持与字典表一致，否则该字段无法保存

Province

省份

City

城市

Region

区域

User

业务员，人员名称必须与员工表中的名称一致，否则无法保存

Address

地址

Label

客户标签

ServiceUser

售后人员，人员名称必须与员工表中的名称一致，否则无法保存

Memo

备注信息

CustomFields

扩展字段

字段名	描述
扩展字段1
扩展字段2

如果为客户建立了扩展字段，则按照建立的扩展字段的名称来进行传递，如建立了“客户行业”、“企业规模”两个字段，则传递内容为"CustomFields": {"客户行业":"生产制作","企业规模":"100人左右"}

Json示例

{
	"Category": "SaveCustomer",
	"Key": "",
	"Data": {
		"Number": "客户编号",
		"Name": "客户名称",
		"Contact": "联系人",
		"Tel": "电话号码",
		"Mobile": "手机号码",
		"Email": "邮箱",
		"Type": "客户类型",
		"Origin": "客户来源",
		"Province": "省份",
		"City": "城市",
		"Region": "区",
		"User": "业务员",
		"Address": "工作地址",
		"Label": "标签",
		"ServiceUser": "售后人员",
		"Memo": "备注信息",
		"CustomFields": {
			"客户行业": "",
			"微信号": "",
			"企业规模": ""
		}
	}
}

2.5 获取联系人列表

为必填字段，非必填字段可不传；获取联系人信息时必须指定筛选字段和关键字，如需要获取隶属公司名称为“厦门至鼎科技有限公司”名下的所有联系人，则FilterField传递CustomerName，Keyword可传递“厦门至鼎”。

字段名

描述

Category

标识需要进行的操作，当前调用为：GetContact

Key

身份验证秘钥

Data

获取联系人所需要传递的信息

字段名	描述
FilterField	进行筛选的字段，多个条件用半角逗号隔开，如 CustomerName,Name 查看字段
Keyword	筛选的关键字，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如华为,李总
Fields	需要获取的字段，若不传递则显示默认字段，传递内容示例：Id,Name,CustomerName,Mobile,Tel
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category": "GetContact",
	"Key": "",
	"Data": {
		"FilterField": "CustomerName",
		"Keyword": "厦门至鼎",
		"Page": 1,
		"PageSize": 10
	}
}

返回内容的Data说明

字段名	描述
Id	联系人ID
Name	联系人名称
CustomerName	隶属的客户名称
Tel	电话
Mobile	手机号码
Email	邮箱地址
Group	所在部门
Title	职位
Type	联系人类型

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "39683",
		"Name": "谭朗",
		"CustomerName": "厦门至鼎科技有限公司",
		"Mobile": "",
		"Tel": "",
		"Email": "",
		"Group": "业务部",
		"Title": "销售经理",
		"Type": "需求对接"
	}, {
		"Id": "39683",
		"Name": "唐逍",
		"CustomerName": "厦门至鼎科技有限公司",
		"Mobile": "",
		"Tel": "",
		"Email": "",
		"Group": "采购部",
		"Title": "采购经理",
		"Type": "关键决策人"
	}]
}

2.6 保存联系人

为必填字段，非必填字段可不传；接口调用动作为新增联系人

字段名

描述

Category

标识需要进行的操作，当前调用为：SaveContact

Key

身份验证秘钥

Data

需要保存的联系人信息

字段名

描述

Customer

联系人所属客户的名称，客户必须与系统中已存的客户名称一致，否则不予保存

Name

联系人名称

Tel

电话号码

Mobile

手机号码

Email

邮箱地址

Type

联系人类型，该字段内容必须保持与字典表一致，否则该字段无法保存

Group

所在部门

Title

联系人职务

Gender

性别，填写“男”或“女”

Label

联系人标签

Memo

备注信息

CustomFields

扩展字段

字段名	描述
扩展字段1
扩展字段2

如果为联系人建立了扩展字段，则按照建立的扩展字段的名称来进行传递，如建立了“爱好”、“毕业院校”两个字段，则传递内容为"CustomFields": {"爱好":"钓鱼、远东","毕业院校":"厦门大学"}

Json示例

{
	"Category": "SaveContact",
	"Key": "",
	"Data": {
		"Customer": "所属客户的名称",
		"Name": "联系人名称",
		"Tel": "电话号码",
		"Mobile": "手机号码",
		"Email": "邮箱",
		"Type": "联系人类型",
		"Group": "所在部门",
		"Title": "职位",
		"Gender": "性别",
		"Label": "联系人标签",
		"Memo": "备注",
		"CustomFields": {
			"爱好": "钓鱼、运动"
		}
	}
}

2.7 获取产品列表

为必填字段，非必填字段可不传；

字段名

描述

Category

标识需要进行的操作，当前调用为：GetProduct

Key

身份验证秘钥

Data

获取产品所需要传递的信息

字段名	描述
FilterField	进行筛选的字段，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如 Name,TypeName 查看字段
Keyword	筛选的关键字，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如内存,计算机配件
Fields	需要获取的字段，若不传递则显示默认字段，传递内容示例：Id,Code,Name,TypeName,Price,Unit,Memo
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category":"GetProduct",
	"Key":"",
	"Data":{
		"FilterField": "Name",
		"Keyword": "笔记本",
		"Page": 1,
		"PageSize": 10
	}
}

返回内容的Data说明

字段名	描述
Id	产品ID
Code	产品编号
Name	产品名称
TypeName	产品类型
Price	售价
Unit	单位
Memo	详细描述

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "13453",
		"Code": "E39133-321",
		"Name": "内存DDL",
		"TypeName": "计算机配件",
		"Price": "400.00",
		"Unit": "套",
		"Memo": ""
	}, {
		"Id": "13454",
		"Code": "E39133-323",
		"Name": "硬盘2TB",
		"TypeName": "计算机配件",
		"Price": "400.00",
		"Unit": "块",
		"Memo": ""
	}]
}

2.8 保存产品信息

为必填字段，非必填字段可不传；接口调用动作默认为新增产品，当产品信息中的产品编码（Code）字段进行了传递且该编码的产品已存在系统中时，当前调用将更改为更新产品信息。

字段名

描述

Category

标识需要进行的操作，当前调用为：SaveProduct

Key

身份验证秘钥

Data

需要保存的产品信息

字段名

描述

Code

产品编码

Name

产品名称

Type

产品类型

Price

产品售价（要求必须为数字）

Cost

产品成本（要求必须为数字）

Memo

备注信息

CustomFields

扩展字段

字段名	描述
扩展字段1
扩展字段2

如果为产品建立了扩展字段，则按照建立的扩展字段的名称来进行传递，如建立了“产品尺寸”、“产品属性”两个字段，则传递内容为"CustomFields": {"产品尺寸":"240mm*175mm","产品属性":"成套件"}

Json示例

{
	"Category": "SaveProduct",
	"Key": "",
	"Data": {
		"Code": "产品编码",
		"Name": "产品名称",
		"Type": "产品类型",
		"Price": "产品售价",
		"Cost": "产品成本",
		"Memo": "备注信息",
		"CustomFields": {
			"产品尺寸": "",
			"产品属性": ""
		}
	}
}

2.9 获取销售机会列表

为必填字段，非必填字段可不传；获取销售机会信息时可以指定筛选字段和关键字，也可以指定销售机会的创建时间区间，如需要查找“上古软件”的销售机会，则FilterField传递CustomerName，Keyword传递“上古软件”。

字段名

描述

Category

标识需要进行的操作，当前调用为：GetProject

Key

身份验证秘钥

Data

获取销售机会所需要传递的信息

字段名	描述
FilterField	进行筛选的字段，多个条件用半角逗号隔开，如 CustomerName,UserName 查看字段
Keyword	筛选的关键字，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如可可食品,卢青梅
StartDate	指定销售机会创建时间区间的开始日期（yyyy-MM-dd）
EndDate	指定销售机会创建时间区间的结束时间（yyyy-MM-dd）
Fields	需要获取的字段，若不传递则显示默认字段，传递内容示例：Id,CustomerName,Name,CreateDate,Status,StageName,EstimatePrice,EstimateDate,UserName,Memo
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category": "GetProject",
	"Key": "",
	"Data": {
		"FilterField": "",
		"Keyword": "",
		"StartDate": "2021-07-01",
		"EndDate": "2021-10-31",
		"Page": 1,
		"PageSize": 10
	}
}

返回内容的Data说明

字段名	描述
Id	销售机会ID
CustomerId	客户ID
Name	销售机会名称
CustomerName	客户名称
CreateDate	成交时间
Status	销售机会状态
StageName	销售机会阶段
EstimatePrice	预计成交金额
EstimateDate	预计成交日期
UserName	负责人
Memo	详细描述

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "2175",
		"CustomerId": "175420",
		"CustomerName": "福建省厦门市可可食品",
		"Name": "SWZCXH20210624",
		"CreateDate": "2021-06-24",
		"Status": "成功结束",
		"StageName": "项目注册",
		"EstimatePrice": "0.00",
		"EstimateDate": "2021-02-28",
		"UserName": "谭朗",
		"Memo": ""
	}, {
		"Id": "2169",
		"CustomerId": "175420",
		"CustomerName": "福建省厦门市可可食品",
		"Name": "20200905SWZCXH02",
		"CreateDate": "2020-08-05",
		"Status": "进行中",
		"StageName": "项目注册",
		"EstimatePrice": "20000.00",
		"EstimateDate": "暂不清楚",
		"UserName": "谭朗",
		"Memo": ""
	}]
}

2.10 获取销售机会详情

为必填字段，非必填字段可不传；

字段名

描述

Category

标识需要进行的操作，当前调用为：GetProjectDetail

Key

身份验证秘钥

Data

获取销售机会详情所需要传递的信息

字段名	描述
Id	传递需要获取销售机会的ID（与下方的销售机会名称进行2选1即可）
Name	传递需要获取销售机会的名称（与上方的销售机会ID进行2选1即可）

Json示例

{
	"Category": "GetProjectDetail",
	"Key": "",
	"Data": {
		"Id": "2178",
		"Name": ""
	}
}

返回内容的Data说明

字段名

描述

Id

销售机会ID

Name

销售机会名称

CustomerId

客户ID

CustomerName

客户名称

CreateDate

创建日期

Status

销售机会状态

StageName

销售机会阶段

EstimatePrice

预计成交金额

EstimateDate

预计成交日期

UserName

负责人

Memo

备注

扩展字段内容

根据已建立的销售机会扩展字段的内容进行展现......

Product

销售机会的报价产品信息

字段名	描述
ProductName	产品名称
ProductTypeName	产品类型
Price	单价
Amount	数量
Discount	折扣
SalesPrice	合计价格
Memo	产品备注

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": {
		"Id": "2178",
		"CustomerName": "福建省厦门市可可食品",
		"Name": "32582-BM4",
		"CreateDate": "2021-10-20",
		"Status": "进行中",
		"StageName": "商务洽谈",
		"EstimatePrice": "150000.00",
		"EstimateDate": "2022-01-31",
		"UserName": "谭朗",
		"Memo": "",
		"Product": [{
			"ProductName": "服务费",
			"ProductTypeName": "增值服务",
			"Price": "6000.00",
			"Amount": "5",
			"Discount": "1.0000",
			"SalesPrice": "30000.00",
			"Memo": "无"
		}, {
			"ProductName": "内存DDL",
			"ProductTypeName": "计算机配件",
			"Price": "30000.00",
			"Amount": "4",
			"Discount": "1.0000",
			"SalesPrice": "120000.00",
			"Memo": "无"
		}]
	}
}

2.11 获取合同列表

为必填字段，非必填字段可不传；获取合同信息时可以指定筛选字段和关键字，也可以指定合同的成交时间区间，如需要查找“上古软件”的合同，则FilterField传递CustomerName，Keyword传递“上古软件”。

字段名

描述

Category

标识需要进行的操作，当前调用为：GetOrder

Key

身份验证秘钥

Data

获取合同所需要传递的信息

字段名	描述
FilterField	进行筛选的字段，多个条件用半角逗号隔开，如 CustomerName,SubmitUserName 查看字段
Keyword	筛选的关键字，多个条件用半角逗号隔开，且数量必须与FilterField保持一致，如可可食品,卢青梅
StartDate	指定合同成交时间区间的开始日期（yyyy-MM-dd）
EndDate	指定合同成交时间区间的结束时间（yyyy-MM-dd）
Fields	需要获取的字段，若不传递则显示默认字段，传递内容示例：Id,CustomerName,Name,SubmitDate,OrderPrice,SubmitUserName,StatusName,Memo
Page	显示第几页，需传递数字
PageSize	每页显示多少条记录，需传递数字

Json示例

{
	"Category": "GetOrder",
	"Key": "",
	"Data": {
		"FilterField": "",
		"Keyword": "",
		"StartDate": "2021-07-01",
		"EndDate": "2021-10-31",
		"Page": 1,
		"PageSize": 10
	}
}

返回内容的Data说明

字段名	描述
Id	合同ID
CustomerId	客户ID
Name	合同名称
CustomerName	客户名称
SubmitDate	成交时间
OrderPrice	合同金额
StatusName	合同状态
SubmitUserName	促成人员名称
Memo	备注

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": [{
		"Id": "14915",
		"CustomerId": "175420",
		"Name": "20211117170029",
		"CustomerName": "福建省厦门市可可食品",
		"OrderPrice": "1008000.00",
		"SubmitDate": "2021-10-21",
		"StatusName": "已交付",
		"SubmitUserName": "谭朗",
		"Memo": ""
	}, {
		"Id": "14907",
		"CustomerId": "175420",
		"Name": "20210823230021",
		"CustomerName": "福建省厦门市可可食品",
		"OrderPrice": "45000.00",
		"SubmitDate": "2021-08-25",
		"StatusName": "合同签订",
		"SubmitUserName": "卢青梅",
		"Memo": ""
	}]
}

2.12 获取合同详情

为必填字段，非必填字段可不传；

字段名

描述

Category

标识需要进行的操作，当前调用为：GetOrderDetail

Key

身份验证秘钥

Data

获取合同详情所需要传递的信息

字段名	描述
Id	传递需要获取合同的ID（与下方的合同名称进行2选1即可）
Name	传递需要获取合同的名称（与上方的合同ID进行2选1即可）

Json示例

{
	"Category": "GetOrderDetail",
	"Key": "",
	"Data": {
		"Id": "14907",
		"Name": ""
	}
}

返回内容的Data说明

字段名

描述

Id

合同ID

Name

合同名称

CustomerId

客户ID

CustomerName

客户名称

StatusName

合同状态

OrderPrice

合同金额

SubmitDate

成交时间

SubmitUserName

促成人员名称

ServiceUserName

服务人员名称

ExpireDate

服务到期日期

Memo

备注

扩展字段内容

根据已建立的合同扩展字段的内容进行展现......

Product

合同产品信息

字段名	描述
ProductName	产品名称
ProductTypeName	产品类型
Price	单价
Amount	数量
Discount	折扣
SalesPrice	合计价格
UnitCost	单位成本
Cost	合计成本
Profit	毛利
Memo	产品备注

返回示例

{
	"IsSuccess": true,
	"Message": "",
	"Data": {
		"Id": "14907",
		"Name": "20210823230021",
		"CustomerId": "175420",
		"CustomerName": "福建省厦门市可可食品",
		"StatusName": "合同签订",
		"OrderPrice": "45000.00",
		"SubmitDate": "2021-08-25",
		"SubmitUserName": "卢青梅",
		"ServiceUserName": "唐逍",
		"ExpireDate": "",
		"Memo": "",
		"Product": [{
			"ProductName": "服务费",
			"ProductTypeName": "增值服务",
			"Price": "5000.00",
			"Amount": "1",
			"Discount": "1.0000",
			"SalesPrice": "5000.00",
			"UnitCost": "0.00",
			"Cost": "0.00",
			"Profit": "0.00",
			"Memo": ""
		}, {
			"ProductName": "内存DDL",
			"ProductTypeName": "增值服务",
			"Price": "40000.00",
			"Amount": "1",
			"Discount": "1.0000",
			"SalesPrice": "40000.00",
			"UnitCost": "36000.00",
			"Cost": "36000.00",
			"Profit": "4000.00",
			"Memo": ""
		}]
	}
}

2.13 保存合同信息

为必填字段，非必填字段可不传；接口调用动作默认为新增合同，当合同信息中的合同名称（Name）字段进行了传递且该名称的合同已存在系统中时，当前调用将更改为更新合同。

字段名

描述

Category

标识需要进行的操作，当前调用为：SaveOrder

Key

身份验证秘钥

Data

需要保存的合同信息

字段名

描述

Customer

合同所属客户的名称，客户必须与系统中已存的客户名称一致，否则不予保存

Name

合同名称

Status

合同状态，该字段内容必须保持与字典表一致，否则该字段无法保存

User

促成人员，人员名称必须与员工表中的名称一致，否则该字段无法保存

ServiceUser

服务人员，人员名称必须与员工表中的名称一致，否则该字段无法保存

SubmitDate

成交时间，请填写日期格式内容，如：2021-09-17

ExpireDate

服务到期日期，请填写日期格式内容，如：2021-09-17

PayType

付款方式

Memo

详细描述

CustomFields

扩展字段

字段名	描述
扩展字段1
扩展字段2

如果为合同建立了扩展字段，则按照建立的扩展字段的名称来进行传递，如建立了“合同类型”、“结算方式”两个字段，则传递内容为"CustomFields": {"合同类型":"框架合同","结算方式":"月结"}

Product

合同产品（允许传递多个产品）

字段名

描述

ProductName

产品名称，该字段内容必须与产品表中的产品名称一致，否则无法保存

Amount

数量，请填写数值

Price

销售单价，请填写数值

Discount

折扣，请填写数值，如八折，则填写0.8

UnitCost

单位成本，请填写数值

CustomFields

扩展字段

字段名	描述
扩展字段1
扩展字段2

如果为合同产品建立了扩展字段，则按照建立的扩展字段的名称来进行传递，如建立了“产品型号”、“产品尺寸”两个字段，则传递内容为"CustomFields": {"产品型号":"A-23013","产品尺寸":"160cm*300cm"}

Json示例

{
	"Category": "SaveOrder",
	"Key": "",
	"Data": {
		"Customer": "合同客户",
		"Status": "合同状态",
		"User": "促成人员",
		"ServiceUser": "服务人员",
		"SubmitDate": "2022-03-08",
		"ExpireDate": "2024-03-08",
		"PayType": "付款方式",
		"Memo": "详细描述",
		"CustomFields": {
			"结算方式": "月付",
			"工程资质": ""
		},
		"Product": [{
			"ProductName": "产品名称1",
			"Amount": "2",
			"Price": "6800.00",
			"Discount": "1.0",
			"UnitCost": "3200",
			"CustomFields": {
				"产品型号": "",
				"产品尺寸": ""
			}
		}, {
			"ProductName": "产品名称2",
			"Amount": "1",
			"Price": "19800.00",
			"Discount": "0.95",
			"UnitCost": "12000",
			"CustomFields": {
				"产品型号": "",
				"产品尺寸": ""
			}
		}]
	}
}

2.14 验证用户身份

为必填字段，非必填字段可不传。

字段名

描述

Category

标识需要进行的操作，当前调用为：VerifyUser

Key

身份验证秘钥

Data

获取日程所需要传递的信息

字段名	描述
Account	用户名称
Password	用户密码

Json示例

{
	"Category":"VerifyUser",
	"Key":"",
	"Data":{
		"Account":"", 
		"Password":""
	}
}

返回内容的Data说明

字段名	描述
Id	人员ID
Name	人员名称
Account	用户账号
Group	所在部门
Title	职位
Tel	电话
Mobile	手机
Email	邮箱
WXUserId	微信用户ID
Token	用户身份加密代码

返回示例

{
	"IsSuccess": true,
	"Message": "验证成功",
	"Data": {
		"Id": "399",
		"Name": "唐逍",
		"Group": "销售部",
		"Title": "销售经理",
		"Tel": "5920131",
		"Mobile": "13799999999",
		"Email": "abc@163.com",
		"WXUserId": "",
		"Token": ""
	}
}

版本号	修改点说明	变更人	变更日期
0.1	文档创建	开发组-Analy	2021-09-16
0.14	补充了日程、产品等接口	开发组-Analy	2022-05-09
0.15	补充了合同获取等接口	开发组-Analy	2022-05-17
0.16	补充了销售机会获取接口、合同详情接口加入了扩展字段	开发组-Analy	2022-06-06

知客CRM 开发者接口文档

版本：0.16

1、对接说明

1.1 编码格式

1.2 接口调用方式

1.3 接口调用地址

1.4 身份验证

1.5 返回信息

2、接口部分

2.1 获取日程安排信息

Json示例

返回内容的Data说明

返回示例

2.2 保存日程安排信息

Json示例

2.3 获取客户列表

Json示例

返回内容的Data说明

返回示例

2.4 保存客户信息

Json示例

2.5 获取联系人列表

Json示例

返回内容的Data说明

返回示例

2.6 保存联系人

Json示例

2.7 获取产品列表

Json示例

返回内容的Data说明

返回示例

2.8 保存产品信息

Json示例

2.9 获取销售机会列表

Json示例

返回内容的Data说明

返回示例

2.10 获取销售机会详情

Json示例

返回内容的Data说明

返回示例

2.11 获取合同列表

Json示例

返回内容的Data说明

返回示例

2.12 获取合同详情

Json示例

返回内容的Data说明

返回示例

2.13 保存合同信息

Json示例

2.14 验证用户身份

Json示例

返回内容的Data说明

返回示例