获取订单确认或提交订单

接口描述:

  • 获取订单确认或提交订单。

请求 URL:

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

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
source integer between:0,9 0 订单来源(自定义)
type string in:buynow,cart cart 立即购买或购物车结算
is_submit integer in:0,1 0 1 是否提交订单
delivery_id integer gt:0 1 配送方式编号
consignee string max:50 张三 收货人姓名
country integer egt:0 0 0 收货国家
region_list array min[]:0 [1,2,3] 收货省市区编号
address string max:255 详细地址 收货详细地址
zipcode string max:20 315000 收货邮编
tel string max:20 87487585 收货人电话
mobile string length:7,15 15867430123 收货人手机号码
buyer_remark string max:255 发顺丰 给卖家留言
invoice_type integer in:0,1,2 0 2 开票方式 0=不需要 1=个人 2=企业
invoice_title string max:255 宁波欧瑞… 发票抬头
tax_number string max:20 xxx123456 纳税人识别号
coupon_give_id integer gt:0 1 优惠劵发放编号
coupon_exchange_code string max:10 8TxQqQ2T 优惠劵兑换码
use_money number egt:0 0 99.5 余额支付
use_integral integer egt:0 0 1000 积分支付
use_card number egt:0 0 66.6 购物卡支付
card_number string length:16 951467773 购物卡卡号

响应参数:

备注:

  1. 参数type值为buynow时表示单个商品进行立即购买操作,否则表示购买购物车中选中的商品。

  2. 参数is_submit值为0表示确认订单,买家每进行一次调整都需要重新获取返回数据,此时不会创建订单。而值为1时表示正式创建订单。

  3. invoice_type值为2时,参数invoice_titletax_number必须。值为1时,默认抬头为个人,买家无法自定义填写抬头,如需修改需要管理组成员在后台对订单进行编辑操作。

  4. 需要使用优惠劵时参数coupon_give_idcoupon_exchange_code其中一个必须填写。

  5. 使用购物卡余额抵扣支付金额时参数use_cardcard_number必须

  6. 提交订单之后需要完成的操作是「订单付款在线支付」

确认订单时

接口描述:

  • 确认订单时将返回各项数据并且进行各种验证。

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
goods_list array [] 订单商品数组
coupon_give_list array [] 优惠劵数组
card_use_list array [] 购物卡数组
integral object [] 积分对象
order_price object [] 订单金额对象
goods_list 类型 是否返回 示例值 描述
cart_id integer 43 购物车编号
goods_id integer 13 商品编号
goods_num integer 1 购买数量
key_name string 1_3 商品规格键名
key_value string 颜色:黑色 CPU:I5 商品规格值
goods object [] 商品对象
error integer 0 商品是否规范 0=有效 1=无效
error_msg string 商品已失效 商品不规范的原因
goods 类型 是否返回 示例值 描述
goods_id integer 5 商品编号
name string MateBook 商品名称
goods_code string CS91785250 商品货号
goods_sku string 654321 商品SKU
bar_code string 123456 商品条码
store_qty integer 200 商品库存
measure number 3 商品计量(重量、体积)
measure_type integer 0 计量方式 0=重量 1=计件 2=体积
is_postage integer 1 是否包邮 0=收费 1=包邮
market_price number 7000 商品市场价
shop_price number 5400 商品本店价
purchase_sum integer 2 限购数量
integral_type integer 0 赠送积分结算方式
give_integral number 540 商品赠送积分
is_integral integer 1000 积分可抵扣额
goods_image string //image.jpg 商品封面
coupon_give_list 类型 是否返回 示例值 描述
coupon_give_id integer 106 优惠劵发放编号
coupon_id integer 5 优惠劵编号
user_id integer 0 账号编号 0=未领取
order_id integer 0 订单编号 0=未使用
exchange_code string bq4ZQQr7Ar 优惠劵兑换码
use_time datetime 2018-05-24 16:00:00 使用时间
create_time datetime 2018-05-24 15:07:19 创建时间
get_coupon object [] 优惠劵对象
is_use integer 0 是否可使用 0=否 1=是
not_use_error string 订单金额不足200 不可用原因
get_coupon 类型 是否返回 示例值 描述
coupon_id integer 11 优惠劵编号
name string 六一快乐 优惠劵名称
description string 活动描述 优惠劵描述
guide string //careyshop.cn 优惠劵引导地址
type integer 2 优惠劵类型
give_code string DjEU0GtU9t 优惠劵领取码
money number 100 优惠金额
quota number 1000 限制使用金额(0则不限)
category array ["1","2","3"] 限制商品类目
exclude_category array ["5","6","7"] 排除商品类目
level array [] 限制会员等级
frequency integer 1 限制领取次数(0则不限)
give_num integer 2000 发放数量
receive_num integer 0 累计领取数量
use_num integer 0 累计使用数量
give_begin_time datetime 2018-05-22 10:11:00 发放开始时间
give_end_time datetime 2018-06-05 00:00:00 发放结束时间
use_begin_time datetime 2018-06-01 00:00:00 使用开始时间
use_end_time datetime 2018-06-02 00:00:00 使用结束时间
status integer 1 优惠劵状态 0=禁用 1=启用
is_invalid integer 0 优惠劵是否作废 0=正常 1=作废
card_use_list 类型 是否返回 示例值 描述
number string 9514677739431425 卡号
money number 530 可用余额
name string 实体购物卡 购物卡名称
description string 线下发放 购物卡描述
is_use integer 1 是否可使用 0=否 1=是
not_use_error string 不可用原因
integral 类型 是否返回 示例值 描述
usable integer 2000 最多可抵扣积分
give integer 32411 该笔订单可赠送积分
order_price 类型 是否返回 示例值 描述
pay_amount number 30506.42 订单金额
goods_amount number 44500 商品金额
total_amount number 31245.51 应付金额(含运费)
invoice_amount number 915.19 开票费用
use_money number 99.5 余额抵扣
use_level number 889.4 会员等级抵扣
use_integral integer 10 积分抵扣
use_coupon number 30 优惠劵抵扣
use_discount number 0 商品折扣抵扣
use_promotion number 13074.18 订单促销抵扣
use_card number 66.6 购物卡抵扣
delivery_fee number 0 运费
delivery_dec number 0 费运减免金额

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "goods_list": [
  6. {
  7. "cart_id": 44,
  8. "goods_id": 14,
  9. "goods_num": 2,
  10. "key_name": "2_4",
  11. "key_value": "颜色:白色 CPU:I7",
  12. "goods": {
  13. "goods_id": 14,
  14. "name": "小米笔记本 白色",
  15. "goods_code": "CS36157358",
  16. "goods_sku": "",
  17. "bar_code": "",
  18. "store_qty": 100,
  19. "measure": 3,
  20. "measure_type": 0,
  21. "is_postage": 1,
  22. "market_price": 7000,
  23. "shop_price": 5900,
  24. "purchase_sum": 2,
  25. "integral_type": 0,
  26. "give_integral": 100,
  27. "is_integral": 1000,
  28. "goods_image": "//image_1.jpg"
  29. },
  30. "error": 0,
  31. "error_msg": ""
  32. },
  33. {
  34. "cart_id": 43,
  35. "goods_id": 13,
  36. "goods_num": 6,
  37. "key_name": "1_3",
  38. "key_value": "颜色:黑色 CPU:I5",
  39. "goods": {
  40. "goods_id": 13,
  41. "name": "MateBook 华为 笔记本",
  42. "goods_code": "CS38491916",
  43. "goods_sku": "",
  44. "bar_code": "",
  45. "store_qty": 98,
  46. "measure": 3,
  47. "measure_type": 0,
  48. "is_postage": 1,
  49. "market_price": 7000,
  50. "shop_price": 5400,
  51. "purchase_sum": 2,
  52. "integral_type": 0,
  53. "give_integral": 100,
  54. "is_integral": 1000,
  55. "goods_image": "//image_1.jpg"
  56. },
  57. "error": 0,
  58. "error_msg": ""
  59. },
  60. {
  61. "cart_id": 38,
  62. "goods_id": 1,
  63. "goods_num": 1,
  64. "key_name": "",
  65. "key_value": "",
  66. "goods": {
  67. "goods_id": 1,
  68. "name": "不带规格的商品",
  69. "goods_code": "CS91785258",
  70. "goods_sku": "",
  71. "bar_code": "",
  72. "store_qty": 100,
  73. "measure": 0,
  74. "measure_type": 0,
  75. "is_postage": 1,
  76. "market_price": 500,
  77. "shop_price": 300,
  78. "purchase_sum": 0,
  79. "integral_type": 0,
  80. "give_integral": 0,
  81. "is_integral": 0,
  82. "goods_image": "//image.jpg"
  83. },
  84. "error": 1,
  85. "error_msg": "商品已失效"
  86. }
  87. ],
  88. "coupon_give_list": [
  89. {
  90. "coupon_give_id": 6,
  91. "coupon_id": 3,
  92. "user_id": 1,
  93. "order_id": 0,
  94. "exchange_code": "2ImbP95cJ0",
  95. "use_time": "",
  96. "create_time": "2018-05-24 15:00:44",
  97. "get_coupon": {
  98. "coupon_id": 3,
  99. "name": "端午节",
  100. "description": "",
  101. "guide": "",
  102. "type": 0,
  103. "give_code": "",
  104. "money": 30,
  105. "quota": 100,
  106. "category": [],
  107. "exclude_category": [],
  108. "level": [],
  109. "frequency": 1,
  110. "give_num": 200,
  111. "receive_num": 2,
  112. "use_num": 0,
  113. "give_begin_time": "2018-05-24 02:06:00",
  114. "give_end_time": "2018-06-24 02:06:00",
  115. "use_begin_time": "2018-05-24 02:06:00",
  116. "use_end_time": "2018-08-25 00:27:04",
  117. "status": 1,
  118. "is_invalid": 0
  119. },
  120. "is_use": 1,
  121. "not_use_error": ""
  122. },
  123. {
  124. "coupon_give_id": 106,
  125. "coupon_id": 5,
  126. "user_id": 1,
  127. "order_id": 0,
  128. "exchange_code": "bq4ZQQr7Ar",
  129. "use_time": "",
  130. "create_time": "2018-05-24 15:07:19",
  131. "get_coupon": {
  132. "coupon_id": 5,
  133. "name": "端午节(线下)",
  134. "description": "",
  135. "guide": "",
  136. "type": 1,
  137. "give_code": "",
  138. "money": 30,
  139. "quota": 200,
  140. "category": [],
  141. "exclude_category": [],
  142. "level": [],
  143. "frequency": 1,
  144. "give_num": 200,
  145. "receive_num": 100,
  146. "use_num": 0,
  147. "give_begin_time": "2018-05-24 02:06:00",
  148. "give_end_time": "2018-06-24 02:06:00",
  149. "use_begin_time": "2018-05-24 02:06:00",
  150. "use_end_time": "2018-06-24 02:06:00",
  151. "status": 1,
  152. "is_invalid": 0
  153. },
  154. "is_use": 0,
  155. "not_use_error": "优惠劵使用时间已过期"
  156. }
  157. ],
  158. "card_use_list": [
  159. {
  160. "number": "9514677739431425",
  161. "money": 530,
  162. "name": "实体购物卡",
  163. "description": "线下发放",
  164. "is_use": 1,
  165. "not_use_error": ""
  166. },
  167. {
  168. "number": "1818337623626955",
  169. "money": 470,
  170. "name": "实体购物卡",
  171. "description": "线下发放",
  172. "is_use": 1,
  173. "not_use_error": ""
  174. }
  175. ],
  176. "integral": {
  177. "usable": 2000,
  178. "give": 32411
  179. },
  180. "order_price": {
  181. "pay_amount": 30506.42,
  182. "goods_amount": 44500,
  183. "total_amount": 31245.51,
  184. "invoice_amount": 915.19,
  185. "use_money": 99.5,
  186. "use_level": 889.4,
  187. "use_integral": 10,
  188. "use_coupon": 30,
  189. "use_discount": 0,
  190. "use_promotion": 13074.18,
  191. "use_card": 66.6,
  192. "delivery_fee": 0,
  193. "delivery_dec": 0
  194. }
  195. }
  196. }

提交订单后

接口描述:

  • 提交订单后将返回的各项数据。

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
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 购物卡抵扣
card_number string 997156… 购物卡号
delivery_fee number 1195 运费
delivery_id integer 1 配送方式
consignee string carey 收货人姓名
country integer 0 国家
region_list array [1,2,3] 省市区编号
address string 广济街 详细地址
complete_address string 浙江省 宁波市 江北区 广济街 完整地址
zipcode string 315000 邮编
tel string 0574-8748… 电话
mobile string 15867… 手机号码
buyer_remark string 发韵达 买家备注
integral_pct number 100 记录积分换算比例
give_integral integer 100 赠送积分
give_coupon array [1,2,3] 赠送优惠劵
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=已付
invoice_title string 宁波欧瑞网络科技有限公司 发票抬头
tax_number string xxx0909 纳税人识别号
create_time datetime 2017-01-04 14:04:25 创建时间
update_time datetime 2017-01-04 14:04:25 更新时间

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "order_no": "PO_I6256034532185680001",
  6. "user_id": 1,
  7. "source": "0",
  8. "pay_amount": 30300.62,
  9. "goods_amount": 44200,
  10. "total_amount": 31033.54,
  11. "use_money": 99.5,
  12. "use_level": 883.4,
  13. "use_integral": 10,
  14. "use_coupon": 30,
  15. "use_discount": 0,
  16. "use_promotion": 12985.98,
  17. "use_card": 66.6,
  18. "card_number": "9514677739431425",
  19. "delivery_fee": 0,
  20. "delivery_id": 1,
  21. "consignee": "张三",
  22. "country": 0,
  23. "region_list": [1, 2, 3],
  24. "address": "详细地址",
  25. "complete_address": "浙江省 宁波市 江北区 详细地址",
  26. "zipcode": "315000",
  27. "tel": "87487585",
  28. "mobile": "15867430123",
  29. "buyer_remark": "发顺丰",
  30. "integral_pct": 100,
  31. "give_integral": 32199,
  32. "give_coupon": [],
  33. "invoice_amount": 909.02,
  34. "trade_status": 0,
  35. "delivery_status": 0,
  36. "payment_status": 0,
  37. "invoice_title": "宁波欧瑞网络科技有限公司",
  38. "tax_number": "xxx123456",
  39. "create_time": "2018-06-25 01:12:25",
  40. "update_time": "2018-06-25 01:12:25"
  41. }
  42. }