[[TOC]]

= 订单 =

== 提交订单 ==

> 线上：/appIntf/order/createOrder.jsp

**说明**

> 根据商品outerId和用户id生成订单

**提交方式**

> post

**是否需要登录**

> true

**缓存方式**

> 无

**缓存时间**

> 无

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||outerId||商品outerId||string||""||是||
||addrId||用户地址id||int||0||是||
||common_session_id(cookie参数)||-||string||""||是||

**返回**
{{{#!java
result {
        status: 1,
	msg: '请求成功',
	data: {
             orderId:  123456//订单id
        }
}
}}}
**返回状态**

||1||请求成功||请求成功||
||-1||请求失败||后台数据操作错误||
||-2||未登录||未登录||
||-3||非法请求！||非post请求||
||-4||验证出错！||签名验证未通过||
||10||对不起,该商品无效！||商品无效||
||11||对不起,该商品已无货！||商品无货||
||12||商品价格有变化，请重新核对！商品实时价格:xx||商品价格有变动||
||13||商品无效！||商品后台数据出错||
||14||请勿重复提交！||重复提交。某些接口有防刷机制，同一个用户两次间隔要在5秒以上||
||15||收货地址不存在！||根据addrId找不到用户收货地址||
||16||折扣码不正确！||折扣码不正确||

-------------------



== 取消订单 ==

> 线上：/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: "2015-11-11 11:11:10"
    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,                       //订单状态
           pastDate: "2015-11-11 11:11:11", //付款过期时间
           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: "2015-11-11 11:11:11",    //付款过期时间
        serviceDate: "2015-11-11 11:11:10", //服务器时间
        orderId: 123456
    }
}
}}}


**返回状态**
||1||请求成功||请求成功||
||-1||请求失败||后台数据操作错误||
||-2||未登录||未登录||
||17||订单不存在！||订单不存在或不属于当前登录用户||

-------------------------





== 订单详情 ==

> 线上：/appIntf/order/orderDetail.jsp

**提交方式**

> get

**是否需要登录**

> true

**缓存方式**

> 无

**缓存时间**

> 无

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||orderId||订单id||int||0||是||
||common_session_id(cookie参数)||-||string||""||是||


**返回**
{{{#!java
打开页面
}}}