供应商模式相关的对外开放接口列表，含用途说明、关键参数与约束。
接口路径：/workbench/mode/queryAvailableModes
功能描述：返回商户已开通的工作台身份模式，用于「切换工作台」弹窗展示。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| partnerId | Int | 是 | 商户编码 |
| customerId | Int | 是 | 客户编码 |
返回说明：返回可用的模式列表，前端按数字升序排序后展示。模式枚举如下：
| 值 | 模式 | 说明 |
|---|---|---|
1 |
业务员模式 | 默认工作台身份，绑定业务员 |
4 |
供应商模式 | 供应商身份，绑定协议号 |
⚠️ 未配置任何模式时，前端提示「暂无可用的工作台模式，请联系运营开通」。
接口路径：/workbench/mode/updateWorkbenchMode
功能描述：管理员配置商户启用的工作台模式。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| partnerId | Int | 是 | 商户编码 |
| modeCodes | String[] | 是 | 启用的模式编码集合（如 ["1","4"]） |
接口路径：/insapi/v3/ProtocolManagement/queryProtocolSimple
功能描述：查询该商户 / 客户下的协议号列表，用于供应商模式顶部「协议号」下拉。
关键约束：
功能描述：供应商模式下，若下拉中没有合适协议号，可通过「没有合适协议号？快速新增」新增协议号，成功后下拉自动刷新立即可选。
接口路径：robotWeixinChatSaveChat
功能描述：建立当前群与协议号的绑定关系，绑定主体唯一键为：
| 字段 | 说明 |
|---|---|
| partnerId | 商户编码 |
| customerId | 客户编码 |
| salesId | 协议号（关联群） |
| chatName | 群名称 |
| mode | 4（供应商模式） |
⚠️ 冲突约束：若协议号已被其他群绑定（非当前群），前端提示「该协议号已绑定 "XX" 群，请换绑后再尝试绑定!」，避免一协议多群冲突。
接口路径：branchWeixinChatQueryChat
功能描述：查询该商户下指定模式（mode）的群绑定记录，用于：
关键参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| partnerId | Int | 是 | 商户编码 |
| customerId | Int | 是 | 客户编码 |
| mode | Int | 是 | 模式值，供应商模式传 4 |
返回说明：返回群绑定记录，前端按 chatName 匹配当前群名、salesId 非空判定「已绑定协议号」。
供应商模式与业务员模式为独立页面，切换时整页跳转：
| 模式 | 路由 |
|---|---|
| 业务员模式 | /wechat/insure |
| 供应商模式 | /wechat/provider |
切换携带 token 等登录参数，如 /wechat/provider?token=...。
| 接口 | 说明 |
|---|---|
premiumCalculateCheck |
报价前置校验（报价配置 / 工号 / 城市 / 出单员校准） |
premiumOrderAdd |
转群报价落子项并记录工号（由人工录单提交后触发，原从「智能调价」进入） |
premiumPriceAddOnly |
人工录单：选择主险方案后只建主单，不建子项 |
💡 供应商模式下未绑定协议号时，相关校验 / 拖拽会被拦截并提示「请先绑定协议号」；页面组件使用
bindingType='agreement'（协议绑定）。
| 模块 | 接口 | 说明 |
|---|---|---|
| 工作台模式 | queryAvailableModes | 查询商户可用身份模式 |
| 工作台模式 | updateWorkbenchMode | 配置商户启用模式 |
| 协议号 | queryProtocolSimple | 查询协议号列表（未过期） |
| 群绑定 | robotWeixinChatSaveChat | 保存群与协议号绑定 |
| 群绑定 | branchWeixinChatQueryChat | 查询群绑定记录 |
| 出单报价 | premiumCalculateCheck / premiumOrderAdd / premiumPriceAddOnly | 报价校验与落单 |
最后更新：2026-09-17