declare
描述
在系统中创建一个备货订单（入库单）
路径
HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2b/po |
请求头样例
POST /api/supplier-service/v1/b2b/po HTTP/1.1 Host: http://cfs-qa.etowertech.com/ Content-Type: application/json |
字段
字段名 | 数据类型 | 最大长度 | 必填性 | 描述 |
|---|---|---|---|---|
| 入库单信息 | ||||
referenceNo | 50 | M | 订单唯一标识；客户入库单号 | |
| tallyRule | M | 理货规则：1：单件；2：单箱 | ||
| useShipperBoxNo | M | 使用客户箱号发送海外仓：1：是；2：否 | ||
| shippedDate | Date | O | 发出时间 | |
| eta | Date | O | 预计到达时间 | |
| 目的仓信息 | ||||
warehouseCode | 20 | M | 目的仓库代码 | |
| 发货人信息 | ||||
shipperWarehouseCode | 100 | O | 发货地址代码：填写了发货地址代码，则无需填写发货人的其他信息 | |
shipperContactName | 20 | M | 发货人姓名（填写发货地址代码时无需填写） | |
shipperBizName | 50 | O | 发货人公司名称（填写发货地址代码时无需填写） | |
shipperPhone | 20 | M | 发货人电话（填写发货地址代码时无需填写） | |
shipperEmail | 50 | O | 发货人邮箱（填写发货地址代码时无需填写） | |
| postCode | 20 | O | 发货人邮编（填写发货地址代码时无需填写） | |
country | 2 | M | 发货人国家二字码（填写发货地址代码时无需填写） | |
state | 20 | O | 发货人省/州（填写发货地址代码时无需填写） | |
city | 20 | O | 发货人城市（填写发货地址代码时无需填写） | |
district | 20 | O | 发货人区（填写发货地址代码时无需填写） | |
addressLine1 | 50 | M | 发货人地址第一行（填写发货地址代码时无需填写） | |
addressLine2 | 100 | O | 发货人地址第二行（填写发货地址代码时无需填写） | |
addressLine3 | 100 | O | 发货人地址第三行（填写发货地址代码时无需填写） | |
| 装箱信息 | ||||
boxNo | 20 | M | 客户箱号 | |
boxQty | 10 | M | 箱数 | |
weightDeclared | (10,3) | M | 箱子申报重量 | |
declaredWeightUnit | M | 申报重量单位：目前只支持KG | ||
lengthDeclared | (5,1) | M | 箱子申报长度 | |
widthDeclared | (5,1) | M | 箱子申报宽度 | |
heightDeclared | (5,1) | M | 箱子申报高度 | |
| declareDimensionUnit | M | 箱子申报尺寸单位：目前只支持CM | ||
SKU | 20 | M | SKU编码 | |
productQty | 10 | M | 商品数量（每箱） | |
remark | 200 | O | SKU备注 | |
请求样例
[{
"remark": "备注",
"useShipperBoxNo": false,
"tallyRule": 1,
"shipperContactName": "testzhang",
"shipperBizName": "testcompany",
"shipperPhone": "18856789348",
"shipperEmail": "testshipperemail@123.com",
"referenceNo": "test030747",
"warehouseCode": "Australian warehouse",
"shipperWarehouseCode": "",
"shippedDate": "2023-06-22 00:00:00",
"eta": "2023-06-26 00:00:00",
"shipperAddress": {
"country": "CN",
"postCode": "200210",
"state": "上海市",
"city": "市辖区",
"district": "黄浦区",
"addressLine1": "大连路",
"addressLine2": "900号",
"addressLine3": "20楼"
},
"packingDetails": [{
"boxNo": 1,
"lengthDeclared": 100.0,
"heightDeclared": 100.0,
"widthDeclared": 100.0,
"weightDeclared": 100.0,
"boxQty": 1,
"sku": "TESTcommodity",
"productQty": 20,
"remark": "",
"declaredWeightUnit": "KG",
"declareDimensionUnit": "CM"
},
{
"boxNo": 2,
"lengthDeclared": 100.0,
"heightDeclared": 100.0,
"widthDeclared": 100.0,
"weightDeclared": 100.0,
"boxQty": 1,
"sku": "SKG",
"productQty": 20,
"remark": "",
"declaredWeightUnit": "KG",
"declareDimensionUnit": "CM"
}
]
},
{
"remark": "备注",
"useShipperBoxNo": false,
"tallyRule": 1,
"shipperContactName": "testzhang",
"shipperBizName": "testcompany",
"shipperPhone": "18856789348",
"shipperEmail": "testshipperemail@123.com",
"referenceNo": "test030748",
"warehouseCode": "Australian warehouse",
"shipperWarehouseCode": "",
"shippedDate": "2023-06-22 00:00:00",
"eta": "2023-06-26 00:00:00",
"shipperAddress": {
"country": "CN",
"postCode": "200210",
"state": "上海市",
"city": "市辖区",
"district": "黄浦区",
"addressLine1": "大连路",
"addressLine2": "900号",
"addressLine3": "20楼"
},
"packingDetails": [{
"boxNo": 1,
"lengthDeclared": 100.0,
"heightDeclared": 100.0,
"widthDeclared": 100.0,
"weightDeclared": 100.0,
"boxQty": 1,
"sku": "TESTcommodity",
"productQty": 20,
"remark": "",
"declaredWeightUnit": "KG",
"declareDimensionUnit": "CM"
},
{
"boxNo": 2,
"lengthDeclared": 100.0,
"heightDeclared": 100.0,
"widthDeclared": 100.0,
"weightDeclared": 100.0,
"boxQty": 1,
"sku": "SKG",
"productQty": 20,
"remark": "",
"declaredWeightUnit": "KG",
"declareDimensionUnit": "CM"
},
{
"boxNo": 2,
"lengthDeclared": 100.0,
"heightDeclared": 100.0,
"widthDeclared": 100.0,
"weightDeclared": 100.0,
"boxQty": 1,
"sku": "electric fan",
"productQty": 20,
"remark": "",
"declaredWeightUnit": "KG",
"declareDimensionUnit": "CM"
}
]
}
]
返回样例
orderNo | 返回值 | 系统订单号 |
code | - | 返回编码 |
errors | - | 报错 |
message | - | 返回信息 |
messageId | - | 返回信息编码 |
success | - | 成功响应 |
warnList | - | 废弃字段 |
[
{
"code": "0",
"data": {
"orderNo": "E12283230308000009O",
"referenceNo": "test030747"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
},
{
"code": "0",
"data": {
"orderNo": "E12283230308000010O",
"referenceNo": "test030748"
},
"errors": "",
"message": "",
"messageId": "",
"success": true,
"warnList": ""
}
]
[
{
"code": "0005",
"data": {
"orderIndex": 1,
"referenceNo": "test030747"
},
"errors": [
{
"code": "600904",
"message": "referenceNo:test030747,Already exists in the system"
}
],
"message": "paramter error",
"messageId": "",
"success": false,
"warnList": ""
},
{
"code": "0005",
"data": {
"orderIndex": 2,
"referenceNo": "test030748"
},
"errors": [
{
"code": "600904",
"message": "referenceNo:test030748,Already exists in the system"
}
],
"message": "paramter error",
"messageId": "",
"success": false,
"warnList": ""
}
]