礼品卡

wujiexiang
Commit fad9864a285b754068e123c204dae7524e491dc1 1 parent 79f74b65
Showing 2 changed files with 86 additions and 0 deletions
订单/shopping.md
订单/立即购买.md
--- a/订单/shopping.md
View file @fad9864
+++ b/订单/shopping.md
View file @fad9864
@@ -360,6 +360,7 @@ code为200即为成功，否则是失败。
 |use_red_envelopes|double|否|1.00||使用的红包，单位元|
 |coupon_code|string|是|b123456||优惠券code,多个用","分割|
 |promotion_code|string|是|1345abc||优惠码code|
+|gift_card_code|string|是|YH123456||礼品卡code|
 |product_sku_list|string|是|[{'type':'limitcode','sku':307502,'limitproductcode':'2016030711453248','buy_number':1,'skn':51001888}]||购买限购商品|
 ### 响应
@@ -390,6 +391,11 @@ code为200即为成功，否则是失败。
 		"discount_amount": 0,
 		"fast_shopping_cost": 5,
 		"gain_yoho_coin": 0,
+		"gift_card": { //礼品卡信息
+			"amount": 19.9,//礼品卡金额
+			"code": "YH123456",//卡code
+			"count": 1 //礼品卡使用数量
+		},
 		"goods_count": 4,
 		"last_order_amount": 340,
 		"order_amount": 335,
@@ -773,6 +779,9 @@ code为200即为成功，否则是失败。
 |is_print_price|string|否|"Y"|"N"|是否打印|
 |is_continue_buy|string|否|"N"|"Y"|是否继续结算|
 | qhy_union	| String| 否  |  ||联盟参数,json格式,app没有|
+|gift_card_code|string|是|YH123456||礼品卡code|
+
+
 ### qhy_union入参
 ``` json
 {
@@ -825,6 +834,7 @@ code为200即为成功，否则是失败。
 |product_sku_list|string|否||||
 |client_type|string|否|iphone|iphone|哪一端|
 |activity_id|int|是|0|1222|套餐购买，必须有值;限购不需要该值|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ###### product_sku_list参数
 | 业务类型 | 举例 |
@@ -860,6 +870,7 @@ code为200即为成功，否则是失败。
 |is_print_price|string|否|"Y"|"N"|是否打印|
 | qhy_union	| String| 否  |  ||联盟参数,json格式,app没有|
 |activity_id|int|是|0|1222|套餐购买，必须有值;限购不需要该值|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ###### product_sku_list参数
 | 业务类型 | 举例 |
@@ -904,6 +915,59 @@ code为200即为成功，否则是失败。
 }
 ```
+## 12、获取用户可用的礼品卡张数 ##
+####  说明
+获取用户可用的礼品卡张数（app.Shopping.countUsableGiftCard）
+#### 请求参数
+| 参数名称 | 参数类型 |  可否为空 | 示例 | 默认值 | 备注 | 
+|:-------| -----:|-----:|-----:|-----:|----:| 
+|uid|int|否|3236556|0|用户id|
+|delivery_way|int|否|1||发货方式(1:普通,2顺丰)|
+
+### 请求示例
+http://192.168.102.205:8080/gateway?method=app.Shopping.countUsableGiftcard&uid=8041834&delivery_way=1&debug=XYZ
+### 响应
+code为200即为成功，否则是失败。 
+响应JSON格式如下所示:
+
+```json
+{
+	"alg":"SALT_MD5",
+	"code":200,
+	"data":{"count":5},
+	"md5":"c1d725306fb09dcbf504776d276521cb",
+	"message":"ok"
+}
+```
+## 13、获取用户可用列表 ##
+####  说明
+获取用户优惠券列表，可用和不可用（app.Shopping.listGiftCard）
+#### 请求参数
+| 参数名称 | 参数类型 |  可否为空 | 示例 | 默认值 | 备注 | 
+|:-------| -----:|-----:|-----:|-----:|----:| 
+|uid|int|否|3236556|0|用户id|
+|delivery_way|int|否|1|2|发货方式(1:普通,2顺丰)|
+### 响应
+code为200即为成功，否则是失败。 
+响应JSON格式如下所示:
+```json
+{
+    "alg": "SALT_MD5",
+    "code": 200,
+    "data": {
+        "usable_giftCards":[
+            {
+                "code": "YH123456", //卡号
+                "validity": "2013.11.01-2017.01.31",//有效期
+                "value": "55" //面值
+				"balance": "55" //余额
+            }
+        ]
+    },
+    "md5": "c1d725306fb09dcbf504776d276521cb",
+    "message": "ok"
+}
+```
--- a/订单/立即购买.md
View file @fad9864
+++ b/订单/立即购买.md
View file @fad9864
@@ -328,6 +328,8 @@ code为200即为成功，否则是失败。
 |yoho_bill_term|int|是|0||30天不分期 - 1 分期：3、6、9、12;0，不使用|
 |client_type|string|否|web|iphone|终端,可选值: web,iphone,android,miniapp,...|
 |activity_id|string|否|40|0|秒杀活动id必传|
+|gift_card_code|string|是|YH123456||礼品卡code|
+
 ### 响应
 POST
@@ -358,6 +360,11 @@ code为200即为成功，否则是失败。
 		"discount_amount": 0,
 		"fast_shopping_cost": 5,
 		"gain_yoho_coin": 0,
+		"gift_card": { //礼品卡信息
+			"amount": 19.9,//礼品卡金额
+			"code": "YH123456",//卡code
+			"count": 1 //礼品卡使用数量
+		},
 		"goods_count": 4,
 		"last_order_amount": 340,
 		"order_amount": 335,
@@ -464,6 +471,7 @@ code为200即为成功，否则是失败。
 |promotion_code|string|是|1345abc||优惠码code|
 |client_type|string|否|web|iphone|终端,可选值: web,iphone,android,miniapp,...|
 |activity_id|string|否|40|0|秒杀活动id必传|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ### 响应
 POST
@@ -879,6 +887,7 @@ code为200即为成功，否则是失败。
 |yoho_bill_term|int|是|0||30天不分期 - 1 分期：3、6、9、12;0，不使用|
 |client_type|string|否|web|iphone|终端|
 |activity_id|string|否|40|0|秒杀活动id必传|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ### 响应
 POST
@@ -909,6 +918,11 @@ code为200即为成功，否则是失败。
 		"discount_amount": 0,
 		"fast_shopping_cost": 5,
 		"gain_yoho_coin": 0,
+		"gift_card": { //礼品卡信息
+			"amount": 19.9,//礼品卡金额
+			"code": "YH123456",//卡code
+			"count": 1 //礼品卡使用数量
+		},
 		"goods_count": 4,
 		"last_order_amount": 340,
 		"order_amount": 335,
@@ -1015,6 +1029,7 @@ code为200即为成功，否则是失败。
 |promotion_code|string|是|1345abc||优惠码code|
 |client_type|string|否|web|iphone|终端|
 |activity_id|string|否|40|0|秒杀活动id必传|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ### 响应
 POST
@@ -1280,6 +1295,7 @@ code为200即为成功，否则是失败。
 |coupon_code|string|是|b123456||优惠券code|
 |promotion_code|string|是|1345abc||优惠码code|
 |client_type|string|否|miniapp|miniapp|miniapp 小程序|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ### 响应
 POST
@@ -1310,6 +1326,11 @@ code为200即为成功，否则是失败。
 		"discount_amount": 0,
 		"fast_shopping_cost": 5,
 		"gain_yoho_coin": 0,
+		"gift_card": { //礼品卡信息
+			"amount": 19.9,//礼品卡金额
+			"code": "YH123456",//卡code
+			"count": 1 //礼品卡使用数量
+		},
 		"goods_count": 4,
 		"last_order_amount": 340,
 		"order_amount": 335,
@@ -1408,6 +1429,7 @@ code为200即为成功，否则是失败。
 |coupon_code|string|是|""|""|优惠券码|
 |promotion_code|string|是|1345abc||优惠码code|
 |client_type|string|否|miniapp|miniapp|miniapp 小程序|
+|gift_card_code|string|是|YH123456||礼品卡code|
 ### 响应
 POST