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参数"
     }
}

错误码

错误码 错误描述 解决方案
     

API工具

API测试工具

FAQ