# 下单
type：POST
endpoint：/api/order/create
Head:
User-ID:填您使用用户id
User-Token:联系管理员索要token
1
2
2
Request:
[{
"productId": "B-UPS-GFP-美西",
"customerOrderId": "test2019022618",
"fbaNumber": "",
"shippingDetail": {
"contractName": "jin",
"phone": "32545762222",
"country": "US",
"province": "CT",
"city": "Windsor",
"zipcode": "06095",
"companyName": "",
"addressFirst": "801 Day Hill Rd",
"addressSecond": "",
"fbaWarehouseCode": ""
},
"totalCarton": 1,
"cartonDetails": [{
"customerCartonNumber": "123",
"length": 12,
"width": 12,
"height": 12,
"weight": 12,
"items": [{
"sku": "eqweq",
"nameEn": "",
"nameCn": "",
"qty": 2,
"weight": 2,
"price": 2,
"currency": "USD",
"hscode": "",
"saleLink": "",
"remark": ""
}]
}]
}]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
| 参数 | 类型 | 长度 | 是否必填 | 说明 |
|---|---|---|---|---|
| productId | String | 60 | 必填 | 渠道code |
| customerOrderId | String | 60 | 必填 | 客户单号 |
| fbaNumber | String | 60 | fba号 | |
| shippingDetail | 发货地址对象 | |||
| contractName | String | 60 | 必填 | 联系人 |
| phone | String | 60 | 必填 | ups 渠道10位以上 |
| country | String | 60 | 必填 | 国家 |
| province | String | 60 | 必填 | 省份 |
| city | String | 60 | 必填 | 城市 |
| zipcode | String | 60 | 必填 | 目的地邮编 |
| companyName | String | 60 | 公司名称 | |
| addressFirst | String | 60 | 必填 | 详细地址1 |
| addressSecond | String | 60 | 详细地址2 | |
| fbaWarehouseCode | String | 60 | fba仓码 | |
| totalCarton | int | - | 必填 | 箱数，必须和明细中箱数相等 |
| cartonDetails | [] | 箱明细 | ||
| customerCartonNumber | String | 20 | 客户箱号 | |
| width | double | <9999999.99 | 必填 | 宽(cm) |
| height | double | <9999999.99 | 必填 | 高(cm) |
| weight | double | <9999999.99 | 必填 | 重(kg) |
| length | double | <9999999.99 | 必填 | 长(cm) |
| items | [] | - | 必填 | sku明细 |
| sku | String | 20 | 必填 | sku |
| nameEn | String | 200 | 必填 | sku英文名称 |
| nameCn | String | 200 | 必填 | sku中文名称 |
| qty | int | 必填 | 数量 | |
| currency | String | USD | 必填 | |
| price | double | - | 必填 | sku单价 |
| weight | double | - | 必填 | sku单个净重 |
| hscode | String | - | 海关编码 | |
| remark | String | sku备注 |
Response:
{
"succed": true,
"message": null,
"errors": [
{
"id": "test2019022618",
"msg": "没有找到该渠道B-UPS-GFP-美"
}
],
"succeeds": [
{
"orderId": "ON190226000027",
"referenceId": "test2019022618"
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| 参数 | 类型 | 说明 |
|---|---|---|
| succed | bool | 请求是否成功 |
| message | String | 请求失败信息 |
| cartonNumber | String | 箱号 |
| errors | [] | 下单失败数组 |
| id | String | 下单失败客户单号 |
| msg | String | 下单失败返回信息 |
| succeeds | [] | 下单成功数组 |
| orderId | String | 下单成功 返回的单号 |
| referenceId | String | 客户订单号 |