创建多渠道订单

请求参数

Header 参数

X-Site-Tenant

string

必需

渠道租户：

US_SPT：美国多渠道，时区：America/Los_Angeles

CA_SPT：加拿大多渠道，时区：America/Vancouver

DE_SPT：德国多渠道，时区：Europe/Berlin

GB_SPT：英国多渠道，时区：Europe/London

FR_SPT：法国多渠道，时区：Europe/Paris

IT_SPT：英国多渠道，时区：Europe/Rome

ES_SPT：法国多渠道，时区：Europe/Madrid

Body 参数application/json

order_type

string

订单类型

必需

MO：一件代发

FBA: FBA

storage_code

string

始发仓仓code

必需

print_label_way

string

打单方式

必需

spt: Spotter打单,无需客户提供面单。当前仅支持US_SPT站点

self: 自供面单

sign_service

string

是否需要收件人签收服务,默认不需要

可选

1 是

0 否

plt_order_name

string

销售订单号

必需

支持5~64位数字或大小写字母或"#"或"-"且不能包含空格

>= 5 字符<= 64 字符

frd

integer

期望提货日期

必需

时间戳(毫秒),会自动抹除小时部分

trans_type

string

运输模式

必需

SP 小包裹

LTL 货运

creator_name

string

创建人

可选

order_remark

string

订单备注

可选

不能超过100个字符

<= 100 字符

tracking_num_list

array[string]

运输追踪单号

可选

print_label_way=self 时必填

carrier

string

运输商编码,参考业务说明-运输商编码列表

可选

print_label_way=self 时必填

dest_address

object

可选

contact_name

string

联系人

必需

tel

string

手机号,默认9999999999

可选

仅支持10位数字或"-"

string

邮箱

可选

country

string

国家,填写国家二字码

必需

province

string

州/省.全称或简称

必需

city

string

城市.全称或简称

必需

zip

string

邮编

必需

address1

string

地址1

必需

address2

string

地址2

可选

address3

string

地址3

可选

save_as_common

string

是否保存为常用地址

可选

保存常用地址可在sevc创建订单时,快速选取地址

1-是

product_list

array [object {4}]

产品列表

必需

ssku

string

spotter sku

必需

inner_pack

integer

装箱数量

必需

单件为1,整箱根据实际箱规设置

box_num

integer

箱数

必需

总件数=inner_pack*box_num

change_pro_label_flag

string

是否需要换标

可选

是否需要换标。MO可不填写,FBA必填。

1 是

0 否

attach_list

array [object {2}]

附件列表

可选

print_label_way=self时,必须上传attachShippingLabelBol.

任意产品change_pro_label_flag=1时,需要上传产品标

其他场景根据具体业务场景上传。

type

string

附件类型

必需

attachShippingLabel: 自提面单

attachBol: BOL

attachBoxLabel: 箱标

attachProductLabel: 产品标

attachPalletLabel: 托盘标

attachProLabel: Pro Label

otherLabels: 其它附件

url

string

能直接访问的url地址

必需

示例

{
  "order_type": "string",
  "storage_code": "string",
  "print_label_way": "string",
  "sign_service": "string",
  "plt_order_name": "string",
  "frd": 0,
  "trans_type": "string",
  "creator_name": "string",
  "order_remark": "string",
  "tracking_num_list": [
    "string"
  ],
  "carrier": "string",
  "dest_address": {
    "contact_name": "string",
    "tel": "string",
    "email": "string",
    "country": "string",
    "province": "string",
    "city": "string",
    "zip": "string",
    "address1": "string",
    "address2": "string",
    "address3": "string",
    "save_as_common": "string"
  },
  "product_list": [
    {
      "ssku": "string",
      "inner_pack": 0,
      "box_num": 0,
      "change_pro_label_flag": "string"
    }
  ],
  "attach_list": [
    {
      "type": "string",
      "url": "string"
    }
  ]
}

返回响应

🟢200成功

application/json

Body

code

integer

响应码

必需

0-成功

msg

string

响应信息

必需

resp_data

object

可选

shortage_ssku_list

array[string]

库存不足的ssku列表

可选

success

boolean

是否创建成功

必需

idempotent

string

是否触发幂等

必需

true-订单已存在,直接幂等返回

error_code

string

业务错误码

可选

异常时填写

error_msg

string

业务错误信息

可选

异常时填写

spt_no

string

spotter订单号

必需

示例

{
  "code": 0,
  "msg": "string",
  "resp_data": {
    "shortage_ssku_list": [
      "string"
    ]
  },
  "success": true,
  "idempotent": "string",
  "error_code": "string",
  "error_msg": "string",
  "spt_no": "string"
}