文档中心 > API类目 > 五道口API

alibaba.wdk.sku.query (查询商品)

查询商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param SkuQueryDo 必须 入参
  • └ sku_codes
  • String []
  • 必须
  • [1]
  • 商品编码列表
  • └ ou_code
  • String
  • 可选
  • 1062
  • 门店或DC编码

响应参数

名称 类型 示例值 描述
result ApiResults 223 调用结果
  • └ err_code
  • String
  • NON_EMPTY_PARAMETERS
  • 错误编码
  • └ err_msg
  • String
  • 参数不能为空
  • 错误信息
  • models
  • ApiResult []
  • 请见子字段
  • 结果集合
  • model
  • SkuDo
  • 请见子字段
  • 单条查询结果
  • └ shelf_life
  • Number
  • 12
  • 保质期天数,商品的保质期(单位:天),0表示没有保质期
  • └ barcodes
  • String
  • sdfds
  • 编码
  • └ inventory_unit
  • String
  • kg
  • inventoryUnit
  • └ weight
  • String
  • 10
  • 一个库存单位的审批重量
  • └ width
  • String
  • 23
  • 宽度(宽)
  • └ sku_type
  • Number
  • 1
  • skuType
  • └ suggested_price
  • String
  • 1000
  • suggestedPrice
  • └ ou_code
  • String
  • 4746
  • ouCode
  • └ standard_no
  • String
  • W234
  • standardNo
  • └ manufacturer_name
  • String
  • 天天红
  • manufacturerName
  • └ brand_name
  • String
  • 洛川红富士
  • brandName
  • └ detail_pic_urls
  • String
  • https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png
  • detailPicUrls
  • └ weight_flag
  • Number
  • 1
  • weightFlag
  • └ height
  • String
  • 152
  • 高度
  • └ sku_name
  • String
  • 小龙虾 30-40g/只 称重
  • skuName
  • └ length
  • String
  • 122
  • 长度
  • └ sku_code
  • String
  • 34242
  • skuCode
  • └ category_code
  • String
  • 234234
  • categoryCode
  • └ producer_place
  • String
  • 中国|辽宁省|大连市
  • producerPlace
  • └ main_pic_urls
  • String
  • https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png
  • mainPicUrls
  • └ storage_type
  • Number
  • 1
  • storageType
  • └ tax_rate
  • String
  • 15
  • taxRate
  • └ manufacturer_address
  • String
  • 陕西西安
  • manufacturerAddress
  • └ import_flag
  • Number
  • 0
  • 是否进口
  • └ net_content
  • String
  • 250ml*18盒/箱
  • 净含量
  • └ accounting_category
  • String
  • 22
  • 财务核算分类
  • └ sale_price
  • String
  • 10
  • 商品销售价格,单位元
  • └ sale_unit
  • String
  • 销售单位
  • └ input_invoice_content
  • String
  • 17
  • 进项税率
  • └ invoice_content
  • String
  • invoiceContent
  • invoiceContent
  • └ short_title
  • String
  • 美味可口
  • 小标题
  • └ txt_desc
  • String
  • 传统非转基因压榨工艺
  • 文描
  • └ life_status
  • String
  • A
  • 商品在机构内的生命周期,商品状态;A-正常、T-暂时停购、C-淘汰出清、R-清退、D-删除封挡,传ATCRD
  • └ sale_spec
  • String
  • 500g*5/袋
  • 销售规格
  • └ org_no
  • String
  • 233344
  • 机构编号
  • └ hm_category_code
  • String
  • 11221
  • 平台类目
  • └ rich_text
  • String
  • 绿色xx商品
  • 文描
  • └ alias_name
  • String
  • 商品别名
  • 商品别名
  • └ producer_name
  • String
  • 张三
  • 生产商名称
  • └ factory_no
  • String
  • 12245
  • 厂方货号
  • └ component
  • String
  • 成份
  • └ storage
  • String
  • 常温
  • 存储条件
  • └ grade
  • String
  • 特级
  • 产品等级
  • └ eat_way
  • String
  • 开袋即食
  • 食用方式
  • └ origin_code
  • String
  • 11122
  • 溯源国标码
  • └ input_tax_rate
  • String
  • 商品进项税率
  • 商品进项税率
  • └ input_tax_rate_code
  • String
  • 食品
  • 开票内容
  • └ finance_type_code
  • String
  • 财务核算分类编码
  • 财务核算分类编码
  • └ tax_rate_code
  • String
  • 食品
  • 开票内容
  • └ forest_cate_id
  • Number
  • 11232
  • forest类目id
  • └ purchase_spec
  • String
  • 12/箱
  • 采购规格
  • └ purchase_unit
  • String
  • 采配单位
  • └ purchase_unit_code
  • String
  • 111222
  • 采配编码
  • └ inventory_unit_code
  • String
  • 111222
  • 存储单位编码
  • └ acceptance_criteria
  • String
  • 称重
  • 货物验收标准
  • └ overload_rate
  • String
  • 1
  • 超收比率
  • └ forbid_receive_days
  • Number
  • 0
  • 禁收时限
  • └ forbid_sales_days
  • Number
  • 0
  • 禁售时限
  • └ delivery_unit
  • String
  • 配货单位名称
  • └ delivery_unit_code
  • String
  • 1111222
  • 配货单位编码
  • └ delivery_spec
  • String
  • 12/个
  • 配货规格
  • └ processing_unit
  • String
  • 加工单位 取值选项和采购单位的可选项一致
  • └ processing_unit_code
  • String
  • 111222
  • 加工单位编码
  • └ cost_unit
  • String
  • 成本单位名称
  • └ cost_unit_code
  • String
  • 111222
  • 成本单位编码
  • └ procs_exchange_rate
  • String
  • 1
  • 加工换算率
  • └ cost_exchange_rate
  • String
  • 1
  • 成本换算率
  • └ mass_output_rate
  • String
  • 1
  • 出料率
  • └ cost_tax_price
  • String
  • 100
  • 考核成本价(含税)
  • └ cost_no_price
  • String
  • 90
  • 考核成本价(不含税)
  • └ sku_label_type
  • String
  • NOMAL
  • 商品标类型
  • └ sku_label_type_code
  • String
  • 111222
  • 商品标编码
  • └ warn_days
  • Number
  • 100
  • 保质期预警天数
  • └ allow_app_sale
  • Number
  • 0
  • 是否允许在app上售卖 1:是 0:否(默认为0)
  • └ item_sale_type
  • Number
  • 1
  • 1、普通商品 2、预售商品
  • └ sub_title
  • String
  • 新鲜
  • 商品副标题卖点
  • └ title1
  • String
  • 新鲜
  • 卖点1名称
  • └ sub_title1
  • String
  • 新鲜
  • 卖点1内容
  • └ title2
  • String
  • 便宜
  • 卖点2名称
  • └ sub_title2
  • String
  • 便宜
  • 卖点2内容
  • └ sale_unit_code
  • String
  • 销售单位(取值选项和采购单位的可选项一致)
  • └ label_style_type
  • String
  • 无价签
  • 标价签类型;商品在门店陈列时,采用的售价标签类型。因不采用电子价签,建议淘鲜达商家填默认值“无价签”
  • └ label_price_type_code
  • String
  • 111222
  • 标价签类型编码
  • └ fixed_flag
  • Number
  • 0
  • 是否定制品 0 否 1 是
  • └ avg_weight
  • String
  • 500
  • 均重(销售时库存单位与销售单位的转换)
  • └ pre_minus_weight
  • String
  • 10
  • 预扣款重量(扣款时销售单位与库存单位的转换)
  • └ step_quantity
  • Number
  • 2
  • APP销售时,基于销售单位的步长
  • └ purchase_quantity
  • Number
  • 1
  • APP销售时,基于销售单位的起购量
  • └ store_id
  • String
  • 111222
  • 门店id
  • └ store_name
  • String
  • 111222
  • 门店名称
  • └ channel_codes
  • String
  • 11,222,333
  • 发布渠道
  • └ supplier_no
  • String
  • 111222
  • 默认供应商
  • └ supplier_name
  • String
  • 张三
  • 默认供应商名称
  • └ logistics
  • String
  • 111222
  • 默认物流中心
  • └ logistics_name
  • String
  • 中央xxx
  • 默认物流中心名称
  • └ delivery_warehouse
  • String
  • 111222
  • 配货逻辑仓
  • └ delivery_warehouse_name
  • String
  • 中央xx仓储
  • 配货逻辑仓名称
  • └ return_warehouse
  • String
  • 111222
  • 退货逻辑仓
  • └ return_warehouse_name
  • String
  • 中央xx仓储
  • 退货逻辑仓名称
  • └ delivery_way
  • String
  • 111222
  • 配送方式
  • └ delivery_way_name
  • String
  • 冷链
  • 配送方式名称
  • └ processing_time
  • Number
  • 5
  • 加工时间
  • └ service_items
  • String
  • 111,222,333
  • 服务商品,skucode
  • └ default_sku_price
  • String
  • 10
  • 默认商品价格(同SKU在当前渠道的价格)
  • └ member_price
  • String
  • 9
  • 商品会员价格(主要用于对接线下的)
  • └ online_sale_flag
  • Number
  • 1
  • 是否线上可售 是 0:否 1:是
  • └ sale_flag_for_query
  • Number
  • 1
  • 是否可售,用于查询商品的时候标识商品的可售状态,1可售 0不可售
  • sku_suppliers
  • SkuSupplierDo []
  • skuSuppliers
  • └ supplier_no
  • String
  • 111222
  • 供应商编码
  • └ supplier_name
  • String
  • 张三
  • 供应商编码名称
  • └ return_flag
  • Number
  • 1
  • 是否可退 1可退 0不可退
  • └ minimum
  • String
  • 100
  • 最小起订量
  • └ main_flag
  • Number
  • 1
  • 是否主供应商 1是主供应商 0非主供
  • └ purchase_price
  • String
  • 9.9
  • 采购单价;淘鲜达合作商家填默认值0;单位:元
  • └ storage_code
  • String
  • 111222
  • 存储条件编码
  • └ item_type_new
  • Number
  • 1
  • 商品类型1:普通商品、2:加工半成品、3:加工成品、4:原材料、5:耗材;
  • └ merchant_cat_code
  • String
  • 10086
  • 商家后台类目编码(同字段category_code)
  • └ sku_pic_urls
  • String
  • https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png
  • 在app上显示的商品图片cdn地址(同字段main_pic_urls和detail_pic_urls),https开头,多个图片用英文逗号切割。第一张图片会作为主图;优先使用本字段
  • └ back_cat_code
  • String
  • 10086
  • 平台类目编码(同字段hm_category_code),需要商家把自己的类目对应到平台的类目上,此字段暂时只能支持3、4级类目修改;优先使用本字段
  • └ period
  • Number
  • 15
  • 商品的保质期天数(同字段shelf_life),必须为整数,0代表不管理保质期;优先使用本字段
  • process_props
  • ProcessProp []
  • 加工属性
  • └ service_name
  • String
  • 宰杀
  • 服务名
  • service_props
  • ProcessProp []
  • 服务属性
  • └ prop_name
  • String
  • 温度
  • 属性名
  • prop_values
  • ServicePropValue []
  • 属性值
  • └ name
  • String
  • 常温
  • 属性值名称
  • mutex_props
  • ServiceProp []
  • 互斥属性
  • prop_a
  • MutexProp
  • 互斥属性A
  • └ name
  • String
  • 温度
  • 属性项
  • └ value
  • String
  • 常温
  • 属性值
  • prop_b
  • MutexProp
  • 互斥属性B
  • └ name
  • String
  • 加冰
  • 属性项
  • └ value
  • String
  • 少冰
  • 属性值
  • voucher_ext
  • SelfPickUpVoucherInfoDO
  • 券类商品扩展信息
  • └ voucher_type
  • Number
  • 2
  • 券类型,1. 自提券 2. 代金券
  • └ start_time
  • Date
  • 2024-01-28 00:00:00
  • 核销开始时间
  • └ end_time
  • Date
  • 2024-01-29 00:00:00
  • 核销结束时间
  • └ association_skus
  • String []
  • []
  • 关联实物品商品编码
  • └ err_code
  • String
  • NON_EMPTY_PARAMETERS
  • 请求参数不能为空
  • └ err_msg
  • String
  • 参数不能为空
  • 单条错误信息
  • └ success
  • Boolean
  • true
  • 单条是否成功
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkSkuQueryRequest req = new AlibabaWdkSkuQueryRequest();
AlibabaWdkSkuQueryRequest.SkuQueryDo obj1 = new AlibabaWdkSkuQueryRequest.SkuQueryDo();
obj1.setSkuCodes("1");
obj1.setOuCode("1062");
req.setParam(obj1);
AlibabaWdkSkuQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_wdk_sku_query_response>
    <result>
        <err_code>NON_EMPTY_PARAMETERS</err_code>
        <err_msg>参数不能为空</err_msg>
        <models>
            <api_result>
                <model>
                    <shelf_life>12</shelf_life>
                    <barcodes>sdfds</barcodes>
                    <inventory_unit>kg</inventory_unit>
                    <weight>10</weight>
                    <width>23</width>
                    <sku_type>1</sku_type>
                    <suggested_price>1000</suggested_price>
                    <ou_code>4746</ou_code>
                    <standard_no>W234</standard_no>
                    <manufacturer_name>天天红</manufacturer_name>
                    <brand_name>洛川红富士</brand_name>
                    <detail_pic_urls>https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png</detail_pic_urls>
                    <weight_flag>1</weight_flag>
                    <height>152</height>
                    <sku_name>小龙虾 30-40g/只 称重</sku_name>
                    <length>122</length>
                    <sku_code>34242</sku_code>
                    <category_code>234234</category_code>
                    <producer_place>中国|辽宁省|大连市</producer_place>
                    <main_pic_urls>https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png</main_pic_urls>
                    <storage_type>1</storage_type>
                    <tax_rate>15</tax_rate>
                    <manufacturer_address>陕西西安</manufacturer_address>
                    <import_flag>0</import_flag>
                    <net_content>250ml*18盒/箱</net_content>
                    <accounting_category>22</accounting_category>
                    <sale_price>10</sale_price>
                    <sale_unit>个</sale_unit>
                    <input_invoice_content>17</input_invoice_content>
                    <invoice_content>invoiceContent</invoice_content>
                    <short_title>美味可口</short_title>
                    <txt_desc>传统非转基因压榨工艺</txt_desc>
                    <life_status>A</life_status>
                    <sale_spec>500g*5/袋</sale_spec>
                    <org_no>233344</org_no>
                    <hm_category_code>11221</hm_category_code>
                    <rich_text>绿色xx商品</rich_text>
                    <alias_name>商品别名</alias_name>
                    <producer_name>张三</producer_name>
                    <factory_no>12245</factory_no>
                    <component>糖</component>
                    <storage>常温</storage>
                    <grade>特级</grade>
                    <eat_way>开袋即食</eat_way>
                    <origin_code>11122</origin_code>
                    <input_tax_rate>商品进项税率</input_tax_rate>
                    <input_tax_rate_code>食品</input_tax_rate_code>
                    <finance_type_code>财务核算分类编码</finance_type_code>
                    <tax_rate_code>食品</tax_rate_code>
                    <forest_cate_id>11232</forest_cate_id>
                    <purchase_spec>12/箱</purchase_spec>
                    <purchase_unit>箱</purchase_unit>
                    <purchase_unit_code>111222</purchase_unit_code>
                    <inventory_unit_code>111222</inventory_unit_code>
                    <acceptance_criteria>称重</acceptance_criteria>
                    <overload_rate>1</overload_rate>
                    <forbid_receive_days>0</forbid_receive_days>
                    <forbid_sales_days>0</forbid_sales_days>
                    <delivery_unit>条</delivery_unit>
                    <delivery_unit_code>1111222</delivery_unit_code>
                    <delivery_spec>12/个</delivery_spec>
                    <processing_unit>条</processing_unit>
                    <processing_unit_code>111222</processing_unit_code>
                    <cost_unit>条</cost_unit>
                    <cost_unit_code>111222</cost_unit_code>
                    <procs_exchange_rate>1</procs_exchange_rate>
                    <cost_exchange_rate>1</cost_exchange_rate>
                    <mass_output_rate>1</mass_output_rate>
                    <cost_tax_price>100</cost_tax_price>
                    <cost_no_price>90</cost_no_price>
                    <sku_label_type>NOMAL</sku_label_type>
                    <sku_label_type_code>111222</sku_label_type_code>
                    <warn_days>100</warn_days>
                    <allow_app_sale>0</allow_app_sale>
                    <item_sale_type>1</item_sale_type>
                    <sub_title>新鲜</sub_title>
                    <title1>新鲜</title1>
                    <sub_title1>新鲜</sub_title1>
                    <title2>便宜</title2>
                    <sub_title2>便宜</sub_title2>
                    <sale_unit_code>个</sale_unit_code>
                    <label_style_type>无价签</label_style_type>
                    <label_price_type_code>111222</label_price_type_code>
                    <fixed_flag>0</fixed_flag>
                    <avg_weight>500</avg_weight>
                    <pre_minus_weight>10</pre_minus_weight>
                    <step_quantity>2</step_quantity>
                    <purchase_quantity>1</purchase_quantity>
                    <store_id>111222</store_id>
                    <store_name>111222</store_name>
                    <channel_codes>11,222,333</channel_codes>
                    <supplier_no>111222</supplier_no>
                    <supplier_name>张三</supplier_name>
                    <logistics>111222</logistics>
                    <logistics_name>中央xxx</logistics_name>
                    <delivery_warehouse>111222</delivery_warehouse>
                    <delivery_warehouse_name>中央xx仓储</delivery_warehouse_name>
                    <return_warehouse>111222</return_warehouse>
                    <return_warehouse_name>中央xx仓储</return_warehouse_name>
                    <delivery_way>111222</delivery_way>
                    <delivery_way_name>冷链</delivery_way_name>
                    <processing_time>5</processing_time>
                    <service_items>111,222,333</service_items>
                    <default_sku_price>10</default_sku_price>
                    <member_price>9</member_price>
                    <online_sale_flag>1</online_sale_flag>
                    <sale_flag_for_query>1</sale_flag_for_query>
                    <sku_suppliers>
                        <sku_supplier_do>
                            <supplier_no>111222</supplier_no>
                            <supplier_name>张三</supplier_name>
                            <return_flag>1</return_flag>
                            <minimum>100</minimum>
                            <main_flag>1</main_flag>
                            <purchase_price>9.9</purchase_price>
                        </sku_supplier_do>
                    </sku_suppliers>
                    <storage_code>111222</storage_code>
                    <item_type_new>1</item_type_new>
                    <merchant_cat_code>10086</merchant_cat_code>
                    <sku_pic_urls>https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png</sku_pic_urls>
                    <back_cat_code>10086</back_cat_code>
                    <period>15</period>
                    <process_props>
                        <process_prop>
                            <service_name>宰杀</service_name>
                        </process_prop>
                    </process_props>
                    <service_props>
                        <process_prop>
                            <prop_name>温度</prop_name>
                            <prop_values>
                                <service_prop_value>
                                    <name>常温</name>
                                </service_prop_value>
                            </prop_values>
                        </process_prop>
                    </service_props>
                    <mutex_props>
                        <service_prop>
                            <prop_a>
                                <name>温度</name>
                                <value>常温</value>
                            </prop_a>
                            <prop_b>
                                <name>加冰</name>
                                <value>少冰</value>
                            </prop_b>
                        </service_prop>
                    </mutex_props>
                    <voucher_ext>
                        <voucher_type>2</voucher_type>
                        <start_time>2024-01-28 00:00:00</start_time>
                        <end_time>2024-01-29 00:00:00</end_time>
                        <association_skus>
                            <string>[]</string>
                        </association_skus>
                    </voucher_ext>
                </model>
                <err_code>NON_EMPTY_PARAMETERS</err_code>
                <err_msg>参数不能为空</err_msg>
                <success>true</success>
            </api_result>
        </models>
        <success>true</success>
    </result>
</alibaba_wdk_sku_query_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

返回
顶部