alibaba.ascp.cnsku.update (供应链中台货品修改接口)

供应链中台货品修改接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cnsku CnskuDto 必须 待新增的货品
  • └ cnsku_id
  • Number
  • 必须
  • 1
  • 货品id
  • └ item_code
  • String
  • 必须
  • 123
  • 商品编码
  • └ owner_id
  • Number
  • 必须
  • 123
  • 货主id
  • └ brand
  • String
  • 可选
  • 1
  • 品牌
  • └ sku_id
  • Number
  • 可选
  • 1
  • 前端skuId
  • └ height
  • Number
  • 可选
  • 1
  • 高度
  • └ sku_category
  • Number
  • 可选
  • 1
  • 货品分类
  • └ weight
  • Number
  • 必须
  • 1
  • 重量
  • └ version
  • Number
  • 可选
  • 1
  • 版本号
  • └ volume
  • Number
  • 可选
  • 1
  • 体积
  • └ reserve_price
  • Number
  • 可选
  • 1
  • 吊牌价
  • └ whc_bar_code
  • String
  • 必须
  • 1
  • 条形码( 格式如:条码1#条码2#条码3,多条码中间用 # 分隔)
  • └ title
  • String
  • 必须
  • 1
  • 商品标题
  • └ package_material
  • String
  • 可选
  • 1
  • 包装材料
  • cnsku_extend_d_t_o
  • CnskuExtendDto
  • 可选
  • 扩展字段
  • └ deliver_requirements
  • String
  • 可选
  • 1
  • 配送要求(1:顺丰优先配)
  • └ is_precious
  • Boolean
  • 可选
  • false
  • 是否贵品
  • └ picture_url
  • String
  • 可选
  • 1
  • 商品图片
  • └ cnsku_sn_sample_d_t_o_list
  • []
  • 可选
  • [{"snSeq":"1","sampleDesc":"1","sampleRuleList":[{"ruleDesc":"1","ruleRegularExpression":"1","ruleImgUrl":"1","ruleSample":"1","isSnMgtSub":false,"snMgtSubStart":1,"snMgtSubEnd":2,"snMgtSubExpression":"1"}]}]
  • sn 示例
  • └ main_composition
  • String
  • 可选
  • 1
  • 主要成分
  • └ is_imported
  • Boolean
  • 可选
  • false
  • 是否进口
  • └ trans_width
  • Number
  • 可选
  • 1
  • 运输单元宽
  • └ package_unit
  • String
  • 可选
  • 1
  • 包装单位
  • └ temperature_requirement
  • String
  • 可选
  • 1
  • 温度标识 1:常温 2:5°C-12°C 3:0°C-4°C 4:-18°C-0°C
  • └ trans_length
  • Number
  • 可选
  • 1
  • 运输单元长
  • └ include_battery
  • String
  • 可选
  • 1
  • 是否包含电池(默认无电池) 1:无电池, 2:内置电池, 3:外置电池
  • └ package_material_class
  • String
  • 可选
  • 1
  • 商品使用的包材材质
  • └ type_property
  • String
  • 可选
  • 1
  • 3w货品分类属性(大电用)空调属性,内外机
  • └ manufacturer
  • String
  • 可选
  • 1
  • 生产厂家
  • └ inner_length
  • Number
  • 可选
  • 1
  • 内长
  • └ trans_image_url
  • String
  • 可选
  • 1
  • 运输单元体积照片
  • └ load_bearing
  • Number
  • 可选
  • 1
  • 承重
  • └ pic_url
  • String
  • 可选
  • 1
  • 货品图片
  • └ is_produce_code_mgt
  • Boolean
  • 可选
  • false
  • 是否生产批号管理
  • └ is_drugs
  • Boolean
  • 可选
  • false
  • 是否监管
  • └ brand_country
  • String
  • 可选
  • 1
  • 原产国
  • └ currency
  • String
  • 可选
  • 1
  • 币种
  • └ producing_area
  • String
  • 可选
  • 1
  • 产地
  • └ trans_height
  • Number
  • 可选
  • 1
  • 运输单元高
  • └ trans_volume
  • Number
  • 可选
  • 1
  • 运输单元体积
  • └ inner_height
  • Number
  • 可选
  • 1
  • 内高
  • └ record_url
  • String
  • 可选
  • 1
  • 备案链接
  • └ trans_weight
  • Number
  • 可选
  • 1
  • 运输单元重量
  • └ material_type
  • Number
  • 可选
  • 1
  • 包材类型 1:空白箱 2:菜鸟联盟包材
  • └ package_material_mode
  • Number
  • 可选
  • 1
  • 商品使用的包材范围 1:商家包材 2:CP包材
  • └ classification
  • String
  • 可选
  • 1
  • 存储分类
  • └ tax_code
  • String
  • 可选
  • 1
  • 税收分类编码
  • └ www_bar_code
  • String
  • 可选
  • 1
  • 大电barCode
  • └ tax_rate
  • String
  • 可选
  • 1
  • 税率标示
  • └ inner_width
  • Number
  • 可选
  • 1
  • 内宽
  • └ dosage_forms
  • String
  • 可选
  • 1
  • 剂型
  • cnsku_feature_d_t_o
  • CnskuFeatureDto
  • 可选
  • feature标签
  • └ is_sn_mgt
  • Boolean
  • 可选
  • true
  • 是否启用序列号(sn)管理
  • └ sn_mode
  • String
  • 可选
  • 1
  • SN管理模式
  • └ origin_address
  • String
  • 可选
  • 1
  • 产地
  • └ sku_price
  • Number
  • 可选
  • 1
  • 零售价
  • └ lifecycle
  • Number
  • 可选
  • 1
  • 有效期天数
  • └ is_precious
  • Boolean
  • 可选
  • false
  • 是否贵品
  • └ is_standard_carton
  • Boolean
  • 可选
  • false
  • 是否规范运输单元
  • └ gray_flag
  • String
  • 可选
  • 1
  • 服务产品标
  • └ whc_category
  • String
  • 可选
  • 1
  • 商品类目
  • └ whc_sn_out_mode
  • Boolean
  • 可选
  • false
  • sn出库管理
  • └ is_danger
  • Boolean
  • 可选
  • false
  • 是否危险品
  • └ net_weight
  • Number
  • 可选
  • 1
  • 净重
  • └ unit
  • String
  • 可选
  • 1
  • 计量单位
  • └ size
  • String
  • 可选
  • 1
  • 尺寸
  • └ material_group
  • String
  • 可选
  • 1
  • 包材分组
  • └ reject_lifecycle
  • Number
  • 可选
  • 1
  • 保质期禁收天数
  • └ whc_sn_in_mode
  • Boolean
  • 可选
  • false
  • sn入库管理
  • └ sku_code
  • String
  • 可选
  • 1
  • 商家商品编码
  • └ is_unified_all_wh
  • Boolean
  • 可选
  • false
  • 是否统一全仓数据-销售单元
  • └ lockup_lifecycle
  • Number
  • 可选
  • 1
  • 保质期禁售天数
  • └ advent_lifecycle
  • Number
  • 可选
  • 1
  • 保质期临期天数
  • └ is_unified_all_wh_carton
  • Boolean
  • 可选
  • false
  • 是否统一全仓数据-运输单元
  • └ goods_value
  • String
  • 可选
  • 1.22
  • 对应货值 单位元 小数点后保留2位
  • └ need_measure_image_carton
  • Boolean
  • 可选
  • false
  • 是否需要测量图片-运输单元
  • └ is_po_mgt
  • Boolean
  • 可选
  • false
  • 是否Po管理
  • └ use_yn
  • Boolean
  • 可选
  • false
  • 是否启用标识
  • └ goods_no
  • String
  • 可选
  • 1
  • 货号
  • └ pcs
  • Number
  • 可选
  • 1
  • 箱规
  • └ material_class
  • String
  • 可选
  • 1
  • 包材分类
  • └ cost_price
  • Number
  • 可选
  • 1
  • 成本价
  • └ specification
  • String
  • 可选
  • 1
  • 规格
  • └ specification_type
  • String
  • 可选
  • 20
  • 规格类型,20:大件;10:中小件
  • └ packaging_scheme
  • String
  • 可选
  • 1
  • 包装方式:1 原箱发货
  • └ cn_product_code
  • String
  • 可选
  • 1
  • 产品编码
  • └ approval_number
  • String
  • 可选
  • 1
  • 批准文号
  • └ is_hygroscopic
  • Boolean
  • 可选
  • false
  • 是否易碎品
  • └ cn_cubage
  • String
  • 可选
  • 1
  • 容积
  • └ is_standard
  • Boolean
  • 可选
  • false
  • 是否规范销售单元
  • └ is_batch_mgt
  • Boolean
  • 可选
  • false
  • 是否启用批次管理标识
  • └ is_shelflife
  • Boolean
  • 可选
  • false
  • 是否效期管理
  • └ need_measure_image
  • Boolean
  • 可选
  • false
  • 是否需要测量图片-销售单元
  • └ length
  • Number
  • 可选
  • 1
  • 长度
  • └ width
  • Number
  • 可选
  • 1
  • 宽度
  • └ category_id
  • Number
  • 可选
  • 1
  • 淘系叶子类目id
  • └ update_feature_map
  • 可选
  • {"supplier_id":"100001"}
  • 需要向featureMap中增加的属性列表(新增&更新接口使用)
  • └ remove_feature_map
  • 可选
  • {"supplier_id":"100001"}
  • 需要向featureMap中删除的属性列表(更新接口使用)
  • └ type
  • String
  • 必须
  • NORMAL
  • 货品类型
option UpdateCnskuOption 必须 修改选项
  • └ sync_wms
  • Boolean
  • 可选
  • true
  • 默认值:true
  • 是否同步到wms, 为空时默认下发

响应参数

名称 类型 示例值 描述
error_messages String [] errorMessage 异常信息
data Json 1234567 货品id
is_success Boolean true 是否成功
is_system_failed Boolean true 是否系统异常
sys_error_code String errorCode 异常信息Code

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpCnskuUpdateRequest req = new AlibabaAscpCnskuUpdateRequest();
AlibabaAscpCnskuUpdateRequest.CnskuDto obj1 = new AlibabaAscpCnskuUpdateRequest.CnskuDto();
obj1.setCnskuId(1L);
obj1.setItemCode("123");
obj1.setOwnerId(123L);
obj1.setBrand("1");
obj1.setSkuId(1L);
obj1.setHeight(1L);
obj1.setSkuCategory(1L);
obj1.setWeight(1L);
obj1.setVersion(1L);
obj1.setVolume(1L);
obj1.setReservePrice(1L);
obj1.setWhcBarCode("1");
obj1.setTitle("1");
obj1.setPackageMaterial("1");
AlibabaAscpCnskuUpdateRequest.CnskuExtendDto obj2 = new AlibabaAscpCnskuUpdateRequest.CnskuExtendDto();
obj2.setDeliverRequirements("1");
obj2.setIsPrecious(false);
obj2.setPictureUrl("1");
obj2.setMainComposition("1");
obj2.setIsImported(false);
obj2.setTransWidth(1L);
obj2.setPackageUnit("1");
obj2.setTemperatureRequirement("1");
obj2.setTransLength(1L);
obj2.setIncludeBattery("1");
obj2.setPackageMaterialClass("1");
obj2.setTypeProperty("1");
obj2.setManufacturer("1");
obj2.setInnerLength(1L);
obj2.setTransImageUrl("1");
obj2.setLoadBearing(1L);
obj2.setPicUrl("1");
obj2.setIsProduceCodeMgt(false);
obj2.setIsDrugs(false);
obj2.setBrandCountry("1");
obj2.setCurrency("1");
obj2.setProducingArea("1");
obj2.setTransHeight(1L);
obj2.setTransVolume(1L);
obj2.setInnerHeight(1L);
obj2.setRecordUrl("1");
obj2.setTransWeight(1L);
obj2.setMaterialType(1L);
obj2.setPackageMaterialMode(1L);
obj2.setClassification("1");
obj2.setTaxCode("1");
obj2.setWwwBarCode("1");
obj2.setTaxRate("1");
obj2.setInnerWidth(1L);
obj2.setDosageForms("1");
obj1.setCnskuExtendDTO(obj2);
AlibabaAscpCnskuUpdateRequest.CnskuFeatureDto obj3 = new AlibabaAscpCnskuUpdateRequest.CnskuFeatureDto();
obj3.setIsSnMgt(true);
obj3.setSnMode("1");
obj3.setOriginAddress("1");
obj3.setSkuPrice(1L);
obj3.setLifecycle(1L);
obj3.setIsPrecious(false);
obj3.setIsStandardCarton(false);
obj3.setGrayFlag("1");
obj3.setWhcCategory("1");
obj3.setWhcSnOutMode(false);
obj3.setIsDanger(false);
obj3.setNetWeight(1L);
obj3.setUnit("1");
obj3.setSize("1");
obj3.setMaterialGroup("1");
obj3.setRejectLifecycle(1L);
obj3.setWhcSnInMode(false);
obj3.setSkuCode("1");
obj3.setIsUnifiedAllWh(false);
obj3.setLockupLifecycle(1L);
obj3.setAdventLifecycle(1L);
obj3.setIsUnifiedAllWhCarton(false);
obj3.setGoodsValue("1.22");
obj3.setNeedMeasureImageCarton(false);
obj3.setIsPoMgt(false);
obj3.setUseYn(false);
obj3.setGoodsNo("1");
obj3.setPcs(1L);
obj3.setMaterialClass("1");
obj3.setCostPrice(1L);
obj3.setSpecification("1");
obj3.setSpecificationType("20");
obj3.setPackagingScheme("1");
obj3.setCnProductCode("1");
obj3.setApprovalNumber("1");
obj3.setIsHygroscopic(false);
obj3.setCnCubage("1");
obj3.setIsStandard(false);
obj3.setIsBatchMgt(false);
obj3.setIsShelflife(false);
obj3.setNeedMeasureImage(false);
obj1.setCnskuFeatureDTO(obj3);
obj1.setLength(1L);
obj1.setWidth(1L);
obj1.setCategoryId(1L);
obj1.setType("NORMAL");
req.setCnsku(obj1);
AlibabaAscpCnskuUpdateRequest.UpdateCnskuOption obj4 = new AlibabaAscpCnskuUpdateRequest.UpdateCnskuOption();
obj4.setSyncWms(true);
req.setOption(obj4);
AlibabaAscpCnskuUpdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_cnsku_update_response>
    <error_messages>
        <string>errorMessage</string>
    </error_messages>
    <data>1234567</data>
    <is_success>true</is_success>
    <is_system_failed>true</is_system_failed>
    <sys_error_code>errorCode</sys_error_code>
</alibaba_ascp_cnsku_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部