Showing
1 changed file
with
733 additions
and
725 deletions
| 1 | -# 订单服务接口 | ||
| 2 | - | ||
| 3 | -## 1、订单列表 | ||
| 4 | - | ||
| 5 | - | ||
| 6 | -### 接口说明 | ||
| 7 | - | ||
| 8 | -| 接口说明 | 接口说明 | | ||
| 9 | -| :-- | -----: | | ||
| 10 | -| 请求域名 | http://api.yoho.cn/ | | ||
| 11 | -| 接口名 | app.SpaceOrders.get | | ||
| 12 | -| 接口说明 | 获取用户订单列表 | | ||
| 13 | -| http请求方式 | GET/POST | | ||
| 14 | - | ||
| 15 | -### 请求参数 | ||
| 16 | -| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 | | ||
| 17 | -| :-- | :-- | :-- | :-- | :-- | :-- | | ||
| 18 | -| method | string | 是 | app.SpaceOrders.get | | | | ||
| 19 | -| uid | int | 是 | 5772257 | | | | ||
| 20 | -| type | int | 是 | 1 | | 订单类型 1:全部订单,2:待付款,3:待发货,4:待收货,5:待评论/成功订单,7:失败/取消 | | ||
| 21 | -| page | int | 否 | 1 | 1 | 页数 | | ||
| 22 | -| limit | int | 否 | 10 | 10 | 每页大小 | | ||
| 23 | - | ||
| 24 | -### 正常返回结果 | ||
| 25 | -```json | ||
| 26 | -{ | ||
| 27 | - "code": 200, | ||
| 28 | - "data": { | ||
| 29 | - "order_list": [ | ||
| 30 | - { | ||
| 31 | - "id": "5528982", | ||
| 32 | - "order_code": "1519273880", | ||
| 33 | - "parent_order_code": "0", | ||
| 34 | - // 订单类型 1:有货,3:iphone,4:android,5:淘宝,6:h5,7:是换货,9:渠道,20:ipad | ||
| 35 | - "order_type": 1, | ||
| 36 | - // 退货状态（该字段已经废弃了）0:正常订单,1:退货审核中,2:退货审核不通过,3:退货审核通过,4:退货商品寄回,5:退货库房入库,6:财务退款,7:完成 | ||
| 37 | - "refund_status": 0, | ||
| 38 | - "uid": "5772257", | ||
| 39 | - // 创建时间 | ||
| 40 | - "create_time": "1449633428", | ||
| 41 | - // 更新时间 | ||
| 42 | - "update_time": "1449633455", | ||
| 43 | - //是否展示取消订单倒计时，Y表示展示,N不展示 | ||
| 44 | - "counter_flag":"Y", | ||
| 45 | - // 取消订单倒计时时间，单位：秒 | ||
| 46 | - "pay_lefttime":"6446", | ||
| 47 | - // 支付超期时间 | ||
| 48 | - "pay_expire": "2015-12-09 13:57:08", | ||
| 49 | - // 支付方式编号 | ||
| 50 | - "payment": "2", | ||
| 51 | - // 支付状态 Y:已支付,N:未支付 | ||
| 52 | - "payment_status": "Y", | ||
| 53 | - // 支付方式 1:在线支付,2:货到付款,3:现金支付,4:抵消支付 | ||
| 54 | - "payment_type": "1", | ||
| 55 | - "payment_type_str": "在线支付", | ||
| 56 | - // 状态 0:待付款,1-3:待发货,4-5:待收货(0:未付款,1:已付款,2:备货中,3:配货中,4:已发货,5:运输中,6:已完成) | ||
| 57 | - "status": 1, | ||
| 58 | - // 状态名称 | ||
| 59 | - "status_str": "已付款", | ||
| 60 | - "attribute": "5", | ||
| 61 | - // 是否取消 Y:已取消,N:未取消 | ||
| 62 | - "is_cancel": "N", | ||
| 63 | - // 是否评论 Y:已评论,N:未评论 | ||
| 64 | - "is_comment": "N", | ||
| 65 | - // 订单金额 | ||
| 66 | - "amount": "1.00", | ||
| 67 | - // 运费 | ||
| 68 | - "shipping_cost": "0.00", | ||
| 69 | - // 使用限购码 Y:使用,N:未使用 | ||
| 70 | - "use_limit_code": "N", | ||
| 71 | - // 用户确认支付 Y:是,N:否 | ||
| 72 | - "user_confirm_paid": "N", | ||
| 73 | - // 购买商品数量 | ||
| 74 | - "buy_total": 1, | ||
| 75 | - // 购买商品 | ||
| 76 | - "order_goods": [ | ||
| 77 | - { | ||
| 78 | - // 购买商品数量 | ||
| 79 | - "buy_number": 1, | ||
| 80 | - "goods_id": 125106, | ||
| 81 | - // 商品默认图片 | ||
| 82 | - "goods_image": "http://img10.static.yhbimg.com/goodsimg/2014/06/19/02/0118c2721e4f2219f69539dd389f4bacac.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 83 | - // 商品价格 | ||
| 84 | - "goods_price": "1.00", | ||
| 85 | - // 商品类型 ordinary:普通商品 | ||
| 86 | - "goods_type": "ordinary", | ||
| 87 | - // 商品总价格 | ||
| 88 | - "goods_amount": "1.00", | ||
| 89 | - "product_id": 84230, | ||
| 90 | - "product_name": "004 满版龙纹迷彩七分休闲裤", | ||
| 91 | - "cn_alphabet": "004QiFenBuKu004PA095", | ||
| 92 | - "product_skn": 51055461, | ||
| 93 | - // 退货数量 | ||
| 94 | - "refund_num": 0, | ||
| 95 | - // 商品颜色 | ||
| 96 | - "color_name": "彩色", | ||
| 97 | - // 商品尺寸 | ||
| 98 | - "size_name": "M", | ||
| 99 | - // 预期到货时间 | ||
| 100 | - "expect_arrival_time": "" | ||
| 101 | - } | ||
| 102 | - ] | ||
| 103 | - } | ||
| 104 | - ], | ||
| 105 | - "page": 1, | ||
| 106 | - "page_total": 27, | ||
| 107 | - "total": 265 | ||
| 108 | - }, | ||
| 109 | - "message": "ok" | ||
| 110 | -} | ||
| 111 | -``` | ||
| 112 | - | ||
| 113 | -### 2、订单详情 | ||
| 114 | - | ||
| 115 | -### 接口说明 | ||
| 116 | - | ||
| 117 | -| 接口说明 | 接口说明 | | ||
| 118 | -| :-- | -----: | | ||
| 119 | -| 请求域名 | http://api.yoho.cn/ | | ||
| 120 | -| 接口名 | app.SpaceOrders.detail | | ||
| 121 | -| 接口说明 | 订单详情 | | ||
| 122 | -| http请求方式 | GET/POST | | ||
| 123 | - | ||
| 124 | -### 请求参数 | ||
| 125 | -| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 | | ||
| 126 | -| :-- | :-- | :-- | :--| :-- | :-- | | ||
| 127 | -| method | string | 是 | app.SpaceOrders.detail ||| | ||
| 128 | -| uid | int | 是 | 5772257 ||| | ||
| 129 | -| order_code | int | 是 | 1519273880 || 订单号 | | ||
| 130 | - | ||
| 131 | - | ||
| 132 | -#### 正常返回结果 | ||
| 133 | -```json | ||
| 134 | -{ | ||
| 135 | - "alg": "SALT_MD5", | ||
| 136 | - "code": 200, | ||
| 137 | - "data": { | ||
| 138 | - "address": "你那", | ||
| 139 | - "amount": "¥690.00", | ||
| 140 | - "area": "北京市 北京市 东城区 ", | ||
| 141 | - "area_code": "110101", | ||
| 142 | - "attribute": "0", | ||
| 143 | - "can_comment": "Y", | ||
| 144 | - //是否有关联其他订单 "Y":有关联其他订单 "N"：没有关联其他订单 | ||
| 145 | - "relate_order_code": "Y", | ||
| 146 | - // 地址ID | ||
| 147 | - "address_id": 12345, | ||
| 148 | - //是否展示取消订单倒计时，Y表示展示,N不展示 | ||
| 149 | - "counter_flag":"Y", | ||
| 150 | - // 取消订单倒计时时间，单位：秒 | ||
| 151 | - "pay_lefttime":"6446", | ||
| 152 | - //能否修改订单收货人地址 "Y":能修改 "N"：不能修改 | ||
| 153 | - "can_update_delivery_address": "Y", | ||
| 154 | - "coupons_amount": "-¥0.00", | ||
| 155 | - "create_time": "1458138942", | ||
| 156 | - "delivery_time": "只工作日送货（双休日、节假日不用送）", | ||
| 157 | - "exchange_status": "0", | ||
| 158 | - "express_company": { | ||
| 159 | - "caption": "顺丰", | ||
| 160 | - "is_support": 1, | ||
| 161 | - "logo": "http://static.yohobuy.com/images/v3/express/order_carrier_sf_logo.png", | ||
| 162 | - "url": "http://www.sf-express.com" | ||
| 163 | - }, | ||
| 164 | - "goods_total_amount": "¥690.00", | ||
| 165 | - "is_cancel": "N", | ||
| 166 | - "is_support_exchange": "N", | ||
| 167 | - "is_support_refund": "N", | ||
| 168 | - "mobile": "15950561359", | ||
| 169 | - "order_code": "1519816409", | ||
| 170 | - "order_goods": [ | ||
| 171 | - { | ||
| 172 | - "buy_number": "2", | ||
| 173 | - "cn_alphabet": "5PREVIEWPJBASICTEENvZhuangTaoTouShanJ540_100", | ||
| 174 | - "color_name": "白色", | ||
| 175 | - "expect_arrival_time": "", | ||
| 176 | - "goods_amount": "690.00", | ||
| 177 | - "goods_id": 185491, | ||
| 178 | - "goods_image": "http://img13.static.yhbimg.com/goodsimg/2014/11/27/09/0222a041d7f9c17479a684e9e7e4efeac2.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 179 | - "goods_price": "345.00", | ||
| 180 | - "goods_status": "", | ||
| 181 | - "goods_type": "ordinary", | ||
| 182 | - "product_id": "133109", | ||
| 183 | - "product_name": "5 PREVIEW 人物趣味印花圆领T恤衫 （通用款）", | ||
| 184 | - "product_skn": "51080712", | ||
| 185 | - "product_sku": "51080712", | ||
| 186 | - "size_name": "XXS", | ||
| 187 | - "yoho_give_coin": 0 | ||
| 188 | - } | ||
| 189 | - ], | ||
| 190 | - "order_id": "5529469", | ||
| 191 | - "order_type": "3", | ||
| 192 | - "parent_order_code": "0", | ||
| 193 | - "pay_expire": "2016-03-17 00:35:42", | ||
| 194 | - "payment": "0", | ||
| 195 | - "payment_amount": "690.00", | ||
| 196 | - "payment_name": "", | ||
| 197 | - "payment_status": "Y", | ||
| 198 | - "payment_type": "1", | ||
| 199 | - "phone": "", | ||
| 200 | - "promotion_amount": "-¥0.00", | ||
| 201 | - "refund_status": "0", | ||
| 202 | - "remark": "", | ||
| 203 | - "shipping_cost": "¥0.00", | ||
| 204 | - "status": "6", | ||
| 205 | - "status_str": "交易成功", | ||
| 206 | - "use_limit_code": "N", | ||
| 207 | - "user_confirm_paid": "N", | ||
| 208 | - "user_name": "骆秀春", | ||
| 209 | - // 使用YOHO币价格 | ||
| 210 | - "yoho_coin_num": "-¥9.60", | ||
| 211 | - // 返YOHO币个数 | ||
| 212 | - "yoho_give_coin": 0, | ||
| 213 | - // 是否包含多个包裹 Y:分仓调拨,N:单个包裹 | ||
| 214 | - "is_multi_package": "Y", | ||
| 215 | - // 包裹明细 | ||
| 216 | - "package_list": [ | ||
| 217 | - { | ||
| 218 | - // 供应商编号 | ||
| 219 | - "supplier_id": "0", | ||
| 220 | - // 包裹运费 | ||
| 221 | - "shopping_cost": "2.00", | ||
| 222 | - // 运费优惠 | ||
| 223 | - "shopping_cut_cost": "5", | ||
| 224 | - // 运费原价 | ||
| 225 | - "shopping_orig_cost": "5", | ||
| 226 | - // 包裹中商品 | ||
| 227 | - "goods_list": [ | ||
| 228 | - { | ||
| 229 | - "buy_number": "1", | ||
| 230 | - "goods_image": "http://img10.static.yhbimg.com/goodsimg/2014/06/19/02/0118c2721e4f2219f69539dd389f4bacac.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 231 | - "goods_type": "ordinary", | ||
| 232 | - "product_id": 84230, | ||
| 233 | - "product_name": "004 满版龙纹迷彩七分休闲裤", | ||
| 234 | - "product_skn": "51055461", | ||
| 235 | - "product_skc": "1022222", | ||
| 236 | - "product_sku": "51055461" | ||
| 237 | - } | ||
| 238 | - ] | ||
| 239 | - } | ||
| 240 | - ] | ||
| 241 | - }, | ||
| 242 | - "md5": "93833c6c94b5da93af49f4591a166147", | ||
| 243 | - "message": "OK" | ||
| 244 | -} | ||
| 245 | -``` | ||
| 246 | - | ||
| 247 | - | ||
| 248 | -### 3、取消订单 | ||
| 249 | - | ||
| 250 | -#### 说明 | ||
| 251 | -根据订单号取消订单 | ||
| 252 | -#### 请求参数 | ||
| 253 | -| Param Name | Param Value | Desc| | ||
| 254 | -| :-------- | --------------:|----:| | ||
| 255 | -| method | app.SpaceOrders.close| 请求方法 | | ||
| 256 | -| order_code | 1061003682 | 订单号 | | ||
| 257 | -| reason_id | 1 | 原因id | | ||
| 258 | -| reason | 支付不成功 | 原因描述 | | ||
| 259 | -#### 正常返回结果 | ||
| 260 | -```json | ||
| 261 | -{ | ||
| 262 | -"code":200, | ||
| 263 | -"message":"订单取消成功" | ||
| 264 | -} | ||
| 265 | -``` | ||
| 266 | - | ||
| 267 | -### 5、确认订单 | ||
| 268 | - | ||
| 269 | -#### 说明 | ||
| 270 | -根据订单号确认订单 | ||
| 271 | -#### 请求参数 | ||
| 272 | -| Param Name | Param Value | Desc| | ||
| 273 | -| :-------- | --------------:|----:| | ||
| 274 | -| method | app.SpaceOrders.confirm| 请求方法 | | ||
| 275 | -| order_code | 1061003682 | 订单号 | | ||
| 276 | - | ||
| 277 | -#### 响应内容 | ||
| 278 | -```json | ||
| 279 | -{ | ||
| 280 | -"code":200, | ||
| 281 | -"message":"订单确认成功" | ||
| 282 | -} | ||
| 283 | -``` | ||
| 284 | - | ||
| 285 | - | ||
| 286 | -### 6、获取电子票列表 | ||
| 287 | - | ||
| 288 | - | ||
| 289 | - | ||
| 290 | -#### 说明 | ||
| 291 | -根据订单号获取电子票列表 | ||
| 292 | -#### 请求参数 | ||
| 293 | -| Param Name | Param Value | Desc| | ||
| 294 | -| :-------- | --------------:|----:| | ||
| 295 | -| method | app.SpaceOrders.getQrByOrderCode| 请求方法 | | ||
| 296 | -| order_code | 1061003682 | 订单号 | | ||
| 297 | - | ||
| 298 | -#### 响应内容 | ||
| 299 | -```json | ||
| 300 | -{ | ||
| 301 | - "code": 200, | ||
| 302 | - "data": { | ||
| 303 | - "ticks": [{ | ||
| 304 | - "ticket_code":"8611779901", | ||
| 305 | - "qr_image":"http://img06.static.yhbimg.com/yohood/4063/ticket-8611779901-1-40-1-1.jpg", | ||
| 306 | - "passkit":"Y" | ||
| 307 | - }], | ||
| 308 | - "title": "FURY ANIMALS Normal迷彩系列BUNNY短袖TEE" | ||
| 309 | - }, | ||
| 310 | - "md5": "24aff7ba505dccb63a14b5d78ae22821", | ||
| 311 | - "message": "ok" | ||
| 312 | -} | ||
| 313 | -``` | ||
| 314 | -##### 响应内容描述 | ||
| 315 | -| Param Name | Param Type | Desc | | ||
| 316 | -| ---------- | ---------- | ---- | | ||
| 317 | -| title | string | 商品名称 | | ||
| 318 | -| ticks | json | 电子票 | | ||
| 319 | -| ticket_code| string | 电子票code | | ||
| 320 | -| qr_image | string | 电子票code二维码图片路径 | | ||
| 321 | -| passkit | string | | | ||
| 322 | - | ||
| 323 | -### 7、获取YOHO赠品 | ||
| 324 | - | ||
| 325 | -#### 说明 | ||
| 326 | -根据skn获取yohoGift | ||
| 327 | -#### 请求参数 | ||
| 328 | -| Param Name | Param Value | Desc| | ||
| 329 | -| :-------- | --------------:|----:| | ||
| 330 | -| method | web.Shopping.yohoGift| 请求方法 | | ||
| 331 | -| skn_list | [50001829,50002280]| skn列表 | | ||
| 332 | - | ||
| 333 | -#### 响应内容 | ||
| 334 | -```json | ||
| 335 | - { | ||
| 336 | - "alg": "SALT_MD5", | ||
| 337 | - "code": 200, | ||
| 338 | - "data": | ||
| 339 | - [ | ||
| 340 | - { | ||
| 341 | - "default_pic": "http://img11.static.yhbimg.com/goodsimg/2012/03/02/17/019a0794f1eb1ad77ce5d8a2c2b2cf2e50.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 342 | - "id": 3, | ||
| 343 | - "price": | ||
| 344 | - { | ||
| 345 | - "sales_price": 250, | ||
| 346 | - "yoho_coin_num": 0 | ||
| 347 | - }, | ||
| 348 | - "product_name": "OVERKILL 天使山羊TEE", | ||
| 349 | - "storage": 0, | ||
| 350 | - "storage_list": | ||
| 351 | - [ | ||
| 352 | - { | ||
| 353 | - "erp_sku_id": 102009, | ||
| 354 | - "goods_dimension_id": 201, | ||
| 355 | - "goods_id": 3, | ||
| 356 | - "product_id": 3, | ||
| 357 | - "size": | ||
| 358 | - { | ||
| 359 | - "size_name": "L" | ||
| 360 | - }, | ||
| 361 | - "storage_num": 0 | ||
| 362 | - }, | ||
| 363 | - { | ||
| 364 | - "erp_sku_id": 102010, | ||
| 365 | - "goods_dimension_id": 203, | ||
| 366 | - "goods_id": 3, | ||
| 367 | - "product_id": 3, | ||
| 368 | - "size": | ||
| 369 | - { | ||
| 370 | - "size_name": "M" | ||
| 371 | - }, | ||
| 372 | - "storage_num": 0 | ||
| 373 | - }, | ||
| 374 | - { | ||
| 375 | - "erp_sku_id": 102012, | ||
| 376 | - "goods_dimension_id": 211, | ||
| 377 | - "goods_id": 3, | ||
| 378 | - "product_id": 3, | ||
| 379 | - "size": | ||
| 380 | - { | ||
| 381 | - "size_name": "XL" | ||
| 382 | - }, | ||
| 383 | - "storage_num": 0 | ||
| 384 | - } | ||
| 385 | - ], | ||
| 386 | - "url": "http://www.yohobuy.com/product/pro_3_3/OVERKILL TianShiShanYangTEE.html" | ||
| 387 | - }, | ||
| 388 | - { | ||
| 389 | - "default_pic": "http://img10.static.yhbimg.com/goodsimg/2011/06/23/04/0158a984a768a351328138ea3671e270de.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 390 | - "id": 5, | ||
| 391 | - "price": | ||
| 392 | - { | ||
| 393 | - "sales_price": 138, | ||
| 394 | - "yoho_coin_num": 0 | ||
| 395 | - }, | ||
| 396 | - "product_name": "MANIA TAKI X 圆领印花短袖TEE", | ||
| 397 | - "storage": 0, | ||
| 398 | - "storage_list": | ||
| 399 | - [ | ||
| 400 | - { | ||
| 401 | - "erp_sku_id": 102015, | ||
| 402 | - "goods_dimension_id": 213, | ||
| 403 | - "goods_id": 5, | ||
| 404 | - "product_id": 5, | ||
| 405 | - "size": | ||
| 406 | - { | ||
| 407 | - "size_name": "XS" | ||
| 408 | - }, | ||
| 409 | - "storage_num": 0 | ||
| 410 | - } | ||
| 411 | - ], | ||
| 412 | - "url": "http://www.yohobuy.com/product/pro_5_5/MANIA TAKI X YuanLingYinHuaDuanXiuTEE.html" | ||
| 413 | - } | ||
| 414 | - ], | ||
| 415 | - "md5": "d6e4c90434e98a90555d864cf4798679", | ||
| 416 | - "message": "操作成功" | ||
| 417 | - } | ||
| 418 | -``` | ||
| 419 | - | ||
| 420 | -### 8、购物车列表 | ||
| 421 | - | ||
| 422 | -#### 说明 | ||
| 423 | - | ||
| 424 | -#### 请求参数 | ||
| 425 | -| Param Name | Param Value | Desc| | ||
| 426 | -| :-------- | --------------:|----:| | ||
| 427 | -| method | app.Shopping.cart| 请求方法 | | ||
| 428 | -| shopping_key | 9c101f734768105aafc792d460d12206 | | | ||
| 429 | -| uid | 10166061 | | | ||
| 430 | - | ||
| 431 | -#### 响应内容 | ||
| 432 | -```json | ||
| 433 | -{ | ||
| 434 | - "code": 200, | ||
| 435 | - "data": { | ||
| 436 | - "advance_cart_data": { | ||
| 437 | - "gift_list": [], | ||
| 438 | - "goods_list": [], | ||
| 439 | - "price_gift": [], | ||
| 440 | - "promotion_info": [], | ||
| 441 | - "shopping_cart_data": { | ||
| 442 | - "discount_amount": 0, | ||
| 443 | - "fast_shopping_cost": 0, | ||
| 444 | - "gain_yoho_coin": 0, | ||
| 445 | - "goods_count": 0, | ||
| 446 | - "last_order_amount": 0, | ||
| 447 | - "order_amount": 0, | ||
| 448 | - "promotion_formula": "总计¥0.00=商品金额¥0.00", | ||
| 449 | - "promotion_formula_list": [ | ||
| 450 | - { | ||
| 451 | - "promotion": "商品金额", | ||
| 452 | - "promotion_amount": "¥0.00" | ||
| 453 | - } | ||
| 454 | - ], | ||
| 455 | - "selected_goods_count": 0, | ||
| 456 | - "shipping_cost": 0, | ||
| 457 | - "str_discount_amount": "¥0.00", | ||
| 458 | - "str_order_amount": "¥0.00" | ||
| 459 | - }, | ||
| 460 | - "sold_out_goods_list": [] | ||
| 461 | - }, | ||
| 462 | - "ordinary_cart_data": { | ||
| 463 | - "gift_list": [], | ||
| 464 | - "goods_list": [ | ||
| 465 | - { | ||
| 466 | - "attribute": "1", | ||
| 467 | - "brand_id": "350", | ||
| 468 | - "buy_limit": 0, | ||
| 469 | - "buy_number": "1", | ||
| 470 | - "color_id": "7", | ||
| 471 | - "color_name": "蓝色", | ||
| 472 | - "expect_arrival_time": "", | ||
| 473 | - "fit_promotions": [ | ||
| 474 | - "8579", | ||
| 475 | - "8479", | ||
| 476 | - "8477", | ||
| 477 | - "8475" | ||
| 478 | - ], | ||
| 479 | - "get_yoho_coin": "0", | ||
| 480 | - "goods_id": "404795", | ||
| 481 | - "goods_images": "http://....jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 482 | - "goods_type": "ordinary", | ||
| 483 | - "is_advance": "N", | ||
| 484 | - "is_jit": "N", | ||
| 485 | - "is_limited": "N", | ||
| 486 | - "is_outlets": "N", | ||
| 487 | - "is_special": "N", | ||
| 488 | - "last_price": "319.0", | ||
| 489 | - "last_vip_price": 369, | ||
| 490 | - "market_price": 369, | ||
| 491 | - "max_sort_id": "7", | ||
| 492 | - "middle_sort_id": "49", | ||
| 493 | - "product_id": 314449, | ||
| 494 | - "product_name": "MACROPUS 复古帆布系列 双肩包(男女通用)", | ||
| 495 | - "product_skc": "306652", | ||
| 496 | - "product_skn": "51174830", | ||
| 497 | - "product_sku": "967008", | ||
| 498 | - "promotion_flag": "103", | ||
| 499 | - "promotion_id": "0", | ||
| 500 | - "real_price": 319, | ||
| 501 | - "real_vip_price": 0, | ||
| 502 | - "sale_price": 0, | ||
| 503 | - "sales_price": 369, | ||
| 504 | - "selected": "Y", | ||
| 505 | - "shop_id": 0, | ||
| 506 | - "shopping_cart_goods_id": "94305847", | ||
| 507 | - "shopping_cart_id": "130769237", | ||
| 508 | - "size_id": "199", | ||
| 509 | - "size_name": "F", | ||
| 510 | - "small_sort_id": "152", | ||
| 511 | - "storage_number": "99", | ||
| 512 | - "str_subtotal": "¥369.00", | ||
| 513 | - "subtotal": 369, | ||
| 514 | - "supplier_id": 0, | ||
| 515 | - "uid": "10166061", | ||
| 516 | - "vip1_price": "350.55", | ||
| 517 | - "vip2_price": "332.10", | ||
| 518 | - "vip3_price": "324.72", | ||
| 519 | - "vip_discount": 1, | ||
| 520 | - "vip_discount_money": 0, | ||
| 521 | - "vip_discount_type": "1", | ||
| 522 | - "vip_price": 0, | ||
| 523 | - "yoho_coin_num": "0" | ||
| 524 | - } | ||
| 525 | - ], | ||
| 526 | - "price_gift": [ | ||
| 527 | - { | ||
| 528 | - "gift_price": 39, | ||
| 529 | - "goods_list": [ | ||
| 530 | - { | ||
| 531 | - "goods_images": "http://...jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 532 | - "last_price": 39, | ||
| 533 | - "market_price": 90, | ||
| 534 | - "product_id": 269401, | ||
| 535 | - "product_name": "VOCHIC 欧式多用抗菌艺术砧板", | ||
| 536 | - "product_skn": 51150012, | ||
| 537 | - "sales_price": 49, | ||
| 538 | - "storage_number": 150 | ||
| 539 | - } | ||
| 540 | - ], | ||
| 541 | - "max_select_number": "1", | ||
| 542 | - "promotion_id": 8475, | ||
| 543 | - "promotion_title": "【全场39元加价购】", | ||
| 544 | - "promotion_type": "Needpaygift" | ||
| 545 | - } | ||
| 546 | - ], | ||
| 547 | - "promotion_info": [ | ||
| 548 | - { | ||
| 549 | - "cutdown_amount": 50, | ||
| 550 | - "promotion_id": 8579, | ||
| 551 | - "promotion_title": "【包配随行】满￥299减￥50", | ||
| 552 | - "promotion_type": "Cashreduce" | ||
| 553 | - } | ||
| 554 | - ], | ||
| 555 | - "shopping_cart_data": { | ||
| 556 | - "discount_amount": 50, | ||
| 557 | - "fast_shopping_cost": 15, | ||
| 558 | - "gain_yoho_coin": 0, | ||
| 559 | - "goods_count": 1, | ||
| 560 | - "last_order_amount": 319, | ||
| 561 | - "order_amount": 369, | ||
| 562 | - "promotion_formula": "总计¥319.00=商品金额¥369.00-活动金额¥50.00", | ||
| 563 | - "promotion_formula_list": [ | ||
| 564 | - { | ||
| 565 | - "promotion": "商品金额", | ||
| 566 | - "promotion_amount": "¥369.00" | ||
| 567 | - } | ||
| 568 | - ], | ||
| 569 | - "selected_goods_count": 1, | ||
| 570 | - "shipping_cost": 10, | ||
| 571 | - "str_discount_amount": "¥50.00", | ||
| 572 | - "str_order_amount": "¥369.00" | ||
| 573 | - }, | ||
| 574 | - "sold_out_goods_list": [] | ||
| 575 | - } | ||
| 576 | - }, | ||
| 577 | - "md5": "d222cf08c9d43d0c5f3ab31d278cabd8", | ||
| 578 | - "message": "cart goods list." | ||
| 579 | -} | ||
| 580 | -``` | ||
| 581 | - | ||
| 582 | - | ||
| 583 | -### 9、获取待处理订单总数 | ||
| 584 | - | ||
| 585 | -#### 说明 | ||
| 586 | -根据获取待处理订单总数 | ||
| 587 | -#### 请求参数 | ||
| 588 | -| Param Name | Param Value | Desc | | ||
| 589 | -| ---------- | ----------- | ---- | | ||
| 590 | -| method | web.SpaceOrders.getPendingOrderCount| 请求方法 | | ||
| 591 | -| uid | 5772257 | | | ||
| 592 | - | ||
| 593 | -#### 响应内容 | ||
| 594 | - | ||
| 595 | -```json | ||
| 596 | -{ | ||
| 597 | - "code": 200, | ||
| 598 | - "message": "操作成功" | ||
| 599 | - "data": { | ||
| 600 | - "count": 100 | ||
| 601 | - } | ||
| 602 | -} | ||
| 603 | -``` | ||
| 604 | - | ||
| 605 | -### 10、历史订单列表 | ||
| 606 | - | ||
| 607 | -#### 说明 | ||
| 608 | -获取历史订单列表 | ||
| 609 | -#### 请求参数 | ||
| 610 | -| Param Name | Param Type | Required | Param Value | Desc | | ||
| 611 | -| :-- | --: | --: | --: | --: | | ||
| 612 | -| method | string | true | app.SpaceOrders.history| 请求方法 不可变 | | ||
| 613 | -| uid | int | true | 1 |用户编号 | | ||
| 614 | -| page | int | false | 1 | 页数 | | ||
| 615 | -| limit | int | false | 10 | 每页大小 | | ||
| 616 | - | ||
| 617 | -#### 响应内容 | ||
| 618 | -```json | ||
| 619 | - | ||
| 620 | - | ||
| 621 | - { | ||
| 622 | - "alg": "SALT_MD5", | ||
| 623 | - "code": 200, | ||
| 624 | - "data": | ||
| 625 | - { | ||
| 626 | - "list": | ||
| 627 | - [ | ||
| 628 | - { | ||
| 629 | - "amount": "257.00", | ||
| 630 | - "goods_data": "["\u7070\u8272V\u9886\u706f\u82af\u7ed2\u62fc\u8d34\u9488\u7ec7\u523a\u7ee3LOGO\u5f00\u80f8\u7ebf\u886b","L-HOUSE\u53cc\u9762\u62fc\u63a5\u9ed1\u767d\u671d\u9633\u683c\u56f4\u5dfe"]", | ||
| 631 | - "order_code": "10380864", | ||
| 632 | - "order_time": "1292069832", | ||
| 633 | - "payment": "支付宝" | ||
| 634 | - }, | ||
| 635 | - { | ||
| 636 | - "amount": "237.00", | ||
| 637 | - "goods_data": "["Jasonwood\u5f69\u8272\u978b\u5e26\u5b54\u725b\u4ed4\u4f11\u95f2\u978b"]", | ||
| 638 | - "order_code": "68971578", | ||
| 639 | - "order_time": "1310435462", | ||
| 640 | - "payment": "支付宝" | ||
| 641 | - } | ||
| 642 | - ], | ||
| 643 | - "page": 1, | ||
| 644 | - "total": 2, | ||
| 645 | - "total_page": 1 | ||
| 646 | - }, | ||
| 647 | - "md5": "684313284330ddc5e2951f7e979d5712", | ||
| 648 | - "message": "ok" | ||
| 649 | - } | ||
| 650 | - | ||
| 651 | - | ||
| 652 | -``` | ||
| 653 | -##### 响应内容描述 | ||
| 654 | -| Param Name | Param Type | Desc | | ||
| 655 | -| ---------- | ---------- | ---- | | ||
| 656 | -| page | int | 当前页数 | | ||
| 657 | -| total_page | int | 总页数 | | ||
| 658 | -| total | int | 总记录数 | | ||
| 659 | -| list | json | 订单列表 | | ||
| 660 | -| order_code | string |订单编号 | | ||
| 661 | -| order_time | string |下单时间 | | ||
| 662 | -| amount | string | 订单金额 | | ||
| 663 | -| payment | string | 支付方式 | | ||
| 664 | -| goods_data | string | 订单商品 | | ||
| 665 | - | ||
| 666 | -### 11、取消订单原因列表 | ||
| 667 | - | ||
| 668 | -#### 说明 | ||
| 669 | -根据订单号取消订单 | ||
| 670 | -#### 请求参数 | ||
| 671 | -| Param Name | Param Value | Desc| | ||
| 672 | -| :-------- | --------------:|----:| | ||
| 673 | -| method | app.SpaceOrders.closeReasons| 请求方法 | | ||
| 674 | - | ||
| 675 | - | ||
| 676 | -#### 正常返回结果 | ||
| 677 | -```json | ||
| 678 | -{ | ||
| 679 | - "alg": "SALT_MD5", | ||
| 680 | - "code": 200, | ||
| 681 | - "data": [ | ||
| 682 | - { | ||
| 683 | - "id": "1", | ||
| 684 | - "reason": "支付不成功" | ||
| 685 | - }, | ||
| 686 | - { | ||
| 687 | - "id": "2", | ||
| 688 | - "reason": "现在不想购买" | ||
| 689 | - }, | ||
| 690 | - { | ||
| 691 | - "id": "3", | ||
| 692 | - "reason": "订单价格有问题" | ||
| 693 | - }, | ||
| 694 | - { | ||
| 695 | - "id": "4", | ||
| 696 | - "reason": "修改订单信息" | ||
| 697 | - }, | ||
| 698 | - { | ||
| 699 | - "id": "5", | ||
| 700 | - "reason": "错误或重复下单" | ||
| 701 | - }, | ||
| 702 | - { | ||
| 703 | - "id": "6", | ||
| 704 | - "reason": "忘记使用优惠劵或YOHO币" | ||
| 705 | - }, | ||
| 706 | - { | ||
| 707 | - "id": "7", | ||
| 708 | - "reason": "等待发货时间过长" | ||
| 709 | - }, | ||
| 710 | - { | ||
| 711 | - "id": "8", | ||
| 712 | - "reason": "商品价格较贵" | ||
| 713 | - }, | ||
| 714 | - { | ||
| 715 | - "id": "9", | ||
| 716 | - "reason": "运费过高" | ||
| 717 | - }, | ||
| 718 | - { | ||
| 719 | - "id": "10", | ||
| 720 | - "reason": "其他" | ||
| 721 | - } | ||
| 722 | - ], | ||
| 723 | - "md5": "c5ebf5f9145238ea6bc861b4b3fd895a", | ||
| 724 | - "message": "订单取消原因列表" | ||
| 725 | -} | 1 | +# 订单服务接口 |
| 2 | + | ||
| 3 | +## 1、订单列表 | ||
| 4 | + | ||
| 5 | + | ||
| 6 | +### 接口说明 | ||
| 7 | + | ||
| 8 | +| 接口说明 | 接口说明 | | ||
| 9 | +| :-- | -----: | | ||
| 10 | +| 请求域名 | http://api.yoho.cn/ | | ||
| 11 | +| 接口名 | app.SpaceOrders.get | | ||
| 12 | +| 接口说明 | 获取用户订单列表 | | ||
| 13 | +| http请求方式 | GET/POST | | ||
| 14 | + | ||
| 15 | +### 请求参数 | ||
| 16 | +| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 | | ||
| 17 | +| :-- | :-- | :-- | :-- | :-- | :-- | | ||
| 18 | +| method | string | 是 | app.SpaceOrders.get | | | | ||
| 19 | +| uid | int | 是 | 5772257 | | | | ||
| 20 | +| type | int | 是 | 1 | | 订单类型 1:全部订单,2:待付款,3:待发货,4:待收货,5:待评论/成功订单,7:失败/取消 | | ||
| 21 | +| page | int | 否 | 1 | 1 | 页数 | | ||
| 22 | +| limit | int | 否 | 10 | 10 | 每页大小 | | ||
| 23 | + | ||
| 24 | +### 正常返回结果 | ||
| 25 | +```json | ||
| 26 | +{ | ||
| 27 | + "code": 200, | ||
| 28 | + "data": { | ||
| 29 | + "order_list": [ | ||
| 30 | + { | ||
| 31 | + "id": "5528982", | ||
| 32 | + "order_code": "1519273880", | ||
| 33 | + "parent_order_code": "0", | ||
| 34 | + // 订单类型 1:有货,3:iphone,4:android,5:淘宝,6:h5,7:是换货,9:渠道,20:ipad | ||
| 35 | + "order_type": 1, | ||
| 36 | + // 退货状态（该字段已经废弃了）0:正常订单,1:退货审核中,2:退货审核不通过,3:退货审核通过,4:退货商品寄回,5:退货库房入库,6:财务退款,7:完成 | ||
| 37 | + "refund_status": 0, | ||
| 38 | + "uid": "5772257", | ||
| 39 | + // 创建时间 | ||
| 40 | + "create_time": "1449633428", | ||
| 41 | + // 更新时间 | ||
| 42 | + "update_time": "1449633455", | ||
| 43 | + //是否展示取消订单倒计时，Y表示展示,N不展示 | ||
| 44 | + "counter_flag":"Y", | ||
| 45 | + // 取消订单倒计时时间，单位：秒 | ||
| 46 | + "pay_lefttime":"6446", | ||
| 47 | + // 支付超期时间 | ||
| 48 | + "pay_expire": "2015-12-09 13:57:08", | ||
| 49 | + // 支付方式编号 | ||
| 50 | + "payment": "2", | ||
| 51 | + // 支付状态 Y:已支付,N:未支付 | ||
| 52 | + "payment_status": "Y", | ||
| 53 | + // 支付方式 1:在线支付,2:货到付款,3:现金支付,4:抵消支付 | ||
| 54 | + "payment_type": "1", | ||
| 55 | + "payment_type_str": "在线支付", | ||
| 56 | + // 状态 0:待付款,1-3:待发货,4-5:待收货(0:未付款,1:已付款,2:备货中,3:配货中,4:已发货,5:运输中,6:已完成) | ||
| 57 | + "status": 1, | ||
| 58 | + // 状态名称 | ||
| 59 | + "status_str": "已付款", | ||
| 60 | + "attribute": "5", | ||
| 61 | + // 是否取消 Y:已取消,N:未取消 | ||
| 62 | + "is_cancel": "N", | ||
| 63 | + // 是否评论 Y:已评论,N:未评论 | ||
| 64 | + "is_comment": "N", | ||
| 65 | + // 订单金额 | ||
| 66 | + "amount": "1.00", | ||
| 67 | + // 运费 | ||
| 68 | + "shipping_cost": "0.00", | ||
| 69 | + // 使用限购码 Y:使用,N:未使用 | ||
| 70 | + "use_limit_code": "N", | ||
| 71 | + // 用户确认支付 Y:是,N:否 | ||
| 72 | + "user_confirm_paid": "N", | ||
| 73 | + // 购买商品数量 | ||
| 74 | + "buy_total": 1, | ||
| 75 | + // 购买商品 | ||
| 76 | + "order_goods": [ | ||
| 77 | + { | ||
| 78 | + // 购买商品数量 | ||
| 79 | + "buy_number": 1, | ||
| 80 | + "goods_id": 125106, | ||
| 81 | + // 商品默认图片 | ||
| 82 | + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2014/06/19/02/0118c2721e4f2219f69539dd389f4bacac.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 83 | + // 商品价格 | ||
| 84 | + "goods_price": "1.00", | ||
| 85 | + // 商品类型 ordinary:普通商品 | ||
| 86 | + "goods_type": "ordinary", | ||
| 87 | + // 商品总价格 | ||
| 88 | + "goods_amount": "1.00", | ||
| 89 | + "product_id": 84230, | ||
| 90 | + "product_name": "004 满版龙纹迷彩七分休闲裤", | ||
| 91 | + "cn_alphabet": "004QiFenBuKu004PA095", | ||
| 92 | + "product_skn": 51055461, | ||
| 93 | + // 退货数量 | ||
| 94 | + "refund_num": 0, | ||
| 95 | + // 商品颜色 | ||
| 96 | + "color_name": "彩色", | ||
| 97 | + // 商品尺寸 | ||
| 98 | + "size_name": "M", | ||
| 99 | + // 预期到货时间 | ||
| 100 | + "expect_arrival_time": "" | ||
| 101 | + } | ||
| 102 | + ] | ||
| 103 | + } | ||
| 104 | + ], | ||
| 105 | + "page": 1, | ||
| 106 | + "page_total": 27, | ||
| 107 | + "total": 265 | ||
| 108 | + }, | ||
| 109 | + "message": "ok" | ||
| 110 | +} | ||
| 111 | +``` | ||
| 112 | + | ||
| 113 | +### 2、订单详情 | ||
| 114 | + | ||
| 115 | +### 接口说明 | ||
| 116 | + | ||
| 117 | +| 接口说明 | 接口说明 | | ||
| 118 | +| :-- | -----: | | ||
| 119 | +| 请求域名 | http://api.yoho.cn/ | | ||
| 120 | +| 接口名 | app.SpaceOrders.detail | | ||
| 121 | +| 接口说明 | 订单详情 | | ||
| 122 | +| http请求方式 | GET/POST | | ||
| 123 | + | ||
| 124 | +### 请求参数 | ||
| 125 | +| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 | | ||
| 126 | +| :-- | :-- | :-- | :--| :-- | :-- | | ||
| 127 | +| method | string | 是 | app.SpaceOrders.detail ||| | ||
| 128 | +| uid | int | 是 | 5772257 ||| | ||
| 129 | +| order_code | int | 是 | 1519273880 || 订单号 | | ||
| 130 | + | ||
| 131 | + | ||
| 132 | +#### 正常返回结果 | ||
| 133 | +```json | ||
| 134 | +{ | ||
| 135 | + "alg": "SALT_MD5", | ||
| 136 | + "code": 200, | ||
| 137 | + "data": { | ||
| 138 | + "address": "你那", | ||
| 139 | + "amount": "¥690.00", | ||
| 140 | + "area": "北京市 北京市 东城区 ", | ||
| 141 | + "area_code": "110101", | ||
| 142 | + "attribute": "0", | ||
| 143 | + "can_comment": "Y", | ||
| 144 | + //是否有关联其他订单 "Y":有关联其他订单 "N"：没有关联其他订单 | ||
| 145 | + "relate_order_code": "Y", | ||
| 146 | + // 地址ID | ||
| 147 | + "address_id": 12345, | ||
| 148 | + //是否展示取消订单倒计时，Y表示展示,N不展示 | ||
| 149 | + "counter_flag":"Y", | ||
| 150 | + // 取消订单倒计时时间，单位：秒 | ||
| 151 | + "pay_lefttime":"6446", | ||
| 152 | + //能否修改订单收货人地址 "Y":能修改 "N"：不能修改 | ||
| 153 | + "can_update_delivery_address": "Y", | ||
| 154 | + "coupons_amount": "-¥0.00", | ||
| 155 | + "create_time": "1458138942", | ||
| 156 | + "delivery_time": "只工作日送货（双休日、节假日不用送）", | ||
| 157 | + "exchange_status": "0", | ||
| 158 | + "express_company": { | ||
| 159 | + "caption": "顺丰", | ||
| 160 | + "is_support": 1, | ||
| 161 | + "logo": "http://static.yohobuy.com/images/v3/express/order_carrier_sf_logo.png", | ||
| 162 | + "url": "http://www.sf-express.com" | ||
| 163 | + }, | ||
| 164 | + "goods_total_amount": "¥690.00", | ||
| 165 | + "is_cancel": "N", | ||
| 166 | + "is_support_exchange": "N", | ||
| 167 | + "is_support_refund": "N", | ||
| 168 | + "mobile": "15950561359", | ||
| 169 | + "order_code": "1519816409", | ||
| 170 | + "order_goods": [ | ||
| 171 | + { | ||
| 172 | + "buy_number": "2", | ||
| 173 | + "cn_alphabet": "5PREVIEWPJBASICTEENvZhuangTaoTouShanJ540_100", | ||
| 174 | + "color_name": "白色", | ||
| 175 | + "expect_arrival_time": "", | ||
| 176 | + "goods_amount": "690.00", | ||
| 177 | + "goods_id": 185491, | ||
| 178 | + "goods_image": "http://img13.static.yhbimg.com/goodsimg/2014/11/27/09/0222a041d7f9c17479a684e9e7e4efeac2.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 179 | + "goods_price": "345.00", | ||
| 180 | + "goods_status": "", | ||
| 181 | + "goods_type": "ordinary", | ||
| 182 | + "product_id": "133109", | ||
| 183 | + "product_name": "5 PREVIEW 人物趣味印花圆领T恤衫 （通用款）", | ||
| 184 | + "product_skn": "51080712", | ||
| 185 | + "product_sku": "51080712", | ||
| 186 | + "size_name": "XXS", | ||
| 187 | + "yoho_give_coin": 0 | ||
| 188 | + } | ||
| 189 | + ], | ||
| 190 | + "order_id": "5529469", | ||
| 191 | + "order_type": "3", | ||
| 192 | + "parent_order_code": "0", | ||
| 193 | + "pay_expire": "2016-03-17 00:35:42", | ||
| 194 | + "payment": "0", | ||
| 195 | + "payment_amount": "690.00", | ||
| 196 | + "payment_name": "", | ||
| 197 | + "payment_status": "Y", | ||
| 198 | + "payment_type": "1", | ||
| 199 | + "phone": "", | ||
| 200 | + "promotion_amount": "-¥0.00", | ||
| 201 | + "refund_status": "0", | ||
| 202 | + "remark": "", | ||
| 203 | + "shipping_cost": "¥0.00", | ||
| 204 | + "status": "6", | ||
| 205 | + "status_str": "交易成功", | ||
| 206 | + "use_limit_code": "N", | ||
| 207 | + "user_confirm_paid": "N", | ||
| 208 | + "user_name": "骆秀春", | ||
| 209 | + // 使用YOHO币价格 | ||
| 210 | + "yoho_coin_num": "-¥9.60", | ||
| 211 | + // 返YOHO币个数 | ||
| 212 | + "yoho_give_coin": 0, | ||
| 213 | + // 是否包含多个包裹 Y:分仓调拨,N:单个包裹 | ||
| 214 | + "is_multi_package": "Y", | ||
| 215 | + // 包裹明细 | ||
| 216 | + "package_list": [ | ||
| 217 | + { | ||
| 218 | + // 供应商编号 | ||
| 219 | + "supplier_id": "0", | ||
| 220 | + // 包裹运费 | ||
| 221 | + "shopping_cost": "2.00", | ||
| 222 | + // 运费优惠 | ||
| 223 | + "shopping_cut_cost": "5", | ||
| 224 | + // 运费原价 | ||
| 225 | + "shopping_orig_cost": "5", | ||
| 226 | + // 包裹中商品 | ||
| 227 | + "goods_list": [ | ||
| 228 | + { | ||
| 229 | + "buy_number": "1", | ||
| 230 | + "goods_image": "http://img10.static.yhbimg.com/goodsimg/2014/06/19/02/0118c2721e4f2219f69539dd389f4bacac.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 231 | + "goods_type": "ordinary", | ||
| 232 | + "product_id": 84230, | ||
| 233 | + "product_name": "004 满版龙纹迷彩七分休闲裤", | ||
| 234 | + "product_skn": "51055461", | ||
| 235 | + "product_skc": "1022222", | ||
| 236 | + "product_sku": "51055461" | ||
| 237 | + } | ||
| 238 | + ] | ||
| 239 | + } | ||
| 240 | + ], | ||
| 241 | + "invoice":--发票 | ||
| 242 | + { | ||
| 243 | + "title" ："xxxx", --发票抬头 | ||
| 244 | + "contentValue" : "服饰" , -- 发票内容 | ||
| 245 | + "mobilePhone" : "13888888", --电话 | ||
| 246 | + "pdfUrl" : "https://dl/fp.pdf" --pdf下载地址 | ||
| 247 | + | ||
| 248 | + } | ||
| 249 | + }, | ||
| 250 | + "md5": "93833c6c94b5da93af49f4591a166147", | ||
| 251 | + "message": "OK" | ||
| 252 | +} | ||
| 253 | +``` | ||
| 254 | + | ||
| 255 | + | ||
| 256 | +### 3、取消订单 | ||
| 257 | + | ||
| 258 | +#### 说明 | ||
| 259 | +根据订单号取消订单 | ||
| 260 | +#### 请求参数 | ||
| 261 | +| Param Name | Param Value | Desc| | ||
| 262 | +| :-------- | --------------:|----:| | ||
| 263 | +| method | app.SpaceOrders.close| 请求方法 | | ||
| 264 | +| order_code | 1061003682 | 订单号 | | ||
| 265 | +| reason_id | 1 | 原因id | | ||
| 266 | +| reason | 支付不成功 | 原因描述 | | ||
| 267 | +#### 正常返回结果 | ||
| 268 | +```json | ||
| 269 | +{ | ||
| 270 | +"code":200, | ||
| 271 | +"message":"订单取消成功" | ||
| 272 | +} | ||
| 273 | +``` | ||
| 274 | + | ||
| 275 | +### 5、确认订单 | ||
| 276 | + | ||
| 277 | +#### 说明 | ||
| 278 | +根据订单号确认订单 | ||
| 279 | +#### 请求参数 | ||
| 280 | +| Param Name | Param Value | Desc| | ||
| 281 | +| :-------- | --------------:|----:| | ||
| 282 | +| method | app.SpaceOrders.confirm| 请求方法 | | ||
| 283 | +| order_code | 1061003682 | 订单号 | | ||
| 284 | + | ||
| 285 | +#### 响应内容 | ||
| 286 | +```json | ||
| 287 | +{ | ||
| 288 | +"code":200, | ||
| 289 | +"message":"订单确认成功" | ||
| 290 | +} | ||
| 291 | +``` | ||
| 292 | + | ||
| 293 | + | ||
| 294 | +### 6、获取电子票列表 | ||
| 295 | + | ||
| 296 | + | ||
| 297 | + | ||
| 298 | +#### 说明 | ||
| 299 | +根据订单号获取电子票列表 | ||
| 300 | +#### 请求参数 | ||
| 301 | +| Param Name | Param Value | Desc| | ||
| 302 | +| :-------- | --------------:|----:| | ||
| 303 | +| method | app.SpaceOrders.getQrByOrderCode| 请求方法 | | ||
| 304 | +| order_code | 1061003682 | 订单号 | | ||
| 305 | + | ||
| 306 | +#### 响应内容 | ||
| 307 | +```json | ||
| 308 | +{ | ||
| 309 | + "code": 200, | ||
| 310 | + "data": { | ||
| 311 | + "ticks": [{ | ||
| 312 | + "ticket_code":"8611779901", | ||
| 313 | + "qr_image":"http://img06.static.yhbimg.com/yohood/4063/ticket-8611779901-1-40-1-1.jpg", | ||
| 314 | + "passkit":"Y" | ||
| 315 | + }], | ||
| 316 | + "title": "FURY ANIMALS Normal迷彩系列BUNNY短袖TEE" | ||
| 317 | + }, | ||
| 318 | + "md5": "24aff7ba505dccb63a14b5d78ae22821", | ||
| 319 | + "message": "ok" | ||
| 320 | +} | ||
| 321 | +``` | ||
| 322 | +##### 响应内容描述 | ||
| 323 | +| Param Name | Param Type | Desc | | ||
| 324 | +| ---------- | ---------- | ---- | | ||
| 325 | +| title | string | 商品名称 | | ||
| 326 | +| ticks | json | 电子票 | | ||
| 327 | +| ticket_code| string | 电子票code | | ||
| 328 | +| qr_image | string | 电子票code二维码图片路径 | | ||
| 329 | +| passkit | string | | | ||
| 330 | + | ||
| 331 | +### 7、获取YOHO赠品 | ||
| 332 | + | ||
| 333 | +#### 说明 | ||
| 334 | +根据skn获取yohoGift | ||
| 335 | +#### 请求参数 | ||
| 336 | +| Param Name | Param Value | Desc| | ||
| 337 | +| :-------- | --------------:|----:| | ||
| 338 | +| method | web.Shopping.yohoGift| 请求方法 | | ||
| 339 | +| skn_list | [50001829,50002280]| skn列表 | | ||
| 340 | + | ||
| 341 | +#### 响应内容 | ||
| 342 | +```json | ||
| 343 | + { | ||
| 344 | + "alg": "SALT_MD5", | ||
| 345 | + "code": 200, | ||
| 346 | + "data": | ||
| 347 | + [ | ||
| 348 | + { | ||
| 349 | + "default_pic": "http://img11.static.yhbimg.com/goodsimg/2012/03/02/17/019a0794f1eb1ad77ce5d8a2c2b2cf2e50.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 350 | + "id": 3, | ||
| 351 | + "price": | ||
| 352 | + { | ||
| 353 | + "sales_price": 250, | ||
| 354 | + "yoho_coin_num": 0 | ||
| 355 | + }, | ||
| 356 | + "product_name": "OVERKILL 天使山羊TEE", | ||
| 357 | + "storage": 0, | ||
| 358 | + "storage_list": | ||
| 359 | + [ | ||
| 360 | + { | ||
| 361 | + "erp_sku_id": 102009, | ||
| 362 | + "goods_dimension_id": 201, | ||
| 363 | + "goods_id": 3, | ||
| 364 | + "product_id": 3, | ||
| 365 | + "size": | ||
| 366 | + { | ||
| 367 | + "size_name": "L" | ||
| 368 | + }, | ||
| 369 | + "storage_num": 0 | ||
| 370 | + }, | ||
| 371 | + { | ||
| 372 | + "erp_sku_id": 102010, | ||
| 373 | + "goods_dimension_id": 203, | ||
| 374 | + "goods_id": 3, | ||
| 375 | + "product_id": 3, | ||
| 376 | + "size": | ||
| 377 | + { | ||
| 378 | + "size_name": "M" | ||
| 379 | + }, | ||
| 380 | + "storage_num": 0 | ||
| 381 | + }, | ||
| 382 | + { | ||
| 383 | + "erp_sku_id": 102012, | ||
| 384 | + "goods_dimension_id": 211, | ||
| 385 | + "goods_id": 3, | ||
| 386 | + "product_id": 3, | ||
| 387 | + "size": | ||
| 388 | + { | ||
| 389 | + "size_name": "XL" | ||
| 390 | + }, | ||
| 391 | + "storage_num": 0 | ||
| 392 | + } | ||
| 393 | + ], | ||
| 394 | + "url": "http://www.yohobuy.com/product/pro_3_3/OVERKILL TianShiShanYangTEE.html" | ||
| 395 | + }, | ||
| 396 | + { | ||
| 397 | + "default_pic": "http://img10.static.yhbimg.com/goodsimg/2011/06/23/04/0158a984a768a351328138ea3671e270de.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 398 | + "id": 5, | ||
| 399 | + "price": | ||
| 400 | + { | ||
| 401 | + "sales_price": 138, | ||
| 402 | + "yoho_coin_num": 0 | ||
| 403 | + }, | ||
| 404 | + "product_name": "MANIA TAKI X 圆领印花短袖TEE", | ||
| 405 | + "storage": 0, | ||
| 406 | + "storage_list": | ||
| 407 | + [ | ||
| 408 | + { | ||
| 409 | + "erp_sku_id": 102015, | ||
| 410 | + "goods_dimension_id": 213, | ||
| 411 | + "goods_id": 5, | ||
| 412 | + "product_id": 5, | ||
| 413 | + "size": | ||
| 414 | + { | ||
| 415 | + "size_name": "XS" | ||
| 416 | + }, | ||
| 417 | + "storage_num": 0 | ||
| 418 | + } | ||
| 419 | + ], | ||
| 420 | + "url": "http://www.yohobuy.com/product/pro_5_5/MANIA TAKI X YuanLingYinHuaDuanXiuTEE.html" | ||
| 421 | + } | ||
| 422 | + ], | ||
| 423 | + "md5": "d6e4c90434e98a90555d864cf4798679", | ||
| 424 | + "message": "操作成功" | ||
| 425 | + } | ||
| 426 | +``` | ||
| 427 | + | ||
| 428 | +### 8、购物车列表 | ||
| 429 | + | ||
| 430 | +#### 说明 | ||
| 431 | + | ||
| 432 | +#### 请求参数 | ||
| 433 | +| Param Name | Param Value | Desc| | ||
| 434 | +| :-------- | --------------:|----:| | ||
| 435 | +| method | app.Shopping.cart| 请求方法 | | ||
| 436 | +| shopping_key | 9c101f734768105aafc792d460d12206 | | | ||
| 437 | +| uid | 10166061 | | | ||
| 438 | + | ||
| 439 | +#### 响应内容 | ||
| 440 | +```json | ||
| 441 | +{ | ||
| 442 | + "code": 200, | ||
| 443 | + "data": { | ||
| 444 | + "advance_cart_data": { | ||
| 445 | + "gift_list": [], | ||
| 446 | + "goods_list": [], | ||
| 447 | + "price_gift": [], | ||
| 448 | + "promotion_info": [], | ||
| 449 | + "shopping_cart_data": { | ||
| 450 | + "discount_amount": 0, | ||
| 451 | + "fast_shopping_cost": 0, | ||
| 452 | + "gain_yoho_coin": 0, | ||
| 453 | + "goods_count": 0, | ||
| 454 | + "last_order_amount": 0, | ||
| 455 | + "order_amount": 0, | ||
| 456 | + "promotion_formula": "总计¥0.00=商品金额¥0.00", | ||
| 457 | + "promotion_formula_list": [ | ||
| 458 | + { | ||
| 459 | + "promotion": "商品金额", | ||
| 460 | + "promotion_amount": "¥0.00" | ||
| 461 | + } | ||
| 462 | + ], | ||
| 463 | + "selected_goods_count": 0, | ||
| 464 | + "shipping_cost": 0, | ||
| 465 | + "str_discount_amount": "¥0.00", | ||
| 466 | + "str_order_amount": "¥0.00" | ||
| 467 | + }, | ||
| 468 | + "sold_out_goods_list": [] | ||
| 469 | + }, | ||
| 470 | + "ordinary_cart_data": { | ||
| 471 | + "gift_list": [], | ||
| 472 | + "goods_list": [ | ||
| 473 | + { | ||
| 474 | + "attribute": "1", | ||
| 475 | + "brand_id": "350", | ||
| 476 | + "buy_limit": 0, | ||
| 477 | + "buy_number": "1", | ||
| 478 | + "color_id": "7", | ||
| 479 | + "color_name": "蓝色", | ||
| 480 | + "expect_arrival_time": "", | ||
| 481 | + "fit_promotions": [ | ||
| 482 | + "8579", | ||
| 483 | + "8479", | ||
| 484 | + "8477", | ||
| 485 | + "8475" | ||
| 486 | + ], | ||
| 487 | + "get_yoho_coin": "0", | ||
| 488 | + "goods_id": "404795", | ||
| 489 | + "goods_images": "http://....jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 490 | + "goods_type": "ordinary", | ||
| 491 | + "is_advance": "N", | ||
| 492 | + "is_jit": "N", | ||
| 493 | + "is_limited": "N", | ||
| 494 | + "is_outlets": "N", | ||
| 495 | + "is_special": "N", | ||
| 496 | + "last_price": "319.0", | ||
| 497 | + "last_vip_price": 369, | ||
| 498 | + "market_price": 369, | ||
| 499 | + "max_sort_id": "7", | ||
| 500 | + "middle_sort_id": "49", | ||
| 501 | + "product_id": 314449, | ||
| 502 | + "product_name": "MACROPUS 复古帆布系列 双肩包(男女通用)", | ||
| 503 | + "product_skc": "306652", | ||
| 504 | + "product_skn": "51174830", | ||
| 505 | + "product_sku": "967008", | ||
| 506 | + "promotion_flag": "103", | ||
| 507 | + "promotion_id": "0", | ||
| 508 | + "real_price": 319, | ||
| 509 | + "real_vip_price": 0, | ||
| 510 | + "sale_price": 0, | ||
| 511 | + "sales_price": 369, | ||
| 512 | + "selected": "Y", | ||
| 513 | + "shop_id": 0, | ||
| 514 | + "shopping_cart_goods_id": "94305847", | ||
| 515 | + "shopping_cart_id": "130769237", | ||
| 516 | + "size_id": "199", | ||
| 517 | + "size_name": "F", | ||
| 518 | + "small_sort_id": "152", | ||
| 519 | + "storage_number": "99", | ||
| 520 | + "str_subtotal": "¥369.00", | ||
| 521 | + "subtotal": 369, | ||
| 522 | + "supplier_id": 0, | ||
| 523 | + "uid": "10166061", | ||
| 524 | + "vip1_price": "350.55", | ||
| 525 | + "vip2_price": "332.10", | ||
| 526 | + "vip3_price": "324.72", | ||
| 527 | + "vip_discount": 1, | ||
| 528 | + "vip_discount_money": 0, | ||
| 529 | + "vip_discount_type": "1", | ||
| 530 | + "vip_price": 0, | ||
| 531 | + "yoho_coin_num": "0" | ||
| 532 | + } | ||
| 533 | + ], | ||
| 534 | + "price_gift": [ | ||
| 535 | + { | ||
| 536 | + "gift_price": 39, | ||
| 537 | + "goods_list": [ | ||
| 538 | + { | ||
| 539 | + "goods_images": "http://...jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80", | ||
| 540 | + "last_price": 39, | ||
| 541 | + "market_price": 90, | ||
| 542 | + "product_id": 269401, | ||
| 543 | + "product_name": "VOCHIC 欧式多用抗菌艺术砧板", | ||
| 544 | + "product_skn": 51150012, | ||
| 545 | + "sales_price": 49, | ||
| 546 | + "storage_number": 150 | ||
| 547 | + } | ||
| 548 | + ], | ||
| 549 | + "max_select_number": "1", | ||
| 550 | + "promotion_id": 8475, | ||
| 551 | + "promotion_title": "【全场39元加价购】", | ||
| 552 | + "promotion_type": "Needpaygift" | ||
| 553 | + } | ||
| 554 | + ], | ||
| 555 | + "promotion_info": [ | ||
| 556 | + { | ||
| 557 | + "cutdown_amount": 50, | ||
| 558 | + "promotion_id": 8579, | ||
| 559 | + "promotion_title": "【包配随行】满￥299减￥50", | ||
| 560 | + "promotion_type": "Cashreduce" | ||
| 561 | + } | ||
| 562 | + ], | ||
| 563 | + "shopping_cart_data": { | ||
| 564 | + "discount_amount": 50, | ||
| 565 | + "fast_shopping_cost": 15, | ||
| 566 | + "gain_yoho_coin": 0, | ||
| 567 | + "goods_count": 1, | ||
| 568 | + "last_order_amount": 319, | ||
| 569 | + "order_amount": 369, | ||
| 570 | + "promotion_formula": "总计¥319.00=商品金额¥369.00-活动金额¥50.00", | ||
| 571 | + "promotion_formula_list": [ | ||
| 572 | + { | ||
| 573 | + "promotion": "商品金额", | ||
| 574 | + "promotion_amount": "¥369.00" | ||
| 575 | + } | ||
| 576 | + ], | ||
| 577 | + "selected_goods_count": 1, | ||
| 578 | + "shipping_cost": 10, | ||
| 579 | + "str_discount_amount": "¥50.00", | ||
| 580 | + "str_order_amount": "¥369.00" | ||
| 581 | + }, | ||
| 582 | + "sold_out_goods_list": [] | ||
| 583 | + } | ||
| 584 | + }, | ||
| 585 | + "md5": "d222cf08c9d43d0c5f3ab31d278cabd8", | ||
| 586 | + "message": "cart goods list." | ||
| 587 | +} | ||
| 588 | +``` | ||
| 589 | + | ||
| 590 | + | ||
| 591 | +### 9、获取待处理订单总数 | ||
| 592 | + | ||
| 593 | +#### 说明 | ||
| 594 | +根据获取待处理订单总数 | ||
| 595 | +#### 请求参数 | ||
| 596 | +| Param Name | Param Value | Desc | | ||
| 597 | +| ---------- | ----------- | ---- | | ||
| 598 | +| method | web.SpaceOrders.getPendingOrderCount| 请求方法 | | ||
| 599 | +| uid | 5772257 | | | ||
| 600 | + | ||
| 601 | +#### 响应内容 | ||
| 602 | + | ||
| 603 | +```json | ||
| 604 | +{ | ||
| 605 | + "code": 200, | ||
| 606 | + "message": "操作成功" | ||
| 607 | + "data": { | ||
| 608 | + "count": 100 | ||
| 609 | + } | ||
| 610 | +} | ||
| 611 | +``` | ||
| 612 | + | ||
| 613 | +### 10、历史订单列表 | ||
| 614 | + | ||
| 615 | +#### 说明 | ||
| 616 | +获取历史订单列表 | ||
| 617 | +#### 请求参数 | ||
| 618 | +| Param Name | Param Type | Required | Param Value | Desc | | ||
| 619 | +| :-- | --: | --: | --: | --: | | ||
| 620 | +| method | string | true | app.SpaceOrders.history| 请求方法 不可变 | | ||
| 621 | +| uid | int | true | 1 |用户编号 | | ||
| 622 | +| page | int | false | 1 | 页数 | | ||
| 623 | +| limit | int | false | 10 | 每页大小 | | ||
| 624 | + | ||
| 625 | +#### 响应内容 | ||
| 626 | +```json | ||
| 627 | + | ||
| 628 | + | ||
| 629 | + { | ||
| 630 | + "alg": "SALT_MD5", | ||
| 631 | + "code": 200, | ||
| 632 | + "data": | ||
| 633 | + { | ||
| 634 | + "list": | ||
| 635 | + [ | ||
| 636 | + { | ||
| 637 | + "amount": "257.00", | ||
| 638 | + "goods_data": "["\u7070\u8272V\u9886\u706f\u82af\u7ed2\u62fc\u8d34\u9488\u7ec7\u523a\u7ee3LOGO\u5f00\u80f8\u7ebf\u886b","L-HOUSE\u53cc\u9762\u62fc\u63a5\u9ed1\u767d\u671d\u9633\u683c\u56f4\u5dfe"]", | ||
| 639 | + "order_code": "10380864", | ||
| 640 | + "order_time": "1292069832", | ||
| 641 | + "payment": "支付宝" | ||
| 642 | + }, | ||
| 643 | + { | ||
| 644 | + "amount": "237.00", | ||
| 645 | + "goods_data": "["Jasonwood\u5f69\u8272\u978b\u5e26\u5b54\u725b\u4ed4\u4f11\u95f2\u978b"]", | ||
| 646 | + "order_code": "68971578", | ||
| 647 | + "order_time": "1310435462", | ||
| 648 | + "payment": "支付宝" | ||
| 649 | + } | ||
| 650 | + ], | ||
| 651 | + "page": 1, | ||
| 652 | + "total": 2, | ||
| 653 | + "total_page": 1 | ||
| 654 | + }, | ||
| 655 | + "md5": "684313284330ddc5e2951f7e979d5712", | ||
| 656 | + "message": "ok" | ||
| 657 | + } | ||
| 658 | + | ||
| 659 | + | ||
| 660 | +``` | ||
| 661 | +##### 响应内容描述 | ||
| 662 | +| Param Name | Param Type | Desc | | ||
| 663 | +| ---------- | ---------- | ---- | | ||
| 664 | +| page | int | 当前页数 | | ||
| 665 | +| total_page | int | 总页数 | | ||
| 666 | +| total | int | 总记录数 | | ||
| 667 | +| list | json | 订单列表 | | ||
| 668 | +| order_code | string |订单编号 | | ||
| 669 | +| order_time | string |下单时间 | | ||
| 670 | +| amount | string | 订单金额 | | ||
| 671 | +| payment | string | 支付方式 | | ||
| 672 | +| goods_data | string | 订单商品 | | ||
| 673 | + | ||
| 674 | +### 11、取消订单原因列表 | ||
| 675 | + | ||
| 676 | +#### 说明 | ||
| 677 | +根据订单号取消订单 | ||
| 678 | +#### 请求参数 | ||
| 679 | +| Param Name | Param Value | Desc| | ||
| 680 | +| :-------- | --------------:|----:| | ||
| 681 | +| method | app.SpaceOrders.closeReasons| 请求方法 | | ||
| 682 | + | ||
| 683 | + | ||
| 684 | +#### 正常返回结果 | ||
| 685 | +```json | ||
| 686 | +{ | ||
| 687 | + "alg": "SALT_MD5", | ||
| 688 | + "code": 200, | ||
| 689 | + "data": [ | ||
| 690 | + { | ||
| 691 | + "id": "1", | ||
| 692 | + "reason": "支付不成功" | ||
| 693 | + }, | ||
| 694 | + { | ||
| 695 | + "id": "2", | ||
| 696 | + "reason": "现在不想购买" | ||
| 697 | + }, | ||
| 698 | + { | ||
| 699 | + "id": "3", | ||
| 700 | + "reason": "订单价格有问题" | ||
| 701 | + }, | ||
| 702 | + { | ||
| 703 | + "id": "4", | ||
| 704 | + "reason": "修改订单信息" | ||
| 705 | + }, | ||
| 706 | + { | ||
| 707 | + "id": "5", | ||
| 708 | + "reason": "错误或重复下单" | ||
| 709 | + }, | ||
| 710 | + { | ||
| 711 | + "id": "6", | ||
| 712 | + "reason": "忘记使用优惠劵或YOHO币" | ||
| 713 | + }, | ||
| 714 | + { | ||
| 715 | + "id": "7", | ||
| 716 | + "reason": "等待发货时间过长" | ||
| 717 | + }, | ||
| 718 | + { | ||
| 719 | + "id": "8", | ||
| 720 | + "reason": "商品价格较贵" | ||
| 721 | + }, | ||
| 722 | + { | ||
| 723 | + "id": "9", | ||
| 724 | + "reason": "运费过高" | ||
| 725 | + }, | ||
| 726 | + { | ||
| 727 | + "id": "10", | ||
| 728 | + "reason": "其他" | ||
| 729 | + } | ||
| 730 | + ], | ||
| 731 | + "md5": "c5ebf5f9145238ea6bc861b4b3fd895a", | ||
| 732 | + "message": "订单取消原因列表" | ||
| 733 | +} | ||
| 726 | ``` | 734 | ``` |
-
Please register or login to post a comment