导入或更新物品信息

接口提供物品导入和更新能力,用户推荐物品到圈子之前,开发者需要先调用此接口进行物品导入。

接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importproduct?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 导入或更新物品数据
接口调用时机 导入新物品,物品信息、状态更新

请求数据样例

{
  "product_list": [
    {
      "item_code": "here_is_spu_id",
      "title": "product_name",
      "desc": "product_description",
      "category_list": [
        "服装",
        "上衣",
        "短袖衬衫"
      ],
      "image_list": [
        "image_url1",
        "image_url2"
      ],
      "src_wxapp_path": "/detail?item_code=xxxx",
      "attr_list": [
        {
          "name": "材质",
          "value": "纯棉"
        },
        {
          "name": "款式",
          "value": "短袖"
        },
        {
          "name": "季度",
          "value": "2018年秋"
        }
      ],
      "version": 200,
      "sku_list": [
        {
          "sku_id": "sku_id1",
          "price": 10000,
          "original_price": 20010,
          "status": 1,
          "sku_attr_list": [
            {
              "name": "颜色",
              "value": "白色"
            },
            {
              "name": "码数",
              "value": "L"
            }
          ],
          "version": 1200,
          "poi_list": [
            {
              "longitude": 116.32676,
              "latitude": 40.003305,
              "radius": 4,
              "business_name": "肯德基",
              "branch_name": "珠江新城店",
              "address": "新港中路123号"
            },
            {
              "longitude": 117.32676,
              "latitude": 41.003305,
              "radius": 5,
              "business_name": "肯德基",
              "branch_name": "客村店",
              "address": "新港中路123号"
            }
          ],
          "bar_code_info": {
            "barcode_type": "ean8",
            "barcode": "12345678"
          }
        },
        {
          "sku_id": "sku_id2",
          "price": 10010,
          "status": 1,
          "sku_attr_list": [
            {
              "name": "颜色",
              "value": "黑色"
            },
            {
              "name": "码数",
              "value": "XXL"
            }
          ],
          "poi_list": [
            {
              "longitude": 116.32676,
              "latitude": 40.003305,
              "radius": 4,
              "business_name": "肯德基",
              "branch_name": "珠江新城店",
              "address": "新港中路123号"
            },
            {
              "longitude": 117.32676,
              "latitude": 41.003305,
              "radius": 5,
              "business_name": "肯德基",
              "branch_name": "客村店",
              "address": "新港中路123号"
            }
          ],
          "bar_code_info": {
            "barcode_type": "ean13",
            "barcode": "0123456789123"
          }
        }
      ]
    }
  ]
}
物品基本字段 必填 字段类型 说明
product_list array 单次请求物品数量不可超过10个
product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
title string 物品名称
desc string 物品描述
category_list string array 物品类目列表,用于搜索排序
image_list string array 物品图片链接列表,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
src_wxapp_path string 物品来源小程序路径
attr_list object array 物品SPU属性
sku_list object array 物品SKU列表,单次导入不超过16个SKU,微信后台会合并多次导入的SKU
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
can_be_search bool 物品能否被搜索(默认true可以被搜索)
brand_info object 商家信息
attr_list字段 必填 字段类型 说明
name string 属性名称
value string 属性内容
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address string 门店地址(不包含省市区信息,如:新港中路123号)
sku_list字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
status int 物品状态,1:在售,2:停售,3:售罄
sku_attr_list object array sku属性列表,参考attr_list
poi_list object array 物品所在门店的列表。如果物品仅支持到店提货或到家送货,该字段必填;如果物品同时支持线上物流配送,该字段应为空。
bar_code_info object 物品的条形码信息
platform_category_list字段 必填 字段类型 说明
category_id uint32 平台类目ID
category_name string 平台类目名称
brand_info字段 必填 字段类型 说明
phone string 用于售后场景的商家联系电话,便于用户咨询和问题解决
contact_detail_page object 联系商家页面
logo string 商家logo,不填的话,默认取小程序头像
name string 商家名称,不填的话,默认取小程序名字
id string 商家id,不填的话,默认取商家名称
contact_detail_page字段 必填 字段类型 说明
kf_type int 在线客服类型 1 没有在线客服; 2 微信客服消息; 3 小程序自有客服; 4 公众号h5自有客服
path string 小程序自有客服页面路径,kf_type为3时必填
src_h5_path string 公众号h5自有客服页面路径,kf_type为4时必填
bar_code_info字段 必填 字段类型 说明
barcode_type string 条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcode string 条形码数字字符串

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看