拜哥网API文档

====== 订单接口 ======
------
===== 1、订单列表 =====

=== 接口名称 ===
 orders/list
=== 请求方式 ===
  get
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| buyerId| int   | 是     | 买家id  |
| type| int   | 否     | 订单类型  |
| orderNo| string|  否     | 订单编号|
| startTime| date|  否     | 订单创建开始时间|
| endTime| date|  否     | 订单创建结束时间  |
| status| int   |  否     | 订单状态 (0 :待付款，1 :待发货，2 :待收货，3 :交易成功，4：交易取消，5：交易关闭，6：取消订单等待卖家处理)  |
| productName| string|  否     | 产品名称 |
|pageSize|int|否|每页数量 默认为50|
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| items| data| 数据  |
| _links| data| 分页信息    |
| _meta| data| 查询数据信息    |
=== items数据说明 ===
^ 名称         ^ 类型      ^ 说明    ^
| id| int| 订单ID|
| order_no| string| 订单编号    |
| supplier_id| int| 供货商ID    |
| member_id| int| 买家ID    |
| order_type| int|订单类型 1 实物订单 2 积分兑换订单   |
| order_money| number| 订单金额    |
| discount| number| 折扣    |
| shipping_costs| number| 运费    |
| order_total| number| 订单合计金额    |
| pay_money| number| 支付金额    |
| quantity| int| 合计件数    |
| create_time| string| 创建时间    |
| pay_time| string| 支付时间   |
| ship_time| string| 查询数据信息    |
| complete_time| string| 发货时间    |
| express| int| 配送方式    |
| express_code| string| 运单号   |
| cancle_time| string| 取消时间   |
| status| int|订单状态订单状态 0 待付款 1待发货 2待收货 3交易成功 4交易取消5交易关闭 6 取消订单等待卖家处理    |
| memos| string| 订单备注    |
| buyer_feedback| string| 买家留言   |
| is_comment| int| 是否评论    |
| details| array| 订单产品信息<code> {
          "id": "43", //订单详情id
          "orders_id": "26",//订单ID
          "product_id": "3",//产品ID
          "sku_id": "3",//产品SKU ID
          "product_name": "432432432",//产品名称
          "properties": "颜色:红色,大小:X,套餐:电信",//SKU属性
          "quantity": "2",//购买数量
          "price": "22.00",//单价
          "total": "44.00",//小计
          "cost": "46.00",//成本价
          "back_status": "0",//退款状态（0没有退款，1申请中，2退款成功，3退款失败，4退款中）
          "pic1": "http://pic.8dage.net/data/uploadfile/images/1/20160504/6c50be469f.png"////产品图片
        }</code>    |

===== 2、订单详情 =====
=== 接口名称 ===
 orders/detail
=== 请求方式 ===
  get
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| buyerId| int   | 是     | 买家id  |
| orderId| int   | 是     | 订单id  |

=== 返回值 ===
^ 名称              ^ 类型      ^ 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           ^
| id              | int     | 订单ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| order_no        | string  | 订单编号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| supplier_id     | int     | 供货商ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| member_id       | int     | 买家ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| order_type      | int     | 订单类型 1 实物订单 2 积分兑换订单                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| order_money     | number  | 订单金额                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| discount        | number  | 折扣                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| shipping_costs  | number  | 运费                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| order_total     | number  | 订单合计金额                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| pay_money       | number  | 支付金额                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| quantity        | int     | 合计件数                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| create_time     | string  | 创建时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| pay_time        | string  | 支付时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ship_time       | string  | 查询数据信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| complete_time   | string  | 发货时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| express         | int     | 配送方式                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| express_code    | string  | 运单号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| cancle_time     | string  | 取消时间                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| status          | int     | 订单状态订单状态 0 待付款 1待发货 2待收货 3交易成功 4交易取消5交易关闭 6 取消订单等待卖家处理                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| memos           | string  | 订单备注                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| buyer_feedback  | string  | 买家留言                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| is_comment      | int     | 是否评论                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| detail          | array   | 订单产品信息<code> {           "id": "43", //订单详情id           "orders_id": "26",//订单ID           "product_id": "3",//产品ID           "sku_id": "3",//产品SKU ID           "product_name": "432432432",//产品名称           "properties": "颜色:红色,大小:X,套餐:电信",//SKU属性           "quantity": "2",//购买数量           "price": "22.00",//单价           "total": "44.00",//小计           "cost": "46.00",//成本价           "back_status": "0",//退款状态（0没有退款，1申请中，2退款成功，3退款失败，4退款中）           "pic1": "http://pic.8dage.net/data/uploadfile/images/1/20160504/6c50be469f.png"////产品图片         }</code>  |
===== 3、创建订单 =====

=== 接口名称 ===
 orders/create
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^

| buyerId       | int     | 是   | 买家id                           |
| orderType     | int     | 否   | 订单类型（1 实物订单 2 积分兑换订单 默认为实物订单）  |
| discount      | number  |  否  | 折扣 （默认为0）                      |
| addressId     | int     |  是  | 买家收货地址id                       |
| productSkuId  | int     |  是  | 产品skuid                        |
| buyCount      | int     |  是  | 购买数量                           |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 4、从购物车创建订单 =====

=== 接口名称 ===
 orders/create-by-cart
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^

| buyerId| int   | 是     | 买家id  |
| orderType| int   | 是     | 订单类型  |
| discount| number  |  是     | 折扣  |
| addressId| int   |  是     | 买家收货地址id  |
| carts| string|  是     |购物车id，多个以逗号拼接  |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 5、支付订单 =====

=== 接口名称 ===
 orders/pay
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| orderId| int   | 是     | 订单id |
| orderMoney| number   | 是     | 订单金额  |
| buyerId| int   | 是     | 买家id  |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 6、订单发货 =====

=== 接口名称 ===
 orders/fahuo
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| orderId| int   | 是     | 订单id |
| expressType| string| 是     | 快递类型  |
| expressCode| string| 是     | 快递名称  |
| sellerId| int   | 是     | 卖家id  |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 7、订单确认收货 =====

=== 接口名称 ===
 orders/confirm
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| orderId| int   | 是     | 订单id |
| buyerId| int   | 是     | 买家id  |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |

===== 8、取消订单 =====

=== 接口名称 ===
 orders/cancel
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| orderId| int   | 是     | 订单id |
| buyerId| int   | 是     | 买家id  |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 9、申请退款 =====

=== 接口名称 ===
 orders/apply-refund
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| buyerId| int   | 是     | 买家id  |
| orderDetailId| int   | 是     | 订单详情id |
| backType| int   | 是     | 退款类型 |
| backNote| string| 是     | 退款说明 |
| backPrice| string| 是     | 退款金额 |
| backPic| string| 是     | 退款凭证|
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |

===== 10、买家取消退款 =====

=== 接口名称 ===
 orders/callce-refund
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| buyerId| int   | 是     | 买家id  |
| backId| int   | 是     | 退款id |

=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
===== 11、卖家拒绝退款 =====

=== 接口名称 ===
 orders/refuse-refund
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| sellerId| int   | 是     | 卖家id |
| backId| int   | 是     | 退款id |

=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |

===== 12、卖家同意退款 =====

=== 接口名称 ===
 orders/agree-refund
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| sellerId| int   | 是     | 卖家id |
| backId| int   | 是     | 退款id |
| backAddrs| int   |否     | 退货地址id |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |

===== 13、买家退货 =====

=== 接口名称 ===
 orders/return-goods
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| buyerId| int   | 是     | 买家id |
| backId| int   | 是     | 退款id |
| shipping_id| int   | 是     | 快递id |
| shipping_name| string| 是     | 快递名称 |
| invoice_no| string| 是     | 快递单号 |
=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |

===== 14、卖家确认退货 =====

=== 接口名称 ===
 orders/agree-return
=== 请求方式 ===
  post
=== 请求参数 ===
^ 参数名称  ^ 参数类型  ^ 是否必填  ^ 说明    ^
| sellerId| int   | 是     | 卖家id |
| backId| int   | 是     | 退款id |

=== 返回值 ===
^ 名称         ^ 类型      ^ 说明    ^
| result         | bool     | 返回结果 success 成功 error 失败  |
| message| string  | 返回信息    |
拜哥网API文档

用户工具

站点工具

页面工具
