Hishop.Open.Api.ITrade.GetIncrementSoldTrades
查询订单的增量交易数据（根据修改时间）
1. 一次请求只能查询时间跨度为一天的增量交易记录，即end_modified - start_modified小于等于1天。
2. 返回的数据结果是以订单的修改时间倒序排列的，通过从后往前翻页的方式可以避免漏单问题。
注意: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_modified |
Date |
必须 |
查询修改开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss |
| end_modified |
Date |
必须 |
查询修改结束时间，必须大于修改开始时间(修改时间跨度不能大于一天)，格式:yyyy-MM-dd HH:mm:ss。建议使用30分钟以内的时间跨度，能大大提高响应速度和成功率 |
| 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（建议使用40~50，可以提高成功率，减少超时数量） |
返回结果
{
"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
