Changes between Version 2 and Version 3 of price_api_2.4.0

Timestamp:

01/29/2016 10:17:16 AM (10 years ago)

Author:

oujianqiang

Comment:

--

price_api_2.4.0

@@ -35 +35 @@
 
 }}}
+
+
+== 二.接口列表 ==
+
+
+
+== 1 订单管理 ==
+=== 1.1订单列表（M） ===
+'''（未完成）'''[[BR]]
+需求
+{{{
+每个订单新增赔付id字段refundId。
+}}}
+
+**mrobot接口**
+
+> http://mrobot.pconline.com.cn/s/best/buy/orderList.xsp?type=0&pageNo=1&pageSize=10
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/order/orderList.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#用户订单列表 用户订单列表]
+
+**说明**
+
+> 请求用户的订单列表
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| pageNo || 第几页 || int || 1 || 是 ||  ||
+|| pageSize || 一页的数据量 || int || 10 || 是 ||  ||
+|| type || 0全部订单；1待付款订单；2待发货订单；3待收货订单；4已完成订单 || int || 0 || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+  
+    pageNo: 1,
+    pageSize: 10,
+    total: 20,
+    pageTotal: 2,
+    serviceDate: 111111111111111111 //系统时间毫秒数
+    data: [
+        {
+           orderId: 123456,           //订单id
+           orderNo: "20151111123321", //订单编号
+           enName: "ECCO Men's Dress Moccasin Penny Loafer",        //商品标题
+           property: "Size: 42 M EU / 8-8.5 D(M) US|Color: Black",  //商品参数 有些商品没有参数  此项为""
+           imgUrl: "xxx.xxxx...",           //商品图片
+           cnPrice: 123.00,                 //人民币单价
+           frPrice: 20.00,                  //美元单价
+           itemCnPrice: 123.00              //商品总价  单价*数量
+           tariffAmountprice: 120.00,       //关税
+           expAmountprice: 123.00,          //运费
+           amountPrice: 100000.00,          //订单总价
+           status: 1,                       //订单状态
+           statusDesc: "已取消",            //订单状态描述
+           pastDate: 111111111111111111111, //付款过期时间毫秒数
+           quantity: 1,                     //商品数量
+           mallId: 123,                     //电商id
+           mallName: "美国亚马逊"           //电商名称
+           refundId: 0                      //0未申请赔付  不为0则标示已申请赔付的ID   2.4.0新增
+        }
+    ]
+}
+}}}
+
+
+----------
+
+
+=== 1.2 订单详情wap页（M） ===
+'''（未完成）'''[[BR]]
+需求
+
+{{{
+正文内容增加：
+1、增加订单关闭的时间信息；
+2、增加关闭订单的原因说明；
+3、如果订单申请了赔付，则增加跳转赔付详情入口（操作协议：pcaction://see-compensateDetail?orderId={orderId}&refundId={refundId}    ）；
+}}}
+
+
+**mrobot接口**
+
+> http://mrobot.pconline.com.cn/x/best-best/buy/appIntf/order/orderDetail.jsp?orderId=1504
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/order/orderDetail.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/order#订单详情 订单详情]
+
+**说明**
+
+> 订单详情
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单id || int || 0 || 是 || ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+||v||版本号||int||0||否||2.2.0版本传v=2.2.0||
+
+**返回格式**
+> html
+
+**返回数据**
+
+html页面
+
+
+----------
+
+
+
+== 2 赔付 ==
+=== 2.1赔付列表（M） ===
+'''（未完成）'''[[BR]]
+需求：新接口[[BR]]
+
+**mrobot接口**
+
+> 待补充
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/refund/refundList.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app/refund#赔付列表 赔付列表]
+
+**说明**
+
+> 请求用户的赔付列表
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| pageNo || 第几页 || int || 1 || 是 ||  ||
+|| pageSize || 一页的数据量 || int || 10 || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+  
+    pageNo: 1,
+    pageSize: 10,
+    total: 20,
+    pageTotal: 2,
+    serviceDate: 111111111111111111 //系统时间毫秒数
+    data: [
+        {
+           orderId:  123456             //订单id
+           refundId:  123456            //赔付id 
+           refundNo: 1482817            //赔付编号
+           status: '1'                  //赔付状态
+           imgUrl: "xxx.xxxx...",           //商品图片
+           enName: 'ECCO Men's Dress Moccasin Penny Loafer'       //商品标题
+           property: "Size: 42 M EU / 8-8.5 D(M) US|Color: Black" //商品参数
+        }
+    ]
+}
+}}}
+
+
+----------
+
+
+=== 2.2 申请赔付 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> 无
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/refund/submitRefund.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app/refund#提交赔付申请 提交赔付申请]
+
+**说明**
+
+> 提交赔付申请
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> POST
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单outerId || int || "" || 是 ||  ||
+|| causeType || 赔付原因 || int || "" || 是 ||  ||
+|| cause || 赔付说明 || string || "" || 是 ||  ||
+|| proofs || 凭证图片，多张图片用","隔开 || string || "" || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+}
+}}}
+
+
+----------
+
+
+=== 2.3 取消赔付申请 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> 无
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/refund/refundList.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app/refund#取消赔付申请 取消赔付申请]
+
+**说明**
+
+> 取消赔付申请
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> POST
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单outerId || int || "" || 是 ||  ||
+|| refundId || 赔付申请id || int || "" || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+}
+}}}
+
+
+----------
+
+
+=== 2.4 赔付详情 ===
+[[BR]]
+**需求：**[[BR]]
+1、新接口；[[BR]]
+
+**mrobot接口**
+
+> 无
+
+**后端接口**
+
+> http://best.pconline.com.cn/buy/appIntf/refund/getRefund.jsp
+
+**后端接口文档**
+
+> [http://rdtrac.pc.com.cn/pc_best/wiki/app/refund#获取赔付详情 获取赔付详情]
+
+**说明**
+
+> 获取赔付详情
+
+**缓存时间**
+
+> 无
+
+**提交方式**
+
+> GET
+
+**是否需要登录**
+
+> 是
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =||
+|| orderId || 订单outerId || int || "" || 是 ||  ||
+|| refundId || 赔付申请id || int || "" || 是 ||  ||
+|| common_session_id(cookie参数) || 登录sessionId || string || "" || 是 ||  ||
+
+**返回格式**
+> json
+
+**返回数据**
+
+{{{#!java
+{
+  status: 1,
+  msg: "请求成功"
+  data: {
+           refundId:123456,              //赔付申请id
+           orderId:123456                //订单的id
+           refundNo: "1111111111"        //赔付编号
+           causeType: 1，                //退款类型
+           causeTypeDesc: "商品损坏"     //退款类型描述
+           status: 1,                    //状态
+           statusDesc: "待审核"          //状态描述
+           createAt: 11111111111111      //申请提交时间
+        }
+}
+}}}
+
+
+----------