# 下单

type：POST

endpoint：/api/tms/order

Header:

Token: 登录系统 API设置里面
1

Request:

{
    "customerRef": "123",
    "channelCode": "XXXX",
    "pickUpType": "DOOR_DELIVERY",
    "pickUpTime": "2023-01-01 00:00:00",
    "pickUpAddress": {
        "address": "广东省深圳市龙岗区坂田街道*****",
        "area": "",
        "city": "",
        "companyName": "",
        "contacts": "张三",
        "countryCode": "CN",
        "house": "",
        "latitude": "",
        "longitude": "",
        "phone": "13153549394",
        "province": "",
        "zipCode": ""
    },
     "consigneeAddress": {
        "contacts": "Gabriela Dominguez",
        "phone": "13423040008",
        "countryCode": "US",
        "state": "CA",
        "city": "SAN JOSE",
        "address": " 2247 Flint Avenue",
        "address2": "",
        "company": "",
        "zipCode": "95148",
        "fbaCode": ""
    },
    "cartonNotes": [
        {
            "length": 61,
            "width": 50,
            "height": 33,
            "weight": 18.85,
            "sameSpecCartons": 2,
            "fbaNumber": "FBA15FGPBC17U000001",
            "referenceId": "ref11111",
            "details": [
                {
                    "asinOrSalesLink": "https://www.baidu.com",
                    "brand": "无",
                    "cargoProperties": "不带磁不带电",
                    "hscod": "3926909090",
                    "pictures": "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",
                    "model": "无",
                    "material": "t",
                    "purpose": "er't",
                    "qty": 100,
                    "skuNameCn": "搓脚器",
                    "skuNameEn": "Foot file",
                    "unitPrice": 1.4,
                    "skuWeight": 8.85
                },
                {
                    "asinOrSalesLink": null,
                    "brand": "无",
                    "cargoProperties": "不带磁不带电",
                    "hscod": "4201000090",
                    "pictures": "",
                    "model": "无",
                    "material": "er",
                    "purpose": "er't",
                    "qty": 10,
                    "skuNameCn": "双手柄狗绳",
                    "skuNameEn": "double handle dog leash",
                    "unitPrice": 2,
                    "skuWeight": 10
                }
            ]
        }
    ],
    "customsClearanceFile": {
      "fileName": "xxx.pdf",
      "file": "iVBORw0KGgoAAAANSUhEUgAAADQAAAAiCAYAAAAQ9/ptAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7D....."
    },
    "warehouseId": 0,
    "fromCity": "",
    "taxType": 0,
    "vatNumber": "",
    "cargoProperties": ""
}
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
参数 类型 长度 是否必填 说明 例子
customerRef String 60 必填 客户订单号
channelCode String 必填 渠道代码（登录系统 API设置 可以查看）
pickUpType String 60 必填 取货类型: DOOR_DELIVERY(上门提货)，DELIVERY_TO_WAREHOUSE(送货到仓)
pickUpTime Date pickUpType为DOOR_DELIVERY时必填 上门取货时间
pickUpAddress pickUpAddress pickUpType为DOOR_DELIVERY时必填 上门取件地址
consigneeAddress consigneeAddress 必填 收件人地址
cartonNotes cartonNotes 必填 装箱单
customsClearanceFile 一般贸易为true时必填 一般贸易报关文件,文件内容，UTF-8编码字节数组
  fileName string 文件名
  file byte[] 文件：UTF-8编码字节数组，base64字符串
warehouseId long pickUpType为DELIVERY_TO_WAREHOUSE时必填 仓库id，通过仓库接口获取
fromCity int 必填 起运城市
taxType int 必填 国内报关方式： 0：买单报关，2：9710，3：9810，4：0110，5：1039 ，6：9610
vatNumber string vat号
cargoProperties string 多个id用逗号分割，例如：1,2,3 接口获取：货物类型查询 /op/tms/channels/goodstype/query-all 1,2,3

pickUpAddress 类型：

参数 类型 长度 是否必填 说明 -
contacts String 60 pickUpType为DOOR_DELIVERY时必填 联系人
phone String 60 pickUpType为DOOR_DELIVERY时必填 联系人电话
province String 60 省
city String 60 市
area String 60 区
house String 60 门牌号
address String 200 pickUpType为DOOR_DELIVERY时必填 详细地址
longitude String 200 经度
latitude String 200 纬度
company String 60 公司
zipCode String 20 邮编
fbaCode String 20 亚马逊仓码

consigneeAddress 类型：

参数 类型 长度 是否必填 说明 -
contacts String 60 必填 收件人
phone String 60 必填 收件人电话
countryCode String 2 必填 国家二位简码
state String 60 必填 省/州
city String 60 必填 城市
address String 200 必填 地址
address2 String 200 地址2
company String 60 公司
zipCode String 20 必填 邮编
fbaCode String 亚马逊仓码

cartonNotes 类型：

参数 类型 长度 是否必填 说明 -
length double 必填 箱子的长
width double 必填 箱子的宽
height double 必填 箱子的高
weight double 必填 箱子的重
sameSpecCartons int 必填 同尺寸重量箱数
fbaNumber String 为fba地址时必填 fba编码,至少为19位以上，例如FBA15FGPBC17U000001， 如果同一箱规多个箱数， 可以用横杠连接，如5箱：FBA15FGPBC17U000001-5
referenceId String 为fba地址时必填 fba追踪编码
details details 必填 箱明细

details 类型：

参数 类型 长度 是否必填 说明 -
skuNameEn String 20 必填 英文名称
skuNameCn String 20 必填 中文名称
qty int 必填 商品数量不能小于1
unitPrice double 必填 单价
hscod String 20 必填 海关编码
brand String 20 必填 品牌
material String 20 必填 材质
origin String 20 产地
unit String 20 必填 单位
model String 20 必填 型号
purpose String 20 必填 用途
cargoProperties String 20 必填 货物属性(4选一): 带电,带磁,带磁带电,不带磁不带电
asinOrSalesLink String 20 asin或销售链接
skuWeight double sku重量
pictures byte[] 必填 商品图片内容,UTF-8编码字节数组

Response:

{
    "success": false,
    "message": "客户订单号[1235467788]重复",
    "data": null
}
1
2
3
4
5
参数 类型 说明
success boolean 成功与否
message String 如果成功了该值为null，如果失败了，就是失败信息
data String 如果成功了就是系统订单号，如果失败了为null
Last Updated: 6/18/2026, 11:03:24 AM

← 取消订单 →