服务人员信息更新API

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


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

注意:

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

接口说明

适用对象:服务商 直连商户

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

请求方式:PATCH

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


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

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 系统错误 请使用相同参数稍后重新调用
扩展父子商户票据错误 请使用相同参数稍后重新调用
调用云函数错误 请使用相同参数稍后重新调用


版本说明

关闭
V1.0
2020年07月10日
1. 服务人员更新接口上线

技术咨询

反馈有奖