eb_tradelist/batch_get
目录 |
1.接口说明
1.1接口描述
获取电商订单列表
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
电商集成
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/eb_tradelist/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| cshopcode | 否 | string | 店铺编码 |
| tid_begin | 否 | string | 起始交易编号 |
| tid_end | 否 | string | 结束交易编号 |
| title | 否 | string | 交易标题 |
| buyer_nick | 否 | string | 买家会员号 |
| receiver_name | 否 | string | 收货人的姓名关键字 |
| receiver_state | 否 | string | 收货人的所在省份 |
| receiver_city | 否 | string | 收货人的所在城市 |
| receiver_district | 否 | string | 收货人的所在地区 |
| receiver_address | 否 | string | 收货人的详细地址 |
| receiver_mobile | 否 | string | 收货人的手机号码 |
| isinvoice | 否 | boolean | 是否开票 |
| receiver_phone | 否 | string | 收货人的电话号码 |
| buyer_email | 否 | string | 买家邮件地址 |
| seller_memo | 否 | string | 卖家备注 |
| created_begin | 否 | date | 起始交易时间 |
| created_end | 否 | date | 结束交易时间 |
| pay_time_begin | 否 | date | 起始付款时间 |
| pay_time_end | 否 | date | 结束付款时间 |
| buyer_message | 否 | string | 买家留言 |
| trade_memo | 否 | string | 交易备注 |
| cexpresscode | 否 | string | 快递单号 |
| cdepcode | 否 | string | 部门编码 |
| cdepname | 否 | string | 部门 |
| cpersonname | 否 | string | 业务员关键字 |
| ispickself | 否 | number | 是否自提 |
| sysstatus | 否 | string | 单据状态 |
| ishold | 否 | boolean | 是否挂起 |
| isclosed | 否 | boolean | 是否关闭 |
3.3请求示例
GET https://api.yonyouup.com/api/eb_tradelist/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&cshopcode=xxxxx&tid_begin=xxxxx&tid_end=xxxxx&title=xxxxx&buyer_nick=xxxxx&receiver_name=xxxxx&receiver_state=xxxxx&receiver_city=xxxxx&receiver_district=xxxxx&receiver_address=xxxxx&receiver_mobile=xxxxx&isinvoice=xxxxx&receiver_phone=xxxxx&buyer_email=xxxxx&seller_memo=xxxxx&created_begin=xxxxx&created_end=xxxxx&pay_time_begin=xxxxx&pay_time_end=xxxxx&buyer_message=xxxxx&trade_memo=xxxxx&cexpresscode=xxxxx&cdepcode=xxxxx&cdepname=xxxxx&cpersonname=xxxxx&ispickself=xxxxx&sysstatus=xxxxx&ishold=xxxxx&isclosed=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| cshopcode | string | 店铺编码 | |
| tid | string | 交易编号 | |
| title | string | 交易标题 | |
| buyer_nick | string | 买家会员号 | |
| receiver_name | string | 收货人的姓名 | |
| receiver_state | string | 收货人的所在省份 | |
| receiver_city | string | 收货人的所在城市 | |
| receiver_district | string | 收货人的所在地区 | |
| receiver_address | string | 收货人的详细地址 | |
| receiver_zip | string | 收货的人邮编 | |
| receiver_mobile | string | 收货人的手机号码 | |
| isinvoice | boolean | 是否开票 | |
| receiver_phone | string | 收货人的电话号码 | |
| buyer_email | string | 买家邮件地址 | |
| seller_memo | string | 卖家备注 | |
| created | date | 交易时间 | |
| pay_time | date | 付款时间 | |
| promotion | string | 交易促销信息 | |
| buyer_message | string | 买家留言 | |
| trade_memo | string | 交易备注 | |
| invoice_name | string | 发票抬头 | |
| cinvoicecode | string | 发票号 | |
| cexpresscocode | string | 快递公司编码 | |
| cexpressconame | string | 快递公司名称 | |
| cexpresscode | string | 快递单号 | |
| cdepcode | string | 部门编码 | |
| cdepname | string | 部门 | |
| cpersonname | string | 业务员 | |
| cstname | string | 销售类型 | |
| cssname | string | 结算方式 | |
| cshipmode | string | 发货模式 | |
| cdefine1 | string | 表头自定义项1 | |
| cdefine2 | string | 表头自定义项2 | |
| cdefine3 | string | 表头自定义项3 | |
| cdefine4 | date | 表头自定义项4 | |
| cdefine5 | number | 表头自定义项5 | |
| cdefine6 | date | 表头自定义项6 | |
| cdefine7 | number | 表头自定义项7 | |
| cdefine8 | string | 表头自定义项8 | |
| cdefine9 | string | 表头自定义项9 | |
| cdefine10 | string | 表头自定义项10 | |
| cdefine11 | string | 表头自定义项11 | |
| cdefine12 | string | 表头自定义项12 | |
| cdefine13 | string | 表头自定义项13 | |
| cdefine14 | string | 表头自定义项14 | |
| cdefine15 | number | 表头自定义项15 | |
| cdefine16 | number | 表头自定义项16 | |
| id | string | 店铺编码_商品编码 | |
| ispickself | number | 是否自提 | |
| sysstatus | string | 单据状态 | |
| ishold | boolean | 是否挂起 | |
| isclosed | boolean | 是否关闭 | |
| total_fee | number | 商品金额 | |
| discount_fee | number | 系统优惠金额 | |
| end_time | date | 交易结束时间 | |
| cshipcode | string | 发货单编号 | |
| dshiptime | date | 发货时间 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"eb_tradelist":[
{
"cexpressconame":"",
"isinvoice":"1",
"seller_memo":"",
"receiver_address":"北清路68号用友软件园",
"ishold":"0",
"receiver_phone":"",
"trade_memo":"",
"created":"2014-12-0400:00:00.0",
"total_fee":"799.00",
"tid":"784470431496937",
"cinvoicecode":"",
"discount_fee":"405.00",
"cdepname":"电子商务",
"receiver_city":"杭州市",
"dshiptime":"",
"pay_time":"2014-12-0500:00:00.0",
"receiver_mobile":"*35057*6665",
"cssname":"银行转账",
"receiver_name":"陈洁",
"buyer_nick":"加菲猫m",
"cshipcode":"",
"cstname":"电子商务",
"end_time":"",
"cdefine12":"",
"cdefine11":"",
"cdefine10":"",
"isclosed":"0",
"cdepcode":"0304",
"receiver_zip":"310011",
"promotion":"",
"buyer_message":"",
"cpersonname":"何彤",
"cdefine14":"",
"cdefine13":"",
"cdefine16":"",
"cdefine15":"",
"id":"01_784470431496937",
"buyer_email":"13505716665@139.com",
"title":"淘宝",
"cexpresscocode":"",
"receiver_state":"浙江省",
"sysstatus":"UnConfirm",
"cdefine9":"",
"invoice_name":"陈洁",
"cdefine8":"",
"cdefine7":"",
"cdefine6":"",
"cdefine5":"",
"cdefine4":"",
"cdefine3":"",
"cdefine2":"",
"cdefine1":"",
"ispickself":"0",
"receiver_district":"拱墅区",
"cexpresscode":"",
"cshipmode":"EnterpriseDeliver",
"cshopcode":"01"
},
{
"cexpressconame":"",
"isinvoice":"0",
"seller_memo":"",
"receiver_address":"北清路68号用友软件园",
"ishold":"0",
"receiver_phone":"",
"trade_memo":"",
"created":"2014-12-0400:00:00.0",
"total_fee":"799.00",
"tid":"784305475703094",
"cinvoicecode":"",
"discount_fee":"405.00",
"cdepname":"电子商务",
"receiver_city":"鸡西市",
"dshiptime":"",
"pay_time":"2014-12-0500:00:00.0",
"receiver_mobile":"*88*57*3777",
"cssname":"银行转账",
"receiver_name":"刘勇峰",
"buyer_nick":"touareg88",
"cshipcode":"",
"cstname":"电子商务",
"end_time":"",
"cdefine12":"",
"cdefine11":"",
"cdefine10":"",
"isclosed":"0",
"cdepcode":"0304",
"receiver_zip":"158100",
"promotion":"",
"buyer_message":"",
"cpersonname":"何彤",
"cdefine14":"",
"cdefine13":"",
"cdefine16":"",
"cdefine15":"",
"id":"01_784305475703094",
"buyer_email":"turuiv8@163.com",
"title":"淘宝",
"cexpresscocode":"",
"receiver_state":"黑龙江省",
"sysstatus":"UnConfirm",
"cdefine9":"",
"invoice_name":"",
"cdefine8":"",
"cdefine7":"",
"cdefine6":"",
"cdefine5":"",
"cdefine4":"",
"cdefine3":"",
"cdefine2":"",
"cdefine1":"",
"ispickself":"0",
"receiver_district":"鸡冠区",
"cexpresscode":"",
"cshipmode":"EnterpriseDeliver",
"cshopcode":"01"
}
],
"page_index":"1",
"rows_per_page":"20",
"row_count":"225",
"errmsg":"",
"page_count":"12",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}