接口说明

更新箱单信息支持有箱单信息和无箱单信息的入库单，更新方式：覆盖更新

有箱单入库：仅支持“已下单”状态的海外仓入库单更新箱单信息
无箱单入库：
1. 订单未到仓之前且没有预约单，或订单未到仓前且预约单没有预约成功过，可更改商品信息planMerchandiseList或入库增值服务valueAddedService
2. 订单已上架前，都可以新增识别码（已扫描到的识别码不可以删除）orderIdentificationCodeList

每个模块可单独更新，若传入的更新模块有任一不可更新，则本次更新失败

接口名称

winit.wh.inbound.order.updatepackinglist

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，1000有需要可申请加大。

请求入参

有箱单入库

名称	类型	必填	说明	示例
orderNo	String(30)	Y	入库单号	W0100001
packageList	Array	Y	箱单信息
–\|isAutoBoxStorage	String(30)	N	已弃用是否使用自动组箱存储增值服务 Y-是；N-否；默认不使用入参Y后，仅满足下述条件时，才会自动按箱产品存储： 1、包裹内为单一产品 2、包裹等级为A或A+包裹 3、使用海外验入库 4、万邑通仓库确认包裹满足SKU包裹级库存标准
–\|sellerCaseNo	String(20)	Y	卖家箱号(自定义箱号)
–\|thirdPartyCaseNo	String(50)	N	自定义包裹编号（第三方箱号）注意：贴在实物包裹上的非Winit箱号，需全局唯一性，保证海外仓可扫描识别。
–\|sellerWeight	Numberic(10,4)	Y	包裹重量(KG) 卖家下单数据
–\|sellerLength	Numeric(10,2)	Y	包裹长(CM) 卖家下单数据
–\|sellerWidth	Numeric(10,2)	Y	包裹宽(CM) 卖家下单数据
–\|sellerHeight	Numberic(10,2)	Y	包裹高(CM) 卖家下单数据
–\|merchandiseList	Array	Y	包裹中的商品信息,以下为merchandiseList的子节点
–\|–\|merchandiseCode	String(255)	Y	商品编码取 [查询入库可选商品]的商品编码	3010011818-20
–\|–\|specification	String(255)	N	商品规格注意：若规格存在，则必填；若不存，则可不填
–\|–\|skuType	String(30)	N	SKU类型 SINGL：单一商品 SUITE：套装商品 BOX：箱商品	BOX
–\|–\|standardPartsQty	Integer	O	标准件数当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时，必填。当SKU类型(skuType)为单一商品(SINGLE)时，可不填，不填则默认为1	10
–\|–\|quantity	Integer	Y	数量(库存单元数量)
–\|–\|productionBatch	String(255)	O	产品批次号仅开通了保质期管理或生产批次管理的SKU可填
–\|–\|productionDate	String(30)	O	生产日期，YYYY-MM-DD 仅开通了保质期管理或生产批次管理的SKU可填	2023-01-01
–\|–\|expirationDate	String(30)	O	失效日期，YYYY-MM-DD 仅开通了保质期管理或生产批次管理的SKU可填	2023-12-01
–\|–\|barcodeValue	String(30)	O	条码值开通条码值白名单权限，且商品为条码值管理时，必填
–\|–\|itemList	Array	N	包裹中商品的实物单品条码信息
–\|–\|–\|itemSerno	String(128)	O	单品条码即下单商品(套装)对应的实物条码。注意： 1、当下单商品的SKU类型(skuType)为套装商品(SUITE)，且其管理方式为单品化管理(SI)时，必填；其他情形，不填。 2、支持2种格式条码：Winit单品条码(S码)、第三方单品条码(非Winit)。 3、第三方(非Winit)单品条码，需全局唯一性，保证海外仓可扫描识别。
–\|–\|–\|originItemSerno	String(128)	O	源单一商品的单品条码即指下单商品的源单一商品的实物条码。注意： 1、当下单商品SKU类型(skuType)为箱商品(BOX)\套装商品(SUITE)，且箱/套内的源单一商品(SINGLE)的管理方式为单品化管理(SI)时，必填； 2、支持2种格式条码：Winit单品条码(S码)、第三方单品条码(非Winit)。 3、第三方(非Winit)单品条码，需全局唯一性，保证海外仓可扫描识别。

无箱单入库

名称	类型	必填	说明	示例
orderNo	String(30)	Y	入库单号	W0100001
valueAddedService	Object	N	入库增值服务
–\|shelveAsDefectiveProducts	String(1)	N	直接上架到不良品区服务 Y：启用服务 N：不启用不传入则默认不启用
–\|singleToBoxService	String(1)	N	单一转箱产品存储服务 Y：启用服务 N：不启用不传入则默认不启用
planMerchandiseList	Array	N	预报计划商品信息list
–\|merchandiseCode	String(255)	Y	商品编码取 [查询入库可选商品]的商品编码	3010011818-20
–\|specification	String(255)	N	商品规格注意：若规格存在，则必填；若不存，则可不填
–\|skuType	String(30)	N	SKU类型 SINGLE：单一商品 SUITE：套装商品 BOX ：箱商品	SINGLE
–\|standardPartsQty	Integer	O	标准件数注意：当SKU类型(skuType)为套装商品(SUITE)或箱商品(BOX)时，必填。当SKU类型(skuType)为单一商品(SINGLE)时，可不填，不填则默认为1	1
–\|quantity	Integer	Y	数量
orderIdentificationCodeList	Array	N	订单识别码清单信息list
–\|type	String(30)	Y	识别码类型 TRACKING_NO：快递单号 ORDER：入库单号 OTHER：其他
–\|code	String(128)	O	识别码，当识别码为快递单号或其他时必填
–\|expressCompany	String(128)	N	物流公司注意：当识别码类型为快递(TRACKING_NO)时填写。 UPS取值编码：UPS DHL取值编码：LG_DHL TNT取值编码：LG_TNT FEDEX取值编码：DIRECT007 其他取值编码：OTHER

请求示例

有箱单-标准海外仓

{
    "action": "winit.wh.inbound.order.updatepackinglist",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "54CC4FAB637AB02BCF9278A809E27BC7",
    "data": {
        "orderNo": "WI010001",
        "packageList": [
            {
                "sellerCaseNo": "qyk001",
                "thirdPartyCaseNo": "third2019062101",
                "sellerWeight": "0.01",
                "sellerLength": "18.00",
                "sellerWidth": "15.00",
                "sellerHeight": "2.00",
                "merchandiseList": [
                    {
                        "merchandiseCode": "iphoned6",
                        "specification": "",
                        "quantity": "1"
                    }
                ]
            }
        ]
    },
    "format": "json",
    "platform": "OWNERERP",
    "sign_method": "md5",
    "timestamp": "2015-08-11 10:48:39",
    "version": "1.0",
    "sign": "34530F91CBF4D674988B5231FBBD1BDD",
    "language": "zh_CN"
}

无箱单-直发海外验

{
    "action": "winit.wh.inbound.order.updatepackinglist",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "FBCF49119BE6C4C7B52DA1018DBB31ED",
    "data": {
        "orderNo": "WI010001",
        "valueAddedService": {
            "shelveAsDefectiveProducts": "Y",
            "singleToBoxService": "Y"
        },
        "planMerchandiseList": [
            {
                "merchandiseCode": "4BAR002A",
                "specification": "",
                "skuType": "SINGLE",
                "standardPartsQty": 1,
                "quantity": "1"
            }
        ],
        "orderIdentificationCodeList": [
            {
                "type": "TRACKING_NO",
                "code": "1010001001",
                "expressCompany": "UPS"
            },
            {
                "type": "TRACKING_NO",
                "code": "1010001002",
                "expressCompany": "UPS"
            }
        ]
    },
    "format": "json",
    "platform": "OWNERERP",
    "sign_method": "md5",
    "timestamp": "2015-08-11 10:48:39",
    "version": "1.0",
    "sign": "B2A38ACBEEA289E3DBE637696BCEAFA8",
    "language": "zh_CN"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

名称	类型	必传	说明	示例
orderNo	String(64)	Y	入库单号

返回示例

{
      "code": "0",
      "data": {
          "orderNo": "W0100000000002324"
      },
      "msg": "操作成功"
}

关键词