腾讯有数官方文档
  • 返回总览

    • 商品相关接口--字段描述汇总

    新增 更新商品

    一级字段名称 二级字段名称 三级字段名称 四级字段名称 字段释义 数据类型 必填
    dataSourceId       数据源id（create方法返回的data.dataSource.id） string Y
    skus       商品SKU列表 数组最大长度 50 struct[] Y
      external_sku_id     您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节 string Y
      external_spu_id     您为商品SPU分配的唯一ID。 一般而言，是您在商品库为该商品SPU分配的id。 字段长度最小 1 字节，长度最大 128 字节 string  
      sku_barcode     商品条形码 字段长度最小 1 字节，长度最大 64 字节 string  
      img_urls     商品图片url列表 数组最大长度 10 struct[] Y
        imgs   图片信息列表 数组最大长度 10 struct[] Y
          img_url 商品图片地址 图片300*300以上 图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节 srting Y
        primary_imgs   主图图片信息列表  数组最大长度 10 struct[] Y
          img_url 商品主图地址 图片300*300以上，1张，正方形 图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节 string Y
        detail_imgs   详情页图片信息列表 数组最大长度 10 struct[]  
          img_url 商品详情图片地址，图片300*300以上 图片可正常打开 字段长度最小 1 字节，长度最大 2048 字节 sting  
      product_props     商品属性 struct  
        color   商品颜色属性 struct  
          color_rgb 颜色RGB编码 字段长度最小 1 字节，长度最大 64 字节 string  
          color_name 颜色名称，如黄色 字段长度最小 1 字节，长度最大 64 字节 string  
        is_o2o   true：线上线下同款；false：线上线下不同款 boolean  
        size   商品尺码 字段长度最小 1 字节，长度最大 8 字节 string  
      sales_props     商品销售属性 struct Y
        is_available   上架状态 true：上架；false：下架 boolean Y
      desc_props     商品描述属性 struct Y
        product_name_chinese   商品中文名 字段长度最小 1 字节，长度最大 100 字节 string Y
      external_created_time     客户侧的商品创建时间 字段长度为 10 字节或者长度为 13 字节 string Y

    新增 更新商品类目

    一级字段名称 二级字段名称 字段释义 数据类型 必填
    dataSourceId   数据源id（create方法返回的data.dataSource.id） string Y
    categories   商品类目列表，数组最大长度 50 struct[] Y
      external_category_id 您为商品类目分配的唯一 id。一般而言，是您在商品库为该商品类目分配的 id。 字段长度最小 1 字节，长度最大 255 字节 string Y
      category_name 类目名称 字段长度最小 1 字节，长度最大 255 字节 string Y
      category_type 类目类型，1：前台类目；2：后台类目 integer Y
      category_level 类目层级 integer Y
      external_parent_category_id 父类目 id，顶级类目填 0 字段长度最小 1 字节，长度最大 255 字节 string Y
      is_root 是否为根节点，true：是；false：不是， boolean Y

    新增 更新门店仓库

    一级字段名称 二级字段名称 三级字段名称 四级字段名称 字段释义 数据类型 必填
    dataSourceId       数据源id（create方法返回的data.dataSource.id） string Y
    stores       仓库列表 数组最大长度 50 struct[] Y
      external_store_id     您为仓库分配的唯一ID。 一般而言，是您在商品库为该仓库分配的id。 字段长度最小 1 字节，长度最大 32 字节 string Y
      type     门店类型 1：门店仓（可进行线下购物的门店）；2：前置仓（支持同城配/落地配的仓库；3：电商仓（支持快递配送的仓库） integer Y
      business_type     门店经营类型 1：住宅店；2：交通枢纽店；3：功能区店 99：其他 integer Y
      operation_status     运营状态 1：开业；2：关店；3：暂停营业 与daojia_operation_status两者必填其一 integer  
      daojia_operation_status     运营状态 1：开业；2：关店；3：暂停营业 与operation_status两者必填其一 integer  
      phone_numbers     店仓电话列表 格式075588888888 string[]  
      location_info     地址信息 struct Y
        country_code   国家编码 CNN 字段长度最小 1 字节，长度最大 64 字节 string  
        country_name   国家名称 中国 字段长度最小 1 字节，长度最大 64 字节 string  
        province_code   省份编码，使用《统计用区划代码和城乡分代码编制规则》 440000 integer  
        province_name   省份名称 XX省 字段长度最小 1 字节，长度最大 64 字节 string Y
        city_code   城市编码，使用《统计用区划代码和城乡分代码编制规则》 integer  
        city_name   城市名称 XX市 字段长度最小 1 字节，长度最大 64 字节 string Y
        district_code   行政区编码，使用《统计用区划代码和城乡分代码编制规则 integer  
        district_name   行政区名称 XX区 字段长度最小 1 字节，长度最大 64 字节 string Y
        address   除国家省市区之外的地址信息，如：文心五路保利文化广场B区二楼 字段长度最小 1 字节，长度最大 64 字节 string Y
        geo_info   坐标信息 struct[]  
          type 填写了longitude和latitude则必填 1：腾讯/高德地图；2：百度地图：3：国际标准 integer Y
          latitude 店仓纬度 如：22.5200 float Y
          longitude 店仓经度 如：113.9400 float Y
      basic_props     基础信息 struct Y
        name   店仓名称 建议格式：品牌名称（XX店） 字段长度最小 1 字节，长度最大 32 字节 string Y
        opening_time   店仓开业时间 时间戳 毫秒 字段长度为长度为 13 字节 string  
        operating_time   为空默认周一至周日，10:00-22:00 struct[]  
          date_zone 日期区间  字段长度最小 1 字节，长度最大 64 字节 string Y
          time_zone 时间区间  字段长度最小 1 字节，长度最大 64 字节 string Y
        daojia_operating_time   为空默认周一至周日，10:00-22:00 struct[]  
          date_zone 日期区间  字段长度最小 1 字节，长度最大 64 字节 string Y
          time_zone 时间区间  字段长度最小 1 字节，长度最大 64 字节 string Y
      delivery_info       配送类型 struct  
        range_type   配送范围类型 1：圆形；3：多边形；store支持到家配送时必填 integer  
        radius   配送半径 range_type=1时，必填 字段长度最小 1 字节，长度最大 128 字节 string  
        geo_group   坐标信息组合，坐标点的二维数组，表示多个形状 range_type=3时，必填 array[]  
          geos 坐标点信息 array[]  

    新增 更新销售信息

    一级字段名称 二级字段名称 三级字段名称 四级字段名称 字段释义 数据类型 必填
    dataSourceId       数据源id（create方法返回的data.dataSource.id） string Y
    salesinfo       商品库存价格列表 数组最大长度 50 struct[] Y
      external_store_id     客户侧店铺/仓库ID 字段长度最小 1 字节，长度最大 32 字节 string Y
      external_sku_id     您为商品SKU分配的唯一ID。 一般而言，是您在商品库为该商品SKU分配的id。 字段长度最小 1 字节，长度最大 128 字节 string Y
      price     商品价格信息 struct Y
        daily_price   商品日常售价，单位：元，保留两位小数 float  
        current_price   商品目前售价，单位：元，保留2位小数 大于等于0，最小值0 current_price需≤sku_price float Y
        sku_price   商品原价，单位：元，保留2位小数 大于等于0，最小值0 current_price需≤sku_price float Y
        sku_promotions   商品活动及促销价列表 数组最大长度 50 struct[]  
          external_promotion_id 活动的促销id string Y
          promotion_price 活动的促销价格 float Y
      stock     库存信息 struct Y
        sku_stock_status   同一个商品在不同店仓中的销售/上下架状态 1：销售中；2：停售中 integer Y
      target_url_props     商品目标页属性 struct Y
        url_miniprogram   小程序落地页url类型，长度不超过2048 字段长度最小 1 字节，长度最大 2048 字节 string Y
        miniprogram_appid   微信小程序APP ID 字段长度最小 1 字节，长度最大 1024 字节 string Y
      labels     标签列表 struct[]  
        name   商品标签名称 字段长度最小 1 字节，长度最大 64 字节 string  
        start_time   标签开始时间 字段长度为 10 字节或者长度为 13 字节 string  
        end_time   标签结束时间 字段长度为 10 字节或者长度为 13 字节 string  
    关于腾讯
    Copyright © 1998-2019 Tencent. All Rights Reserved.