批量新增或修改商品

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String BatchInsertItems

系统规定参数。取值:BatchInsertItems。

ItemInfo.N.ActionPrice Integer 500

实际销售价格(单位:分)。

ItemInfo.N.ItemBarCode String 690560583****

商品条码。

ItemInfo.N.ItemId String 1234567

自定义商品条码。

ItemInfo.N.ItemTitle String 纯牛奶

商品标题。

ItemInfo.N.PriceUnit String

计价单位。

StoreId String s-dxsxx****

门店ID或商家自定义门店ID。

ItemInfo.N.PromotionText String 买一送一

促销文案。

ItemInfo.N.MemberPrice Integer 500

会员价(单位:分)。

ItemInfo.N.SupplierName String 天猫超市

经销商。

ItemInfo.N.ForestFirstId String 酒类

一类商品类目ID。

ItemInfo.N.ModelNumber String 256G

型号。

ItemInfo.N.ItemShortTitle String 牛奶

商品简称。

ItemInfo.N.Material String 金属

材质。

ItemInfo.N.BePromotion Boolean true

是否促销。

ItemInfo.N.ForestSecondId String 白酒

二类商品类目ID。

ItemInfo.N.CategoryName String 手机

品类。

ItemInfo.N.EnergyEfficiency String 1kw/h

能效。

ItemInfo.N.CustomizeFeatureO String 自定义属性O

自定义属性O。

ItemInfo.N.Manufacturer String 中国制造

生产商。

ItemInfo.N.CustomizeFeatureM String 自定义属性M

自定义属性M。

ItemInfo.N.CustomizeFeatureN String 自定义属性N

自定义属性N。

ItemInfo.N.CustomizeFeatureK String 自定义属性K

自定义属性K。

ItemInfo.N.CustomizeFeatureL String 自定义属性L

自定义属性L。

ItemInfo.N.PromotionEnd String 2020-02-01T00:00:00Z

促销结束时间 UTC格式 "yyyy-MM-dd'T'HH:mm:ss'Z'"。

ItemInfo.N.OriginalPrice Integer 1000

原价(单位:分)。

ItemInfo.N.CustomizeFeatureI String 自定义属性I

自定义属性I。

ItemInfo.N.CustomizeFeatureJ String 自定义属性J

自定义属性J。

ItemInfo.N.CustomizeFeatureG String 自定义属性G

自定义属性G。

ItemInfo.N.SaleSpec String 1台/盒

规格。

ItemInfo.N.CustomizeFeatureH String 自定义属性H

自定义属性H。

ItemInfo.N.CustomizeFeatureE String 自定义属性E

自定义属性E。

ItemInfo.N.CustomizeFeatureF String 自定义属性F

自定义属性F。

ItemInfo.N.CustomizeFeatureC String 自定义属性C

自定义属性C。

ItemInfo.N.CustomizeFeatureD String 自定义属性D

自定义属性D。

ItemInfo.N.CustomizeFeatureA String 自定义属性A

自定义属性A。

ItemInfo.N.CustomizeFeatureB String 自定义属性B

自定义属性B。

ItemInfo.N.TaxFee String 增值税

税费信息。

ItemInfo.N.ProductionPlace String 中国

产地。

ItemInfo.N.ItemInfoIndex Integer 1

商品信息坐标,此字段不用填。

ItemInfo.N.InventoryStatus String OUT_OF_STOCK

库存状态,可选值:

  • OUT_OF_STOCK:缺货
  • NORMAL:正常。
ItemInfo.N.BrandName String Apple

品牌名称。

ItemInfo.N.ItemQrCode String http://m.taobao.com/xxx.html

商品二维码地址。

ItemInfo.N.PromotionReason String 情人节活动

促销原因。

ItemInfo.N.PromotionStart String 2020-02-10T00:00:00Z

促销开始时间 UTC格式 "yyyy-MM-dd'T'HH:mm:ss'Z'"。

ItemInfo.N.BeSourceCode Boolean true

是否溯源。

ItemInfo.N.SalesPrice Integer 400

销售价格(单位:分)。

ItemInfo.N.ItemPicUrl String http://m.taobao.com/xxx.html

商品图片URL。

ItemInfo.N.SkuId String 1234567

商品ID(SKU)。

ItemInfo.N.SuggestPrice Integer 600

建议零售价(单位:分)。

ItemInfo.N.Rank String 1级

等级。

ItemInfo.N.SourceCode String 1234567

溯源码。

返回数据

名称 类型 示例值 描述
BatchResults Array

批量返回结果。

ErrorCode String MandatoryParameters

错误码。

Index Integer 1

请求序列下标。

Message String success

消息。

Success Boolean true

当前商品插入成功与否标识。

Code String -1001

内部错误码。

DynamicCode String PlatformResponseError.%s

动态错误码。

DynamicMessage String The specified store %s does not exist.

动态消息。

ErrorCode String MandatoryParameters

错误码。

ErrorMessage String The specified resource type is invalid.

错误消息。

Message String success

消息。

RequestId String E69C8998-1787-4999-8C75-D663FF1173CF

请求ID。

Success Boolean true

请求成功与否标识。

示例

请求示例

http(s)://cloudesl.cn-hangzhou.aliyuncs.com/?Action=BatchInsertItems
&ItemInfo.1.ActionPrice=500
&ItemInfo.1.ItemBarCode=690560583****
&ItemInfo.1.ItemId=1234567
&ItemInfo.1.ItemTitle=Apple iPhone 12 Pro
&ItemInfo.1.PriceUnit=台
&StoreId=s-dxsxx****
&<公共请求参数>

正常返回示例

XML 格式

<code>200</code>
<data>
    <RequestId>8D4EC562-FA78-4423-AA28-9A5AA6BDEE10</RequestId>
    <BatchResults>
        <Index>1</Index>
        <Success>true</Success>
    </BatchResults>
    <Success>true</Success>
</data>
<requestId>8D4EC562-FA78-4423-AA28-9A5AA6BDEE10</requestId>
<successResponse>true</successResponse>

JSON 格式

{
    "code": 200,
    "data": {
        "RequestId": "8D4EC562-FA78-4423-AA28-9A5AA6BDEE10",
        "BatchResults": {
            "Index": 1,
            "Success": true
        },
        "Success": true
    },
    "requestId": "8D4EC562-FA78-4423-AA28-9A5AA6BDEE10",
    "successResponse": true
}

错误码

访问错误中心查看更多错误码。