创建订单
# 创建订单
### 请求地址
| HTTP Method | Path |
| :- | :- |
| POST | /api/v1/trade|
### 请求参数
无
### 请求Body
| 参数名称 | 类型 | 必填 | 描述 |
| :- | :-| :- | :- |
| goodsId | int | 是 | 产品id |
| skuId | int | 是 | 产品sku id |
| num | int | 是 | 购买数量 |
| buyerName | string | 是 | 联系人 |
| buyerPhone | string | 是 | 联系电话 |
| buyerEmail | string | 否 | 联系邮箱 |
| buyerMessage | string | 否 | 下单备注 |
| travellerInfo | *TravellerInfo* | 是 | 出行人信息 |
| channelTid | string | 是 | 商户订单编号 |
*TravellerInfo*
| 参数名称 | 类型 | 必填 | 描述 |
| :- | :-| :- | :- |
| num | int | 是 | 数量 |
| useDate | string | 否 | 入住日期/使用日期 yyyy-MM-dd |
| returnDate | string | 否 | 离店日期/回程日期 yyyy-MM-dd |
| travellers | *Traveller*[] | 否 | 出行人列表 |
*Traveller*
| 参数名称 | 类型 | 必填 | 描述 |
| :- | :-| :- | :- |
| name | string | 是 | 出行人姓名 |
| phone| string | 是 | 出行人手机号 |
| credentialType | int | 否 | 证件类型 0-身份证 1-护照 2-学生证 3-军官证 4-回乡证 5-台胞证 6-港澳通行证 10-警官证 11-士兵证 12-台湾通行证 |
| credentialNo | string | 否 | 证件号 |
### 响应Body，Data部分
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| tradeNo | string | 交易编号 |
| tradeOrders | *TradeOrder*[] | 订单列表 |
| totalPrice | decimal | 商品合计金额 |
| expressFee| decimal | 快递费用 |
| payment | decimal | 实付金额 |
*TradeOrder*
| 参数名称 | 类型 | 描述 |
| :- | :-| :- |
| goodsId | int | 产品id |
| skuId | int | 产品skuId |
| goodsName | string | 产品名称 |
| skuName | string | sku名称 |
| price | decimal | 单价 |
| num | int | 购买数量 |
### 业务错误码
| Error Code | HTTP Status Code | Error Message |
| :- | :-| :- | :-|
| SkuNotExist | 400 | 产品SKU不存在 |
| SkuUnderstock | 400 | 库存不足 |
| SkuOutOfServiceTime | 400 | 产品不在售卖时间内 |
| TradeNeedTrvellers | 400 | 需要提供出行人信息 |
| TradeNeedTrveller | 400 | 至少需要提供一位出行人 |
| TradeNeedIDCard | 400 | 需要提供出行人身份证 |
| TradeCreateFiled | 400 | 交易创建失败 |
### 请求示例
``` http
POST http://test.openapi.huitravel.com/api/v1/trade HTTP/1.1
accessKeyId: 7568512625
signatureNonce: 0.6764230582287643
timestamp: 2020-11-27T09:42:05Z
signature: 45d46e387a893eb99dd038aaebef26aa7ad44b78
Accept-Encoding: gzip, deflate
Content-Type: application/json
Content-Length: 334
{
"goodsId": 51,
"skuId": 98,
"num": 1,
"buyerName": "test",
"buyerPhone": "12345678",
"buyerEmail": "",
"buyerMessage": "test order",
"travellerInfo": {
"num": 1,
"useDate": "2020-11-28",
"returnDate": "2020-11-28",
"travellers": [{
"name": "test",
"phone": "12345678",
"credentialType": 0,
"credentialNo": ""
}
],
"deliverType": 0
}
}
```
``` json
HTTP/1.1 200 OK
{
"requestId": "d02f9ae8-e4fa-465d-b8f9-fa6462bbb49a",
"data": {
"tradeNo": "T201127174211628",
"tradeOrders": [{
"goodsId": 51,
"skuId": 98,
"goodsName": "澄江抚仙湖样样好生态农庄",
"skuName": "澄江抚仙湖样样好生态农庄1号",
"price": 0.01,
"num": 1
}
],
"totalPrice": 0.0,
"payment": 0.0
}
}
```