接口描述:

  • 获取订单列表。

请求 URL:

  • http|https://host/api/v1/order/method/get.order.list/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
is_export integer in:0,1 0 0 是否导出 0=否 1=是
keywords string max:200 PO_I10495… 商品名称或订单号
consignee string max:50 carey 收货人姓名
mobile string length:7,15 15867… 收货人手机号码
payment_code integer egt:0 3 支付方式
is_delete integer in:0,1 0 0 查看回收站订单 0=否 1=是
begin_time datetime beforeTime:end_time 2018-06-01 00:00:00 下单开始时间
end_time datetime afterTime:begin_time 2018-06-30 00:00:00 下单结束时间
status integer between:0,7 0 0 组合状态,详见附属 B
account string max:80 carey 账号或昵称
page_no integer gt:0 1 1 页码
page_size integer between:1,40 15 15 每页数量
order_type string in:asc,desc desc asc 排序方式
order_field string 见附属 A order_id status 排序字段

附属 A:
in:order_id,payment_time,finished_time,create_time,update_time

附属 B:
0:所有状态
1:未付款/待付款
2:已付款
3:待发货/配货中
4:已发货/待收货
5:已完成/已收货
6:已取消
7:待评价

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
items array [] 列表项
total_result integer 2 合计计数
items 类型 是否返回 示例值 描述
order_no string PO_I1049550… 订单号
user_id integer 1 账号编号
source integer 0 订单来源(自定义)
pay_amount number 290 订单金额
goods_amount number 300 商品金额
total_amount number 20 应付金额(含运费)
use_money number 694.89 余额抵扣
use_level number 0 会员等级抵扣
use_integral number 10.01 积分抵扣
use_coupon number 10 优惠劵抵扣
use_discount number 0 商品折扣抵扣
use_promotion number 0 订单促销抵扣
use_card number 780 购物卡抵扣
delivery_fee number 1195 运费
payment_no string ZF_I104955… 支付单号(交易流水号)
payment_code string 3 支付编码
card_number string 997156… 购物卡号
delivery_id integer 1 配送方式
consignee string carey 收货人姓名
complete_address string 浙江省 宁波市 江北区 广济街 完整地址
zipcode string 315000 邮编
tel string 0574-8748… 电话
mobile string 15867… 手机号码
buyer_remark string 发韵达 买家备注
invoice_title string 宁波欧瑞网络科技有限公司 发票抬头
tax_number string xxx0909 纳税人识别号
invoice_amount number 10.99 开票费用
trade_status integer 0 交易状态 0=待处理 1=配货中 2=已发货 3=已完成 4=已取消
delivery_status integer 0 配送状态 0=未发 1=已发 2=部分发
payment_status integer 0 支付状态 0=未付 1=已付
sellers_remark string 客户A备注 卖家备注
adjustment number 19.9 调整价格
integral_pct number 100 记录积分换算比例
give_integral integer 100 赠送积分
give_coupon array [1,2,3] 赠送优惠劵
payment_time datetime 2017-01-04 14:04:25 支付时间
delivery_time datetime 2017-01-04 14:04:25 发货时间
finished_time datetime 2017-01-04 14:04:25 完成时间
create_time datetime 2017-01-04 14:04:25 创建时间
update_time datetime 2017-01-04 14:04:25 更新时间
get_user object [] 账号对象
get_order_goods array [] 订单商品数组
get_user 类型 是否返回 示例值 描述
username string carey 账号
nickname string carey 昵称
head_pic string //host/head_pic.jpg 头像
get_order_goods 类型 是否返回 示例值 描述
order_goods_id integer 1 订单商品编号
goods_name string 一条数据 商品名称
goods_id integer 89 商品编号
goods_image string //image.jpg 商品封面
goods_code string CS27981253 商品货号
goods_sku string SKY001 商品SKU
bar_code string BAR002 商品条码
key_name string 1_3 规格键名
key_value string 规格B 规格值
market_price number 500 市场价
shop_price number 200 本店价
qty integer 2 购买数量
is_comment integer 0 评价状态 0=未评 1=已评 2=追评
is_service integer 0 售后状态 0=可申请 1=售后中 2=已售后 3=不可申
status integer 2 货品状态 0=未发 1=已发 2=收货 3=取消

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "items": [
  6. {
  7. "order_no": "PO_I1049550470892680001",
  8. "user_id": 1,
  9. "source": 0,
  10. "pay_amount": 290,
  11. "goods_amount": 300,
  12. "total_amount": 0.1,
  13. "use_money": 694.89,
  14. "use_level": 0,
  15. "use_integral": 10.01,
  16. "use_coupon": 10,
  17. "use_discount": 0,
  18. "use_promotion": 0,
  19. "use_card": 780,
  20. "delivery_fee": 1195,
  21. "payment_no": "",
  22. "payment_code": "",
  23. "card_number": "9971564621172962",
  24. "delivery_id": 1,
  25. "consignee": "consignee",
  26. "complete_address": "浙江省 宁波市 江北区 address",
  27. "zipcode": "",
  28. "tel": "",
  29. "mobile": "15867430425",
  30. "buyer_remark": "",
  31. "invoice_title": "",
  32. "tax_number": "",
  33. "invoice_amount": 0,
  34. "trade_status": 0,
  35. "delivery_status": 0,
  36. "payment_status": 0,
  37. "sellers_remark": "",
  38. "adjustment": 0,
  39. "integral_pct": 100,
  40. "give_integral": 100,
  41. "give_coupon": [],
  42. "payment_time": "",
  43. "delivery_time": "",
  44. "finished_time": "",
  45. "create_time": "2018-01-04 00:05:04",
  46. "update_time": "2018-01-04 15:17:53",
  47. "get_user": {
  48. "username": "dnyz520",
  49. "nickname": "careya",
  50. "head_pic": "//host/head_pic.jpg"
  51. },
  52. "get_order_goods": [
  53. {
  54. "order_goods_id": 4,
  55. "goods_name": "添加一条数据",
  56. "goods_id": 89,
  57. "goods_image": "",
  58. "goods_code": "CS27981253",
  59. "goods_sku": "",
  60. "bar_code": "",
  61. "key_name": "1_3",
  62. "key_value": "规格B",
  63. "market_price": 500,
  64. "shop_price": 200,
  65. "qty": 1,
  66. "is_comment": 0,
  67. "is_service": 0,
  68. "status": 3
  69. },
  70. {
  71. "order_goods_id": 5,
  72. "goods_name": "添加一条数据",
  73. "goods_id": 89,
  74. "goods_image": "",
  75. "goods_code": "CS27981253",
  76. "goods_sku": "",
  77. "bar_code": "",
  78. "key_name": "1_2",
  79. "key_value": "规格A",
  80. "market_price": 500,
  81. "shop_price": 100,
  82. "qty": 1,
  83. "is_comment": 0,
  84. "is_service": 0,
  85. "status": 3
  86. }
  87. ]
  88. },
  89. {
  90. "order_no": "PO_I1049550470892670001",
  91. "user_id": 1,
  92. "source": 0,
  93. "pay_amount": 290,
  94. "goods_amount": 300,
  95. "total_amount": 20,
  96. "use_money": 694.89,
  97. "use_level": 0,
  98. "use_integral": 10.01,
  99. "use_coupon": 10,
  100. "use_discount": 0,
  101. "use_promotion": 0,
  102. "use_card": 780,
  103. "delivery_fee": 1195,
  104. "payment_no": "ZF_I1049554124677490001",
  105. "payment_code": "3",
  106. "card_number": "9971564621172962",
  107. "delivery_id": 1,
  108. "consignee": "consignee",
  109. "complete_address": "浙江省 宁波市 江北区 address",
  110. "zipcode": "",
  111. "tel": "",
  112. "mobile": "15867430425",
  113. "buyer_remark": "",
  114. "invoice_title": "",
  115. "tax_number": "",
  116. "invoice_amount": 0,
  117. "trade_status": 0,
  118. "delivery_status": 0,
  119. "payment_status": 0,
  120. "sellers_remark": "",
  121. "adjustment": 19.9,
  122. "integral_pct": 100,
  123. "give_integral": 100,
  124. "give_coupon": [],
  125. "payment_time": "",
  126. "delivery_time": "2017-01-04 14:04:25",
  127. "finished_time": "2018-01-04 15:17:53",
  128. "create_time": "2018-01-04 00:05:04",
  129. "update_time": "2018-06-12 09:33:13",
  130. "get_user": {
  131. "username": "dnyz520",
  132. "nickname": "careya",
  133. "head_pic": "//host/head_pic.jpg"
  134. },
  135. "get_order_goods": [
  136. {
  137. "order_goods_id": 1,
  138. "goods_name": "添加一条数据",
  139. "goods_id": 89,
  140. "goods_image": "",
  141. "goods_code": "CS27981253",
  142. "goods_sku": "",
  143. "bar_code": "",
  144. "key_name": "1_3",
  145. "key_value": "规格B",
  146. "market_price": 500,
  147. "shop_price": 200,
  148. "qty": 1,
  149. "is_comment": 0,
  150. "is_service": 0,
  151. "status": 2
  152. },
  153. {
  154. "order_goods_id": 2,
  155. "goods_name": "添加一条数据",
  156. "goods_id": 89,
  157. "goods_image": "",
  158. "goods_code": "CS27981253",
  159. "goods_sku": "",
  160. "bar_code": "",
  161. "key_name": "1_2",
  162. "key_value": "规格A",
  163. "market_price": 500,
  164. "shop_price": 100,
  165. "qty": 1,
  166. "is_comment": 0,
  167. "is_service": 1,
  168. "status": 2
  169. }
  170. ]
  171. }
  172. ],
  173. "total_result": 2
  174. }
  175. }

备注:

  1. 该接口支持条件搜索,如果不带入业务参数则使用默认值。

  2. 参数is_export1时,page_nopage_size将无效。

文档更新时间: 2018-06-21 23:51