导入或更新物品信息

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

接口说明如下：

接口调用基本信息 说明
协议 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 成功
其他常见错误码 点击查看