API
更新箱单信息
更新时间: 2023-11-24 12:27:19 访问次数:539

接口说明

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

  1. 有箱单入库:仅支持“已下单”状态的海外仓入库单更新箱单信息
  2. 无箱单入库:
    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

请求示例

有箱单-标准海外仓

  1. {
  2. "action": "winit.wh.inbound.order.updatepackinglist",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "54CC4FAB637AB02BCF9278A809E27BC7",
  6. "data": {
  7. "orderNo": "WI010001",
  8. "packageList": [
  9. {
  10. "sellerCaseNo": "qyk001",
  11. "thirdPartyCaseNo": "third2019062101",
  12. "sellerWeight": "0.01",
  13. "sellerLength": "18.00",
  14. "sellerWidth": "15.00",
  15. "sellerHeight": "2.00",
  16. "merchandiseList": [
  17. {
  18. "merchandiseCode": "iphoned6",
  19. "specification": "",
  20. "quantity": "1"
  21. }
  22. ]
  23. }
  24. ]
  25. },
  26. "format": "json",
  27. "platform": "OWNERERP",
  28. "sign_method": "md5",
  29. "timestamp": "2015-08-11 10:48:39",
  30. "version": "1.0",
  31. "sign": "34530F91CBF4D674988B5231FBBD1BDD",
  32. "language": "zh_CN"
  33. }

无箱单-直发海外验

  1. {
  2. "action": "winit.wh.inbound.order.updatepackinglist",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "FBCF49119BE6C4C7B52DA1018DBB31ED",
  6. "data": {
  7. "orderNo": "WI010001",
  8. "valueAddedService": {
  9. "shelveAsDefectiveProducts": "Y",
  10. "singleToBoxService": "Y"
  11. },
  12. "planMerchandiseList": [
  13. {
  14. "merchandiseCode": "4BAR002A",
  15. "specification": "",
  16. "skuType": "SINGLE",
  17. "standardPartsQty": 1,
  18. "quantity": "1"
  19. }
  20. ],
  21. "orderIdentificationCodeList": [
  22. {
  23. "type": "TRACKING_NO",
  24. "code": "1010001001",
  25. "expressCompany": "UPS"
  26. },
  27. {
  28. "type": "TRACKING_NO",
  29. "code": "1010001002",
  30. "expressCompany": "UPS"
  31. }
  32. ]
  33. },
  34. "format": "json",
  35. "platform": "OWNERERP",
  36. "sign_method": "md5",
  37. "timestamp": "2015-08-11 10:48:39",
  38. "version": "1.0",
  39. "sign": "B2A38ACBEEA289E3DBE637696BCEAFA8",
  40. "language": "zh_CN"
  41. }

返回出参

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

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

返回示例

  1. {
  2. "code": "0",
  3. "data": {
  4. "orderNo": "W0100000000002324"
  5. },
  6. "msg": "操作成功"
  7. }
关键词