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