customer/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取客户信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/customer/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 | 每页行数 |
| code_begin | 否 | string | 起始编码 |
| code_end | 否 | string | 结束编码 |
| name | 否 | string | 名称关键字 |
| timestamp_begin | 否 | string | 起始时间戳 |
| timestamp_end | 否 | string | 结束时间戳 |
| ModifyDate_begin | 否 | string | 起始修改日期 |
| ModifyDate_end | 否 | string | 结束修改日期 |
| seed_date_begin | 否 | string | 起始发展日期 |
| seed_date_end | 否 | string | 结束发展日期 |
3.3请求示例
GET https://api.yonyouup.com/api/customer/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| code | string | 客户编码 | |
| name | string | 客户名称 | |
| abbrname | string | 客户简称 | |
| sort_code | string | 所属分类码 | |
| domain_code | string | 所属地区码 | |
| industry | string | 所属行业 | |
| address | string | 地址 | |
| bank_open | string | 开户银行 | |
| bank_acc_number | string | 银行账号 | |
| contact | string | 联系人 | |
| phone | string | 电话 | |
| fax | string | 传真 | |
| mobile | string | 手机 | |
| devliver_site | string | 发货地址 | |
| ModifyDate | date | 变更日期 | |
| seed_date | date | 发展日期 | |
| end_date | date | 停用日期 | |
| memo | string | 备注 | |
| ccusexch_name | string | 币种 | |
| bcusdomestic | string | 国内 | |
| bcusoverseas | string | 国外 | |
| bserviceattribute | string | 服务 | |
| ccusmngtypecode | string | 客户管理类型 | |
| ccusmngtypename | string | 客户管理类型名称 | |
| spec_operator_name | string | 专管业务员名称 | |
| timestamp | number | 时间戳 | |
| self_define1 | string | 自定义项1 | |
| self_define2 | string | 自定义项2 | |
| self_define3 | string | 自定义项3 | |
| self_define4 | string | 自定义项4 | |
| self_define5 | string | 自定义项5 | |
| self_define6 | string | 自定义项6 | |
| self_define7 | string | 自定义项7 | |
| self_define8 | string | 自定义项8 | |
| self_define9 | string | 自定义项9 | |
| self_define10 | string | 自定义项10 | |
| self_define11 | string | 自定义项11 | |
| self_define12 | string | 自定义项12 | |
| self_define13 | string | 自定义项13 | |
| self_define14 | string | 自定义项14 | |
| self_define15 | string | 自定义项15 | |
| self_define16 | string | 自定义项16 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"2",
"row_count":"109",
"errmsg":"",
"page_count":"55",
"errcode":"0",
"customer":[
{
"abbrname":"000",
"name":"000",
"code":"000",
"sort_code":"01"
},
{
"abbrname":"世纪天华",
"name":"世纪天华集团公司",
"domain_code":"01",
"code":"00000001",
"industry":"电子类",
"contact":"刘婷",
"sort_code":"03",
"mobile":13811388661
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}