文档中心 > API类目 > 天猫供应链

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

普通货品查询接口（支持批量&单个）

公共参数

请求地址：

环境	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 []	可选		最大列表长度：999	货品商家编码列表
fuzzyScItemName	String	可选	桌		货品名称模糊匹配
pageNo	Number	必须	1		页码
pageSize	Number	必须	100		每页数量，不大于100
bizRequestTime	Number	必须	1639466166000		业务请求时间戳（毫秒数）
bizRequestId	String	必须	xxx		业务请求ID

响应参数

名称	类型	示例值	描述
result	QueryScItemResult		分页查询结果
data PageData 货品列表数据 └ pageNo Number 1 页码 └ pageSize Number 100 每页数量，不大于100 └ hasNext Boolean true 是否有下一页 list ScItem [] 货品列表 └ brandName String xxx 品牌名称 └ precious Number 0 是否贵重品。1=是，0=否 └ ownerCode String 123456 货主ID └ scItemCode String 123456 货品Code └ hazardous Number 0 是否危险品。1=是，0=否 └ length Number 1000 长，毫米 └ weight Number 1000 重量，克 └ industry String NORMAL 行业。综合-NORMAL 图书-BOOKS 美妆-BEAUTY └ 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 是否液体。1=是，0=否 └ scItemName String 123456 货品名称 └ width Number 1000 宽，毫米 └ extendProps String {"xxx":"xxx"} 扩展属性 purchasePrices PurchasePrice [] 采购价格 └ supplierName String xxx 供应商名称 └ price Number 20007 采购价，人民币—分 └ fragile Number 0 是否易碎品。1=是，0=否 └ 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}

响应示例

{
    "result":{
        "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":[
                            {
                                    "supplierName":"xxx",
                                    "price":20007
                            }
                        ],
                        "fragile":0,
                        "retailPrice":20007,
                        "height":1000
                }
            ]
        },
        "bizMessage":"xxx",
        "bizCode":"xxx",
        "success":true
    }
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

天猫供应链

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ