技术文档

# 商品信息变更（单店版）


开发之前请创建有数数据仓库 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。


# 请求地址

域名/data-api/v1/sku_info/update


# 请求方法

POST


# 请求参数

参数名 样例 描述
app_id abc 分配的app_id
nonce 61794670f155b 随机字符串
sign sha256 签名算法
timestamp 1569232087 请求时间戳（秒级）
signature aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5 签名结果

# 请求体参数

名称
类型
必填
描述
dataSourceIdstringY数据源id（create方法返回的data.dataSource.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 字节
seller_infoobject商品的卖家信息，供平台类商家填写自己的卖家信息
seller_idstring商品卖家 id，由平台类商家自己生成
seller_name_chinesestring平台类商家的子卖家中文名称
seller_name_englishstring平台类商家的子卖家英文名称
product_propsobject商品属性
colorobject商品颜色属性
color_rgbstring颜色RGB编码 字段长度最小 1 字节，长度最大 64 字节
color_namestring颜色名称，如黄色 字段长度最小 1 字节，长度最大 64 字节
prop_infoarray商品属性信息，数组
prop_idinteger属性ID，字段长度最小 1 字节，长度最大 64 字节
prop_namestring属性名称，字段长度最小 1 字节，长度最大 64 字节
value_idinteger属性值ID，字段长度最小 1 字节，长度最大 64 字节
value_namestring属性值名称，字段长度最小 1 字节，长度最大 64 字节
video_propsobject视频类商品属性
genrestring视频的分类，如爱情，字段长度最小 1 字节，长度最大 64 字节
durationinteger视频时长，单位秒，字段长度最小 1 字节，长度最大 64 字
directorstring导演姓名，字段长度最小 1 字节，长度最大 64 字
starstring主演姓名，字段长度最小 1 字节，长度最大 64 字节
release_datestring上线时间，字段长度最小 1 字节，长度最大 64 字节
ratingfloat评分，字段长度最小 1 字节，长度最大 64 字节
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展示销量
sales_num_typeinteger展示销量口径，1：近 30 天销量；2：历史累计销量
product_typeinteger商品类型，1：普通商品；2：赠品；3：小样；4：套装商品
tag_infoobject商品的标签信息 数组最大长度 10
custom_tagarray商品的标签信息 数组最大长度 50
tag_namestring标签名称，长度最大 2048 字节
tag_valuestring[]标签值，数组，长度最大 2048 字节
desc_infoobject商品描述信息
product_name_chinesestring商品中文名称，字段长度最小 1 字节，长度最大 100 字节
product_name_englishstring商品英文名 字段长度最小 1 字节，长度最大 1000 字节
spu_name_chinesestring商品spu 名称，若无 spu，传输内容请与 product_name_chinese 保持一致
product_descstring商品描述，字段长度最小 1 字节，长度最大 1000 字节
seo_descstring[]商品SEO词，数组，搜索中的扩展词包
priceobject商品销售信息
current_pricefloat商品现价，单位元，保留 2 位小数
sku_pricefloat商品原价，单位元，保留 2 位小数
after_coupon_pricefloat券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
after_coupon_price_hmfloat惠买专项券后价，券后价=商品现价-券面额，单位元，保留 2 位小数
estimated_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区/县名称，XX市 字段长度最小 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 字节
store_infoobject店铺信息
external_store_idstring店铺id，填写`store_name`时必填，字段长度最小 1 字节，长度最大 100 字节
store_namestring店铺名称，填写`external_store_id`时必填，字段长度最小 1 字节，长度最大 100 字节
store_gradefloat按满分5分换算的店铺评分，2位小数
logostring店铺图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
url_store_h5string店铺 h5 首页url，字段长度最小 1 字节，长度最大 2048 字节
url_store_miniprogramstring店铺微信小程序首页url，字段长度最小 1 字节，长度最大 2048 字节
coupon_infoarray优惠券信息
coupon_idstring券批次id 字段长度最小 1 字节，长度最大 100 字节
coupon_typeinteger券类型，1：公开券；2：CPS优惠券；3：渠道专享券；4：定向券；5：满折券
amount_couponfloat券面额，单位元，保留 2 位小数，字段长度最小 1 字节，长度最大 100 字节
stock_statusinteger卡券的库存状态 1：库存＞0；2：库存≤0
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：未过期
discount_couponfloat卡券折扣，coupon_type = 5 时必填，保留2位小数，不带百分号，如 99.99% 填 99.99
short_descriptionstring卡券短描述，字段长度最小 1 字节，长度最大 64 字节
promotion_infoarray活动信息，数组
promotion_idstring活动id 字段长度最小 1 字节，长度最大 100 字节
promotion_namestring活动名称 字段长度最小 1 字节，长度最大 2048 字节
promotion_typeinteger活动类型，1：满减；2：秒杀；3：超市百货；4：品牌促销；5：新人专享；6：大促活动；7：精选推荐；8：每日热榜；9：高佣专区；10；历史低价；11：30天热榜；21：活动会场页
promotion_descriptionstring促销描述字段长度最大 100 字节
url_liststring活动地址
start_timestring活动生效开始时间，unix毫秒级时间戳，为空表示永久
end_timestring活动生效结束时间，unix毫秒级时间戳，为空表示永久
show_start_timestring活动展示开始时间，unix毫秒级时间戳，为空表示永久
show_end_timestring活动展示结束时间，unix毫秒级时间戳，为空表示永久
is_bestinteger是否最优活动，1：是；0：否
comment_infoobject评论信息
comment_numinteger商品评论数
comment_num_typeinteger评论口径，1：近 30 天评论数；2：历史累计评论数
positive_comment_ratingfloat商品好评率，2位小数，不带百分号，如 99.99% 填 99.99
after_service_infoarray商品售后信息
service_typeintegerC售后服务类型：1：无售后服务；2：支持退换货；3：7天无理由退货 4:15天无理由退货 5:退货包运费 6:先用后付 7:坏损包退 8:假一赔三 9:运费险 10:全国联保 11:只换不修 12:退货包运费
service_descstringC针对售后服务类型的描述，如 service_type = 3 时填写，满足7天无理由退换货申请的前提下，包邮商品需要买家承担退货邮费，非包邮商品需要买家承担发货和退货邮费，长度最大 200 字节
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
usage_infoarray商品使用情况
inner_appidinteger商品的特殊应用场景。为空：商品将应用到您在有数数据管理后台绑定的全部场景；11：有数；16：直跳；19：广告CPS；20：搜一搜品牌专区；21：云选联盟；22：商品广告；例如：商家开通了场景16、19，如果不填，则所有商品应用到场景16、19；如果填了16，则改商品仅应用到场景16
is_deletedinteger商家标记商品已删除；0：未删除，1：已删除，为空默认为0

# 请求体类型

application/json


# 请求示例

{
  "dataSourceId": "12",
  "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": 5.0,
        "promote_status": 1,
        "commission_amount": 69.4,
        "exclusive_info": {
          "exclusive_status": 1,
          "kol_id": ["wx59d61fd21f0b1364", "wx59d61fd21f0b1365"]
        }
      },
      "tag_info": {
        "custom_tag": [
          {
            "tag_name": "商品规格",
            "tag_value": ["30ml"]
          },
          {
            "tag_name": "营销卖点",
            "tag_value": ["法式浪漫甜美", "鲜活愉悦", "自信清新"]
          },
          {
            "tag_name": "适合肤质",
            "tag_value": ["适合任何肤质"]
          },
          {
            "tag_name": "原产国",
            "tag_value": ["法国"]
          }
        ]
      },
      "is_deleted": 0
    }
  ]
}

# 应答字段

名称
类型
描述
retcodeinteger返回码
errmsgstring错误信息
datajson object响应内容

# 应答示例

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