淘宝开放平台

登录
文档中心 > API类目 > 分销API

分销API

alibaba.ascp.cnsku.search (供应链中台货品搜索接口)

供应链中台货品搜索接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 ScItemSearchDTO 必须 货品搜索条件
  • └ page_size
  • Number
  • 可选
  • 20
  • 分页大小
  • └ non_sc_item_type_list
  • String []
  • 可选
  • []
  • 剔除的货品类型
  • └ sc_item_name
  • String
  • 可选
  • 测试请不要拍
  • 货品名称
  • └ item_dim
  • Number
  • 可选
  • 3
  • 标记位，3表示后端商品
  • └ sc_item_status
  • Number
  • 可选
  • 0
  • 货品状态，0 正常
  • └ non_feature_condition
  • Json
  • 可选
  • {"scm_archive_status":"3"}
  • 货品不包含的特征
  • └ sc_item_type_list
  • String []
  • 可选
  • ["NORMAL"]
  • 货品类型
  • └ brand_name
  • String
  • 可选
  • 测试品牌
  • 品牌名称
  • └ outer_id_list
  • String []
  • 可选
  • ["2406549600332"]
  • 货品编码列表
  • └ sc_item_code
  • String
  • 可选
  • 2406549600332
  • 货品编码
  • └ whc_bar_code_list
  • String []
  • 可选
  • ["2406549600332"]
  • 条形码列表
  • └ sc_item_id
  • Number
  • 可选
  • 645968622048
  • 货品ID
  • └ feature_condition
  • Json
  • 可选
  • {"merchantCode":"MCCSSJ"}
  • 货品包含的特征
  • └ merchant_category_id_list
  • Number []
  • 可选
  • [11010101]
  • 商家类目ID列表
  • └ whc_barcode
  • String
  • 可选
  • 2406549600332
  • 条形码
  • └ auction_tags
  • String []
  • 可选
  • [30081]
  • 标签
  • └ sc_item_id_list
  • Number []
  • 可选
  • [645968622048]
  • 货品ID列表
  • └ current_page
  • Number
  • 可选
  • 1
  • 页码
  • └ category_id
  • Number
  • 可选
  • 50050381
  • 市场类目ID

响应参数

名称 类型 示例值 描述
result CnskuResult / 返回结果
  • data
  • CnskuDTO []
  • /
  • 对应货品信息
  • └ cnsku_id
  • Number
  • 1
  • 货品id
  • └ item_code
  • String
  • 123
  • 商品编码
  • └ brand
  • String
  • 1
  • 品牌
  • └ owner_id
  • Number
  • 1
  • 货主id
  • └ sku_id
  • Number
  • 1
  • 前端skuId
  • └ height
  • Number
  • 1
  • 高度
  • └ sku_category
  • Number
  • 1
  • 货品分类
  • └ weight
  • Number
  • 1
  • 重量
  • └ volume
  • Number
  • 1
  • 体积
  • └ reserve_price
  • Number
  • 1
  • 吊牌价
  • └ whc_bar_code
  • String
  • 1
  • 条形码( 格式如：条码1#条码2#条码3，多条码中间用 # 分隔)
  • └ title
  • String
  • 1
  • 商品标题
  • └ package_material
  • String
  • 1
  • 包装材料
  • └ length
  • Number
  • 1
  • 长度
  • └ width
  • Number
  • 1
  • 宽度
  • └ category_id
  • Number
  • 1
  • 淘系叶子类目id
  • └ type
  • String
  • 1
  • 货品类型
  • cnsku_extend_d_t_o
  • CnskuExtendDTO
  • 扩展字段
  • └ main_composition
  • String
  • 1
  • 主要成分
  • └ deliver_requirements
  • String
  • 1
  • 配送要求（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
  • 承重
  • └ is_precious
  • Boolean
  • false
  • 是否贵品
  • └ 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
  • 内高
  • └ 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标签
  • └ 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
  • 保质期禁售天数
  • └ is_sn_mgt
  • Boolean
  • false
  • 是否启用序列号（sn）管理
  • └ 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
  • 1
  • 规格类型，20：大件；10：中小件
  • └ packaging_scheme
  • String
  • 1
  • 包装方式：1 原箱发货
  • └ cn_product_code
  • String
  • 1
  • 产品编码
  • └ approval_number
  • String
  • 1
  • 批准文号
  • └ sn_mode
  • String
  • 1
  • SN管理模式
  • └ 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
  • 是否需要测量图片-销售单元
  • └ feature_map
  • Json
  • 1
  • 扩展属性
  • └ status
  • Number
  • 1
  • 商品状态
  • └ page_index
  • Number
  • 1
  • 页码
  • └ total_num
  • Number
  • 1
  • 总个数
  • └ is_system_failed
  • Boolean
  • false
  • 是否系统异常
  • └ sys_error_code
  • String
  • errorCode
  • 异常信息Code
  • └ page_size
  • Number
  • 20
  • 分页大小
  • └ is_success
  • Boolean
  • true
  • 是否成功
  • └ error_m_s_g
  • String
  • errorMessage
  • 异常信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpCnskuSearchRequest req = new AlibabaAscpCnskuSearchRequest();
AlibabaAscpCnskuSearchRequest.ScItemSearchDTO obj1 = new AlibabaAscpCnskuSearchRequest.ScItemSearchDTO();
obj1.setPageSize(20L);
obj1.setNonScItemTypeList("");
obj1.setScItemName("测试请不要拍");
obj1.setItemDim(3L);
obj1.setScItemStatus(0L);
obj1.setNonFeatureConditionString("{\"scm_archive_status\":\"3\"}");
obj1.setScItemTypeList(""NORMAL"");
obj1.setBrandName("测试品牌");
obj1.setOuterIdList(""2406549600332"");
obj1.setScItemCode("2406549600332");
obj1.setWhcBarCodeList(""2406549600332"");
obj1.setScItemId(645968622048L);
obj1.setFeatureConditionString("{\"merchantCode\":\"MCCSSJ\"}");
obj1.setMerchantCategoryIdList(new Long[] { 11010101 };
);
obj1.setWhcBarcode("2406549600332");
obj1.setAuctionTags("30081");
obj1.setScItemIdList(new Long[] { 645968622048 };
);
obj1.setCurrentPage(1L);
obj1.setCategoryId(50050381L);
req.setParam0(obj1);
AlibabaAscpCnskuSearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<alibaba_ascp_cnsku_search_response>
    <result>
        <data>
            <cnsku_d_t_o>
                <cnsku_id>1</cnsku_id>
                <item_code>123</item_code>
                <brand>1</brand>
                <owner_id>1</owner_id>
                <sku_id>1</sku_id>
                <height>1</height>
                <sku_category>1</sku_category>
                <weight>1</weight>
                <volume>1</volume>
                <reserve_price>1</reserve_price>
                <whc_bar_code>1</whc_bar_code>
                <title>1</title>
                <package_material>1</package_material>
                <length>1</length>
                <width>1</width>
                <category_id>1</category_id>
                <type>1</type>
                <cnsku_extend_d_t_o>
                    <main_composition>1</main_composition>
                    <deliver_requirements>1</deliver_requirements>
                    <is_imported>false</is_imported>
                    <trans_width>1</trans_width>
                    <package_unit>1</package_unit>
                    <temperature_requirement>1</temperature_requirement>
                    <trans_length>1</trans_length>
                    <include_battery>1</include_battery>
                    <package_material_class>1</package_material_class>
                    <type_property>1</type_property>
                    <manufacturer>1</manufacturer>
                    <inner_length>1</inner_length>
                    <trans_image_url>1</trans_image_url>
                    <load_bearing>1</load_bearing>
                    <is_precious>false</is_precious>
                    <pic_url>1</pic_url>
                    <is_produce_code_mgt>false</is_produce_code_mgt>
                    <is_drugs>false</is_drugs>
                    <brand_country>1</brand_country>
                    <currency>1</currency>
                    <producing_area>1</producing_area>
                    <trans_height>1</trans_height>
                    <trans_volume>1</trans_volume>
                    <inner_height>1</inner_height>
                    <trans_weight>1</trans_weight>
                    <material_type>1</material_type>
                    <package_material_mode>1</package_material_mode>
                    <classification>1</classification>
                    <tax_code>1</tax_code>
                    <www_bar_code>1</www_bar_code>
                    <tax_rate>1</tax_rate>
                    <inner_width>1</inner_width>
                    <dosage_forms>1</dosage_forms>
                </cnsku_extend_d_t_o>
                <cnsku_feature_d_t_o>
                    <origin_address>1</origin_address>
                    <sku_price>1</sku_price>
                    <lifecycle>1</lifecycle>
                    <is_precious>false</is_precious>
                    <is_standard_carton>false</is_standard_carton>
                    <gray_flag>1</gray_flag>
                    <whc_category>1</whc_category>
                    <whc_sn_out_mode>false</whc_sn_out_mode>
                    <is_danger>false</is_danger>
                    <net_weight>1</net_weight>
                    <unit>1</unit>
                    <size>1</size>
                    <material_group>1</material_group>
                    <reject_lifecycle>1</reject_lifecycle>
                    <whc_sn_in_mode>false</whc_sn_in_mode>
                    <sku_code>1</sku_code>
                    <is_unified_all_wh>false</is_unified_all_wh>
                    <lockup_lifecycle>1</lockup_lifecycle>
                    <is_sn_mgt>false</is_sn_mgt>
                    <advent_lifecycle>1</advent_lifecycle>
                    <is_unified_all_wh_carton>false</is_unified_all_wh_carton>
                    <goods_value>1.22</goods_value>
                    <need_measure_image_carton>false</need_measure_image_carton>
                    <is_po_mgt>false</is_po_mgt>
                    <use_yn>false</use_yn>
                    <goods_no>1</goods_no>
                    <pcs>1</pcs>
                    <material_class>1</material_class>
                    <cost_price>1</cost_price>
                    <specification>1</specification>
                    <specification_type>1</specification_type>
                    <packaging_scheme>1</packaging_scheme>
                    <cn_product_code>1</cn_product_code>
                    <approval_number>1</approval_number>
                    <sn_mode>1</sn_mode>
                    <is_hygroscopic>false</is_hygroscopic>
                    <cn_cubage>1</cn_cubage>
                    <is_standard>false</is_standard>
                    <is_batch_mgt>false</is_batch_mgt>
                    <is_shelflife>false</is_shelflife>
                    <need_measure_image>false</need_measure_image>
                </cnsku_feature_d_t_o>
                <feature_map>1</feature_map>
                <status>1</status>
            </cnsku_d_t_o>
        </data>
        <page_index>1</page_index>
        <total_num>1</total_num>
        <is_system_failed>false</is_system_failed>
        <sys_error_code>errorCode</sys_error_code>
        <page_size>20</page_size>
        <is_success>true</is_success>
        <error_m_s_g>errorMessage</error_m_s_g>
    </result>
</alibaba_ascp_cnsku_search_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部