淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	描述
ownerCode	String	必须	123456	货主ID
scItemCodes	String	可选		货品编码列表
fuzzyScItemName	String	可选	桌	货品名称模糊匹配
pageNo	Number	必须	1	页码
pageSize	Number	必须	100	每页数量，不大于100
bizRequestTime	Number	必须	1639466166000	业务请求时间戳（毫秒数）
bizRequestId	String	必须	xxx	业务请求ID

名称	类型	示例值	描述
data	Data		返回数据结构体
└ pageNo Number 1 页码 └ pageSize Number 100 每页数量 └ hasNext Boolean true 是否有下一页 list ScItem [] 货品列表 └ brandName String xxx 品牌名称 └ precious Number 0 是否贵重品。0表示否，1表示是 └ ownerCode String 123456 货主Code └ scItemCode String 123456 货品商家编码 └ hazardous Number 0 是否危险品。0表示否，1表示是 └ length Number 1000 长，单位毫米 └ weight Number 1000 重量，单位毫克 └ industry String NORMAL 行业。NORMAL-综合；BEAUTY-美妆；BOOKS-图书 └ remark String xxx 备注 └ categoryName String xxx 类目名称 └ warehouseCode String 123456 仓库编码 └ storageEnvironment String NORMAL 存储条件。NORMAL：常温 COOL：阴凉 5°C-12°C FRESHNESS：保鲜 0°C-4°C REEFER：冷藏 -18°C-0°C THERMOSTATIC：恒温 18°C-25°C FROZEN：冷冻 <-18°C COOL_AND_DRY：阴凉干燥 5°C-25°C,相对湿度65%以下 └ barCode String 123456 货品条码 └ picPath String http://xxx.pic 货品主图 └ liquid Number 0 是否液体。0表示否，1表示是 └ scItemName String 123456 货品名称 └ width Number 1000 宽，单位毫米 └ extendProps String {"xxx":"xxx"} 扩展属性（如果是基础扩展字段，字段名称加上前缀common.；如果是行业扩展字段，字段名称加上前缀industry.） purchasePrices PurchasePrice 供应商价格 └ currency String CNY 币种，USD-美元，CNY-人民币，RUB-卢布，JPY-日元，EUR-欧元，GBP-英镑，HKD-港币，NZD-新西兰元，SGD-新加坡元，AUD-澳元，KRW-韩元，THB-泰铢 └ price String 20007 价格，单位分 └ supplierName String xxx 供应商名称 └ currency String CNY 币种，USD-美元，CNY-人民币，RUB-卢布，JPY-日元，EUR-欧元，GBP-英镑，HKD-港币，NZD-新西兰元，SGD-新加坡元，AUD-澳元，KRW-韩元，THB-泰铢 └ fragile Number 0 是否易碎品。0表示否，1表示是 └ retailPrice Number 20007 零售价，单位分 └ height Number 1000 高，单位毫米
bizMessage	String	xxx	业务信息
bizCode	String	xxx	业务信息码
success	Boolean	true	成功或者失败

{"fuzzyScItemName":"桌","ownerCode":"123456","pageNo":1,"pageSize":100,"bizRequestId":"xxx","scItemCodes":"","bizRequestTime":0}

{
    "data":{
        "pageNo":1,
        "pageSize":100,
        "hasNext":true,
        "list":[
            {
                    "brandName":"xxx",
                    "precious":0,
                    "ownerCode":"123456",
                    "scItemCode":"123456",
                    "hazardous":0,
                    "length":1000,
                    "weight":1000,
                    "industry":"NORMAL",
                    "remark":"xxx",
                    "categoryName":"xxx",
                    "warehouseCode":"123456",
                    "storageEnvironment":"NORMAL",
                    "barCode":"123456",
                    "picPath":"http:\/\/xxx.pic",
                    "liquid":0,
                    "scItemName":"123456",
                    "width":1000,
                    "extendProps":"{\"xxx\":\"xxx\"}",
                    "purchasePrices":{
                        "currency":"CNY",
                        "price":"20007",
                        "supplierName":"xxx"
                    },
                    "currency":"CNY",
                    "fragile":0,
                    "retailPrice":20007,
                    "height":1000
            }
        ]
    },
    "bizMessage":"xxx",
    "bizCode":"xxx",
    "success":true
}

{"bizMessage":"Illegal request","success":"false","bizCode":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

天猫供应链

qimen.alibaba.dchain.aoxiang.scitem.batch.query (普通货品查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ