描述
在系统中创建一个备货订单（入库单）
路径
HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2b/po |
请求头样例
POST /api/supplier-service/v1/b2b/po 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= |
字段
字段名 | 数据类型 | 最大长度 | 必填性 | 描述 |
|---|---|---|---|---|
| 入库单信息 | ||||
referenceNo | 50 | M | 订单唯一标识；客户入库单号 | |
| remark | 入库单备注（新增） | |||
| 目的仓信息 | ||||
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 | 发货人地址第三行（填写发货地址代码时无需填写） | |
| 装箱信息 | ||||
| tallyRule | M | 理货规则（新增） 单件 单箱 | ||
| useShipperBoxNo | O | 使用客户箱号发送海外仓（新增） 是 否 | ||
shipperBoxNo | 20 | M | 客户箱号 | |
| warehouseBoxNo | 仓库箱号（新增） | |||
boxQty | (5,1) | M | 箱数 | |
declaredWeight | (10,3) | M | 箱子申报重量 | |
| declaredWeightUnit | M | 申报重量单位 目前只支持KG（新增） | ||
declareLength | (5,1) | M | 箱子申报长度 | |
declareWidth | (5,1) | M | 箱子申报宽度 | |
declareHeight | (5,1) | M | 箱子申报高度 | |
| decareDimensionUnit | 箱子申报尺寸单位 目前只支持CM （新增） | |||
SKU | 20 | M | SKU编码 | |
productQty | 10 | M | （每箱）商品数量 | |
skuRemark | 100 | O | SKU备注 | |
请求样例
[ { "shipperAddress": { "country": "CN", "postCode": "", "state": "上海市", "city": "市辖区", "district": "黄浦区", "addressLine1": "中国", "addressLine2": "上海市", "addressLine3": "黄浦区" }, "shipperContactName": "testzhang", "shipperBizName": "", "shipperPhone": "18856789348", "shipperEmail": "", "referenceNo": "CA-0001", "warehouseCode": "Canada Warehouse", "shipperWarehouseCode": "cnzhang", "packingDetails": [ { "boxNo": "1", "lengthDeclared": 20.00, "heightDeclared": 20.00, "widthDeclared": 20.00, "weightDeclared": 20.00, "boxQty": 1, "sku": "deli1498603", "productQty": 20, "remark": "" } ] } ] |
返回样例
orderNo | 返回值 | 系统订单号 |
code | - | 返回编码 |
errors | - | 报错 |
message | - | 返回信息 |
messageId | - | 返回信息编码 |
success | - | 成功响应 |
warnList | - | 废弃字段 |
[ { "code": "0", "data": { "orderNo": "E12283221114000007O", "referenceNo": "CA-0008" }, "errors": "", "message": "", "messageId": "", "success": true, "warnList": "" } ] |
[ { "code": "0005", "data": "", "errors": [ { "code": "600904", "message": "referenceNo:CA-0001,Already exists in the system" } ], "message": "paramter error", "messageId": "", "success": false, "warnList": "" } ] |