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 | 理货规则（新增） 1：单件 2：单箱 | |||
| useShipperBoxNo | 使用客户箱号发送海外仓（新增） 1：是 2：否 | |||
| 目的仓信息 | ||||
warehouseCode | 20 | M | 目的仓库代码；收货仓库代码 （可联系管理员） | |
| 发货人信息 | ||||
shipperAddressCode | 100 | O/M？ | 发货地址代码 如果填写了地址代码，则不需要填写发货人的其他信息 （可联系管理员） | |
shipperContactName | 20 | M | 发货人姓名（填写发货地址代码时无需填写） | |
改为shipperCompanyName | 50 | O | 发货人公司名称 | |
shipperPhone | 20 | O/M | 发货人电话（填写发货地址代码时无需填写） | |
shipperEmail | 50 | O | 发货人邮箱（填写发货地址代码时无需填写） | |
| postCode | 20 | O | 发货人邮编（填写发货地址代码时无需填写） | |
country | 2 | O | 发货人国家（二字码，填写发货地址代码时无需填写） 比如CN;US;UK | |
state | 20 | O | 发货人省/州（填写发货地址代码时无需填写） | |
city | 20 | O | 发货人城市（填写发货地址代码时无需填写） | |
district | 20 | O | 发货人区（填写发货地址代码时无需填写） | |
addressLine1 | 50 | O/M | 发货人地址第一行（填写发货地址代码时无需填写） | |
addressLine2 | 100 | O | 发货人地址第二行（填写发货地址代码时无需填写） | |
addressLine3 | 100 | O | 发货人地址第三行（填写发货地址代码时无需填写） | |
| 装箱信息 | ||||
shipperBoxNo | 20 | M | 客户箱号 | |
boxQty | 10 | M | 箱数 | |
declareWeight | (10,3) | M | 箱子申报重量 | |
| declareWeightUnit | M | 申报重量单位 目前只支持KG（新增） | ||
declareLength | (5,1) | M | 箱子申报长度 | |
declareWidth | (5,1) | M | 箱子申报宽度 | |
declareHeight | (5,1) | M | 箱子申报高度 | |
| declareDimensionUnit | 箱子申报尺寸单位 目前只支持CM （新增） | |||
SKU | 20 | M | SKU编码 | |
productQty | 10 | M | （每箱）商品数量 | |
skuRemark | 200 | O | SKU备注 | |
[
{
"shipperAddress": {
"country": "CN",
"postCode": "200210",
"state": "上海市",
"city": "市辖区",
"district": "黄浦区",
"addressLine1": "大连路",
"addressLine2": "900号",
"addressLine3": "20楼"
},
"shipperContactName": "testzhang",
"shipperBizName": "testcompany",
"shipperPhone": "18856789348",
"shipperEmail": "testshipperemail@123.com",
"referenceNo": "test030747",
"warehouseCode": "Australian warehouse",
"shipperWarehouseCode": "",
"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
},
{
"shipperAddress": {
"country": "CN",
"postCode": "200210",
"state": "上海市",
"city": "市辖区",
"district": "黄浦区",
"addressLine1": "大连路",
"addressLine2": "900号",
"addressLine3": "20楼"
},
"shipperContactName": "testzhang",
"shipperBizName": "testcompany",
"shipperPhone": "18856789348",
"shipperEmail": "testshipperemail@123.com",
"referenceNo": "test030748",
"warehouseCode": "Australian warehouse",
"shipperWarehouseCode": "",
"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"
}
],
"remark": "备注",
"useShipperBoxNo": false,
"tallyRule": 1
}
] |
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": ""
}
] |