# shopping-guide.addGuideBuyerRelation

本接口应在服务器端调用，详细说明参见服务端API。

为顾问分配客户

单次请求接口，可选择一次分配一个客户（传openid）或者一次分配多个（传buyer_list），建议使用buyer_list。结果将推送给开发者。

# 请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/addguidebuyerrelation?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
guide_account	string		是	顾问微信号（guide_account和guide_openid二选一）
guide_openid	string		是	顾问openid或者unionid（guide_account和guide_openid二选一）
openid	string		否	客户openid（openid和buyer_list二选一）
buyer_nickname	string	微信昵称	否	客户openid对应的昵称
buyer_list	Array.<Object>		否	客户列表（不超过200，openid和buyer_list二选一）

# 返回值

# Object

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
buyer_resp	Array.<Object>	客户列表绑定结果,当请求buyer_list列表大于0有意义

buyer_list结构

属性	类型	必填	说明
openid	string	是	客户openid
buyer_nickname	string	否	客户昵称

buyer_resp的结构

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
openid	string	请求里的buyer_list粉丝openid

errcode 的合法值

值	说明	最低版本
0	成功
-1	系统失败
-1000	粉丝未关注公众号
40003	无效的openid
43004	没有关注该服务号
9300801	无效的微信号
9300804	顾问不存在
9300805	粉丝已绑定其它顾问
40032	客户列表大小不合法

# 请求数据示例

{
  "guide_account": "wx_account",
  "openid": "xxxxxxx",
  "buyer_nickname": "张三"
}

或者

{
  "guide_account": "wx_account",
  "buyer_list": {
    [
        "openid": "xxxxxxx",
        "buyer_nickname": "张三"
    ],
    [
        "openid": "yyyyyyyy",
        "buyer_nickname": "李四"
    ]
  }
}

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok",
}

或者

{
  "errcode": 0,
  "errmsg": "ok",
  "buyer_resp": {
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "xxxxxxx"
    ],
    [
        "errcode": 0,
        "errmsg": "ok",
        "openid": "yyyyyyyy"
    ]
  }
}

# 事件推送

结果将推送给开发者

参数 MsgType=event Event=add_guide_buyer_relation_event

# 示例

<xml>
  <ToUserName><![CDATA[toUser]]></ToUserName>
  <FromUserName><![CDATA[fromUser]]></FromUserName>
  <CreateTime>1546924844</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[add_guide_buyer_relation_event]]></Event>
  <errcode>0</errcode>
  <errmsg><![CDATA[ok]]></errmsg>
  <guide_account><![CDATA[xxxxx]]></guide_account>
  <guide_openid><![CDATA[yyyyyyyyyy]]></guide_openid>
  <buyer_openid><![CDATA[zzzzzzzz]]></buyer_openid>
</xml>