订单查询
请求URL:
https://openapi.weixin12315.com/api/sign/md.shop.order/v1/list
请求方式:
POST
请求示例:
IAuth auth = new Sign("app_id", "app_secret"); IClient client = new SignClient(auth); IDictionary<string, object> parameters = new Dictionary<string, object>(); parameters.Add("orderstatus", 1); parameters.Add("orderscope", 10); parameters.Add("keyword", ""); parameters.Add("startordertime", ""); parameters.Add("endordertime", ""); parameters.Add("startreceivetime", ""); parameters.Add("endreceivetime", ""); parameters.Add("packagestatus", "-1"); parameters.Add("pageindex", "1"); parameters.Add("pagesize", "10"); var result = client.Call("https://openapi.weixin12315.com","md.shop.order.list", "v1", "POST", parameters);
请求参数说明:
参数名 | 必选 | 类型 | 说明 | 参数说明 | |
---|---|---|---|---|---|
orderstatus | 否 | int | 订单状态 | 待付款、待发货、待收货、完成交易、取消交易、退款订单 | |
orderscope | 是 | int | 订单列表范围 | 0:全部类型(或发货管理页面),1:微商城订单,2:拼团订单,3:奖品订单 | |
keyword | 否 | string | 搜索关键词, 订单号 | ||
startordertime | 否 | string | 下单时间(始) | 如:2017-06-19 18:30:30 | |
endordertime | 否 | string | 下单时间(终)精确到秒 | 如:2017-06-19 18:30:30 | |
startreceivetime | 否 | string | 收货时间(始)精确到秒 | 如:2017-06-19 18:30:30 | |
endreceivetime | 否 | string | 收货时间(终)精确到秒 | 如:2017-06-19 18:30:30 | |
packagestatus | 是 | int | 拼团状态 | -1:全部,0:组团中,1:组团成功,2:组团失败 | |
pageindex | 是 | int | 当前页码 | ||
pagesize | 是 | int | 分页大小 | 每页记录数:最大每页查询1000 |
返回示例
{ "return_code": "0", "return_msg": "success", "return_data": { "count": 74, "orders": [ { "orderid": "12613", "ordernumber": "fw2017072913396286", "nickname": "布***鱼", "ordertime": "2017/7/29 13:39:34", "orderstatus": "待付款", "payprice": "112.00", "payway": "", "usepoints": "0", "fees": "0.00", "ischeck": "0", "remark": "", "businessremark": "", "openid": "os9Zrt_b*****************", "passtime": "2017/7/29 13:39:34", "items": [ { "recordID": 11942, "orderID": 12613, "activityID": 0, "productID": 2140, "productName": "海宴mini小酒 \"?/\\~@#$%^&*///******", "number": "QAQ002", "amount": 2, "originalPrice": 56.00, "totalPrice": 112.00, "discount": 1.00, "payPrice": 112.00, "payPoint": 0, "publishedTime": "2017-07-29 13:39:34", "formatID": 0, "picUrl": "http://image.yibishi.com/2017/07/13800138000/f5d7f11e-c41d-4cf6-9ee6-045936a6fcf0.gif", "ggRemark": "", "weight": 0.00, "yhRemark": "", "productType": 0, "lastTimestamp": "AAAAAAGnImo=", "source": 0, "cxActivityID": 0, "type": 0, "purchasePrice": 0.00 } ] } ] } }
返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
return_code | int | 返回状态: 0 成功 不等于0 失败 |
return_msg | string | 返回消息 |
return_data | json | 返回数据,详细见“retrun_data 参数说明” |
retrun_data返回参数说明
参数名 | 类型 | 说明 |
---|---|---|
total | int | 记录总数 |
orders | json[] | 返回数据集,详细见 "orders" 参数说明” |
orders 参数说明
参数名 | 类型 | 说明 |
---|---|---|
orderid | int | 订单id |
ordernumber | string | 订单编号 |
nickname | string | 买家昵称 |
ordertime | string | 下单时间 |
orderstatus | string | 订单状态(待付款、待发货、待收货、完成交易、取消交易、退款订单) |
payprice | decimal | 订单需支付的总价格 |
payway | string | 支付方式 |
usepoints | int | 消耗积分数 |
fees | decimal | 运费 |
remark | string | 备注(买家留言) |
businessremark | string | 商家备注 |
openid | string | 买家Openid |
postcode | string | 邮政编码 |
province | string | 省份名称 |
city | string | 城市名称 |
county | string | 区(县)名称 |
address | string | 详细地址 |
mobile | string | 收货人手机号码 |
consignee | string | 收货人姓名 |
passtime | string | 付款时间 |
items | json[] | 订单明细,详见items参数说明 |
items 参数说明
参数名 | 类型 | 说明 |
---|---|---|
recordID | int | 订单明细id |
orderID | int | 订单ID |
activityID | int | 促销ID |
productID | int | 商品ID |
productName | string | 商品名称 |
number | string | 商品编号 |
amount | int | 数量 |
originalPrice | decimal | 原价 |
totalPrice | decimal | 总价 |
discount | decimal | 折扣 |
payPrice | decimal | 需支付的总价格 |
payPoint | int | 需支付积分 |
publishedTime | string | 记录时间 |
formatID | int | 商品规格ID |
picUrl | string | 商品图片URL |
ggRemark | string | 规格备注 |
weight | decimal | 重量 |
yhRemark | string | 优惠备注 |
productType | int | 商品类型:0:正品;1:积分换购 |
lastTimestamp | string | 时间戳 |
source | int | 礼品来源0:自有礼品1:集市礼品 |
cxActivityID | int | 促销ID |
type | int | 礼品类型0:实物礼品1:虚拟商品(虚拟票券类)2:购物券3:微信红包4:联盟卡券5:直充类 |
purchasePrice | Decimal | 集市礼品的选品价 |