接口说明

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

使用场景

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

接口名称

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

请求示例

{
    "action": "winit.item.box.save",
    "app_key": "rebecca",
    "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign": "3495F21ED1E70F817AD97F6BBC94E354",
    "data": {
        "itemPackagingVos": [
            {
                "countryCode": "AU",
                "id": "",
                "orderType": 1,
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingSku": "TEE1",
                "outPackagingType": "PACKAGING_WINIT"
            },
            {
                "countryCode": "AU",
                "id": "",
                "orderType": 2,
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingSku": "TEE2",
                "outPackagingType": "PACKAGING_WINIT"
            },
            {
                "countryCode": "DE",
                "id": "",
                "orderType": 1,
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingSku": "TEE3",
                "outPackagingType": "PACKAGING_WINIT"
            },
            {
                "countryCode": "DE",
                "id": "",
                "orderType": 2,
                "outPackagingSku": "TEE6",
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingType": "PACKAGING_WINIT"
            },
            {
                "countryCode": "US",
                "id": "",
                "orderType": 1,
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingSku": "TEE4",
                "outPackagingType": "PACKAGING_WINIT"
            },
            {
                "countryCode": "US",
                "id": "",
                "orderType": 2,
                "outPackagingMethod": "COURIER_SATCHEL",
                "outPackagingSku": "TEE5",
                "outPackagingType": "PACKAGING_WINIT"
            }
        ],
        "itemThirdVos": [],
        "isShareInventory": "Y",
        "registerHeight": "1",
        "registerLength": "5",
        "registerWeight": "0.01",
        "registerWidth": "2",
        "skuCode": "ticky0617API0001",
        "specification": "",
        "supervisorMode": "SI",
        "type": "SUITE",
        "qty": "2",
        "packagingMaterial": "CARTON",
        "itemPackagingMaterial": "COURIER",
        "itemShape": "STRIP",
        "itemPackaging": "SALES"
    },
    "format": "json",
    "language": "zh_CN",
    "sign": "F4228F042F62507F533901DE5F7D933E",
    "sign_method": "md5",
    "timestamp": "2015-06-16 00:19:26",
    "platform": "OWNERERP",
    "version": "1.0"
}

返回出参

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

返回示例

{
    "code": 0,
    "msg": "操作成功",
    "data": [ ]
}

关键词