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

qimen.wdk.wdkapi.item.publish (全渠道商品发布)

全渠道商品发布

公共参数

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
itemPublishRequest	ItemPublishRequest	必须			商品发布
└ status String 必须 0 商品上下架状态，枚举值：0-上架，1-下架 └ skuCode String 必须 48982094 商品编码 └ avgWeight Number 必须 300 商品均重(销售时库存单位与销售单位的转换) └ purchaseQuantity Number 可选 1 销售时，基于销售单位的起购量 └ boxNum Number 可选 2 单件商品需使用的打包盒的数量 └ preMinusWeight Number 必须 1 预扣款重量（扣款时销售单位与库存单位的转换） └ stockUnit String 必须 g 库存单位 └ picture String 可选 urls 商品图片。 * 1.此字段将返回商品图片URL地址； * 2.如商品有多张图片，将返回多个图片URL地址，以英文逗号隔开 * 3.第一张图片为商品主图 └ stepQuantity Number 可选 2 销售时，基于销售单位的步长 └ categoryCode String 必须 4625 商品所属的前台分类编码 └ weight Number 可选 300 单品重量（g为单位） └ upc String 必须 138983598539 商品条码 └ brandName String 可选 CSSJ 商品的品牌名称 └ merchantCode String 必须 CSSJ 商家编码 └ stock Number 可选 300 库存数量 └ shopId String 必须 CSSJ 渠道店id └ backCodeName String 必须水果商品所属的后台类目名称 └ weightFlag Number 必须 1 是否称重品： 0-非称重品 1-称重品 └ boxPrice Number 可选 50 单个打包盒的价格，单位是分 └ price Number 必须 2000 商品价格，单位分 └ subTitle String 可选猕猴桃商品副标题 └ skuName String 必须猕猴桃商品名称 └ producerPlace String 可选山东省,烟台市,蓬莱区省市区，逗号分隔 └ categoryName String 必须水果商品所属的前台分类名称 └ saleUnit String 必须 g 商品的售卖单位 └ description String 可选 <span>猕猴桃</span> 商品描述信息，中文，可能包含html格式 └ saleSpec String 可选盒销售规格描述 └ bizDate Number 必须 123452495254000 业务操作时间戳 └ backCatCode String 必须 6537 商品所属的后台类目编码

响应参数

名称	类型	示例值	描述
success	Boolean	false	接口状态
errCode	String	ILLEGAL_PARAMETERS	错误码
errMsg	String	参数错误	错误信息
data	Model		数据模板
└ itemId String 123456 渠道商品id └ shopId String CSSJ 渠道店id └ merchantCode String CSSJ 商家编码

请求示例

{"itemPublishRequest":{"backCatCode":"6537","bizDate":0,"saleSpec":"盒","description":"<span>猕猴桃</span>","categoryName":"水果","saleUnit":"g","producerPlace":"山东省,烟台市,蓬莱区","skuName":"猕猴桃","subTitle":"猕猴桃","price":2000,"boxPrice":50,"weightFlag":1,"backCodeName":"水果","shopId":"CSSJ","stock":300,"brandName":"CSSJ","merchantCode":"CSSJ","weight":300,"upc":"138983598539","categoryCode":"4625","stepQuantity":2,"picture":"urls","stockUnit":"g","preMinusWeight":1,"boxNum":2,"purchaseQuantity":1,"avgWeight":300,"skuCode":"48982094","status":"0"}}

响应示例

{
    "success":false,
    "errCode":"ILLEGAL_PARAMETERS",
    "errMsg":"参数错误",
    "data":{
        "itemId":"123456",
        "shopId":"CSSJ",
        "merchantCode":"CSSJ"
    }
}

验签示例

{"weightFlag":"sign-check-failure","description":"Illegal request","status":"不等于1"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

五道口API

qimen.wdk.wdkapi.item.publish (全渠道商品发布)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ