跳到主要内容

商品信息变更[单店]


前置条件

请在 DataNexus -<数据接入>-<数据源>中新建数据源，参考新建数据源。并在数据源中选择或新建数据集，参考新建数据集。


请求地址​

https://api.e.qq.com/v1.1/sku_info/update


请求方法​

POST


请求参数​

参数名描述
access_token授权令牌，完成 OAuth 2.0 授权后获得，参考开发者账号及环境
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

名称类型必填描述
account_idintegerY客户账号id
data_source_idintegerYDataNexus数据源id
data_set_idintegerYDataNexus数据集id
skusarrayY商品SKU列表 数组最大长度 50
external_sku_idstringY您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节
poly_sku_idstring商品的sku聚合id，供推荐、搜索场景使用。 字段长度最小 1 字节，长度最大 128 字节
gdt_sku_idstring腾讯广告商品的skuid。 字段长度最小 1 字节，长度最大 128 字节
external_spu_idstring您为商品SPU分配的唯一ID。 色码款商品必填。 字段长度最小 1 字节，长度最大 128 字节
sku_barcodestring商品条形码，超市商品必填。字段长度最小 1 字节，长度最大 64 字节
seo_idstring[]商品可被搜索的编码
brand_namestring品牌名称。字段长度最小 1 字节，长度最大 64 字节
media_infoobject商品图片及视频信息，最大长度 10
primary_imgsobject主图图片信息列表 数组最大长度 10
img_urlstring商品主图地址；图片320*320以上，1张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
imgsarray商品轮播图信息列表 数组最大长度 10
img_urlstring商品轮播图地址；图片320*320以上，10张，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
prop_imgsarray商品属性图信息列表 数组最大长度 10
img_urlstring商品属性图地址；图片320*320以上，正方形图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节
detail_imgsarray详情页图片信息列表 数组最大长度 50
img_urlstring商品详情图片地址，50张，图片可正常打开，字段长度最小 1 字节，长度最大 2048 字节
rich_text_urlstring商品富文本地址，最大长度50，url可正常打开，字段长度最小 1 字节，长度最大 2048 字节
videosarray商品视频信息，数组最大长度 10
video_urlstring视频地址；字段长度最小 1 字节，长度最大 2048 字节
img_urlstring视频封面图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
category_infoarray类目信息，数组
category_typeinteger类目类型，1：前台类目；2：后台类目
category_level_1_idstring一级类目id
category_level_1_namestring一级类目名称
category_level_2_idstring二级类目id
category_level_2_namestring二级类目名称
category_level_3_idstring三级类目id
category_level_3_namestring三级类目名称
category_level_4_idstring四级类目id
category_level_4_namestring四级类目名称
sales_infoobject商品销售信息
stock_totalinteger商品总库存量，当product_type=3（小样）时必填
is_availableboolean上架状态；true：上架；false：下架
sku_stock_statusinteger商品的销售状态 1：库存＞0；2：库存≤0（常见为售罄/暂无库存商品在页面底部展示，可标记为状态2）
sales_numinteger展示销量
product_typeinteger商品类型，1：普通商品；2：赠品；3：小样；4：套装商品
tag_infoobject商品的标签信息 数组最大长度 10
custom_tagarray商品的标签信息 数组最大长度 50
tag_namestring标签名称，长度最大 2048 字节
tag_valuestring[]标签值，长度最大 2048 字节
desc_infoobject商品描述信息
product_name_chinesestring商品sku名称，字段长度最小 1 字节，长度最大 100 字节
product_name_englishstring商品英文名 字段长度最小 1 字节，长度最大 1000 字节
spu_name_chinesestring商品spu 名称，若无 spu，传输内容请与 product_name_chinese 保持一致
product_descstring商品描述，字段长度最小 1 字节，长度最大 1000 字节
priceobject商品销售信息
current_pricefloat商品现价，单位元，保留 2 位小数
sku_pricefloat商品原价，单位元，保留 2 位小数
after_coupon_pricefloat券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
currency_translationboolean商品价格是否为外币汇率折算后价格，true:是；false：否，默认为false
normal_product_infoarray关联的正品的价格，当该商品为小样时需填写，单位元，保留 2 位小数
sku_idstring关联的商品id字段长度最小 1 字节，长度最大 128 字节
normal_product_pricefloat正品价格
delivery_infoarray配送信息
freight_amountfloat运费金额，单位元，保留 2 位小数
locationarray地址信息
country_codestring国家编码，CN 字段长度最小 1 字节，长度最大 64 字节
country_namestring国家名称，中国 字段长度最小 1 字节，长度最大 64 字节
province_codeinteger省份编码，使用《民政部行政区划代码》，440000
province_namestring省份名称，XX省 字段长度最小 1 字节，长度最大 64 字节
city_codeinteger城市编码，使用《民政部行政区划代码》
city_namestring城市名称，XX市 字段长度最小 1 字节，长度最大 64 字节
district_codeinteger区/县名称编码，使用《民政部行政区划代码》
district_namestring区/县名称，字段长度最小 1 字节，长度最大 64 字节
target_urlobject商品目标页信息
url_miniprogramstring微信小程序落地页 url，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appidstring微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_usernamestring小程序原始ID，登录小程序管理后台-设置-基本设置-帐号信息中，gh_xx，当落地页为微信小程序时必填字段长度最小 1 字节，长度最大 100 字节
url_miniprogram_qqstringqq小程序落地页 url，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
miniprogram_appid_qqstringqq小程序 appid，当落地页为QQ小程序时必填 字段长度最小 1 字节，长度最大 100 字节
url_h5stringh5落地页url 字段长度最小 1 字节，长度最大 100 字节
url_h5_2stringh5落地页url 字段长度最小 1 字节，长度最大 1000 字节
url_h5_3stringh5落地页url 字段长度最小 1 字节，长度最大 1000 字节
coupon_infoarray优惠券信息
coupon_idstring券批次id 字段长度最小 1 字节，长度最大 100 字节
coupon_typeinteger券类型，1：公开券；2：CPS优惠券；3：渠道专享券
amount_couponfloat券面额，单位元，保留 2 位小数，字段长度最小 1 字节，长度最大 100 字节
url_liststring券地址
amount_minimumfloat使用卡券的最低消费金额，单位元，保留 2 位小数
show_start_timestring展示开始时间/券领取开始时间，unix毫秒级时间戳，为空表示永久
show_end_timestring展示结束时间/券领取结束时间，unix毫秒级时间戳，为空表示永久
start_timestring券有效使用开始时间，unix毫秒级时间戳，为空表示永久
end_timestring券有效使用结束时间，unix毫秒级时间戳，为空表示永久
available_num_per_personinteger每个用户可领取优惠券数量上限
total_numinteger实际总数量
store_numinteger优惠券剩余张数
statusinteger优惠券状态，1：过期；0：未过期
promotion_infoarray活动信息
promotion_idstring活动id 字段长度最小 1 字节，长度最大 100 字节
promotion_typeinteger活动类型，1：满减；2：秒杀
url_liststring活动地址
show_start_timestring展示开始时间/券领取开始时间，unix毫秒级时间戳，为空表示永久
show_end_timestring展示结束时间/券领取结束时间，unix毫秒级时间戳，为空表示永久
is_bestinteger是否最优活动，1：是；0：否
service_infoobject商品售后信息
service_typeinteger售后服务类型：1：无售后服务；2：支持退换货
third_promotion_infoobjectCPS业务必填，第三方推广信息
commission_ratefloat佣金比例，2位小数，不带百分号，如 10% 填10.00
promote_statusinteger推广状态；1：推广中；0：停止推广
commission_amountfloat佣金 = 商品现价*佣金比例
commission_amount_after_couponfloat券后佣金 =（商品现价-券面额）*佣金比例
start_timestring推广计划开始时间,unix毫秒级时间戳，为空表示永久
end_timestring推广计划结束时间,unix毫秒级时间戳，为空表示永久
exclusive_infoobject专属商品信息
exclusive_statusinteger专属商品标识，1：专属商品；0：普通商品
kol_idarray可推广商品的达人ID，以英文逗号分割，如54321836,85623992
is_deletedinteger商家标记商品已删除；0：未删除，1：已删除，为空默认为0

请求示例​

{
  "account_id": 1111111111,
  "data_source_id": 1111111111,
  "data_set_id": 1111111111,
  "skus": [
    {
      "external_sku_id": "SKU_123456",
      "external_spu_id": "SPU_123456",
      "sku_barcode": "123456",
      "brand_name": "品牌名",
      "media_info": {
        "primary_imgs": {
          "img_url": "http://abcd.com/1.jpg"
        },
        "imgs": [
          {
            "img_url": "http://abcd.com/1.jpg"
          },
          {
            "img_url": "http://abcd.com/2.jpg"
          }
        ],
        "detail_imgs": [
          {
            "img_url": "http://abcd.com/1.jpg"
          },
          {
            "img_url": "http://abcd.com/2.jpg"
          }
        ],
        "videos": [
          {
            "img_url": "http://abcd.com/1.jpg",
            "video_url": "http://abcd.com/vedio1.mp4"
          },
          {
            "img_url": "http://abcd.com/2.jpg",
            "video_url": "http://abcd.com/vedio2.mp4"
          }
        ]
      },
      "category_info": [
        {
          "category_type": 2,
          "category_level_1_id": "1",
          "category_level_1_name": "一级类目名称",
          "category_level_2_id": "2",
          "category_level_2_name": "二级类目名称",
          "category_level_3_id": "3",
          "category_level_3_name": "三级类目名称"
        }
      ],
      "sales_info": {
        "is_available": true,
        "sales_num": 100
      },
      "desc_info": {
        "product_name_chinese": "商品名称"
      },
      "price": {
        "current_price": 1.2,
        "sku_price": 5.3
      },
      "target_url": {
        "url_miniprogram": "",
        "miniprogram_appid": "",
        "url_miniprogram_qq": "",
        "miniprogram_appid_qq": "",
        "url_h5": ""
      },
      "store_info": {
        "external_store_id": "12",
        "store_name": "店铺名称",
        "store_grade": 4.5
      },
      "coupon_info": [
        {
          "coupon_id": "CD-34422",
          "amount_coupon": 3.4,
          "url_list": "http://abcd.com/ciiewo23",
          "amount_minimum": 6.8,
          "show_start_time": "1607310404000",
          "show_end_time": "1607396804000",
          "start_time": "1607324804000",
          "end_time": "1607497604000",
          "is_best": 1
        }
      ],
      "comment_info": {
        "comment_num": 10000,
        "positive_comment_rating": 99.99
      },
      "third_promotion_info": {
        "commission_rate": 12.25,
        "promote_status": 1
      },
      "tag_info": {
        "custom_tag": [
          {
            "tag_name": "商品规格",
            "tag_value": ["30ml"]
          },
          {
            "tag_name": "营销卖点",
            "tag_value": ["法式浪漫甜美", "鲜活愉悦", "自信清新"]
          },
          {
            "tag_name": "适合肤质",
            "tag_value": ["适合任何肤质"]
          },
          {
            "tag_name": "原产国",
            "tag_value": ["法国"]
          }
        ]
      },
      "is_deleted": 0
    }
  ]
}

应答字段​

名称类型是否一定返回描述
codeintegerY返回码，等于0表示成功，不等于0表示错误，具体见文档附录
messagestringY错误描述，code不等于0时，message为错误描述
message_cnstring中文错误描述，code不等于0时，message_cn为错误情况的中文描述
dataobject资源数据，具体返回内容见各接口定义，只在code等于0时可能返回
errorsobject详细错误信息，只在code不等于0时可能返回

应答示例​

{
    "retcode": 0,
    "errmsg": "",
    "data": {}
}