最新更新時間：2020.9.15 版本說明
用于服務(wù)商/商戶開發(fā)者查詢已注冊的服務(wù)人員ID等信息。
個人微信商家
? 1.傳入門店ID，查詢該門店下的所有已注冊服務(wù)人員的信息（每次查詢不可超過10條）
? 2.傳入服務(wù)人員的工號（服務(wù)人員注冊時填寫）或手機號，查詢單個服務(wù)人員的信息。
企業(yè)微信商家
? 1.傳入門店ID，查詢該門店下的所有已注冊服務(wù)人員的信息（每次查詢不可超過10條）
? 2.傳入服務(wù)人員的企業(yè)微信員工ID或手機號，查詢單個服務(wù)人員的信息。
服務(wù)人員注冊API和查詢API請求URL相同，區(qū)別主要是在body和query，請注意區(qū)分。
適用對象：服務(wù)商 直連商戶
請求URL：https://api.mch.weixin.qq.com/v3/smartguide/guides
請求方式：GET
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)路徑參數(shù)
query 指該參數(shù)需在請求URL傳參
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 子商戶ID | sub_mchid | string[1,64] | 否 | query服務(wù)人員所屬商戶的商戶ID （如果是直連商戶/普通特約商戶自己調(diào)用接口，不傳即可；如果是服務(wù)商幫普通特約商戶調(diào)用接口，傳普通特約商戶的商戶號） 示例值：1234567890 |
| 門店ID | store_id | int | 是 | query門店在微信支付商戶平臺的唯一標識 示例值：1234 |
| 企業(yè)微信的員工ID | userid | string[1,64] | 否 | query員工在商戶企業(yè)微信通訊錄使用的唯一標識，企業(yè)微信商家可傳入該字段查詢單個服務(wù)人員信息；不傳則查詢整個門店下的服務(wù)人員信息 示例值：robert |
| 手機號碼 | mobile | string[1,32] | 否 | query服務(wù)人員通過小程序注冊時填寫的手機號碼，企業(yè)微信/個人微信商家可傳入該字段查詢單個服務(wù)人員信息；不傳則查詢整個門店下的服務(wù)人員信息。 該字段需進行加密處理，加密方法詳見敏感信息加密說明 特殊規(guī)則：加密前字段長度限制為32個字節(jié) 示例值：str2WoWy8uUiWM7xahvNv0lV3C+nn3t4QlKNnyr+iwlk2FoMcn/lxrR6YdKKFI6NFJkC5oyvzNwc1MDzIgjLR0W6bJKiwWeOV3Fp0x+VIoRDONal1Mgb6VTYg7lvACEqdwmVkvbt4/oEWaWP62njMGGe0fMiBSAvao3LrcsOwDvN3E9kiaw5XQZMP/rUdWTFfy5THuohcQobGMrxclHKAnwAHU8CWfkziW5crUc3Z83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA== |
| 工號 | work_id | string[1,20] | 否 | query服務(wù)人員通過小程序注冊時填寫的工號，個人微信商家可傳入該字段查詢單個服務(wù)人員信息；不傳則查詢整個門店下的服務(wù)人員信息 示例值：robert |
| 最大資源條數(shù) | limit | int | 否 | query商家自定義字段，該次請求可返回的最大資源條數(shù)，不大于10 示例值：5 |
| 請求資源起始位置 | offset | int | 否 | query商家自定義字段，該次請求資源的起始位置，默認值為0
示例值：0 |
https://api.mch.weixin.qq.com/v3/smartguide/guides?store_id=1234&sub_mchid=1234567890
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| +服務(wù)人員列表 | data | array | 是 | 服務(wù)人員列表 |
| 服務(wù)人員數(shù)量 | total_count | int | 是 | 符合條件篩選的服務(wù)人員數(shù)量，當服務(wù)人員列表返回為空時，服務(wù)人員數(shù)量返回0；當服務(wù)人員列表有返回值時，服務(wù)人員數(shù)量按查詢到的值返回。 示例值：10 |
| 最大資源條數(shù) | limit | int | 是 | 該次請求可返回的最大資源條數(shù)，不大于10 示例值：5 |
| 請求資源起始位置 | offset | int | 是 | 該次請求資源的起始位置，默認值為0 示例值：0 |
{
"data": [
{
"guide_id": "LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic",
"store_id": 1234,
"name": "str2WUc3Z83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"mobile": "str2WoWyZ83uMVcFQu38y9EcWR12FJ3jip5nyVKiqCF4iDSN+JRXjWsWlqTZ0Y8Q+piBCS5ACusK6nz7mKQeypi9fKjAggRfvNFPf/bNxPvork4mMVgZkA==",
"userid": "robert",
"work_id": "robert"
}
],
"total_count": 10,
"limit": 5,
"offset": 0
}
| 狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
|---|---|---|---|
| 400 | PARAM_ERROR | 必填參數(shù)為空 | 根據(jù)錯誤提示，傳入正確參數(shù) |
| 門店ID格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| userid格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 手機號碼格式錯誤 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 門店ID為空 | 請?zhí)顚戦T店id | ||
| 個微商家不應(yīng)填寫企業(yè)微信id | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 企微商家不應(yīng)填寫工號 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 最大資源條數(shù)大于10 | 根據(jù)錯誤提示，傳入正確參數(shù) | ||
| 400 | MCH_NOT_EXISTS | 子商戶不存在 | 請確認商戶號是否有誤 |
| 商戶號格式錯誤 | 請確認商戶號是否有誤 | ||
| 子商戶號格式錯誤 | 請確認商戶號是否有誤 | ||
| 子商戶號為空 | 請?zhí)顚懽由虘籼? | ||
| 400 | INVALID_REQUEST | 子商戶未授權(quán) | 子商戶未授權(quán),請聯(lián)系子商戶授權(quán) |
| 子商戶產(chǎn)品權(quán)限未開通 | 子商戶產(chǎn)品權(quán)限未開通,請聯(lián)系子商戶開通 | ||
| 子商戶產(chǎn)品配置未完成 | 子商戶產(chǎn)品配置未完成,請確認子商戶完成產(chǎn)品配置后重試 | ||
| 500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |
| 擴展父子商戶票據(jù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 | ||
| 調(diào)用云函數(shù)錯誤 | 請使用相同參數(shù)稍后重新調(diào)用 |