注意：以下文档只适用于TOP接口，请谨慎使用！

文档中心 > API类目 > AE-商品

AE-商品

aliexpress.offer.draftproduct.get (查询草稿箱里的产品信息)

根据商品id查询单个商品的详细信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 可选 1307422965 商品ID

响应参数

名称 类型 示例值 描述
result AeopFindProductResultDto result
  • └ add_unit
  • Number
  • 11
  • 每增加件数.取值范围1-1000。
  • └ add_weight
  • String
  • 11.11
  • 对应增加的重量.取值范围:0.001-500.000,保留三位小数,采用进位制,单位:公斤。
  • aeop_a_e_multimedia
  • AeopAeMultimedia
  • aeopAEMultimedia":{"aeopAEVideos":[{"mediaId":30994083,"posterUrl":"http://img02.taobaocdn.com/bao/uploaded/TB16e9MJVXXXXacXVXXXXXXXXXX.jpg","mediaStatus":"approved","mediaType":"video","aliMemberId":225671041}]}
  • 商品多媒体信息，该属性主要包含商品的视频列表
  • aeop_a_e_videos
  • AeopAeVideo []
  • [ { "aliMemberId": 117284237, "mediaId": 35683461, "mediaType": "video", "mediaStatus": "approved", "posterUrl": "http://img02.taobaocdn.com/bao/uploaded/TB1a7HKLVXXXXX5XVXXXXXXXXXX.jpg" }]
  • 多媒体信息。
  • └ ali_member_id
  • Number
  • 1006680305
  • 卖家主账户ID
  • └ media_id
  • Number
  • 12345678
  • 视频ID
  • └ media_status
  • String
  • approved
  • 视频的状态
  • └ media_type
  • String
  • video
  • 视频的类型
  • └ poster_url
  • String
  • http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg
  • 视频封面图片的URL
  • aeop_ae_product_propertys
  • AeopAeProductProperty []
  • 商品的类目属性
  • └ attr_name
  • String
  • size
  • 自定义属性名属性名。 自定义属性名时,该项必填.
  • └ attr_name_id
  • Number
  • 200000043
  • 属性名ID。从类目属性接口getAttributesResultByCateId获取普通类目属性，不可填入sku属性。 自定义属性名时,该项不填.
  • └ attr_value
  • String
  • 2 - 5 kg
  • 自定义属性值。自定义属性名时,该项必填。 当自定义属性值内容为区间情况时，建议格式2 - 5 kg。(注意，数字'-'单位三者间是要加空格的！)
  • └ attr_value_end
  • String
  • 0
  • 自定义属性值的结束端
  • └ attr_value_start
  • String
  • 0
  • 自定义属性值的开始端
  • └ attr_value_unit
  • String
  • 0
  • 自定义属性值单位
  • └ attr_value_id
  • Number
  • 493
  • 属性值ID
  • aeop_ae_product_s_k_us
  • AeopAeProductSku []
  • 商品的SKU信息
  • aeop_s_k_u_property_list
  • AeopSkuProperty []
  • "aeopSKUProperty":[{"skuPropertyId":"14","propertyValueId":"771"},{"skuPropertyId":"25","propertyValueId":"775"}]
  • Sku属性对象list，允许1-3个sku属性对象，按sku属性顺序排放。sku属性从类目属性接口getAttributesResultByCateId获取。该项值输入sku属性，不能输入普通类目属性。注意，sku属性是有顺序的，必须按照顺序存放。
  • └ property_value_definition_name
  • String
  • 标准套餐
  • 属性值定义名称
  • └ sku_image
  • String
  • http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg
  • SKU图片地址
  • └ sku_property_id
  • Number
  • 14
  • SKU属性ID
  • └ property_value_id
  • Number
  • 366
  • SKU属性值ID
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ id
  • String
  • "200000182:193;200007763:201336100"
  • SKU ID，格式：“sku_property_id:property_value_id”
  • └ ipm_sku_stock
  • Number
  • 1234
  • SKU实际可售库存属性ipmSkuStock，该属性值的合理取值范围为0~999999，如该商品有SKU时，请确保至少有一个SKU是有货状态，也就是ipmSkuStock取值是1~999999，在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性，那么系统以ipmSkuStock属性为优先；如果没有设置ipmSkuStock属性，那么系统会根据skuStock属性进行设置库存，true表示999，false表示0。
  • └ sku_code
  • String
  • cfas00978
  • Sku商家编码。 格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价（productprice）和商品编码，需要完整生成一条SKU记录提交，否则商品编码无法保存。系统会认为只提交了零售价，而没有SKU，导致商品编辑未保存。
  • └ sku_price
  • String
  • 200.07
  • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07，表示:200美元7分。需要在正确的价格区间内。
  • └ sku_stock
  • Boolean
  • true
  • Sku库存,数据格式有货true，无货false；至少有一条sku记录是有货的。
  • └ barcode
  • String
  • 0
  • 条码，所有的仓发商品（尖货，自营，假发）会返回这个参数
  • aeop_s_k_u_national_discount_price_list
  • AeopSkuNationalDiscountPrice []
  • sku分国家的日常促销价
  • └ discount_price
  • String
  • 9.98
  • sku分国家的日常促销价价格
  • └ shipto_country
  • String
  • RU
  • sku分国家的日常促销价国家
  • └ sku_discount_price
  • String
  • 10.01
  • sku日常促销价
  • └ base_unit
  • Number
  • 2
  • 自定义计重的基本产品件数
  • └ bulk_discount
  • Number
  • 90
  • 产品的批发折扣
  • └ bulk_order
  • Number
  • 10
  • 享受批发价的产品数
  • └ category_id
  • Number
  • 123456
  • 产品所在类目的ID
  • └ coupon_end_date
  • Date
  • 0
  • 卡券商品结束有效期
  • └ coupon_start_date
  • Date
  • 0
  • 卡券商品开始有效期
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ delivery_time
  • Number
  • 60
  • 商品的备货期
  • └ detail
  • String
  • <div></div>
  • 商品详描
  • └ gross_weight
  • String
  • 40.12
  • 产品的毛重
  • └ image_u_r_ls
  • String
  • http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg
  • 产品的主图列表
  • └ is_image_dynamic
  • Boolean
  • true
  • 是否是动态图产品
  • └ is_pack_sell
  • Boolean
  • true
  • 是否支持是自定义计重
  • └ keyword
  • String
  • 0
  • 关键字
  • └ lot_num
  • Number
  • 1
  • 每包的数量
  • └ mobile_detail
  • String
  • balalaba
  • 商品无线详描
  • └ owner_member_id
  • String
  • aliqatest01
  • 商品拥有者的login_id
  • └ owner_member_seq
  • Number
  • 1006680305
  • 商品拥有者的ID
  • └ package_height
  • Number
  • 30
  • 产品的高度
  • └ package_length
  • Number
  • 10
  • 产品的长度
  • └ package_width
  • Number
  • 20
  • 产品的宽度
  • └ product_id
  • Number
  • 1234
  • 产品ID
  • └ product_more_keywords1
  • String
  • 0
  • productMoreKeywords1
  • └ product_more_keywords2
  • String
  • 0
  • productMoreKeywords2
  • └ product_price
  • String
  • 10.23
  • 单品产品的价格。
  • └ product_status_type
  • String
  • onSelling
  • 产品的状态，包括onSelling（正在销售），offline（已下架），auditing（审核中），editingRequired（审核不通过）
  • └ product_unit
  • Number
  • 100000015
  • 产品的单位
  • └ promise_template_id
  • Number
  • 100
  • 产品所关联的服务模版
  • └ reduce_strategy
  • String
  • place_order_withhold或payment_success_deduct
  • 库存的扣减策略
  • └ sizechart_id
  • Number
  • 123
  • 产品所关联的尺码模版ID
  • └ src
  • String
  • 1688
  • 产品来源。'tdx'为淘宝代销产品，'1688'为1688分销商品，'isv'为通过API发布的商品。其他字符或空为普通产品。
  • └ subject
  • String
  • knew odd
  • 产品的标题
  • └ summary
  • String
  • 0
  • 商品概要
  • └ ws_valid_num
  • Number
  • 30
  • 产品的有效期
  • aeop_national_quote_configuration
  • AeopNationalQuoteConfiguration
  • 商品分国家定价规则数据，建议使用新格式，请参考：https://developers.aliexpress.com/doc.htm?docId=109575&docType=1
  • └ configuration_data
  • String
  • [{"shiptoCountry":"US","percentage":"5"},{"shiptoCountry":"RU","percentage":"-2"}]
  • jsonArray格式的分国家定价规则数据。 1)基于基准价格按比例配置的数据格式：[{"shiptoCountry":"US","percentage":"5"},{"shiptoCountry":"RU","percentage":"-2"}] 其中shiptoCountry：ISO两位的国家编码（目前支持11个国家：RU,US,CA,ES,FR,UK,NL,IL,BR,CL,AU）， percentage：相对于基准价的调价比例（百分比整数，支持负数，当前限制>=-30 && <=100）
  • └ configuration_type
  • String
  • percentage
  • 分国家定价规则类型[percentage：基于基准价格按比例配置]
  • └ package_type
  • Boolean
  • true
  • 打包销售: true 非打包销售:false
  • └ gmt_modified
  • Date
  • 2018-12-18 17:11:08
  • 修改日期
  • └ gmt_create
  • Date
  • 2018-12-03 15:17:33
  • 创建日期
  • └ src_detail_url
  • String
  • https://detail.1688.com/offer/123.html
  • 产品来源的详情地址，目前仅支持1688
  • └ freight_template_id
  • Number
  • 1
  • 商品关联的运费模板Id
  • └ ext_param
  • String
  • { "custom_image": { "image": { "RU": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "BR": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "ES": "" }, "process_customized_image": true }, "vat_tags": [{ "sku_id": "200007763:201336100", "is_sku_vat_tag": true }] }
  • Json字符串custom_imagem 分国家 vat_tags 含税标

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressOfferDraftproductGetRequest req = new AliexpressOfferDraftproductGetRequest();
req.setProductId(1307422965L);
AliexpressOfferDraftproductGetResponse 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
<aliexpress_offer_draftproduct_get_response>
    <result>
        <add_unit>11</add_unit>
        <add_weight>11.11</add_weight>
        <aeop_a_e_multimedia>
            <aeop_a_e_videos>
                <aeop_ae_video>
                    <ali_member_id>1006680305</ali_member_id>
                    <media_id>12345678</media_id>
                    <media_status>approved</media_status>
                    <media_type>video</media_type>
                    <poster_url>http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg</poster_url>
                </aeop_ae_video>
            </aeop_a_e_videos>
        </aeop_a_e_multimedia>
        <aeop_ae_product_propertys>
            <aeop_ae_product_property>
                <attr_name>size</attr_name>
                <attr_name_id>200000043</attr_name_id>
                <attr_value>2 - 5 kg</attr_value>
                <attr_value_end>0</attr_value_end>
                <attr_value_start>0</attr_value_start>
                <attr_value_unit>0</attr_value_unit>
                <attr_value_id>493</attr_value_id>
            </aeop_ae_product_property>
        </aeop_ae_product_propertys>
        <aeop_ae_product_s_k_us>
            <aeop_ae_product_sku>
                <aeop_s_k_u_property_list>
                    <aeop_sku_property>
                        <property_value_definition_name>标准套餐</property_value_definition_name>
                        <sku_image>http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg</sku_image>
                        <sku_property_id>14</sku_property_id>
                        <property_value_id>366</property_value_id>
                    </aeop_sku_property>
                </aeop_s_k_u_property_list>
                <currency_code>USD</currency_code>
                <id>&quot;200000182:193;200007763:201336100&quot;</id>
                <ipm_sku_stock>1234</ipm_sku_stock>
                <sku_code>cfas00978</sku_code>
                <sku_price>200.07</sku_price>
                <sku_stock>true</sku_stock>
                <barcode>0</barcode>
                <aeop_s_k_u_national_discount_price_list>
                    <aeop_sku_national_discount_price>
                        <discount_price>9.98</discount_price>
                        <shipto_country>RU</shipto_country>
                    </aeop_sku_national_discount_price>
                </aeop_s_k_u_national_discount_price_list>
                <sku_discount_price>10.01</sku_discount_price>
            </aeop_ae_product_sku>
        </aeop_ae_product_s_k_us>
        <base_unit>2</base_unit>
        <bulk_discount>90</bulk_discount>
        <bulk_order>10</bulk_order>
        <category_id>123456</category_id>
        <coupon_end_date>0</coupon_end_date>
        <coupon_start_date>0</coupon_start_date>
        <currency_code>USD</currency_code>
        <delivery_time>60</delivery_time>
        <detail>&lt;div&gt;&lt;/div&gt;</detail>
        <gross_weight>40.12</gross_weight>
        <image_u_r_ls>http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg</image_u_r_ls>
        <is_image_dynamic>true</is_image_dynamic>
        <is_pack_sell>true</is_pack_sell>
        <keyword>0</keyword>
        <lot_num>1</lot_num>
        <mobile_detail>balalaba</mobile_detail>
        <owner_member_id>aliqatest01</owner_member_id>
        <owner_member_seq>1006680305</owner_member_seq>
        <package_height>30</package_height>
        <package_length>10</package_length>
        <package_width>20</package_width>
        <product_id>1234</product_id>
        <product_more_keywords1>0</product_more_keywords1>
        <product_more_keywords2>0</product_more_keywords2>
        <product_price>10.23</product_price>
        <product_status_type>onSelling</product_status_type>
        <product_unit>100000015</product_unit>
        <promise_template_id>100</promise_template_id>
        <reduce_strategy>place_order_withhold或payment_success_deduct</reduce_strategy>
        <sizechart_id>123</sizechart_id>
        <src>1688</src>
        <subject>knew odd</subject>
        <summary>0</summary>
        <ws_valid_num>30</ws_valid_num>
        <aeop_national_quote_configuration>
            <configuration_data>[{&quot;shiptoCountry&quot;:&quot;US&quot;,&quot;percentage&quot;:&quot;5&quot;},{&quot;shiptoCountry&quot;:&quot;RU&quot;,&quot;percentage&quot;:&quot;-2&quot;}]</configuration_data>
            <configuration_type>percentage</configuration_type>
        </aeop_national_quote_configuration>
        <package_type>true</package_type>
        <gmt_modified>2018-12-18 17:11:08</gmt_modified>
        <gmt_create>2018-12-03 15:17:33</gmt_create>
        <src_detail_url>https://detail.1688.com/offer/123.html</src_detail_url>
        <freight_template_id>1</freight_template_id>
        <ext_param>{   &quot;custom_image&quot;: {     &quot;image&quot;: {       &quot;RU&quot;: &quot;http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg&quot;,       &quot;BR&quot;: &quot;http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg&quot;,       &quot;ES&quot;: &quot;&quot;     },     &quot;process_customized_image&quot;: true   },   &quot;vat_tags&quot;: [{     &quot;sku_id&quot;: &quot;200007763:201336100&quot;,     &quot;is_sku_vat_tag&quot;: true   }] }</ext_param>
    </result>
</aliexpress_offer_draftproduct_get_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

我要提问
返回
顶部

阿里巴巴集团|淘宝网|天猫|聚划算|全球速卖通|阿里巴巴国际交易市场|1688|阿里妈妈|阿里旅行 · 去啊|阿里云计算|YunOS|阿里通信|万网|高德|UC|友盟+

虾米|天天动听|来往|钉钉|支付宝

© 2009-2017 Aliyun.com 版权所有 ICP证：浙B2-20080101售前咨询 技术支持官方微博