创建订单接口

创建用户购物订单,支持单个商品或多个商品下单,可指定收货地址、优惠券等信息。

注意事项

  • 该接口采用POST方法,需要以application/json格式提交数据
  • 需要用户登录后才能访问
  • 订单状态为待付款状态,等待用户支付
  • 可以通过商品ID或商品详情列表创建订单
  • 支持使用优惠券和指定收货地址

请求地址

{域名地址}/api/order/create

说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/order/create

请求语法

POST {域名地址}/api/order/create
Content-Type: application/json

请求头

此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

请求参数

字段名 类型 必填 说明
goods_id int 否 商品ID,单个商品下单时可使用
quantity int 否 商品数量,单个商品下单时可使用
goods_sku_id int 否 SKU ID,单个商品下单时可使用
details object[] 否 多个商品信息,goods_id 和 details 必须传一个
remark string 否 订单备注
type string 否 订单类型,goods、vip
coupon_code string 否 优惠券码
coupon_code_id int 否 优惠券码ID
coupon_id int 否 优惠券ID,满减类型的优惠券
address object 否 收件地址信息
cart_ids int[] 否 购物车ID列表

details item 参数

字段名 类型 必填 说明
goods_id int 是 商品ID
quantity int 是 商品数量

address 参数

字段名 类型 必填 说明
id int 否 地址ID
name string 是 收件人
phone string 是 联系电话
province string 是 省份
city string 是 城市
country string 是 区县
address_info string 是 详细地址
postcode string 是 邮编

响应头

此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)。

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object 订单信息

data 结果参数

字段名 类型 说明
id int 订单ID
order_id string 订单号
payment_id string 支付流水ID
user_id int 用户ID
remark string 订单备注
type string 订单类型
origin_amount int 订单原始总价
amount int 订单实际总价
paid_time int 支付时间
end_time int 订单预计自动完成时间
deliver_time int 发货时间
finished_time int 订单完成时间
discount_amount int 优惠金额
seller_id int 卖家ID
seller_amount int 卖家可得收益
share_user_id int 推广者ID
share_parent_user_id int 推广者上级ID
share_amount int 推广者可得收益
share_parent_amount int 推广者上级可得收益
express_company string 快递公司
tracking_number string 快递运单号
created_time int 下单时间戳
updated_time int 更新时间戳
status int 订单状态:-1取消,0待付款,1已付款,2已发货,3已完成,8退款中,9已退款
refund_status int 退款状态:-1退款失败,0无或退款中,1已退款

使用示例

请求示例(单个商品)

POST /api/order/create HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json

{
  "goods_id": 188,
  "quantity": 1,
  "type": "goods",
  "remark": "普通商品订单"
}

请求示例(多个商品)

POST /api/order/create HTTP/1.1
Host: www.anqicms.com
Content-Type: application/json

{
  "details": [
    {
      "goods_id": 188,
      "quantity": 1
    },
    {
      "goods_id": 189,
      "quantity": 2
    }
  ],
  "type": "goods",
  "address": {
    "name": "王先生",
    "phone": "13888888888",
    "province": "河南省",
    "city": "郑州市",
    "country": "中原区",
    "address_info": "中原西路233号",
    "postcode": "450000"
  },
  "remark": "多商品订单",
  "coupon_code": "COUPON2023"
}

响应示例

{
  "code": 0,
  "msg": "",
  "data": {
    "id": 46,
    "created_time": 1669212548,
    "updated_time": 1669212548,
    "order_id": "202211232209080046",
    "payment_id": "",
    "user_id": 1000,
    "address_id": 0,
    "remark": "普通商品订单",
    "type": "goods",
    "status": 0,
    "refund_status": 0,
    "origin_amount": 9900,
    "amount": 9900,
    "paid_time": 0,
    "end_time": 0,
    "deliver_time": 0,
    "finished_time": 0,
    "discount_amount": 0,
    "seller_id": 15,
    "seller_amount": 7920,
    "share_user_id": 0,
    "share_parent_user_id": 0,
    "share_amount": 0,
    "share_parent_amount": 0,
    "express_company": "",
    "tracking_number": ""
  }
}

错误代码

错误码 说明
0 OK
-1 错误,错误原因在 msg 中指出
1001 未登录
1002 未授权
200 API 请求 OK