万邑通开发者网站 - 注册/编辑商品

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

请求示例

Json
XML

{
    "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

返回示例

Json
XML

{
    "code": 0,
    "msg": "操作成功",
    "data": [
        {
            "productCode": "1234567test2"
        },
        {
            "productCode": "1234567test"
        }
    ]
}

关键词

registerProduct
海外仓商品注册
商品注册