更新箱单信息
更新时间: 2023-11-24 12:27:19 访问次数:2270
接口说明
更新箱单信息支持有箱单信息和无箱单信息的入库单,更新方式:覆盖更新
- 有箱单入库:仅支持“已下单”状态的海外仓入库单更新箱单信息
- 无箱单入库:
- 订单未到仓之前且没有预约单,或订单未到仓前且预约单没有预约成功过,可更改商品信息planMerchandiseList或入库增值服务valueAddedService
- 订单已上架前,都可以新增识别码(已扫描到的识别码不可以删除)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": "操作成功"
}