统一接口说明
# 满减活动v1.0统一接口说明
服务器地址:
测试机:10.60.1.150:8081
启按本地 :10.60.1.226
测试账号:另外提供
------
前端实现说明:
【商城页面】 领券模块和临取页面 略
【确认订单页面】 第一次进去是系统自动计算最优的方式给前端,前端可自主选择,自主选择的条件是满减券or普通券+折扣只能二选一,即选择了满减券之后折扣变为0元,普通券和折扣叠加,折扣要临时保留起来。
------
表A-统一接口说明
| 编号 | 作用 | 老接口 | 新接口 | 方式 | 传参 | 反参 |
| :--: | :-----------: | :------------------: | :--------------------------: | :--: | :---------------------: | ----- |
| 1 | 【满减活动】领券模块 是否存在 | 无 | cCoupon/activityCouponStatus | GET | 无 | res.data 0否1是 |
| 2 | 领券模块 列表 | 无| cCoupon/activityCoupons | GET | 无 | 看表C |
| 3 | 临取优惠券 | 无 | cCoupon/getCouponType/{id} | GET | id是couponType的id | res.data 1成功 (接口校验) |
| 4 | 【确认订单】页面 | cShopCart/cShopCartsOfOrder | 无 | GET | 请求参数不变 | 看表C |
| 5 | 【购物车】快捷领取的标语 | 无 | cCoupon/quickCollectionStr | GET |无 | res.data 有数据则显示 看表B |
| 6 | 【立即购买】页面 | cProduct/cGetProductById | | GET |参考之前 | 返回参数请看4 基本一致 |
| 7 | 【商城】一键领取优惠券状态 | cCoupon/getCouponsOnceStatus | | GET |无| res.data 0否1是|
| 8 | 【商城】一键临取优惠券 | cCoupon/getCouponsOnce | | GET |无 | res.data 1成功 |
| 9 | 首页一键领券弹窗图片 | 无 | cCoupon/couponsOnceCarousel | GET |无 | data.imageUrl |
| 10 | 商城 领券中心 图片 | 无 | cCoupon/couponCenterCarousel | GET |无 | data.imageUrl |
------
表B-传参说明(无)
| 编号 | 说明 | 举例 |
| :--: | --------------------------------------------------------- | ------------------------------------------------------------ |
| 4 | addressId地址id,salesOrderId销售单id,shops是提交的哥哥商品和商品数对应的shop集合,每个shop含productId 商品id,count商品数, salesOrderLineId对应的销售明细id | {"addressId":1,"salesOrderId":11987,"shops":[{"count":2,"productId":39,"salesOrderLineId":11785},{"count":6,"productId":38,"salesOrderLineId":11786}]}
| 5 | |正常展示{"data":"满3000减500 满2000减300 满1000减150 满500减50","message":"","status":200} 不正常展示{"data":null,"message":"","status":200} |
表C-反参说明
| 编号 | 说明 | 举例 |
| :--: | --------------------------------------------------------- | ------------------------------------------------------------ |
| 2 | res.date返回的是couponType的集合 | |
| 4 | 在res.data 中 couponsUse 优惠券能否使用使用 0否1是
shopCarts 购物车 fullDiscountStatus满减状态 0否1是 finalDisMoney 最终折扣金额 finalCouMoney最终优惠金额 selectedCouId选择的优惠券id -1无 sumBuyGoodsMoney换购产品总价 sumMainMoney主商品的价格(门槛) sumWeight总重量|
| 3 | res.data 是销售单SalesOrder对象, 预定商品总数(totalOrderProductCount) 和 预定商品已提总数(totalPickUpProductCount) ,其中salesOrderLines是这个销售单的明细集合,每个明细都含产品,已提数量(pickUpCount) 和总共可提数量(productCount) | 1
| 5 | 返回的是stockMove的集合,每个stockmove的状态 0草稿 1待发货 2已发货 3已退回 4已取消 | |
------
表couponType- 优惠券模板
|字段|名称|举例|
|-|-|-|
|id|ID|唯一标识|
|money|金额||
|minMoney|消费门槛|即满xxx元使用|
|couType|类型|0普通券 1满减券|
|beginTime|有效期-开始时间||
|expireTime|有效期-结束时间||
|receivable|是否可领取|0否1是|