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

qimen.alibaba.tcls.aelophy.merchant.channel.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	必须			商品发布
└ merchantCode String 必须 CSSJ 商家编码 └ outMerchantCode String 可选 OUTCSSJ 外部商家编码 └ outShopId String 必须 CSSJ 外部渠道店id └ shopId String 可选 CSMD 内部渠道店id └ skuCode String 必须 48982094 商品编码 └ skuName String 必须猕猴桃商品名称 └ upc String 必须 138983598539 商品条码 └ description String 可选 <span>猕猴桃</span> 商品描述信息，中文，可能包含html格式 └ price Number 必须 2000 商品价格，单位分 └ saleUnit String 必须 g 商品的售卖单位 └ boxNum Number 可选 1 单件商品需使用的打包盒的数量 └ boxPrice Number 可选 1 单个打包盒的价格，单位是分 └ categoryCode String 可选 4625 商品所属的前台分类编码 └ categoryName String 可选水果商品所属的前台分类名称 └ backCatCode String 必须 6537 商品所属的后台类目编码 └ backCodeName String 必须水果商品所属的后台类目名称 └ status Number 必须 0 商品上下架状态，枚举值：0-上架，1-下架 └ picture String 可选 urls 商品图片。 * 1.此字段将返回商品图片URL地址； * 2.如商品有多张图片，将返回多个图片URL地址，以英文逗号隔开 * 3.第一张图片为商品主图 └ brandName String 可选 CSSJ 商品的品牌名称 └ subTitle String 可选猕猴桃商品副标题 └ stock String 可选 300 库存数量 └ stockUnit String 必须 g 库存单位 └ weightFlag Number 必须 1 是否称重品： 0-非称重品 1-称重品 └ avgWeight String 必须 300 商品均重(销售时库存单位与销售单位的转换) └ preMinusWeight String 必须 1 预扣款重量（扣款时销售单位与库存单位的转换） └ weight Number 可选 300 单品重量（g为单位） └ stepQuantity Number 可选 1 销售时，基于销售单位的步长 └ purchaseQuantity Number 可选 1 销售时，基于销售单位的起购量 └ producerPlace String 可选山东省，烟台市，蓬莱区省市区，逗号分隔 └ saleSpec String 可选盒销售规格描述 └ bizDate Number 必须 123452495254000 业务操作时间戳 └ memberPrice Number 可选 100 会员价 └ storage String 可选冷藏存储条件 └ guidePrice Number 可选 1500 商品指导价(划线价), 单位分 └ taxRate Number 可选 0.13 税率, 如13.0 └ taxRateCode String 可选 6 税率编码 └ netContent String 可选见产品外包装净含量

响应参数

名称	类型	示例值	描述
model	ItemDTO		数据模板
└ itemId String 123456 渠道商品id └ merchantCode String CSSJ 商家编码 └ outShopId String CSSJ 外部渠道店id └ shopId String CSMD 内部渠道店id
success	Boolean	true	接口状态
errCode	String	ILLEGAL_PARAMETERS	错误码
errMsg	String	参数错误	错误信息

请求示例

{"itemPublishRequest":{"backCatCode":"6537","bizDate":0,"saleSpec":"盒","description":"<span>猕猴桃</span>","storage":"冷藏","saleUnit":"g","categoryName":"水果","producerPlace":"山东省，烟台市，蓬莱区","skuName":"猕猴桃","subTitle":"猕猴桃","price":2000,"boxPrice":1,"weightFlag":1,"backCodeName":"水果","netContent":"见产品外包装","shopId":"CSMD","stock":"300","outMerchantCode":"OUTCSSJ","merchantCode":"CSSJ","brandName":"CSSJ","memberPrice":100,"outShopId":"CSSJ","upc":"138983598539","weight":300,"categoryCode":"4625","stepQuantity":1,"picture":"urls","stockUnit":"g","preMinusWeight":"1","taxRate":0,"boxNum":1,"purchaseQuantity":1,"guidePrice":1500,"avgWeight":"300","skuCode":"48982094","status":0,"taxRateCode":"6"}}

响应示例

{
    "model":{
        "itemId":"123456",
        "merchantCode":"CSSJ",
        "outShopId":"CSSJ",
        "shopId":"CSMD"
    },
    "success":true,
    "errCode":"ILLEGAL_PARAMETERS",
    "errMsg":"参数错误"
}

验签示例

{"success":"不等于true","errCode":"sign-check-failure","errMsg":"Illegal request"}

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout
isp.http-connection-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

五道口API

qimen.alibaba.tcls.aelophy.merchant.channel.item.publish (翱象商家自有渠道 商品发布)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

qimen.alibaba.tcls.aelophy.merchant.channel.item.publish (翱象商家自有渠道商品发布)