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
20O发货人邮编（填写发货地址代码时无需填写）

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": "test030742",
"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"
}
],
"remark": "备注",
"useShipperBoxNo": false,
"tallyRule": 1
}
]


返回样例





orderNo

返回值

系统订单号

code

-

返回编码

errors

-

报错

message

-

返回信息

messageId

-

返回信息编码

success

-

成功响应

warnList

-

废弃字段


[
    {
        "code": "0",
        "data": {
            "orderNo": "E12283230308000004O",
            "referenceNo": "test030742"
        },
        "errors": "",
        "message": "",
        "messageId": "",
        "success": true,
        "warnList": ""
    }
]


[
    {
        "code": "0005",
        "data": {
            "orderIndex": 1,
            "referenceNo": "test030742"
        },
        "errors": [
            {
                "code": "600904",
                "message": "referenceNo:test030742,Already exists in the system"
            }
        ],
        "message": "paramter error",
        "messageId": "",
        "success": false,
        "warnList": ""
    }
]