导入收藏

开发者可以在用户添加物品到购物车时,同步物品数据至好物圈的收藏列表。在首次接入时,开发者需导入用户购物车中的所有物品。导入数据有助于物品在搜索中获得更好的曝光,同时也保障用户侧获得一致的体验。 接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/addshoppinglist?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 同步用户添加物品到好物圈
接口调用时机 用户添加物品到购物车

请求数据样例

{
  "user_open_id": "user_open_id",
  "sku_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": 100,
      "update_time": 1542868721,
      "platform_category_list": [
        {
          "category_id": 4342,
          "category_name": "运动裤"
        }
      ],
      "sku_info": {
        "sku_id": "sku_id2",
        "price": 10010,
        "original_price": 20010,
        "bar_code_info": {
          "barcode_type": "ean8",
          "barcode": "12345678"
        },
        "status": 1,
        "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号"
          }
        ],
        "sku_attr_list": [
          {
            "name": "颜色",
            "value": "黑色"
          },
          {
            "name": "码数",
            "value": "XXL"
          }
        ],
        "version": 1200
      },
      "can_be_search": true,
      "brand_info": {
        "logo": "http://xxx.jpg",
        "name": "外婆家"
      }
    }
  ]
}
物品基本字段 必填 字段类型 说明
user_open_id string 用户的openid,参见openid说明
sku_product_list array 单次请求物品数量不可超过10个
sku_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_info object 物品SKU信息,微信后台会合并多次导入的SKU
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
update_time int 加入购物车的时间,unix 秒级时间戳,不填默认为当前时间
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_info字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
status int 物品状态,1:在售,2:停售
sku_attr_list object array sku属性列表,参考attr_list
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 条形码数字字符串

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}
错误码 说明
9009099 系统失败
9009202 物品数量超过限制
其他常见错误码 点击查看