customeraddress/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取客户地址
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/customeraddress/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| caddcode_begin | 否 | string | 起始收货地址编码 |
| caddcode_end | 否 | string | 结束收货地址编码 |
| cdeliveradd | 否 | string | 收货地址 |
| cenglishadd | 否 | string | 英文地址 |
| cenglishadd2 | 否 | string | 英文地址2 |
| cenglishadd3 | 否 | string | 英文地址3 |
| cenglishadd4 | 否 | string | 英文地址4 |
| cdeliverunit | 否 | string | 收货单位 |
| clinkpersoncode | 否 | string | 联系人编码 |
| clinkpersonname | 否 | string | 联系人名称关键字 |
| bdefault | 否 | boolean | 默认地址 |
| caddcode | 否 | string | 收货地址编码 |
| ccuscode | 否 | string | 客户编码 |
| ccusname | 否 | string | 客户名称关键字 |
3.3请求示例
GET https://api.yonyouup.com/api/customeraddress/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&caddcode_begin=xxxxx&caddcode_end=xxxxx&cdeliveradd=xxxxx&cenglishadd=xxxxx&cenglishadd2=xxxxx&cenglishadd3=xxxxx&cenglishadd4=xxxxx&cdeliverunit=xxxxx&clinkpersoncode=xxxxx&clinkpersonname=xxxxx&bdefault=xxxxx&caddcode=xxxxx&ccuscode=xxxxx&ccusname=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| caddcode | string | 收货地址编码 | |
| cdeliveradd | string | 收货地址 | |
| cenglishadd | string | 英文地址 | |
| cenglishadd2 | string | 英文地址2 | |
| cenglishadd3 | string | 英文地址3 | |
| cenglishadd4 | string | 英文地址4 | |
| cdeliverunit | string | 收货单位 | |
| clinkpersoncode | string | 联系人编码 | |
| clinkpersonname | string | 联系人名称 | |
| bdefault | boolean | 默认地址 | |
| ccuscode | string | 客户编码 | |
| ccusname | string | 客户名称 | |
| id | number | 主键 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"20",
"customeraddress":[
{
"id":"5",
"cdeliveradd":"湖北省武汉市武昌区信息路11号",
"cenglishadd4":"",
"ccuscode":"0111",
"cenglishadd2":"",
"clinkpersonname":"",
"cenglishadd":"",
"cenglishadd3":"",
"cdeliverunit":"",
"clinkpersoncode":"",
"ccusname":"云飞电子科技集团",
"caddcode":"0002",
"bdefault":"0"
},
{
"id":"2",
"cdeliveradd":"武昌",
"cenglishadd4":"",
"ccuscode":"0111",
"cenglishadd2":"",
"clinkpersonname":"",
"cenglishadd":"",
"cenglishadd3":"",
"cdeliverunit":"",
"clinkpersoncode":"",
"ccusname":"云飞电子科技集团",
"caddcode":"001",
"bdefault":"1"
}
],
"row_count":"225",
"errmsg":"",
"page_count":"12",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}