簡要描述
請求url
https://www.商城域名.com/index.php?s=/api/checkout/order
請求方式
是否需授權(quán)登錄
請求header
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
當(dāng)前請求的客戶端(APP、小程序、H5等) |
Access-Token |
string |
選填 |
- |
當(dāng)前登錄用戶的 Token |
請求參數(shù)
參數(shù)名 |
類型 |
是否必須 |
示例值 |
說明 |
mode |
string |
必填 |
buyNow |
結(jié)算模式(buyNow立即購買 cart購物車) |
delivery |
int |
必填 |
10 |
配送方式(10快遞配送 20上門自提) |
shopId |
int |
必填 |
0 |
自提門店ID |
couponId |
int |
必填 |
0 |
優(yōu)惠券ID |
isUsePoints |
int |
必填 |
0 |
是否使用積分抵扣(1使用 0不使用) |
cartIds |
string |
必填 |
28,30 |
購物車ID集 |
返回示例
{
"status": 200,
"message": "success",
"data": {
"order": {
"goodsList": [
{
"goods_id": 10019,
"goods_name": "清野の木 56L灰色特大號 塑料收納箱整理箱環(huán)保加厚儲物箱",
"goods_no": "",
"video_id": 0,
"video_cover_id": 0,
"selling_point": "",
"spec_type": 10,
"goods_price_min": "31.50",
"goods_price_max": "31.50",
"line_price_min": "0.00",
"line_price_max": "0.00",
"stock_total": 83,
"delivery_id": 10001,
"is_points_gift": 1,
"is_points_discount": 1,
"is_alone_points_discount": 0,
"points_discount_config": "",
"is_enable_grade": 1,
"is_alone_grade": 0,
"alone_grade_equity": [],
"status": 10,
"is_ind_dealer": 0,
"dealer_money_type": 10,
"first_money": "0.00",
"second_money": "0.00",
"third_money": "0.00",
"goods_images": [
{
"file_id": 10364,
"file_type": 10,
"preview_url": "2a6e0c0ea7d1e5f0f2ac3e406198850c.jpg"
}
],
"goods_image": "2a6e0c0ea7d1e5f0f2ac3e406198850c.jpg",
"goods_sales": 203,
"is_user_grade": true,
"skuInfo": {
"id": 10525,
"goods_sku_id": "0",
"goods_id": 10019,
"image_id": 0,
"goods_sku_no": "",
"goods_price": "32.14",
"line_price": "0.00",
"stock_num": 83,
"goods_weight": 0,
"goods_props": null,
"spec_value_ids": null
},
"goods_price": "32.14",
"total_num": 3,
"goods_sku_id": "0",
"total_price": "94.49",
"grade_ratio": "9.8",
"grade_goods_price": "31.50",
"grade_total_money": "1.93",
"coupon_money": 0,
"max_points_num": 0,
"pointsNum": 0,
"points_money": 0,
"total_pay_price": "94.49",
"expressPrice": 0,
"points_bonus": "4"
}
],
"orderTotalNum": 3,
"couponList": [],
"hasError": false,
"errorMsg": "",
"delivery": 10,
"address": {
"address_id": 10052,
"name": "test",
"phone": "13212341234",
"province_id": 1,
"city_id": 2,
"region_id": 3,
"detail": "125125",
"user_id": 10125,
"region": {
"province": "北京",
"city": "北京市",
"region": "東城區(qū)"
}
},
"existAddress": true,
"expressPrice": "0.00",
"isIntraRegion": true,
"extractShop": [],
"isAllowPoints": false,
"isUsePoints": "0",
"pointsMoney": 0,
"pointsBonus": 4,
"lastExtract": {},
"orderTotalPrice": "94.49",
"couponId": 0,
"couponMoney": 0,
"orderPrice": "94.49",
"orderPayPrice": "94.49"
},
"personal": {
"user_id": 10125,
"balance": "91656.64",
"points": 64,
"address_id": 10052
},
"setting": {
"deliveryType": [
10,
20
],
"points_name": "積分",
"points_describe": ""
}
}
}
返回參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
status |
int |
200 |
請求狀態(tài)(200:請求成功;500:請求錯誤/失敗) |
message |
string |
success |
請求結(jié)果的信息,默認(rèn)為 success |
data |
object |
- |
返回的業(yè)務(wù)數(shù)據(jù) |
data 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
order |
object |
- |
訂單信息 |
personal |
object |
- |
當(dāng)前用戶信息 |
setting |
object |
- |
商城設(shè)置 |
data.order 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
goodsList |
array |
- |
商品列表 |
orderTotalNum |
int |
3 |
訂單商品總數(shù)量 |
couponList |
array |
- |
用戶的優(yōu)惠券列表 |
hasError |
boolean |
false |
是否存在錯誤 |
errorMsg |
string |
- |
錯誤信息 |
delivery |
int |
10 |
當(dāng)前配送方式 |
address |
object |
- |
當(dāng)前收貨地址 |
existAddress |
boolean |
true |
是否存在收貨地址 |
expressPrice |
string |
0.00 |
配送費(fèi)用(運(yùn)費(fèi)) |
isIntraRegion |
boolean |
true |
當(dāng)前用戶收貨城市是否存在配送規(guī)則中 |
extractShop |
array |
- |
自提門店信息 |
isAllowPoints |
boolean |
false |
是否允許使用積分抵扣 |
isUsePoints |
string |
0 |
是否使用積分抵扣 |
pointsMoney |
int |
0 |
積分抵扣金額 |
pointsBonus |
int |
4 |
贈送的積分?jǐn)?shù)量 |
lastExtract |
object |
- |
最近的自提聯(lián)系方式 |
orderTotalPrice |
string |
94.49 |
訂單商品總額 |
couponId |
int |
0 |
優(yōu)惠券ID |
couponMoney |
int |
0 |
優(yōu)惠券抵扣金額 |
orderPrice |
string |
94.49 |
訂單金額(含優(yōu)惠折扣) |
orderPayPrice |
string |
94.49 |
訂單實(shí)付款金額(訂單金額 + 運(yùn)費(fèi)) |
data.order.goodsList 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
goods_id |
int |
10019 |
商品ID |
goods_name |
string |
清野の木 56L灰色特大號 塑料收納箱... |
商品標(biāo)題/名稱 |
goods_no |
string |
- |
商品編號 |
video_id |
int |
0 |
主圖視頻ID |
video_cover_id |
int |
0 |
主圖視頻封面ID |
selling_point |
string |
- |
商品賣點(diǎn) |
spec_type |
int |
10 |
商品規(guī)格 (10單規(guī)格 20多規(guī)格) |
goods_price_min |
string |
31.50 |
商品價格 (最低) |
goods_price_max |
string |
31.50 |
商品價格 (最高) |
line_price_min |
string |
0.00 |
劃線價格 (最低) |
line_price_max |
string |
0.00 |
劃線價格 (最高) |
stock_total |
int |
83 |
庫存總量 (包含所有sku) |
delivery_id |
int |
10001 |
配送模板ID |
is_points_gift |
int |
1 |
是否開啟積分贈送 (1開啟 0關(guān)閉) |
is_points_discount |
int |
1 |
是否允許使用積分抵扣 (1允許 0不允許) |
is_enable_grade |
int |
1 |
是否開啟會員折扣 (1開啟 0關(guān)閉) |
is_alone_grade |
int |
0 |
會員折扣設(shè)置 (0默認(rèn)等級折扣 1單獨(dú)設(shè)置折扣) |
alone_grade_equity |
array |
- |
單獨(dú)設(shè)置折扣的配置 |
status |
int |
10 |
商品狀態(tài) (10上架 20下架) |
is_ind_dealer |
int |
0 |
是否開啟單獨(dú)分銷 (0關(guān)閉 1開啟) |
dealer_money_type |
int |
10 |
分銷傭金類型 (10百分比 20固定金額) |
first_money |
string |
0.00 |
分銷傭金 (一級) |
second_money |
string |
0.00 |
分銷傭金 (二級) |
third_money |
string |
0.00 |
分銷傭金 (三級) |
goods_images |
array |
- |
商品輪播圖 |
goods_image |
string |
2a6e0c0ea7d1e5f0f2ac3e406198850c.jpg |
商品主圖 |
goods_sales |
int |
203 |
商品顯示銷量 |
is_user_grade |
boolean |
true |
是否使用會員價 |
skuInfo |
object |
- |
商品SKU信息 |
goods_price |
string |
32.14 |
商品售價 |
total_num |
int |
3 |
購買數(shù)量 |
goods_sku_id |
string |
0 |
商品SKU唯一標(biāo)識 |
total_price |
string |
94.49 |
商品總價格 |
grade_ratio |
string |
9.8 |
會員折扣的金額 |
grade_goods_price |
string |
31.50 |
會員折扣的商品單價 |
grade_total_money |
string |
1.93 |
會員折扣的總額差 |
coupon_money |
int |
0 |
優(yōu)惠券折扣金額 |
max_points_num |
int |
0 |
最多可抵扣的積分?jǐn)?shù)量 |
pointsNum |
int |
0 |
實(shí)際抵扣的積分?jǐn)?shù)量 |
points_money |
int |
0 |
積分實(shí)際抵扣的金額 |
total_pay_price |
string |
94.49 |
訂單商品的實(shí)際付款金額 |
expressPrice |
int |
0 |
配送費(fèi)用(運(yùn)費(fèi)) |
points_bonus |
string |
4 |
積分贈送數(shù)量 |
data.order.goodsList.skuInfo 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
id |
int |
10525 |
SKUID |
goods_sku_id |
string |
0 |
商品SKU唯一標(biāo)識 |
goods_id |
int |
10019 |
商品ID |
image_id |
int |
0 |
SKU圖片ID |
goods_sku_no |
string |
- |
SKU編碼 |
goods_price |
string |
32.14 |
商品售價 |
line_price |
string |
0.00 |
劃線價 |
stock_num |
int |
83 |
庫存數(shù)量 |
goods_weight |
int |
0 |
商品重量 |
goods_props |
null |
null |
SKU規(guī)格屬性名稱 |
spec_value_ids |
null |
null |
SKU規(guī)格值ID集 |
data.personal 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
user_id |
int |
10125 |
用戶ID |
balance |
string |
91656.64 |
賬戶余額 |
points |
int |
64 |
可用積分 |
address_id |
int |
10052 |
默認(rèn)收貨地址ID |
data.setting 參數(shù)
參數(shù)名 |
類型 |
示例值 |
說明 |
deliveryType |
array |
[10, 20] |
支持的配送方式(10快遞配送 20上門自提) |
points_name |
string |
積分 |
積分名稱 |
points_describe |
string |
- |
積分描述 |