导入收藏

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

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

请求数据样例

  1. {
  2. "user_open_id": "user_open_id",
  3. "sku_product_list": [
  4. {
  5. "item_code": "here_is_spu_id",
  6. "title": "product_name",
  7. "desc": "product_description",
  8. "category_list": [
  9. "服装",
  10. "上衣",
  11. "短袖衬衫"
  12. ],
  13. "image_list": [
  14. "image_url1",
  15. "image_url2"
  16. ],
  17. "src_wxapp_path": "/detail?item_code=xxxx",
  18. "attr_list": [
  19. {
  20. "name": "材质",
  21. "value": "纯棉"
  22. },
  23. {
  24. "name": "款式",
  25. "value": "短袖"
  26. },
  27. {
  28. "name": "季度",
  29. "value": "2018年秋"
  30. }
  31. ],
  32. "version": 100,
  33. "update_time": 1542868721,
  34. "platform_category_list": [
  35. {
  36. "category_id": 4342,
  37. "category_name": "运动裤"
  38. }
  39. ],
  40. "sku_info": {
  41. "sku_id": "sku_id2",
  42. "price": 10010,
  43. "original_price": 20010,
  44. "bar_code_info": {
  45. "barcode_type": "ean8",
  46. "barcode": "12345678"
  47. },
  48. "status": 1,
  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. "sku_attr_list": [
  68. {
  69. "name": "颜色",
  70. "value": "黑色"
  71. },
  72. {
  73. "name": "码数",
  74. "value": "XXL"
  75. }
  76. ],
  77. "version": 1200
  78. },
  79. "can_be_search": true,
  80. "brand_info": {
  81. "logo": "http://xxx.jpg",
  82. "name": "外婆家"
  83. }
  84. }
  85. ]
  86. }
物品基本字段必填字段类型说明
user_open_idstring用户的openid,参见openid说明
sku_product_listarray单次请求物品数量不可超过10个
sku_product_list字段必填字段类型说明
item_codestring物品ID(SPU ID),要求appid下全局唯一
titlestring物品名称
descstring物品描述
category_liststring array物品类目列表,用于搜索排序
image_liststring array物品图片链接列表,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
src_wxapp_pathstring物品来源小程序路径
attr_listobject array物品SPU属性
sku_infoobject物品SKU信息,微信后台会合并多次导入的SKU
versionint非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
update_timeint加入购物车的时间,unix 秒级时间戳,不填默认为当前时间
can_be_searchbool物品能否被搜索(默认true可以被搜索)
brand_infoobject商家信息
platform_category_listarray物品平台类目列表,填写的每个类目必须在好物圈物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
attr_list字段必填字段类型说明
namestring属性名称
valuestring属性内容
poi_list字段选填字段类型说明
longitudedouble门店的经度,WGS84标准
latitudedouble门店的纬度,WGS84标准
radiusdouble门店可送达半径,单位km
business_namestring门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_namestring分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
addressstring门店地址(不包含省市区信息,如:新港中路123号)
sku_info字段必填字段类型说明
sku_idstring物品sku_id,特殊情况下可以填入与item_code一致
priceint物品价格,分为单位
original_priceint物品原价,分为单位
versionint非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
statusint物品状态,1:在售,2:停售
sku_attr_listobject arraysku属性列表,参考attr_list
bar_code_infoobject物品的条形码信息
platform_category_list字段必填字段类型说明
category_iduint32平台类目ID
category_namestring平台类目名称
brand_info字段必填字段类型说明
logostring商家logo
namestring商家名称
bar_code_info字段必填字段类型说明
barcode_typestring条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcodestring条形码数字字符串

回包数据样例

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