crmaccount/batch_get
目录 |
1.接口说明
1.1接口描述
批量查询CRM客户档案
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
CRM
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/crmaccount/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| person_code | 否 | string | 人员编码，需要先调用 api/user_login 进行用户登录，方可传入此参数。人员编码可以通过 api/person 获取 |
| user_id | 否 | string | 审批人(用户编码)，user_id与pserson_code输入一个参数即可 |
| AccountNumber | 否 | string | 客户编码关键字 |
| Name | 否 | string | 客户名称关键字 |
| CCusAbbName | 否 | string | 客户简称关键字 |
3.3请求示例
GET https://api.yonyouup.com/api/crmaccount/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| AccountNumber | string | entry | 客户编号 |
| AllotDeptTime | date | entry | 分配到部门时间 |
| AllotUserTime | date | entry | 分配到业务员时间 |
| ApprovedExpense | number | entry | 批准费用 |
| BCredit | boolean | entry | 是否控制信用额度 |
| BCreditDate | boolean | entry | 是否控制信用期限 |
| BCusDomestic | boolean | entry | 国内 |
| BCusOverseas | boolean | entry | 国外 |
| BCusState | boolean | entry | 是否成交 |
| BHomeBranch | boolean | entry | 有分支机构 |
| BLimitSale | boolean | entry | 是否控制允限销 |
| BOnGPinStore | boolean | entry | 门店收款 |
| BRequestSign | boolean | entry | 需要回签 |
| BServiceAttribute | boolean | entry | 服务 |
| BShop | boolean | entry | 零售 |
| bTransFlag | boolean | entry | 客户标识 |
| CBranchAddr | string | entry | 分支机构地址 |
| CBranchPerson | string | entry | 分支机构联系人 |
| CBranchPhone | string | entry | 分支机构电话 |
| CCreatePerson | string | entry | 建档人 |
| CCusAbbName | string | entry | 客户简称 |
| CCusAddress | string | entry | 地址 |
| CCusBP | string | entry | 呼机 |
| CCusCreGrade | string | entry | 信用等级 |
| CCusEnAddr1 | string | entry | 英文地址1 |
| CCusEnAddr2 | string | entry | 英文地址2 |
| CCusEnAddr3 | string | entry | 英文地址3 |
| CCusEnAddr4 | string | entry | 英文地址4 |
| CCusEnName | string | entry | 英文名称 |
| CCusLPerson | string | entry | 法人 |
| CCusOAddress | string | entry | 发货地址 |
| CCusPostCode | string | entry | 邮政编码 |
| CCusRegCode | string | entry | 税号 |
| CInvoiceCompany | string | entry | 开票单位 |
| CMemo | string | entry | 备注 |
| CModifyPerson | string | entry | 变更人 |
| Contact | string | entry | 联系人 |
| CostGrade | number | entry | 价格级别 |
| CreatedTime | date | entry | 建档日期 |
| DCusDevDate | date | entry | 发展日期 |
| DEndDate | date | entry | 停用日期 |
| DepartmentID | string | entry | 部门ID |
| dLtcDate | date | entry | 转换时间 |
| string | entry | 电子邮件 | |
| Expense | number | entry | 发生费用 |
| FAdvancePaymentRatio | number | entry | 定金比例 |
| Fax | string | entry | 传真 |
| FCommisionRate | number | entry | 佣金比率 |
| FCusDiscountRate | number | entry | 直营专柜结算扣率 |
| FInsueRate | number | entry | 保险费率 |
| IARMoney | number | entry | 应收余额 |
| ICusCreDate | number | entry | 信用期限 |
| ICusCreLine | number | entry | 信用额度 |
| ICusDisRate | number | entry | 扣率 |
| ID | string | entry | 客户ID |
| ILastMoney | number | entry | 最近发票金额 |
| ILRMoney | number | entry | 最近收款金额 |
| ITaxRate | number | entry | 税率 |
| Location | string | entry | 经纬度 |
| Mobile | string | entry | 手机 |
| ModifiedTime | date | entry | 变更日期 |
| Name | string | entry | 名称 |
| OwnerID | string | entry | 专管业务员ID |
| pCustCode | string | entry | 潜在客户编码 |
| Phone | string | entry | 电话 |
| RcyDeptTime | number | entry | 回收到部门时间 |
| RcyPubTime | number | entry | 回收到公共时间 |
| RecentlyActivityTime | date | entry | 最近行动时间 |
| RecentlyChanceTime | date | entry | 最近机会时间 |
| RecentlyContractTime | date | entry | 最近订单时间 |
| RecentlyCRMContractTime | date | entry | 最近合同时间 |
| RecentlyDeliverTime | date | entry | 最近出库时间 |
| RecentlyDispatchListTime | date | entry | 最近发货时间 |
| RecentlyInvoiceTime | date | entry | 最近发票时间 |
| RecentlyQuoteTime | date | entry | 最近报价时间 |
| RecentlyReceiptTime | date | entry | 最近收款时间 |
| SimpleCode | string | entry | 助记码 |
| SrcID | number | entry | 来源ID |
| SrcType | number | entry | 来源类型 |
| TouchedTime | date | entry | 最近联络时间 |
| TransUser | string | entry | 转换人 |
| TypeID | number | entry | 类型ID |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"crmaccount":[
{
"AccountNumber":"zyd",
"AllotDeptTime":"",
"AllotUserTime":"",
"ApprovedExpense":"",
"BCredit":"",
"BCreditDate":"",
"BCusDomestic":"1",
"BCusOverseas":"",
"BCusState":"1",
"BHomeBranch":"",
"BLimitSale":"",
"BOnGPinStore":"",
"BRequestSign":"",
"BServiceAttribute":"",
"BShop":1,
"CBranchAddr":"",
"CBranchPerson":"",
"CBranchPhone":"",
"CCCCode":"10",
"CCreatePerson":"demo",
"CCusAbbName":"zyd",
"CCusAddress":"",
"CCusBP":"",
"CCusCountryCode":"",
"CCusCreGrade":"",
"CCusCreditCompany":"zyd",
"CCusEnAddr1":"",
"CCusEnAddr2":"",
"CCusEnAddr3":"",
"CCusEnAddr4":"",
"CCusEnName":"",
"CCusExch_name":"人民币",
"CCusLPerson":"",
"CCusOAddress":"",
"CCusOType":"",
"CCusPayCond":"",
"CCusPortCode":"",
"CCusPostCode":"",
"CCusRegCode":"",
"CCusWhCode":"60",
"CCusssCode":"8",
"CInvoiceCompany":"zyd",
"CMemo":"",
"CModifyPerson":"demo",
"CPrimaryVen":"",
"CRelVendor":"",
"Contact":"",
"CostGrade":-1,
"Country":{
"Name":""
},
"CreatedTime":"2015-06-1711:09:43",
"CreditCompany":{
"CCusAbbName":"zyd"
},
"Currency":{
"Name":"人民币"
},
"CusContactCode":"",
"CustomerKCode":"",
"CustomerType":{
"Name":"门店"
},
"DCusDevDate":"2015-06-17",
"DEndDate":"",
"Department":{
"Name":"销售部"
},
"DepartmentID":"0302",
"District":{
"Name":""
},
"DistrictID":"",
"Email":"",
"Expense":"",
"FAdvancePaymentRatio":"",
"FCommisionRate":"",
"FCusDiscountRate":"",
"FInsueRate":"",
"Fax":"",
"IARMoney":"",
"ICostGrade":{
"Name":""
},
"ICusCreDate":0,
"ICusCreLine":"0",
"ICusDisRate":"0",
"ID":"zyd",
"ILRMoney":"",
"ILastMoney":"",
"ITaxRate":"",
"Location":"",
"MasterUser":"",
"Mobile":"",
"ModifiedTime":"2015-01-1909:51:50",
"Name":"zyd",
"Owner":{
"Name":""
},
"OwnerID":"",
"ParentAccount":{
"CCusAbbName":"zyd"
},
"ParentAccountID":"zyd",
"PayCondition":{
"Name":""
},
"Phone":"",
"Port":{
"Name":""
},
"Rank":{
"Name":""
},
"RcyDeptTime":"",
"RcyPubTime":"",
"RecentlyActivityTime":"",
"RecentlyCRMContractTime":"",
"RecentlyChanceTime":"",
"RecentlyContractTime":"2015-01-2500:00:00",
"RecentlyDeliverTime":"",
"RecentlyDispatchListTime":"",
"RecentlyInvoiceTime":"",
"RecentlyQuoteTime":"",
"RecentlyReceiptTime":"",
"RelatedPrivilege":"",
"RelatingUser":"",
"SettleStyle":{
"Name":"银行转账"
},
"Shipper":{
"Name":""
},
"ShippingChoice":{
"Name":""
},
"SimpleCode":"",
"SrcID":"",
"SrcObject":{
"Name":""
},
"TouchedTime":"2015-01-2500:00:00",
"Trade":{
"Name":""
},
"TradeID":"",
"TransUser":"",
"Type":{
"Name":"普通客户"
},
"TypeID":26,
"Vendor":{
"Name":""
},
"Warehouse":{
"Name":"直营门店"
},
"bTransFlag":2,
"dLtcDate":"",
"pCustCode":""
},
{
"AccountNumber":"p00000084",
"AllotDeptTime":"2015-01-2508:02:31",
"AllotUserTime":"2015-01-2508:02:31",
"ApprovedExpense":"",
"BCredit":"",
"BCreditDate":"",
"BCusDomestic":"1",
"BCusOverseas":"",
"BCusState":"",
"BHomeBranch":"",
"BLimitSale":"",
"BOnGPinStore":"",
"BRequestSign":"",
"BServiceAttribute":"",
"BShop":0,
"CBranchAddr":"",
"CBranchPerson":"",
"CBranchPhone":"",
"CCCCode":"03",
"CCreatePerson":"demo9",
"CCusAbbName":"南京美年达",
"CCusAddress":"",
"CCusBP":"",
"CCusCountryCode":"",
"CCusCreGrade":"",
"CCusCreditCompany":"p00000083",
"CCusEnAddr1":"",
"CCusEnAddr2":"",
"CCusEnAddr3":"",
"CCusEnAddr4":"",
"CCusEnName":"",
"CCusExch_name":"人民币",
"CCusLPerson":"",
"CCusOAddress":"",
"CCusOType":"",
"CCusPayCond":"",
"CCusPortCode":"",
"CCusPostCode":"",
"CCusRegCode":"",
"CCusWhCode":"",
"CCusssCode":"",
"CInvoiceCompany":"p00000084",
"CMemo":"",
"CModifyPerson":"demo9",
"CPrimaryVen":"",
"CRelVendor":"",
"Contact":"",
"CostGrade":0,
"Country":{
"Name":""
},
"CreatedTime":"2015-01-2508:02:31",
"CreditCompany":{
"CCusAbbName":"北京山水文化"
},
"Currency":{
"Name":"人民币"
},
"CusContactCode":"",
"CustomerKCode":"",
"CustomerType":{
"Name":"直销客户"
},
"DCusDevDate":"2015-01-06",
"DEndDate":"",
"Department":{
"Name":"销售部"
},
"DepartmentID":"0302",
"District":{
"Name":""
},
"DistrictID":"",
"Email":"",
"Expense":"",
"FAdvancePaymentRatio":"",
"FCommisionRate":"",
"FCusDiscountRate":"",
"FInsueRate":"",
"Fax":"",
"IARMoney":"0",
"ICostGrade":{
"Name":""
},
"ICusCreDate":0,
"ICusCreLine":"0",
"ICusDisRate":"0",
"ID":"p00000084",
"ILRMoney":"0",
"ILastMoney":"0",
"ITaxRate":"",
"Location":"",
"MasterUser":"",
"Mobile":"",
"ModifiedTime":"2015-01-2508:02:31",
"Name":"南京美年达技术有限公司",
"Owner":{
"Name":"师小容"
},
"OwnerID":"00023",
"ParentAccount":{
"CCusAbbName":"北京山水文化"
},
"ParentAccountID":"p00000083",
"PayCondition":{
"Name":""
},
"Phone":"",
"Port":{
"Name":""
},
"Rank":{
"Name":""
},
"RcyDeptTime":"",
"RcyPubTime":"",
"RecentlyActivityTime":"",
"RecentlyCRMContractTime":"",
"RecentlyChanceTime":"",
"RecentlyContractTime":"",
"RecentlyDeliverTime":"",
"RecentlyDispatchListTime":"",
"RecentlyInvoiceTime":"",
"RecentlyQuoteTime":"",
"RecentlyReceiptTime":"",
"RelatedPrivilege":"",
"RelatingUser":"",
"SettleStyle":{
"Name":""
},
"Shipper":{
"Name":""
},
"ShippingChoice":{
"Name":""
},
"SimpleCode":"",
"SrcID":"",
"SrcObject":{
"Name":""
},
"TouchedTime":"",
"Trade":{
"Name":""
},
"TradeID":"",
"TransUser":"",
"Type":{
"Name":"普通客户"
},
"TypeID":26,
"Vendor":{
"Name":""
},
"Warehouse":{
"Name":""
},
"bTransFlag":1,
"dLtcDate":"",
"pCustCode":"p00000084"
}
],
"errcode":"0",
"errmsg":"",
"page_count":7,
"page_index":"1",
"row_count":123,
"rows_per_page":20
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}