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