API
注册/编辑商品
更新时间: 2021-12-02 20:47:09 访问次数:13320
接口说明
本接口用于实现注册商品功能。
接口名称
registerProduct
使用场景
客户新商品注册。
请求说明
正式URL | https://openapi.winit.com.cn/openapi/service |
测试URL | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
<-->
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
productCode | String(120) | Y | 商品编码
提交后不可变更。 |
SKU001 |
specification | String(120) | N | 商品规格,使用需联系客服开启权限。 | |
chineseName | String(255) | Y | 中文名称 | |
englishName | String(255) | Y | 英文名称 | |
registeredWeight | Numeric(10,2) | Y | 注册重量(克/g) | |
fixedVolumeWeight | String(1) | Y | 重量体积是否固定,请传固定值Y | Y |
registeredLength | Numeric(10,2) | Y | 注册商品长度(cm) | 99 |
registeredWidth | Numeric(10,2) | Y | 注册商品宽度(cm) | 99 |
registeredHeight | Numeric(10,2) | Y | 注册商品高度(cm) | 99 |
branded | String(1) | Y | 是否有品牌,Y|N | Y |
brandedName | String(127) | O | 品牌名称当branded为Y时必填 | HHG |
model | String(127) | O | 型号 当brandedname为Y时为必填 |
HG |
displayPageUrl | String(1000) | Y | 商品链接 | www.demo_icon.com |
remark | String(255) | N | 备注 | e |
exportCountry | String(22) | Y | 出口国家,国家2字码 | CN |
inporCountry | String(22) | Y | 进口国家,国家2字码 | AU |
inportDeclaredvalue | Numeric(10,2) | Y | 进口申报价(USD) | 33 |
exportDeclaredvalue | Numeric(10,2) | Y | 出口申报价(USD) | 34 |
exportValueForImport | Numeric(10,2) | Y | 进口国出口申报价(USD) 默认为0 |
34 |
battery |
String(1) | Y | 是否有电池,Y|N | Y |
batteryTypeId | int | N | battery字段为Y时必填 电池种类 1 :锂离子电池 2 :锂金属电池 3 :非锂电池 |
1 |
batteryPackId | int | N | battery字段为Y时必填 电池包装 4 :纯电 5 :内置 6 :外置 |
4 |
batteryPower | int | N | battery字段为Y时必填 电池功率 |
100 |
isSiManager | Boolean | N | 商品管理方式 Y:单品化管理 N:商品化管理 不传默认按照客户级管理方式赋值。 |
Y |
packaging | String(120) | N | 商品入库时的包装。 LOGISTICS:物流包装 SALES:销售包装 NUDE_CARGO:裸货 不填写默认“LOGISTICS” |
LOGISTICS |
outPackagingType | String(20) | 出库包装类别 不加包装: NO WINIT标准包装:PACKAGING_WINIT 客制物流包装:CUSTOM_LOGISTICS 客制销售包装:CUSTOM_SALE |
LOGISTICS | |
packagingMethod | String(120) | N | 商品出库包装方式(单一订单) COURIER_SATCHEL:快递袋 PADDED_ENVELOPE:气泡袋 CARTON_BOX:纸箱 NO:不加包装 不填写默认“为空”(若选择了outPackagingType出库包装类别为PACKAGING_WINIT,并且packagingMethod商品出库包装方式为空,则winit按照快递袋→纸箱的优先顺序自动匹配合适的包装方式进行发货) |
CARTON_BOX |
outPackagingSku | String(60) | N | 指定包材SKU | outPackagingSku |
packagingMethodMulti | string(30) | 商品出库包装方式(复合订单) 塑料袋:COURIER_SATCHEL, 气泡袋:PADDED_ENVELOPE, 纸箱:CARTON_BOX, 不加包装:NO 不填写默认“为空”(若选择了outPackagingType出库包装类别为PACKAGING_WINIT,并且packagingMethod商品出库包装方式为空,则winit按照快递袋→纸箱的优先顺序自动匹配合适的包装方式进行发货) |
COURIER_SATCHEL | |
outPackagingTypeMulti | string(50) | 复合订单出库包装类别 不加包装: NO WINIT标准包装:PACKAGING_WINIT 客制物流包装:CUSTOM_LOGISTICS 客制销售包装:CUSTOM_SALE |
NO | |
outPackagingSkuMulti | string(30) | 复合订单出库指定包材sku | Sku001 | |
isBatchManager | String(1) | N | 是否批次管理,Y/N 使用需开启权限 |
Sku001 |
batchAttributeType | String(50) | N | 批次属性类型 | N |
isPackingMaterial | String(1) | N | 是否包材, Y/N ,空默认N 使用需开启权限 |
N |
itemShape | String() | Y | 商品形状
STRIP 规则长条形 SQUARE 规则方形 ROUND 规则圆形 IRREGULAR 不规则形状 |
CARTON |
itemPackagingMaterial | String() | Y | 商品包装材质(入库时)
CARTON 通用纸箱 COURIER 快递袋 BUBBLE 气泡袋 WOVEN 编织袋 METAL 金属容器 CORTICAL 皮质 FOAM 泡沫箱 ELSE 其他 |
CARTON |
carryLabelVos | 携带标签 | |||
labelCode | String() | N | 标签编码
CE_LABEL CE标 FIRE_SAFETY_LABEL UM标签(防火标) DANGEROUS_LABEL 9类危险品标 FRAGILE_LABEL 易碎品标 FRONT_UP_LABEL 正面朝上标 |
|
labelValue | String() | N | 标签值
Y 含有该标签 N 不含有该标签 |
|
itemThirdVos | 第三方商品编码信息数据列表 | |||
skuCodeThird | String(50) | N | 第三方商品编码 | KB0123458-test |
description | String() | N | 第三方商品编码的说明 | null |
请求示例
{ "action": "registerProduct", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "19E393A6B2694E249F2D8C4648C9D1AC", "data": { "productList": [ { "packaging": "LOGISTICS", "packagingMethod": "CARTON_BOX", "isSiManager": "Y", "productCode": "1234567test2", "chineseName": "PowerBuyerDEF456", "englishName": "34BayItemI34245", "categoryOne": "1001", "categoryTwo": "1SDDW", "categoryThree": "2", "registeredWeight": "2", "fixedVolumeWeight": "Y", "registeredLength": "4", "registeredWidth": "4", "registeredHeight": "4", "branded": "Y", "brandedName": "HHG", "model": "HG", "displayPageUrl": "www.demo_icon.com", "remark": "e", "itemShape": "", "itemPackagingMaterial": "CARTON", "carryLabelVos": [ { "labelCode": "CE_LABEL", "labelValue": "Y" }, { "labelCode": "DANGEROUS_LABEL", "labelValue": "N" }, { "labelCode": "FRAGILE_LABEL", "labelValue": "N" }, { "labelCode": "FRONT_UP_LABEL", "labelValue": "N" } ], "exportCountry": "CN", "inporCountry": "AU", "inportDeclaredvalue": "33", "exportDeclaredvalue": "34", "stockOutRate": "10", "leadTime": "10", "replenishmentLeadTime": "20", "battery": "Y", "itemThirdVos": [ { "description": "null" } ] }, { "productCode": "1234567test", "packaging": "", "packagingMethod": "", "isSiManager": "N", "chineseName": "PowerBuyerDEF456", "englishName": "34BayItemI34245", "categoryOne": "1001", "registeredWeight": "2", "fixedVolumeWeight": "Y", "registeredLength": "4", "registeredWidth": "4", "registeredHeight": "4", "branded": "Y", "brandedName": "HHG", "model": "HG", "displayPageUrl": "www.demo_icon.com", "remark": "e", "exportCountry": "CN", "inporCountry": "AU", "inportDeclaredvalue": "33", "exportDeclaredvalue": "34", "stockOutRate": "10", "leadTime": "10", "replenishmentLeadTime": "20", "battery": "N", "itemShape": "IRREGULAR ", "itemPackagingMaterial": "", "carryLabelVos": [ { "labelCode": "CE_LABEL", "labelValue": "N" }, { "labelCode": "CE_LABEL", "labelValue": "Y" }, { "labelCode": "DANGEROUS_LABEL", "labelValue": "N" }, { "labelCode": "FRAGILE_LABEL", "labelValue": "N" }, { "labelCode": "FRONT_UP_LABEL", "labelValue": "N" } ], "itemThirdVos": [ { "description": "null" } ] } ] }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "CF0569D4E8F09ECA134086A906C29C1E", "sign_method": "md5", "timestamp": "2015-06-16 00:19:26", "version": "1.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
code | String(80)/Number | Y | 错误代码 | 0 |
msg | String(255) | Y | 提示信息 | |
data | object | Y | 返回数据 | |
productCode | String(80) | Y | 商品sku |
返回示例