API
新增/编辑商品的箱/套装信息
更新时间: 2023-09-07 15:38:19 访问次数:447

接口说明

本接口用于实现新增/编辑商品箱产品/套装功能。

使用场景

仅限开通套装产品管理、箱产品管理或共享库存管理权限后调用,详询客服

接口名称

winit.item.box.save

请求说明

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

请求入参

名称 类型 必填 说明 示例
skuCode String(120) Y 商品编码 (仅已经发布的商品) SKU001
specification String(120) N 商品规格
使用需联系客服开启权限

type String Y 类型
SUITE:套装产品
BOX:箱产品
BOX
isShareInventory String Y 是否共享库存,Y/N N
qty int Y 标准件数
套装/箱必须大于1
supervisorMode String Y 箱/套装商品管理方式
SI:单品化管理
SKU:商品化管理
1、商品为单品管理时,套装产品只能是单品管理
2、箱产品只能是单品管理
SI
registerLength BigDecimal(16,2) Y 注册长(CM) 99
registerWidth BigDecimal(16,2) Y 注册宽(CM) 99
registerHeight BigDecimal(16,2) Y 注册高(CM) 99
registerWeight BigDecimal(16,4) Y 注册重量(KG) 10
itemPackaging String O 入库时的包装
LOGISTICS:物流包装
SALES:销售包装
不填写默认“LOGISTICS”
套装产品必填,箱产品默认物流包装
LOGISTICS
packagingMaterial String O 商品包装材质(入库时)
CARTON:通用纸箱
PLASTIC:塑料袋
套装产品必填,箱产品默认通用纸箱
CARTON
itemShape String O 箱/套装商品形状
STRIP:规则长条形
SQUARE:规则方形
ROUND:规则圆形
IRREGULAR:不规则形状
套装产品必填,箱产品不填
STRIP
itemPackagingVos list O 出库包装信息 **
套装产品选填,箱产品不填**
-|orderType int N 订单类型
1:单一
2:复合
1
-|countryCode String N 国家,二字码 US
-|outPackagingType String N 套装产品出库包装类别
不加包装: NO
WINIT标准包装:PACKAGING_WINIT
客制物流包装:CUSTOM_LOGISTICS
客制销售包装:CUSTOM_SALE
PACKAGING_WINIT
-|outPackagingMethod String N 套装产品出库包装方式
COURIER_SATCHEL:快递袋
PADDED_ENVELOPE:气泡袋
CARTON_BOX:纸箱
NO:不加包装
不填写默认“为空”(若选择了outPackagingType出库包装类别为PACKAGING_WINIT,并且packagingMethod商品出库包装方式为空,则winit按照快递袋→纸箱的优先顺序自动匹配合适的包装方式进行发货)
PADDED_ENVELOPE
-|outPackagingSku String N 指定包材SKU (已注册的包材商品SKU) SKU0012
itemThirdVos list N 套装产品第三方商品条码,仅商品管理才支持
-|skuCodeThird String N 第三方商品条码 AS001
-|description String N 第三方商品条码说明
-|countryCode String N 第三方商品条码的国家编码,与SKU注册国一致
未开通国家级第三方商品条码客户不填,开通的客户必填
US

请求示例

  1. {
  2. "action": "winit.item.box.save",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "3495F21ED1E70F817AD97F6BBC94E354",
  6. "data": {
  7. "itemPackagingVos": [
  8. {
  9. "countryCode": "AU",
  10. "id": "",
  11. "orderType": 1,
  12. "outPackagingMethod": "COURIER_SATCHEL",
  13. "outPackagingSku": "TEE1",
  14. "outPackagingType": "PACKAGING_WINIT"
  15. },
  16. {
  17. "countryCode": "AU",
  18. "id": "",
  19. "orderType": 2,
  20. "outPackagingMethod": "COURIER_SATCHEL",
  21. "outPackagingSku": "TEE2",
  22. "outPackagingType": "PACKAGING_WINIT"
  23. },
  24. {
  25. "countryCode": "DE",
  26. "id": "",
  27. "orderType": 1,
  28. "outPackagingMethod": "COURIER_SATCHEL",
  29. "outPackagingSku": "TEE3",
  30. "outPackagingType": "PACKAGING_WINIT"
  31. },
  32. {
  33. "countryCode": "DE",
  34. "id": "",
  35. "orderType": 2,
  36. "outPackagingSku": "TEE6",
  37. "outPackagingMethod": "COURIER_SATCHEL",
  38. "outPackagingType": "PACKAGING_WINIT"
  39. },
  40. {
  41. "countryCode": "US",
  42. "id": "",
  43. "orderType": 1,
  44. "outPackagingMethod": "COURIER_SATCHEL",
  45. "outPackagingSku": "TEE4",
  46. "outPackagingType": "PACKAGING_WINIT"
  47. },
  48. {
  49. "countryCode": "US",
  50. "id": "",
  51. "orderType": 2,
  52. "outPackagingMethod": "COURIER_SATCHEL",
  53. "outPackagingSku": "TEE5",
  54. "outPackagingType": "PACKAGING_WINIT"
  55. }
  56. ],
  57. "itemThirdVos": [],
  58. "isShareInventory": "Y",
  59. "registerHeight": "1",
  60. "registerLength": "5",
  61. "registerWeight": "0.01",
  62. "registerWidth": "2",
  63. "skuCode": "ticky0617API0001",
  64. "specification": "",
  65. "supervisorMode": "SI",
  66. "type": "SUITE",
  67. "qty": "2",
  68. "packagingMaterial": "CARTON",
  69. "itemPackagingMaterial": "COURIER",
  70. "itemShape": "STRIP",
  71. "itemPackaging": "SALES"
  72. },
  73. "format": "json",
  74. "language": "zh_CN",
  75. "sign": "F4228F042F62507F533901DE5F7D933E",
  76. "sign_method": "md5",
  77. "timestamp": "2015-06-16 00:19:26",
  78. "platform": "OWNERERP",
  79. "version": "1.0"
  80. }

返回出参

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

返回示例

  1. {
  2. "code": 0,
  3. "msg": "操作成功",
  4. "data": [ ]
  5. }
关键词