统一接口说明

# 满减活动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是|