商户进件
特约商户进件
基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
支付即服务
点金计划
行业方案
电商收付通(商户进件)
电商收付通(普通支付)
电商收付通(合单支付)
电商收付通(分账)
电商收付通(补差)
电商收付通(退款)
电商收付通(余额查询)
电商收付通(商户提现)
电商收付通(下载账单)
智慧商圈
微信支付分停车服务
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
分账
连锁品牌分账
风险合规
商户开户意愿确认
消费者投诉2.0
其他能力
图片上传
视频上传

服务人员信息更新API

最新更新时间:2020.07.10 版本说明


用于服务商开发者为商户更新门店服务人员的姓名、头像等信息

注意:

• 个人微信商家、企业微信商家均支持服务人员信息更新

接口说明

适用对象:服务商

请求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}

请求方式:PATCH


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
服务人员ID guide_id string[1,64] path服务人员在支付即服务系统中的唯一标识
示例值:LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic
子商户号 sub_mchid string[1,64] body子商户的商户号,由微信支付生成并下发。
示例值:1234567890
服务人员姓名 name string[1,512] body需更新的服务人员姓名,不更新无需传入,该字段请使用微信支付平台公钥加密,加密方法详见敏感信息加密说明
特殊规则:加密前字段长度限制为64个字节
示例值:pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
服务人员手机号码 mobile string[1,512] body需更新的服务人员手机号码,不更新无需传入,该字段请使用微信支付平台公钥加密,加密方法详见敏感信息加密说明
特殊规则:加密前字段长度限制为32个字节
示例值:pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==
服务人员二维码URL qr_code string[1,1024] body需更新的服务人员二维码,不更新无需传入,企业微信商家适用,个人微信商家不可用
示例值:https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx
服务人员头像URL avatar string[1,1024] body需更新的服务人员头像URL,不更新无需传入
示例值:http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0
群二维码URL group_qrcode string[1,256] body 员工所在门店在企业微信配置的群活码的URL(可通过企业微信“获取客户群进群方式API”获取,请登录企业微信后查看API文档,若无查看权限可通过问卷提交需求 )
示例值:http://p.qpic.cn/wwhead/nMl9ssowtibVGyrmvBiaibzDtp/0

请求示例


{
  "sub_mchid": "1234567890",
  "name": "pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
  "mobile": "pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
  "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=xxx",
  "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
  "group_qrcode" : "http://p.qpic.cn/wwhead/nMl9ssowtibVGyrmvBiaibzDtp/0"
}

{
JAVA示例代码
}

返回参数


处理成功,应答无内容

返回示例


204
处理成功,应答无内容
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 必填参数为空 根据错误提示,传入正确参数
服务人员ID为空 请填写服务人员ID
服务人员ID格式错误 根据错误提示,传入正确参数
员工姓名格式错误 根据错误提示,传入正确参数
员工姓名过长 根据错误提示,传入正确参数
手机号码格式错误 根据错误提示,传入正确参数
二维码串格式错误 根据错误提示,传入正确参数
头像URL不是合法链接 根据错误提示,传入正确参数
非企业微信提供的头像URL 根据错误提示,传入正确参数
个人微信商家不能改二维码 根据错误提示,传入正确参数
所有可更新的参数都没有填 根据错误提示,传入正确参数
群二维码URL格式错误 根据错误提示,传入正确参数
400 MCH_NOT_EXISTS 子商户不存在 请确认商户号是否有误
商户号格式错误 请确认商户号是否有误
子商户号格式错误 请确认商户号是否有误
子商户号为空 请填写子商户号
400 INVALID_REQUEST 子商户未授权 子商户未授权,请联系子商户授权
子商户产品权限未开通 子商户产品权限未开通,请联系子商户开通
子商户产品配置未完成 子商户产品配置未完成,请确认子商户完成产品配置后重试
500 SYSTEM_ERROR 系统错误 请使用相同参数稍后重新调用
扩展父子商户票据错误 请使用相同参数稍后重新调用
调用云函数错误 请使用相同参数稍后重新调用


技术咨询

文档反馈