基本信息
- 用途说明:查询客户列表
- 请求方式:POST
- 请求地址:https://api.kingdee.com/weigusoft/wg_crm/wg_customerListApi?access_token=
请求参数
headers参数
- 所有的接口必须携带header参数
| 参数名称 | 参数示例 | 是否必填 | 参数说明 |
|---|---|---|---|
| Content-Type | application/json | true | 固定传:application/json |
| groupName | ns-v7g6 | true | 分组名称,获取授权信息时返回的groupName |
| accountId | 16xxxxxxxxxxxx | true | 账套ID,获取授权信息时返回的accountId |
| X-GW-Router-Addr | https://tf.jdy.com | true | IDC域名,获取授权信息时返回的domain |
body参数
| 参数名称 | 必选 | 类型 | 说明 |
|---|---|---|---|
| flag | true | String | 列表标识-LIST |
| entity | true | String | 单据标识-wg_bd_customer_inh |
| pageindex | true | number | 当前页(默认1) |
| pagesize | true | number | 每页显示条数(默认10,最大100) |
| sorttime | true | String | 排序-modifytime desc |
| bdate | true | String | 最近联系开始日期 |
| edate | true | String | 最近联系结束日期 |
| custype | true | String | 客户类型 |
| cusclass | true | String | 客户分类 |
| ywyname | true | String | 业务员 |
| isnew | true | String | |
| istrade | true | Boolean | 是否交易客户 |
| labids | true | Array[String] | 客户标签 |
| search | true | String | 模糊搜索-客户编码/名称/手机/联系人/固定电话/通讯地址/备注 |
| startctimeids | true | String | |
| endctimeids | true | String | |
| custClassTypeIds | true | String | 客户分类id |
| compyModelIds | true | String | 公司规模 |
| compyTypeIds | true | String | 公司类别 |
| custStatess | true | String | |
| cussourceid | true | String | |
| ymyid | true | String | 业务员 |
| cbdate | true | String | 创建开始时间 |
| cedate | true | String | 创建结束时间 |
请求示例
{
"flag": "LIST",//列表
"entity": "wg_bd_customer_inh",//单据标识
"pageindex": 1,
"pagesize": 10,
"sorttime": "modifytime desc",//排序
"bdate": "2025-01-10 14:17:35",//最近联系开始日期
"edate": "2025-02-10 14:17:35",//最近联系结束日期
"custype": "",//客户类型
"cusclass": "",//客户分类
"ywyname": "",//业务员
"isnew": null,
"istrade": null,//是否交易客户
"labids": [],//客户标签
"search": "",//模糊搜索
"startctimeids": "",
"endctimeids": "",
"custClassTypeIds": "",//客户分类id
"compyModelIds": "",//公司规模
"compyTypeIds": "",//公司类别
"custStatess": "",
"cussourceid": "",
"ymyid": "",//业务员
"cbdate": "",//创建开始时间
"cedate": ""//创建结束时间
}
响应示例
{
"data": {
"currentPageSize": 10,
"currentPageIndex": 1,
"totalPages": 1,
"count": 1,
"list": [
{
"id": "2096348838817230850",
"customerNo": "CRMKH-20241202-0003",
"customerName": "1202客户3",
"nextGjTime": "",
"salesManId": "1394084520470297600",
"salesMan": "销售员",
"isTrade": false,
"createTime": "2024-12-02 09:50:31.0",
"billStatus": "1",
"customerType": "标准客户",
"lastContactDate": "2025-02-05 17:27:16.0",
"cusDetailedAddress": "",
"cusPostalAddress": "",
"modifytime": "2025-02-05 17:27:17.0",
"colourLabelId": "1715978699427331072",
"colourLabelName": "重要客户",
"color": {
"id": "10",
"category": "4"
},
"custClassId": "2086928943075687424",
"custClassName": "标准客户"
}
]
},
"errorCode": "success",
"status": true,
"success": true
}