基本信息
- 用途说明：crm客户查询接口（单据标识：wg_bd_customer_inh）
- 请求方式：POST
- 请求地址：https://api.kingdee.com/weigusoft/wg_cost/loadList?access_token=&authority_info=
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 |
| Appuserid | 10102023 | true | 当前登录用户id |
params参数
| 参数名称 | 参数类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| access_token | string | true | 金蝶云通行证token |
| authority_info | string | true | 见文档authority_info参数说明 |
body参数
| 参数名称 | 必选 | 类型 | 说明 |
|---|---|---|---|
| entityName | true | String | 单据标识：wg_bd_customer_inh |
| pageindex | true | Number | 当前页（默认1） |
| pagesize | true | Number | 每页显示条数 |
| andQfilters | false | Array |
"andQfilters": [ ], //与条件 |
| selectProperties | true | String |
查询字段，"name,number,name,createtime,modifytime"，需要查哪个字段就在后面拼接 |
| onlyBasic | false | Boolean |
是否只获取基本信息，名称和编码 |
| onlyCount | false | Boolean |
是否只获取数量 |
| haveMatPic | false | Boolean |
是否返回物料图片 |
| srcType | false | String |
上一个页面单据类型 |
| srcId | false | String |
上一个页面单据id |
| exclude | false | Boolean |
是否有排除的 |
| level | false | String |
基础资料查到哪一层，例："1" |
| orderBy | false | String |
排序方式，modifytime desc |
返回参数
| 字段名称 | 类型 | 说明 |
|---|---|---|
| id | String | 客户id |
| number | String | 客户编码 |
| name | String | 客户名称 |
| group | String | 客户分类 |
| mullabel | String | 客户标签 |
| wg_source | String | 客户来源 |
| wg_customer_newtype | String | 客户类型 |
| wg_parent_customer | String | 上级客户 |
| wg_company_size | String | 公司规模 |
| wg_company_type | String | 公司类别 |
| wg_company_nature | String | 公司性质 |
| isspeedprice | Boolean | 快速取价 |
| supplierid | String | 关联供应商 |
| wg_contact_number | String | 固定电话 |
| admindivisionfield | String | 行政化区 |
| addr | String | 详细地址 |
| masterrelater | String | 主联系人 |
| wg_contact_numberrelate | String | 主联系人手机 |
| saledeptid | String | 销售部门 |
| salerid | String | 销售员 |
| wg_service_expiration | String | 服务到期日期 |
| wg_labelcolor | String | 标签颜色 |
| defcurrencyid | String | 默认币别 |
| ifnew | Boolean | 是否新客户 |
| wg_is_trade | Boolean | 是否交易客户 |
| wg_is_ghkh | Boolean | 是否公海客户 |
| remark | String | 备注 |
| bomentity | Array | 联系人 |
bomentity参数
| 字段名称 | 类型 | 说明 |
|---|---|---|
| contactperson | String | 联系人名称 |
| mobile | String | 手机 |
| phone | String | 座机 |
| gender | String | 性别，男：1，女：2 |
| birthday | String | 生日 |
| String | ||
| String | 微信 | |
| String | ||
| contact_admindivision | String | 行政区划（国家/省/市/区） |
| contact_countryid | String | 国家/地区 |
| contact_provinceid | String | 省 |
| contact_cityid | String | 市 |
| contact_districtid | String | 区 |
| contact_address | String | 详细地址 |
| contactlng | String | 地址经度 |
| contactlat | String | 地址纬度 |
| isdefault_linkman | Boolean | 是否是首要联系人 |
| externaluserid | String | 外部联系人id |
| job | String | 职务 |
| department | String | 部门 |
| wg_contact_salerid | String | 销售员 |
| wg_contact_status | String | 单据状态，A:暂存，B:已提交，C:已审核 |
| wg_contact_enable | String | 使用状态，0：禁用，1：可用 |
请求示例
{
"pageindex": 1,
"pagesize": 10,
"entityName": "wg_bd_customer_inh",
"selectProperties": "wg_source.name,number,name,createtime,modifytime,recentrelatedates,salerid,addr,next_tracetime,wg_not_trace_days,wg_is_trade,bomentity.contactperson,wg_contact_numberrelate,wg_contact_number,remark,bomentity.mobile,mullabel,wg_next_trace_time,group,districtid.id,admindivisionfield,saledeptid,salerid,enable,isdefault_linkman",
"orderBy": "modifytime desc",
"onlyBasic": false,
"level": "2",
"andQfilters": [
{
"property": "enable",
"cp": "=",
"value": "1"
}
],
"orQfilters": []
}
crul:
curl ^"https://api.kingdee.com/weigusoft/wg_cost/loadList?access_token=1751589696b6fadec8ca66f4bff7eece^&authority_info=80YVhAfnQaOYK7vgQL1NZOCzmT9slfIZW8j01JnRwGPlJhpCXkVtaJW70RN/XQPn^" ^
-H ^"Accept: */*^" ^
-H ^"Accept-Language: zh-CN,zh;q=0.9^" ^
-H ^"Appuserid: 10102023^" ^
-H ^"Connection: keep-alive^" ^
-H ^"Content-Type: application/json;charset=UTF-8^" ^
-H ^"Origin: http://localhost:5173^" ^
-H ^"Referer: http://localhost:5173/^" ^
-H ^"Sec-Fetch-Dest: empty^" ^
-H ^"Sec-Fetch-Mode: cors^" ^
-H ^"Sec-Fetch-Site: cross-site^" ^
-H ^"User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_2_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.0.3 Mobile/15E148 Safari/604.1^" ^
-H ^"X-GW-Router-Addr: https://tf.jdy.com^" ^
-H ^"access_token: 1751589696b6fadec8ca66f4bff7eece^" ^
-H ^"accountId: 1683187060740048426^" ^
-H ^"groupName: ns-f51c^" ^
--data-raw ^"^{^\^"pageindex^\^":1,^\^"pagesize^\^":10,^\^"entityName^\^":^\^"wg_bd_customer_inh^\^",^\^"selectProperties^\^":^\^"wg_source.name,number,name,createtime,modifytime,recentrelatedates,salerid,addr,next_tracetime,wg_not_trace_days,wg_is_trade,bomentity.contactperson,wg_contact_numberrelate,wg_contact_number,remark,bomentity.mobile,mullabel,wg_next_trace_time,group,districtid.id,admindivisionfield,saledeptid,salerid,enable,isdefault_linkman^\^",^\^"orderBy^\^":^\^"modifytime desc^\^",^\^"onlyBasic^\^":false,^\^"level^\^":^\^"2^\^",^\^"andQfilters^\^":^[^{^\^"property^\^":^\^"enable^\^",^\^"cp^\^":^\^"=^\^",^\^"value^\^":^\^"1^\^"^}^],^\^"orQfilters^\^":^[^]^}^"
响应示例
{
"data": {
"currentPageSize": 10,
"currentPageIndex": 1,
"totalPages": 1,
"count": 1,
"list": [
{
"salerid_modifytime": "2025-07-17 10:04:09",
"salerid_status": "1",
"salerid_userid_id": "10102023",
"salerid_worktype": "1",
"salerid_userid_number": "njwgceshi",
"wg_source_id": "1999989260765133824",
"number": "CRMKH-20250716-0001",
"salerid_departmenid_masterid": "1697221606960547840",
"salerid_sataxtype": "1",
"enable": "1",
"next_tracetime": "",
"salerid_pinyin": "dsm",
"id": "2260394589594703875",
"salerid_departmenid_longnumber": "100000!BM00002",
"saledeptid_longnumber": "100000!BM00002",
"salerid_isimport": false,
"salerid_birthday": "",
"salerid_gender": "0",
"salerid_bankaccount": "",
"wg_is_trade": false,
"wg_next_trace_time": "",
"recentrelatedates": "",
"group_name": "20250514客户分类",
"salerid_bankname": "",
"wg_not_trace_days": "0",
"wg_source_number": "FZZL00058",
"salerid_id": "1697009251337127936",
"salerid_createtime": "2023-05-31 10:14:03",
"salerid_modifier_number": "njwgceshi",
"wg_contact_number": "",
"salerid_userid_truename": "董素敏",
"salerid_leavedate": "",
"mullabel": [],
"group_number": "KHFL00018",
"salerid_number": "ZY00005",
"name": "0716测试客户",
"salerid_creator_name": "鞠志广",
"salerid_disabledate": "",
"salerid_email": "2673922372@qq.com",
"salerid_hiredate": "",
"salerid_creator_masterid": "0",
"modifytime": "2025-07-17 08:09:53",
"wg_contact_numberrelate": "",
"saledeptid_masterid": "1697221606960547840",
"salerid_departmenid_id": "1697221606960547840",
"remark": "",
"salerid_idtype": "1",
"salerid_enable": "1",
"group_fullname": "重点客户.20250514客户分类",
"salerid_idnumber": "",
"bomentity": [],
"salerid_creator_number": "13151424140",
"addr": "",
"salerid_isdeptleader": "0",
"salerid_modifier_id": "10102023",
"createtime": "2025-07-16 18:00:33",
"saledeptid_name": "车间1",
"saledeptid_id": "1697221606960547840",
"group_longnumber": "KHFL00001.KHFL00018",
"salerid_thirdid": "",
"saledeptid_number": "BM00002",
"wg_source_name": "1688",
"salerid_mobile": "18851751157",
"salerid_wechat": "",
"salerid_name": "董素敏",
"salerid_departmenid_number": "BM00002",
"admindivisionfield": null,
"group_id": "2214463080283310080",
"salerid_modifier_masterid": "0",
"salerid_fullpinyin": "dongsumin",
"salerid_creator_id": "5612653",
"salerid_departmenid_name": "车间1",
"salerid_modifier_name": "董素敏"
}
],
"qtycount": 0,
"allamount": 0
},
"errorCode": "success",
"status": true,
"success": true
}