转至元数据结尾
转至元数据起始

正在查看旧版本。 查看 当前版本.

与当前比较 查看页面历史

« 前一个 版本 3 下一个 »

描述

创建头程大包订单

路径

HTTP VerbURL
POST

/api/supplier-service/v1/b2b/createOrder


请求头样例


POST  /services/shipper/orders  HTTP/1.1
Host: cfs-qa.etowertech.com
Content-Type: application/json
Accept: application/json
X-WallTech-Date: Thu, 06 Aug 2020 06:01:26 GMT
Authorization: WallTech testLvs2jdug2qIoRsJyuxs:2THPh5_j4OTYUGdinstTC4nYqDE=

字段

字段

数据类型

长度

必填性

描述

shipperId


10

M

订单所属发货人

channelCode


64

M

服务渠道代码

inspectionWarehouse


100

O

揽收仓地址代码

collectionType


1

M

揽收方式

1-自送到仓

2-上门揽收

referenceNo


50

M

客户订单参考号

platformOrderNumber


50

O

平台参考号

isCommercialInspection


Boolean

O

是否商检

true=是

false=否

不传值时默认为否

insuranceType


1

M

投保类型

0=无

1=保签收

2=保上架

不填写时默认为无

insuranceAmount


(8,2)

C

保险金额

非负数,小数点后两位

当投保类型不等于1时必填

insuranceCurrency


8

C

保险币种

当投保类型不等于1时必填

isBattery


Boolean

O

是否带电

true=是

false=否

不传值时默认为否

isMagnet


Boolean

O

是否带磁

true=是

false=否

不传值时默认为否

remark


255

O

备注

collectionDate


yyyy-MM-dd

C

揽收日期

当揽收方式为上门揽收时必填

精确到日

shipperContactName


512

C

揽收联系人

当揽收方式为上门揽收时必填

shipperPhone


50

C

电话

shipperAddress


 

 

揽收地址容器

shipperAddress.country


10

C

国家/地区

当揽收方式为上门揽收时必填

接口填写国家二字代码

shipperAddress.state


64

O

省/州

shipperAddress.city


64

C

城市

当揽收方式为上门揽收时必填

shipperAddress.postCode


64

O

邮编

shipperAddress.addressLine1


512

C

地址第一行

当揽收方式为上门揽收时必填

shipperAddress.addressLine2


512

O

地址第二行

useWarehouseCode


Boolean

M

是否使用地址簿数据

接口中填写”true,false“

overseasWarehouseType


1

M

海外仓类型

1=其他地址

2=FBA仓

warehouseCode


255

C

FBA仓库编码(FBA下单)/地址代码(其他下单)

当海外仓类型为FBA仓时必填

consigneeName


512

O

收件人姓名

consigneeBizName


512

O

收件人公司

consigneePhone


50

O

电话

consigneeEmail


512

O

邮箱

consigneeAddress


 

 

揽收地址容器

consigneeAddress.country


10

C

国家/地区

填写国家二字代码

当不使用地址簿数据时必填

consigneeAddress.state


64

O

省/州

consigneeAddress.city


64

C

城市

当不使用地址簿数据时必填

consigneeAddress.postCode


64

O

邮编

consigneeAddress.addressLine1


512

C

地址第一行

当不适用地址簿数据时必填

consigneeAddress.addressLine2


512

O

地址第二行

boxList


 

 

箱数据容器

boxNo


128

M

箱序号

boxQty


6

M

箱数

必须填写正整数

weightDeclared


(8,3)

M

单箱毛重(KG)

正数

限制小数点后三位

lengthDeclared


(8,2)

M

单箱长(CM)

正数

限制小数点后两位

widthDeclared


(8,2)

M

单箱宽(CM)

正数

限制小数点后两位

heightDeclared


(8,2)

M

单箱高(CM)

正数

限制小数点后两位

amazonInternalCode


200

O

FBA ID

amazonStoreShipmentCode


200

O

PO Number

subOrderNo


32

O

子单号

remark


255

O

箱子备注

productList


 

 

商品容器

boxNo


128

M

箱序号

必须与材积中传输的箱序号由同样值

sku


128

M

SKU编码

hscode


64

O

海关编码

skuNameEn


255

O

品名(英文)

productMaterial


128

O

材质(英文)

productUsage


128

O

用途(英文)

brand


50

O

品牌(英文)


exportUnitValue

M

(10,2)

申报单价

正数

限制小数点后三位

productQty

M

(11,0)

正整数

url

O

4000

销售链接

model

O

128

型号

image

O

Base64

图片

amazonInternalCode

O

200

PO Number

amazonStoreShipmentCode

O

200

FBA ID


请求样例

{
    "overseasWarehouseType":"2",
    "type":1,
    "isEdit":false,
    "inspectionWarehouse":"沪东揽收仓",
    "collectionType":2,
    "customsClearanceType":"0",
    "shipperId":12283,
    "platformOrderNumber":"1",
    "referenceNo":"Test",
    "etd":"2022-10-05",
    "insuranceType":"0",
    "insuranceCurrency":"USD",
    "insuranceAmount":0,
    "isTaxRefund":true,
    "isCommercialInspection":true,
    "isBattery":true,
    "isMagnet":true,
    "declareValue":"",
    "channelCode": "test001",
    "remark":"1",
    "useShipperWarehouseCode":false,
    "shipperWarehouseCode":"",
    "shipperContactName":"openapi",
    "shipperPhone":"15000695273",
    "collectionDate":"2022-10-27",
    "shipperAddress":{
        "country":"CN",
        "postCode":"postcode",
        "state":"上海",
        "city":"上海市",
        "district":"杨浦区",
        "addressLine1":"line1",
        "addressLine2":"line2",
        "addressLine3":"",
        "collectionDate":"2022-10-27"
    },
    "warehouseCode":"abcfbaccc",
    "useWarehouseCode":true,
    "consigneeName":"shouname",
    "consigneePhone":"15000695273",
    "consigneeBizName":"alex",
    "consigneeEmail":"shouemail",
    "consigneeAddress":{
        "country":"CN",
        "postCode":"shoupost",
        "state":"北京",
        "city":"北京市",
        "district":"西城区",
        "addressLine1":"addline1",
        "addressLine2":""
    },
    "attachments":[
 
    ],
    "boxList":[
        {
            "boxNo":"box1",
            "weightDeclared":"1",
            "lengthDeclared":"2",
            "widthDeclared":"3",
            "heightDeclared":"4",
            "declareData":"",
            "boxQty":"5",
            "amazonInternalCode":"6",
            "subOrderNo":"7",
            "amazonStoreShipmentCode":"8",
            "remark":"9"
        }
    ],
    "productList":[
        {
            "boxNo":"box1",
            "sku":"sku1",
            "hscode":"300",
            "image":"",
            "exportUnitValue":"100",
            "skuNameEn":"pinmingEN",
            "productQty":"200",
            "skuNameLocal":"pinmingZH",
            "brand":"pinpai",
            "model":"xinghao",
            "productMaterial":"caizhi",
            "productUsage":"yongtu",
            "exportUnitValueCurrency":"USD",
            "url":"http://bai",
            "amazonStoreShipmentCode":"ponumber",
            "amazonInternalCode":"fbaid"
        }
    ]
}


返回样例

{
	"code":"0",
	"data":{
	},
	"errors":"",
	"message":"",
	"messageId":"",
	"success":true,
	"warnList":""
}


{
	"code":"600224",
	"data":"",
	"errors":"",
	"message":"Client Reference No are duplicate",
	"messageId":"",
	"success":false,
	"warnList":""
}



  • 无标签