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

Accept: application/json

X-WallTech-Date: Thu, 06 Aug 2020 06:01:26 GMT

Authorization: WallTech testLvs2jdug2qIoRsJyuxs:2THPh5_j4OTYUGdinstTC4nYqDE=

字段

字段名	最大长度	必填性	描述
入库单信息
referenceNo	50	M	订单唯一标识；客户入库单号
~~remark~~			~~入库单备注（新增~~）作废
tallyRule			理货规则（新增） 1：单件 2：单箱
useShipperBoxNo			使用客户箱号发送海外仓（新增） 1：是 2：否
目的仓信息
warehouseCode	20	M	目的仓库代码；收货仓库代码（可联系管理员）
发货人信息
~~shipperWarehouseCode~~ shipperAddressCode	100	O/M？	发货地址代码如果填写了地址代码，则不需要填写发货人的其他信息（可联系管理员）
shipperContactName	20	M	发货人姓名（填写发货地址代码时无需填写）
~~shipperBizName~~ 改为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	发货人地址第三行（填写发货地址代码时无需填写）
装箱信息
~~boxNo~~ shipperBoxNo	20	M	客户箱号
~~warehouseBoxNo~~			~~仓库箱号（新增）~~
boxQty	10	M	箱数
~~weightDeclared~~ declareWeight	(10,3)	M	箱子申报重量
declareWeightUnit		M	申报重量单位目前只支持KG（新增）
~~lengthDeclared~~ declareLength	(5,1)	M	箱子申报长度
~~widthDeclared~~ declareWidth	(5,1)	M	箱子申报宽度
~~heightDeclared~~ declareHeight	(5,1)	M	箱子申报高度
declareDimensionUnit			箱子申报尺寸单位目前只支持CM （新增）
SKU	20	M	SKU编码
productQty	10	M	（每箱）商品数量
~~Remark~~ 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": ""
    }
]

页面树结构

3.创建入库单

描述

路径

请求头样例

字段

请求样例

返回样例