> 本文整理自平台文档 docs/wujies/5.x/plugins/quote.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-69e63cfabf60-cover.svg)
应用编码 quote,本页对应应用版本 1.0.3(引擎要求 >=5.6.2 <6.0.0),许可 MIT,仓库 [wujies-quote-plugin](https://gitee.com/wujies/wujies-quote-plugin)。
报价管两摊:报价单(明细行加价、税率、运费、优惠,状态在 draft → sent → accepted / cancelled 之间流转)和价格库(可从 Excel 批量导入的产品台账,每行持拿货价)。对外有一屏公开询价页 /site/quote,读价格库的上架切片,匿名提交进来落成草稿报价单。依赖 im 标了 optional,它只影响那一页上的「进入在线询价工作台」一条链,不装别的都照常。
与商城没有代码耦合:本应用只声明 im(可选),价格库与商城商品是两张各管各的台账,导入导出都只认 quote_price。
适用场景是访客留需求、业务员在后台改价出单。要让公开页带价直接下单,现状不支持,也没有开关能打开。
装它
没有必装依赖,任何部署都能直接装。MIT 许可,不走购买与激活(各授权档位的差异见 [授权档位](/docs/wujies/5.x/license/editions))。装成功后侧栏多一个「报价管理」,下面一项:
| 菜单 | 路由 | 需要的权限码 |
|---|---|---|
| 报价单系统 | index | quote:order:list |
页面里是两个页签(报价单、价格库),所以按钮码分两组:quote:order:query / add / edit / remove / export / status / generateNo,和 quote:price:list / query / add / edit / remove / export / import。页签本身没有独立开关,想让人看不到价格库页签,收掉整组 quote:price:* 即可。
前台与会员端另有三条边界要在装的时候心里有数:
1. /site/quote 由 [内容中心](/docs/wujies/5.x/plugins/cms) 的主题壳直出。没装 cms 时这条路径返回 404 且响应体为空,宿主日志留一行「前台页要渲染但没有主题壳」的 WARN,后台两页签照常。 2. 自带样式 /site/apps/quote/quote.css 由本插件自己的资源端点发出。插件各自类加载器,主题那侧读不到本插件 jar 里的文件,谁的文件谁发;这条链在这台部署热加载过一次 quote 才生效(见「出问题查什么」)。 3. C 端那个 /quote 询价页在会员端站点 wujies-web 里,不在本仓库;本应用为它提供 /portal/quote/** 接口。
配它
没有全局配置:客户、供应商、税率、运费、优惠、付款 / 质保 / 交货条款、品牌名,全部逐单在页面里填。要提前定口径的是下面几处。
加价模型。报价明细的售价由该行的拿货价推出来,加价方式三选一:百分比、固定额、直接手填,支持一次应用到全部行。报价单的合计按成本、明细额、加价额、税费分列存储,税率运费优惠逐单填。价格库本身只存拿货价,加价只发生在报价单这一层。
公开页展示什么。/site/quote 列价格库里状态为上架的行,每页 20 条,搜索命中分类、产品名称、型号、规格、价格类型五列。这一屏刻意不印任何价格:表里存的那列是拿货价,直出模板不渲染它,也没有开关能打开。对外报价走表单,改价出正式单在后台与会员端。判断「要不要让访客看到价」时,现状是看不到,要看到就得改模板重构建。价格库某一行下架或删除,公开页同步消失;这屏的商品集合完全跟着价格库的状态列走。
SEO 的口径也写死在直出代码里:规范地址固定 /site/quote,带搜索词、翻页或表单回跳参数的屏加 noindex,搜索引擎不会替你把筛选页收录出去。筛选、搜索、分页、已选行和回执全部走 query 不走路径段,加第二个条件时切片页还拼得出来。这一屏没有详情页:一条记录的型号与参数已在列表里摆完,另开一屏只是给导入数据多出几百个抓取入口。
QuoteSiteLinks 里两个地址的写法各有来由。APPLY_API_URL 挂本应用自己的 /site 前缀,表单 POST 走同源、匿名可达,不需要会员端的登录态与 clientid。APPLY_URL 是会员端 SPA 的在线询价那一屏(建单后逐行改加价、算总价),只给相对路径 /quote:本站与会员端同域、按路径前缀区分,写死域名会把本地、测试、线上三种部署写成两种。
匿名收单口径。「我要询价」表单同源 POST 到 /site/quote/apply,成功 302 回列表带 done=报价单号(格式 BJ + 八位日期 + 六位随机数,表上的唯一索引兜底),失败回带 err=(items / quantity / fields / save 四个码之一)。硬口径:每单最多 20 行明细,数量 0.01 到 999999,文本列各有长度上限,电话要匹配 ^\+?[0-9][0-9 -]{5,19}$,另有一个名为 website 的蜜罐字段,机器人填了它就被当作没提交静默处理。进来的单落为草稿,备注自动带「前台询价页提交」前缀,管理员在报价单页签里筛。这一屏没有验证码也没有限流可用(宿主那两道都不为 /site/** 开门),真被刷到收不住时,代码留的出口是把表单指向会员端那条需要登录的询价链,匿名口子随之关闭,改法在 QuoteSiteLinks 一个常量。
提交之后这一屏不再露出任何客户数据:直出页对报价单与明细只写不读,访客刷新页面看不到自己刚提交的单,也看不到别人的;跟进全部回后台。
在线询价工作台(可选的 im)。公开页上那条链要求登录,做的事是按单反查会员、必要时发起好友申请、确保一对一会话(两边都查),会话为空时补一句默认开场话术(「您好,我是从在线询价页过来的,想咨询报价单的事。」),然后把人带到会员中心的消息页。超级管理员账号点它会直接被拒(「当前登录的就是超级管理员…」),这条链是给实际接待的业务账号用的。不装 im,点它得到「应用「即时通讯」未安装或未启用…」,报价自己的页面与数据不受影响。见 [即时通讯](/docs/wujies/5.x/plugins/im)。
用它
管理员在「报价单系统」两个页签里干活。价格库页签:下载导入模板、Excel 批量导入(导入痕迹记录源文件名、工作表、行号,便于回对),单个产品也可手工加行、手工改拿货价。
报价单页签:从价格库选行或手工加行,逐行选加价方式(百分比 / 固定额 / 直接填售价)并可一次应用到全部行,再填税率、运费、优惠;状态按已发送、成交、作废推进,两页签都支持导出。
会员在 C 端 /quote 页(wujies-web 的报价页,不在本仓库)发起在线询价,可调 /portal/quote/price/list 看上架产品、提交自己的询价,落库同样是草稿报价单;改价与出正式报价单回后台做。
访客能看 /site/quote 并提交询价表单;看不到别人提交的单,也看不到拿货价。
出问题查什么
| 现象 | 先看什么 |
|---|---|
/site/quote 返回 404、白页 | 是否装了 cms;没主题壳时这一屏按设计就是 404 空响应体,看宿主日志的 WARN |
| 装了 cms 仍然 404 | 主题壳取自内容中心的装载状态,确认 cms 处于已加载而不只是已安装(热加载与重启的差别见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps)) |
页面样式全无、/site/apps/quote/quote.css 取到的是 JSON 错误体 | 资源端点要热加载一次 quote 才注册(光构建只更新资源);判路由是否命中要看 content-type,未命中的 /site/** 回的是 JSON 不是 404 页 |
| 提交询价没反应也没报错 | 蜜罐字段 website 被填会按未提交处理;地址栏带回 err= 时按四个码对号:行数、数量、字段长度 / 电话格式、保存失败 |
| 想在公开页看到谁提交过哪些询价 | 这一屏按「只写不读」设计:报价单上的客户数据从不出现在直出页里,管理员回后台报价单页签查 |
| 点「进入在线询价工作台」报应用未安装或未启用 | im 未装或未启用,这条链是 quote 唯一用到 im 的地方 |
| 工作台提示当前登录的就是超级管理员 | 换实际负责接待的业务账号登录再点,会话与消息落在那个账号上 |
| 会员端提交询价报「询价产品不存在或已下架」 | 价格库对应行被下架或删除;公开页列表同步只剩上架行 |
| 导入 Excel 失败或串列 | 用「下载模板」出的表头填;导入结果里有源行号,按行号回对原表 |
| 公开页搜索搜不到某个产品 | 搜索只命中分类、产品名称、型号、规格、价格类型五列,写在这五列之外的文案匹配不到 |
| 报价单合计与预期差一笔 | 合计按成本、明细、加价、税费分列落库;先对回该行的拿货价、加价值与税率,本应用没有默认税率可继承 |
| 后台两个页签整个起不来 | 后端 jar(backend/wujies-quote-plugin-1.0.3.jar)是否随包装载;装载操作见 [在部署里使用应用](/docs/wujies/5.x/platform/app-market/using-apps) |
| 新建报价想先看单号规则 |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-69e63cfabf60-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。