Changes between Initial Version and Version 1 of app/refund

Timestamp:

01/25/2016 04:06:08 PM (10 years ago)

Author:

wuyuanbo

Comment:

--

app/refund

@@ +1 @@
+[[TOC]]
+
+= 订单 =
+
+== 提交订单 2.3.0有调整==
+
+> 线上：/appIntf/order/createOrder.jsp
+
+**说明**
+
+> 根据商品outerId和用户id生成订单
+
+**提交方式**
+
+> post
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||outerId||商品outerId||string||""||是||
+||addrId||用户地址id||int||0||是||
+||goodOffCode  2.3.0新增||折扣码||string||""||否||
+||common_session_id(cookie参数)||-||string||""||是||
+
+**返回**
+{{{#!java
+result {
+        status: 1,
+        msg: '请求成功',
+        serviceDate: 111111111111111111 //系统时间毫秒数  2.3.0新增
+        data: {
+             orderId:  123456         //订单id
+             orderNo:  "1234567894123"//订单编号     2.3.0新增
+             pastDate: 111111111111111111111, //付款过期时间毫秒数   2.3.0新增
+        }
+}
+价格变动时返回：
+result {
+        status: 12,
+        msg: '所购商品当前价格已上升至' 或 '所购商品当前价格已下降至',
+        curPrice: 100.00
+}
+}}}
+**返回状态**
+
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+||-3||非法请求！||非post请求||
+||-4||验证出错！||签名验证未通过||
+||10||对不起,该商品无效！||商品无效||
+||11||对不起,该商品已无货！||商品无货||
+||12||"所购商品当前价格已上升至" 或 "所购商品当前价格已下降至" ||商品价格有变动。 此状态接口会返回curPrice字段，为商品人民币最新价格。||
+||13||商品无效！||商品后台数据出错||
+||14||请勿重复提交！||重复提交。某些接口有防刷机制，同一个用户两次间隔要在5秒以上||
+||15||收货地址不存在！||根据addrId找不到用户收货地址||
+||16||优惠码不正确！||优惠码不正确,折扣码应为5-20位的字母、数字或组合！||
+
+-------------------
+
+
+
+== 取消订单 ==
+
+> 线上：/appIntf/order/cancelOrder.jsp
+
+**说明**
+
+> 取消用户某个订单  订单状态为未付款（status == 0）或官方未审核（status == 1）的订单才能够取消
+
+**提交方式**
+
+> post
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||orderId||订单id||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+result {
+        status: 1,
+        msg: '请求成功',
+        data: {
+            orderId:123456 //取消订单的id
+        }
+}
+}}}
+
+**返回状态**
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+||-3||非法请求！||非post请求||
+||-4||验证出错！||签名验证未通过||
+||17||订单不存在！||订单不存在或不属于当前登录用户||
+||18||当前的订单状态不支持取消||当前的订单状态不支持取消||
+
+----------------------
+
+
+
+
+
+
+== 确认收货 ==
+
+> 线上：/appIntf/order/confirmReceive.jsp
+
+**说明**
+
+> 将订单状态改为已收货  订单发货后（status == 7）才能以确认收货
+
+**提交方式**
+
+> post
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||orderId||订单id||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+result {
+        status: 1,
+        msg: '请求成功',
+        data: {
+            orderId:123456 //修改的订单id
+        }
+}
+}}}
+
+
+**返回状态**
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+||-3||非法请求！||非post请求||
+||-4||验证出错！||签名验证未通过||
+||19||不能执行该操作，订单未发货！||当前订单未发货用户不能将订单改为发货状态||
+
+-------------------
+
+
+
+
+
+
+
+== 用户订单列表 ==
+
+> 线上：/appIntf/order/orderList.jsp
+
+**说明**
+
+> 登陆用户的订单列表
+
+**提交方式**
+
+> get
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||pageNo||第几页||int||1||是||
+||pageSize||一页的数据量||int||10||是||
+||type||0全部订单；1待付款订单；2待发货订单；3待收货订单；4已完成订单||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+result {
+    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: "美国亚马逊"           //电商名称
+        }
+    ]
+}
+}}}
+
+**返回状态**
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+
+[http://rdtrac.pc.com.cn/pc_best/wiki/app2.2.0/orderStatus 订单状态说明]
+
+---------------------
+
+
+
+
+
+
+
+== 获取待付款订单剩余支付时间 ==
+
+> 线上：/appIntf/order/payDate.jsp
+
+**提交方式**
+
+> get
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||orderId||订单id||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+result {
+    status: 1,
+    msg: '请求成功',
+    data: {
+        pastDate: 111111111111111111111,    //付款过期时间毫秒数
+        serviceDate: 111111111111111111111, //服务器时间毫秒数
+        orderId: 123456
+    }
+}
+}}}
+
+
+**返回状态**
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+||17||订单不存在！||订单不存在或不属于当前登录用户||
+
+-------------------------
+
+
+
+
+
+== 订单详情(wap) ==
+
+> 线上：/appIntf/order/orderDetail.jsp
+
+**提交方式**
+
+> get
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||orderId||订单id||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+打开页面
+}}}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+== 订单详情（json） 2.3.0新增 ==
+
+> 线上：/appIntf/order/orderInfo.jsp
+
+**说明**
+
+> 返回订单数据
+
+**提交方式**
+
+> get
+
+**是否需要登录**
+
+> true
+
+**缓存方式**
+
+> 无
+
+**缓存时间**
+
+> 无
+
+**参数**
+
+||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
+||orderId||订单id||int||0||是||
+||common_session_id(cookie参数)||-||string||""||是||
+
+
+**返回**
+{{{#!java
+result {
+    status: 1,
+    msg: '请求成功',
+    serviceDate: 111111111111111111111111, //系统时间
+    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: "美国亚马逊"           //电商名称
+         }
+}
+}}}
+
+**返回状态**
+||1||请求成功||请求成功||
+||-1||请求失败||后台数据操作错误||
+||-2||未登录||未登录||
+||-3||非法请求！||非post请求||
+||17||订单不存在！||订单不存在或不属于当前登录用户||
+--------