文档中心 > API文档

aliexpress.postproduct.redefining.findaeproductbyidfordropshipper (Dropshipper查找商品信息接口)

提供给Dropshipper的通过商品ID查找商品信息的接口,只有特定买家可以使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 可选 1307422965 商品ID
local_country String 可选 RU 国家
local_language String 可选 ru 语言

响应参数

名称 类型 示例值 描述
result AeopFindProductResultDto result
  • aeop_ae_product_s_k_us
  • AeopAeProductSku []
  • 0
  • 商品的SKU信息
  • └ sku_stock
  • Boolean
  • true
  • Sku库存,数据格式有货true,无货false;至少有一条sku记录是有货的。
  • └ sku_price
  • String
  • 200.07
  • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07,表示:200美元7分。需要在正确的价格区间内。
  • └ sku_code
  • String
  • cfas00978
  • Sku商家编码。 格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价(productprice)和商品编码,需要完整生成一条SKU记录提交,否则商品编码无法保存。系统会认为只提交了零售价,而没有SKU,导致商品编辑未保存。
  • └ ipm_sku_stock
  • Number
  • 1234
  • SKU实际可售库存属性ipmSkuStock,该属性值的合理取值范围为0~999999,如该商品有SKU时,请确保至少有一个SKU是有货状态,也就是ipmSkuStock取值是1~999999,在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性,那么系统以ipmSkuStock属性为优先;如果没有设置ipmSkuStock属性,那么系统会根据skuStock属性进行设置库存,true表示999,false表示0。
  • └ id
  • String
  • "200000182:193;200007763:201336100"
  • SKU ID
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • aeop_s_k_u_propertys
  • AeopSkuProperty []
  • "aeopSKUProperty":[{"skuPropertyId":"14","propertyValueId":"771"},{"skuPropertyId":"25","propertyValueId":"775"}]
  • Sku属性对象list,允许1-3个sku属性对象,按sku属性顺序排放。sku属性从类目属性接口getAttributesResultByCateId获取。该项值输入sku属性,不能输入普通类目属性。注意,sku属性是有顺序的,必须按照顺序存放。
  • └ sku_property_id
  • Number
  • 0
  • skuPropertyId
  • └ sku_image
  • String
  • 0
  • skuImage
  • └ property_value_id_long
  • Number
  • 0
  • 自定义id
  • └ property_value_definition_name
  • String
  • 0
  • 自定义名
  • └ sku_property_value
  • String
  • "blue"
  • 属性值
  • └ sku_property_name
  • String
  • "color"
  • 属性名
  • └ barcode
  • String
  • 320325455
  • 商品条形码
  • └ offer_sale_price
  • String
  • 3.3
  • sku折扣价格
  • └ offer_bulk_sale_price
  • String
  • 3.2
  • sku批量折扣价
  • └ sku_bulk_order
  • Number
  • 10
  • 最少起批的数量
  • └ s_k_u_available_stock
  • Number
  • 10
  • sku库存
  • └ detail
  • String
  • <div>This is a product</div>
  • 商品详描
  • └ is_success
  • Boolean
  • true
  • 请求是否成功
  • └ product_unit
  • Number
  • 100000015
  • 产品的单位
  • └ ws_offline_date
  • Date
  • 0
  • 产品的下架日期
  • └ ws_display
  • String
  • expire_offline
  • 产品的下架原因
  • └ category_id
  • Number
  • 123456
  • 产品所在类目的ID
  • 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" }]
  • 多媒体信息。
  • └ poster_url
  • String
  • http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg
  • 视频封面图片的URL
  • └ media_type
  • String
  • video
  • 视频的类型
  • └ media_status
  • String
  • approved
  • 视频的状态
  • └ media_id
  • Number
  • 12345678
  • 视频ID
  • └ ali_member_id
  • Number
  • 1006680305
  • 卖家主账户ID
  • └ owner_member_id
  • String
  • aliqatest01
  • 商品拥有者的login_id
  • └ product_status_type
  • String
  • onSelling
  • 产品的状态
  • aeop_ae_product_propertys
  • AeopAeProductProperty []
  • {}
  • 商品的类目属性
  • └ attr_value_unit
  • String
  • piece
  • 属性单位
  • └ attr_value_start
  • String
  • 1
  • 区间属性开始值
  • └ attr_value_id
  • Number
  • 100234
  • 属性值ID
  • └ attr_value_end
  • String
  • 10
  • 区间属性结束值
  • └ attr_value
  • String
  • ABCD
  • 属性值
  • └ attr_name_id
  • Number
  • 2981
  • 属性Id
  • └ attr_name
  • String
  • 型号
  • 属性名字
  • └ gross_weight
  • String
  • 40.12
  • 产品的毛重
  • └ delivery_time
  • Number
  • 7
  • 商品的备货期
  • └ ws_valid_num
  • Number
  • 30
  • 产品的有效期
  • └ gmt_modified
  • Date
  • 0
  • 修改时间
  • └ error_message
  • String
  • 系统异常
  • 错误信息
  • └ package_type
  • Boolean
  • true
  • 包装类型
  • aeop_national_quote_configuration
  • AeopNationalQuoteConfiguration
  • 商品分国家报价的配置
  • └ configuration_type
  • String
  • percentage
  • 分国家定价规则类型[percentage:基于基准价格按比例配置]
  • └ 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)
  • └ subject
  • String
  • knew odd
  • 产品的标题
  • └ base_unit
  • Number
  • 2
  • 自定义计重的基本产品件数
  • └ package_length
  • Number
  • 10
  • 产品的长度
  • └ mobile_detail
  • String
  • {}
  • 无线详描
  • └ package_height
  • Number
  • 2
  • 产品的高度
  • └ package_width
  • Number
  • 12
  • 产品的宽度
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ gmt_create
  • Date
  • 0
  • 产品创建时间
  • └ 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
  • 产品的主图列表
  • └ product_id
  • Number
  • 32839190109
  • 产品ID
  • └ error_code
  • Number
  • 16009999
  • 错误代码
  • └ product_price
  • String
  • 10.23
  • 单品产品的价格。
  • └ item_offer_site_sale_price
  • String
  • USD 5.5
  • 网站折扣后价格
  • └ total_available_stock
  • Number
  • 12
  • 库存
  • store_info
  • AeopStoreInfo
  • n/a
  • 店铺信息
  • └ communication_rating
  • String
  • 4.8
  • 卖家服务,1-5星
  • └ item_as_descriped_rating
  • String
  • 4.8
  • 商品描述,1-5星
  • └ shipping_speed_rating
  • String
  • 4.7
  • 物流,1-5星
  • └ store_id
  • Number
  • 12345
  • 店铺ID
  • └ store_name
  • String
  • Clothes Store
  • 店铺名
  • └ evaluation_count
  • Number
  • 100
  • 评价数
  • └ avg_evaluation_rating
  • String
  • 4.7
  • 平均评价星级,1-5星
  • └ order_count
  • Number
  • 120
  • 订单数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressPostproductRedefiningFindaeproductbyidfordropshipperRequest req = new AliexpressPostproductRedefiningFindaeproductbyidfordropshipperRequest();
req.setProductId(1307422965L);
req.setLocalCountry("RU");
req.setLocalLanguage("ru");
AliexpressPostproductRedefiningFindaeproductbyidfordropshipperResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_postproduct_redefining_findaeproductbyidfordropshipper_response>
    <result>
        <aeop_ae_product_s_k_us>
            <aeop_ae_product_sku>
                <sku_stock>true</sku_stock>
                <sku_price>200.07</sku_price>
                <sku_code>cfas00978</sku_code>
                <ipm_sku_stock>1234</ipm_sku_stock>
                <id>&quot;200000182:193;200007763:201336100&quot;</id>
                <currency_code>USD</currency_code>
                <aeop_s_k_u_propertys>
                    <aeop_sku_property>
                        <sku_property_id>0</sku_property_id>
                        <sku_image>0</sku_image>
                        <property_value_id_long>0</property_value_id_long>
                        <property_value_definition_name>0</property_value_definition_name>
                        <sku_property_value>&quot;blue&quot;</sku_property_value>
                        <sku_property_name>&quot;color&quot;</sku_property_name>
                    </aeop_sku_property>
                </aeop_s_k_u_propertys>
                <barcode>320325455</barcode>
                <offer_sale_price>3.3</offer_sale_price>
                <offer_bulk_sale_price>3.2</offer_bulk_sale_price>
                <sku_bulk_order>10</sku_bulk_order>
                <s_k_u_available_stock>10</s_k_u_available_stock>
            </aeop_ae_product_sku>
        </aeop_ae_product_s_k_us>
        <detail>&lt;div&gt;This is a product&lt;/div&gt;</detail>
        <is_success>true</is_success>
        <product_unit>100000015</product_unit>
        <ws_offline_date>0</ws_offline_date>
        <ws_display>expire_offline</ws_display>
        <category_id>123456</category_id>
        <aeop_a_e_multimedia>
            <aeop_a_e_videos>
                <aeop_ae_video>
                    <poster_url>http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg</poster_url>
                    <media_type>video</media_type>
                    <media_status>approved</media_status>
                    <media_id>12345678</media_id>
                    <ali_member_id>1006680305</ali_member_id>
                </aeop_ae_video>
            </aeop_a_e_videos>
        </aeop_a_e_multimedia>
        <owner_member_id>aliqatest01</owner_member_id>
        <product_status_type>onSelling</product_status_type>
        <aeop_ae_product_propertys>
            <aeop_ae_product_property>
                <attr_value_unit>piece</attr_value_unit>
                <attr_value_start>1</attr_value_start>
                <attr_value_id>100234</attr_value_id>
                <attr_value_end>10</attr_value_end>
                <attr_value>ABCD</attr_value>
                <attr_name_id>2981</attr_name_id>
                <attr_name>型号</attr_name>
            </aeop_ae_product_property>
        </aeop_ae_product_propertys>
        <gross_weight>40.12</gross_weight>
        <delivery_time>7</delivery_time>
        <ws_valid_num>30</ws_valid_num>
        <gmt_modified>0</gmt_modified>
        <error_message>系统异常</error_message>
        <package_type>true</package_type>
        <aeop_national_quote_configuration>
            <configuration_type>percentage</configuration_type>
            <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>
        </aeop_national_quote_configuration>
        <subject>knew odd</subject>
        <base_unit>2</base_unit>
        <package_length>10</package_length>
        <mobile_detail>{}</mobile_detail>
        <package_height>2</package_height>
        <package_width>12</package_width>
        <currency_code>USD</currency_code>
        <gmt_create>0</gmt_create>
        <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>
        <product_id>32839190109</product_id>
        <error_code>16009999</error_code>
        <product_price>10.23</product_price>
        <item_offer_site_sale_price>USD 5.5</item_offer_site_sale_price>
        <total_available_stock>12</total_available_stock>
        <store_info>
            <communication_rating>4.8</communication_rating>
            <item_as_descriped_rating>4.8</item_as_descriped_rating>
            <shipping_speed_rating>4.7</shipping_speed_rating>
            <store_id>12345</store_id>
            <store_name>Clothes Store</store_name>
        </store_info>
        <evaluation_count>100</evaluation_count>
        <avg_evaluation_rating>4.7</avg_evaluation_rating>
        <order_count>120</order_count>
    </result>
</aliexpress_postproduct_redefining_findaeproductbyidfordropshipper_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

返回
顶部