Hishop.Open.Api.ITrade.GetSoldTrades
获取当前商家的订单列表(根据创建时间)
1. 返回的数据结果是以订单的创建时间倒序排列的。
2. 返回的数据结果只包含了订单的部分数据,可通过Hishop.Open.Api.ITrade.GetTrade获取订单详情。
注意:status字段的说明,如果该字段不传,接口默认只查4种类型订单,非默认查询的订单是不返回。遇到订单查不到的情况的,通常都是这个原因造成。解决办法就是status加上订单类型就可正常返回了。
系统级别输入参数
名称 |
类型 |
是否必须 |
描述 |
app_key |
String |
是 |
HOP分配给应用的AppKey |
timestamp |
String |
是 |
时间戳,格式为yyyy-MM-dd HH:mm:ss,时区为GMT+8,例如:2015-01-01 12:00:00。HiShop API服务端允许客户端请求最大时间误差为10分钟。 |
sign |
String |
是 |
API输入参数签名结果,签名算法介绍请点击这里。 |
应用级输入参数
名称 |
类型 |
是否必须 |
描述 |
start_created |
Date |
可选 |
获取时间区间内订单的开始时间。格式:yyyy-MM-dd HH:mm:ss |
end_created |
Date |
可选 |
获取时间区间内订单的结束时间。格式:yyyy-MM-dd HH:mm:ss |
status |
String |
可选 |
交易状态(查看可选值):WAIT_BUYER_PAY(等待买家付款)、
WAIT_SELLER_SEND_GOODS (等待商家发货)、 WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货)、
TRADE_CLOSED (交易关闭)、TRADE_FINISHED(交易成功) 默认查询所有交易状态的数据,
除了默认值外每次只能查询一种状态 |
buyer_uname |
String |
可选 |
买家帐号 |
page_no |
Number |
可选 |
页码。取值范围:大于零的整数; 默认值:1 |
page_size |
Number |
可选 |
每页条数。取值范围:大于零的整数; 默认值:40;最大值:100 |
返回结果
{
"trades_sold_get_response":{
"total_results": 100,
"has_next": true,
"trades":[{
"tid":"201001010001",
"buyer_memo":"上衣要大一号",
"seller_memo":"好的",
"seller_flag":"1",
"discount_fee":"200.07",
"status":"WAIT_BUYER_PAY",
"close_memo":"到期自动关闭",
"created":"2000-01-01 00:00:00",
"modified":"2000-01-01 00:00:00",
"pay_time":"2000-01-01 00:00:00",
"consign_time":"2000-01-01 00:00:00",
"end_time":"2000-01-01 00:00:00",
"buyer_uname":"testuser",
"buyer_email":"test1064@test.com",
"buyer_nick":"我在测试",
"buyer_area":"浙江省杭州市",
"receiver_name":"东方不败",
"receiver_state":"湖北省",
"receiver_city":"宜昌市",
"receiver_district":"伍家岗区",
"receiver_town":"大公桥街道",
"receiver_address":"五一大道湘域中央805",
"receiver_zip":"223700",
"receiver_mobile":"13512501826",
"seller_id":"210030",
"seller_name":"自营店",
"seller_mobile":"13512501826",
"invoice_fee":"0",
"invoice_title":"XXXX有限公司",
"payment":"300.45",
"storeId":"0",
"orders":[{
"sku_id":"5937146",
"num_id":"98",
"outer_sku_id":"50786-4",
"title":"山寨版测试机器",
"sku_properties_name":"颜色:桔色;尺码:M",
"price":"200.07",
"num":1,
"pic_path":"http://img08.test.net/bao/uploaded/i8/091917.jpg",
"refund_status":"WAIT_BUYER_PAY"
}
]
}
]
}
}
异常示例
{
"error_response"
:{
"code"
:"10",
"msg"
:
"Invalid App Key:app_key"
,
"sub_msg"
:
"非法的AppKey参数"
}
}
FAQ