最新更新時間：2020.07.10 版本說明
用于商戶開發(fā)者為商戶更新門店服務人員的姓名、頭像等信息
? 個人微信商家、企業(yè)微信商家均支持服務人員信息更新
適用對象： 直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}
請求方式：PATCH
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 服務人員ID | guide_id | string[1,64] | 是 | path服務人員在支付即服務系統(tǒng)中的唯一標識 示例值：LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic |
| 服務人員姓名 | name | string[1,512] | 否 | body需更新的服務人員姓名，不更新無需傳入，該字段請使用微信支付平臺公鑰加密，加密方法詳見敏感信息加密說明 特殊規(guī)則：加密前字段長度限制為64個字節(jié) 示例值：pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== |
| 服務人員手機號碼 | mobile | string[1,512] | 否 | body需更新的服務人員手機號碼，不更新無需傳入，該字段請使用微信支付平臺公鑰加密，加密方法詳見敏感信息加密說明 特殊規(guī)則：加密前字段長度限制為32個字節(jié) 示例值：pVd1HJ6v/69bDnuC4EL5Kz4jBHLiCa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== |
| 服務人員二維碼URL | qr_code | string[1,1024] | 否 | body需更新的服務人員二維碼，不更新無需傳入，企業(yè)微信商家適用，個人微信商家不可用 示例值：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 員工所在門店在企業(yè)微信配置的群活碼的URL（可通過企業(yè)微信“獲取客戶群進群方式API”獲取，請登錄企業(yè)微信后查看API文檔，若無查看權限可通過問卷提交需求 ） 示例值：http://p.qpic.cn/wwhead/nMl9ssowtibVGyrmvBiaibzDtp/0 |
{
"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"
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 服務人員ID為空 | 請?zhí)顚懛杖藛TID | ||
| 服務人員ID格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 員工姓名格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 員工姓名過長 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 手機號碼格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 二維碼串格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 頭像URL不是合法鏈接 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 非企業(yè)微信提供的頭像URL | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 個人微信商家不能改二維碼 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 所有可更新的參數(shù)都沒有填 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 群二維碼URL格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 400 | MCH_NOT_EXISTS | 商戶號格式錯誤 | 請確認商戶號是否有誤 |
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
| 擴展父子商戶票據(jù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 | ||
| 調(diào)用云函數(shù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |