更新或导入物品信息

开发者可以对好物圈收藏/搜索场景下物品信息进行导入或更新，如上架状态改变、物品售罄、价格更新等。如果物品仅支持到店提货或到家送货，poi_list必填；如果物品同时支持线上物流配送，该字段应为空。

接口说明如下：

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

请求数据样例

  1. {
  2.   "product_list": [
  3.     {
  4.       "item_code": "here_is_spu_id",
  5.       "title": "product_name",
  6.       "desc": "product_description",
  7.       "category_list": [
  8.         "服装",
  9.         "上衣",
  10.         "短袖衬衫"
  11.       ],
  12.       "image_list": [
  13.         "image_url1",
  14.         "image_url2"
  15.       ],
  16.       "src_wxapp_path": "/detail?item_code=xxxx",
  17.       "attr_list": [
  18.         {
  19.           "name": "材质",
  20.           "value": "纯棉"
  21.         },
  22.         {
  23.           "name": "款式",
  24.           "value": "短袖"
  25.         },
  26.         {
  27.           "name": "季度",
  28.           "value": "2018年秋"
  29.         }
  30.       ],
  31.       "version": 200,
  32.       "sku_list": [
  33.         {
  34.           "sku_id": "sku_id1",
  35.           "price": 10000,
  36.           "original_price": 20010,
  37.           "status": 1,
  38.           "sku_attr_list": [
  39.             {
  40.               "name": "颜色",
  41.               "value": "白色"
  42.             },
  43.             {
  44.               "name": "码数",
  45.               "value": "L"
  46.             }
  47.           ],
  48.           "version": 1200,
  49.           "poi_list": [
  50.             {
  51.               "longitude": 116.32676,
  52.               "latitude": 40.003305,
  53.               "radius": 4,
  54.               "business_name": "肯德基",
  55.               "branch_name": "珠江新城店",
  56.               "address": "新港中路123号"
  57.             },
  58.             {
  59.               "longitude": 117.32676,
  60.               "latitude": 41.003305,
  61.               "radius": 5,
  62.               "business_name": "肯德基",
  63.               "branch_name": "客村店",
  64.               "address": "新港中路123号"
  65.             }
  66.           ],
  67.           "bar_code_info": {
  68.             "barcode_type": "ean8",
  69.             "barcode": "12345678"
  70.           }
  71.         },
  72.         {
  73.           "sku_id": "sku_id2",
  74.           "price": 10010,
  75.           "status": 1,
  76.           "sku_attr_list": [
  77.             {
  78.               "name": "颜色",
  79.               "value": "黑色"
  80.             },
  81.             {
  82.               "name": "码数",
  83.               "value": "XXL"
  84.             }
  85.           ],
  86.           "poi_list": [
  87.             {
  88.               "longitude": 116.32676,
  89.               "latitude": 40.003305,
  90.               "radius": 4,
  91.               "business_name": "肯德基",
  92.               "branch_name": "珠江新城店",
  93.               "address": "新港中路123号"
  94.             },
  95.             {
  96.               "longitude": 117.32676,
  97.               "latitude": 41.003305,
  98.               "radius": 5,
  99.               "business_name": "肯德基",
  100.               "branch_name": "客村店",
  101.               "address": "新港中路123号"
  102.             }
  103.           ],
  104.           "bar_code_info": {
  105.             "barcode_type": "ean13",
  106.             "barcode": "0123456789123"
  107.           }
  108.         }
  109.       ],
  110.       "platform_category_list": [
  111.         {
  112.           "category_id": 4342,
  113.           "category_name": "运动裤"
  114.         }
  115.       ]
  116.     }
  117.   ]
  118. }
物品基本字段必填字段类型说明
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商家信息
platform_category_list否array物品平台类目列表，填写的每个类目必须在好物圈物品类目表列出，多级类目只填最后一级（如完整类目为"运动户外-运动服饰-运动裤"，只需要填"运动裤"的类目ID与类目名）
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 arraysku属性列表，参考attr_list
poi_list否object array物品所在门店的列表。如果物品仅支持到店提货或到家送货，该字段必填；如果物品同时支持线上物流配送，该字段应为空。
bar_code_info否object物品的条形码信息
platform_category_list字段必填字段类型说明
category_id是uint32平台类目ID
category_name是string平台类目名称
brand_info字段必填字段类型说明
logo否string商家logo，不填的话，默认取小程序头像
name否string商家名称，不填的话，默认取小程序名字
bar_code_info字段必填字段类型说明
barcode_type是string条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串，后者为13位纯数字字符串
barcode是string条形码数字字符串

回包数据样例

接口调用成功回包
  1. {
  2.     "errcode":0,
  3.     "errmsg":"success"
  4. }

接口错误码

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