alibaba.ascp.cnsku.add (货品创建)

供应链中台货品创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cnsku_dto CnskuDTO 可选 待新增的货品
  • └ update_feature_map
  • String
  • 可选
  • {"supplier_id":"100001"}
  • 需要向featureMap中增加的属性列表(新增&更新接口使用)
  • └ item_code
  • String
  • 必须
  • 123
  • 货品编码
  • └ type
  • String
  • 必须
  • NORMAL
  • 货品类型,NORMAL / COMBINE / SUITEGOODS
  • comb_relation_d_t_o_list
  • CnskuRelationDTO []
  • 可选
  • 组合货品
  • └ relation_type
  • Number
  • 可选
  • 8
  • 组合货品type:8
  • └ target_user_id
  • Number
  • 可选
  • 1
  • 货主Id
  • └ type_attr_map
  • String
  • 可选
  • {"r_quantity":2}
  • r_quantity:2 代表数量
  • └ target_item_id
  • Number
  • 可选
  • 1
  • 组合货品子品Id
  • └ item_id
  • Number
  • 可选
  • 1
  • 组合货品主品Id,创建主品后自动填充
  • └ status
  • Number
  • 可选
  • 0
  • 状态
  • └ height
  • Number
  • 可选
  • 1
  • 货品高度
  • └ weight
  • Number
  • 必须
  • 1
  • 货品重量
  • └ reserve_price
  • Number
  • 可选
  • 1
  • 吊牌价
  • └ whc_bar_code
  • String
  • 可选
  • 69
  • 条形码( 格式如:条码1#条码2#条码3,多条码中间用 # 分隔)
  • └ title
  • String
  • 必须
  • 标题
  • 货品标题
  • cnsku_extend_d_t_o
  • CnskuExtendDTO
  • 可选
  • 扩展字段
  • └ deliver_requirements
  • String
  • 可选
  • 1
  • 配送要求(1:顺丰优先配)
  • └ temperature_requirement
  • String
  • 可选
  • 1
  • 温度标识 1:常温 2:5°C-12°C 3:0°C-4°C 4:-18°C-0°C
  • └ pic_url
  • String
  • 可选
  • 1
  • 货品图片
  • └ is_produce_code_mgt
  • Boolean
  • 可选
  • false
  • 是否生产批号管理
  • cnsku_sn_sample_d_t_o_list
  • CnskuSnSampleDTO []
  • 可选
  • 最大列表长度:20
  • └ sn_seq
  • String
  • 可选
  • 1
  • sn示例顺序
  • sample_rule_list
  • CnskuSnSampleRuleDTO []
  • 可选
  • SN示例
  • └ rule_regular_expression
  • String
  • 可选
  • 1
  • 规则正则表达式
  • └ sn_mgt_sub_end
  • Number
  • 可选
  • 1
  • SN截取结束位置
  • └ rule_desc
  • String
  • 可选
  • 1
  • 规则描述
  • └ sn_mgt_sub_start
  • Number
  • 可选
  • 1
  • SN截取开始位置
  • └ rule_img_url
  • String
  • 可选
  • 1
  • 规则对应图面urlurl
  • └ is_sn_mgt_sub
  • Boolean
  • 可选
  • false
  • SN是否需要截取
  • └ sn_mgt_sub_expression
  • String
  • 可选
  • 1
  • SN截取正则表达式
  • └ rule_sample
  • String
  • 可选
  • 1
  • 规则示例
  • └ sample_desc
  • String
  • 可选
  • 1
  • sn示例顺序
  • └ classification
  • String
  • 可选
  • 1
  • 存储分类
  • └ tax_code
  • String
  • 可选
  • 1
  • 税收分类编码
  • └ tax_rate
  • String
  • 可选
  • 1
  • 税率标示
  • └ is_imported
  • Boolean
  • 可选
  • false
  • 是否进口
  • └ trans_width
  • Number
  • 可选
  • 1
  • 运输单元宽
  • └ trans_length
  • Number
  • 可选
  • 1
  • 运输单元长
  • └ include_battery
  • String
  • 可选
  • 1
  • 是否包含电池(默认无电池) 1:无电池, 2:内置电池, 3:外置电池
  • └ manufacturer
  • String
  • 可选
  • 1
  • 生产企业名称
  • └ trans_image_url
  • String
  • 可选
  • 1
  • 运输单元体积照片
  • └ is_drugs
  • Boolean
  • 可选
  • false
  • 是否监管
  • └ brand_country
  • String
  • 可选
  • 1
  • 原产国
  • └ currency
  • String
  • 可选
  • 1
  • 币种
  • └ producing_area
  • String
  • 可选
  • 1
  • 产地
  • └ trans_height
  • Number
  • 可选
  • 1
  • 运输单元高
  • └ trans_volume
  • Number
  • 可选
  • 1
  • 运输单元体积
  • └ record_url
  • String
  • 可选
  • 1
  • 备案链接
  • └ trans_weight
  • Number
  • 可选
  • 1
  • 运输单元重量
  • cnsku_feature_d_t_o
  • CnskuFeatureDTO
  • 可选
  • feature字段
  • └ lifecycle
  • Number
  • 可选
  • 1
  • 有效期天数
  • └ is_precious
  • Boolean
  • 可选
  • false
  • 是否贵品
  • └ is_standard_carton
  • Boolean
  • 可选
  • false
  • 是否规范运输单元
  • └ gray_flag
  • String
  • 可选
  • 5000000001
  • 认证数据标
  • └ whc_category
  • String
  • 可选
  • 1
  • 物流类目
  • └ is_danger
  • Boolean
  • 可选
  • false
  • 是否危险品
  • └ net_weight
  • Number
  • 可选
  • 1
  • 净重
  • └ unit
  • String
  • 可选
  • 1
  • 计量单位
  • └ reject_lifecycle
  • Number
  • 可选
  • 1
  • 保质期禁收天数
  • └ lockup_lifecycle
  • Number
  • 可选
  • 1
  • 保质期禁售天数
  • └ is_sn_mgt
  • Boolean
  • 可选
  • false
  • 是否启用序列号(sn)管理
  • └ advent_lifecycle
  • Number
  • 可选
  • 1
  • 保质期临期天数
  • └ goods_value
  • String
  • 可选
  • 1.23
  • 对应货值 单位元 小数点后保留2位
  • └ is_po_mgt
  • Boolean
  • 可选
  • false
  • 是否Po管理
  • └ goods_no
  • String
  • 可选
  • 123
  • 货号
  • └ pcs
  • Number
  • 可选
  • 1
  • 箱规
  • └ specification
  • String
  • 可选
  • 1
  • 规格
  • └ sn_mode
  • String
  • 可选
  • 1
  • SN管理模式
  • └ is_hygroscopic
  • Boolean
  • 可选
  • false
  • 是否易碎品
  • └ is_standard
  • Boolean
  • 可选
  • false
  • 是否规范销售单元
  • └ is_batch_mgt
  • Boolean
  • 可选
  • false
  • 是否批次管理
  • └ is_shelflife
  • Boolean
  • 可选
  • false
  • 是否效期管理
  • └ length
  • Number
  • 可选
  • 1
  • 长度
  • └ width
  • Number
  • 可选
  • 1
  • 宽度
  • └ category_id
  • Number
  • 可选
  • 1
  • 市场叶子类目id
  • suite_goods_relation_list
  • CnskuSuiteGoodsRelationDTO []
  • 可选
  • 套装货品关系列表
  • └ belong_suite_good_id
  • Number
  • 可选
  • 123
  • 主品Id,创建可不填
  • └ amount
  • Number
  • 可选
  • 1
  • 单子品数量,要求>0
  • └ goods_id
  • Number
  • 可选
  • 1234
  • 成分子品Id
  • └ goods_value
  • String
  • 可选
  • 2.333
  • 真实货值
option AddCnskuOption 可选 选项
  • └ sync_wms
  • Boolean
  • 可选
  • true
  • 是否同步到wms, 为空时默认下发

响应参数

名称 类型 示例值 描述
error_messages String [] 异常信息
data String 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);
AlibabaAscpCnskuAddRequest req = new AlibabaAscpCnskuAddRequest();
AlibabaAscpCnskuAddRequest.CnskuDTO obj1 = new AlibabaAscpCnskuAddRequest.CnskuDTO();
obj1.setUpdateFeatureMap("{\"supplier_id\":\"100001\"}");
obj1.setItemCode("123");
obj1.setType("NORMAL");
List<AlibabaAscpCnskuAddRequest.CnskuRelationDTO> list3 = new ArrayList<AlibabaAscpCnskuAddRequest.CnskuRelationDTO>();
AlibabaAscpCnskuAddRequest.CnskuRelationDTO obj4 = new AlibabaAscpCnskuAddRequest.CnskuRelationDTO();
list3.add(obj4);
obj4.setRelationType(8L);
obj4.setTargetUserId(1L);
obj4.setTypeAttrMap("{\"r_quantity\":2}");
obj4.setTargetItemId(1L);
obj4.setItemId(1L);
obj4.setStatus(0L);
obj1.setCombRelationDTOList(list3);
obj1.setHeight(1L);
obj1.setWeight(1L);
obj1.setReservePrice(1L);
obj1.setWhcBarCode("69");
obj1.setTitle("标题");
AlibabaAscpCnskuAddRequest.CnskuExtendDTO obj5 = new AlibabaAscpCnskuAddRequest.CnskuExtendDTO();
obj5.setDeliverRequirements("1");
obj5.setTemperatureRequirement("1");
obj5.setPicUrl("1");
obj5.setIsProduceCodeMgt(false);
List<AlibabaAscpCnskuAddRequest.CnskuSnSampleDTO> list7 = new ArrayList<AlibabaAscpCnskuAddRequest.CnskuSnSampleDTO>();
AlibabaAscpCnskuAddRequest.CnskuSnSampleDTO obj8 = new AlibabaAscpCnskuAddRequest.CnskuSnSampleDTO();
list7.add(obj8);
obj8.setSnSeq("1");
List<AlibabaAscpCnskuAddRequest.CnskuSnSampleRuleDTO> list11 = new ArrayList<AlibabaAscpCnskuAddRequest.CnskuSnSampleRuleDTO>();
AlibabaAscpCnskuAddRequest.CnskuSnSampleRuleDTO obj12 = new AlibabaAscpCnskuAddRequest.CnskuSnSampleRuleDTO();
list11.add(obj12);
obj12.setRuleRegularExpression("1");
obj12.setSnMgtSubEnd(1L);
obj12.setRuleDesc("1");
obj12.setSnMgtSubStart(1L);
obj12.setRuleImgUrl("1");
obj12.setIsSnMgtSub(false);
obj12.setSnMgtSubExpression("1");
obj12.setRuleSample("1");
list9.setSampleRuleList(list11);
obj8.setSampleDesc("1");
obj5.setCnskuSnSampleDTOList(list7);
obj5.setClassification("1");
obj5.setTaxCode("1");
obj5.setTaxRate("1");
obj5.setIsImported(false);
obj5.setTransWidth(1L);
obj5.setTransLength(1L);
obj5.setIncludeBattery("1");
obj5.setManufacturer("1");
obj5.setTransImageUrl("1");
obj5.setIsDrugs(false);
obj5.setBrandCountry("1");
obj5.setCurrency("1");
obj5.setProducingArea("1");
obj5.setTransHeight(1L);
obj5.setTransVolume(1L);
obj5.setRecordUrl("1");
obj5.setTransWeight(1L);
obj1.setCnskuExtendDTO(obj5);
AlibabaAscpCnskuAddRequest.CnskuFeatureDTO obj13 = new AlibabaAscpCnskuAddRequest.CnskuFeatureDTO();
obj13.setLifecycle(1L);
obj13.setIsPrecious(false);
obj13.setIsStandardCarton(false);
obj13.setGrayFlag("5000000001");
obj13.setWhcCategory("1");
obj13.setIsDanger(false);
obj13.setNetWeight(1L);
obj13.setUnit("1");
obj13.setRejectLifecycle(1L);
obj13.setLockupLifecycle(1L);
obj13.setIsSnMgt(false);
obj13.setAdventLifecycle(1L);
obj13.setGoodsValue("1.23");
obj13.setIsPoMgt(false);
obj13.setGoodsNo("123");
obj13.setPcs(1L);
obj13.setSpecification("1");
obj13.setSnMode("1");
obj13.setIsHygroscopic(false);
obj13.setIsStandard(false);
obj13.setIsBatchMgt(false);
obj13.setIsShelflife(false);
obj1.setCnskuFeatureDTO(obj13);
obj1.setLength(1L);
obj1.setWidth(1L);
obj1.setCategoryId(1L);
List<AlibabaAscpCnskuAddRequest.CnskuSuiteGoodsRelationDTO> list15 = new ArrayList<AlibabaAscpCnskuAddRequest.CnskuSuiteGoodsRelationDTO>();
AlibabaAscpCnskuAddRequest.CnskuSuiteGoodsRelationDTO obj16 = new AlibabaAscpCnskuAddRequest.CnskuSuiteGoodsRelationDTO();
list15.add(obj16);
obj16.setBelongSuiteGoodId(123L);
obj16.setAmount(1L);
obj16.setGoodsId(1234L);
obj16.setGoodsValue("2.333");
obj1.setSuiteGoodsRelationList(list15);
req.setCnskuDto(obj1);
AlibabaAscpCnskuAddRequest.AddCnskuOption obj17 = new AlibabaAscpCnskuAddRequest.AddCnskuOption();
obj17.setSyncWms(true);
req.setOption(obj17);
AlibabaAscpCnskuAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_cnsku_add_response>
    <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_add_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

返回
顶部