使用手册
1. 登录
- 打开系统网址，输入用户名和密码（账号由管理员提供），点「登录」。
- 如需修改密码，登录后到「设置 → 账户」操作。
- 右上角能看到当前账号，点「退出」可登出。
2. 界面总览
顶部有五个标签页：
- 报价单：所有报价单列表，在这里新建、预览、编辑、删除。
- 发票：已开出的税务发票，查看、下载 PDF、作废（管理员）。
- 价格库：产品/材料/人工的资料和价格，出单时从这里选。
- 设置：公司信息、改密码、添加同事账号。
- 帮助：本手册。
3. 开一张报价单（核心流程）
- 在「报价单」页点右上角 + 新建报价单。
- 基本信息面板：报价单号和日期自动生成，报价单号可手动修改（如与已有单号重复，保存时会提示换一个）；填写客户名称、地址、联系人；需要时调整有效期、报价范围、VAT/WHT 税率。
- 清单明细面板：点「搜索价格库添加明细」框，弹出列表顶部有分类筛选（全部 / 光伏 / 逆变器 / 储能 / 材料 / 人工…），点一个分类只看该类；也可直接输入关键词（明细 / 型号 / 品牌）筛选，点结果即加入清单。
- 填该行的 数量；如果售价或成本要临时调整，直接改「单价」「成本」。其余字段（明细/品牌/型号等）来自价格库，不可改，避免出错。
- 临时的、价格库里没有的项目，点 + 空白行 手动填写。
- 重复添加所有项目。下方会实时显示各项小计、税费、付款额。
- 需要时展开底部「交易条款 / 备注」修改付款方式、银行账号、质保等。
- 点右上角 保存。保存后即可「预览/导出PDF」。
删除某一行：点该行最右侧的「删除」。删除整张报价单：在「报价单」列表点对应行的「删除」。
3.1 整单折扣
折扣只在整单上打一次，不按行打。在明细下方合计区的「整单折扣 Discount」框里填即可：
- 填 50000 → 直接减 50,000 泰铢；填 8% → 按不含税小计的 8% 减。留空 = 无折扣。
- 折扣按不含税小计扣减，扣完再算 VAT，所以客户实际少付的比折扣金额还多一点（含税）。
- 报价单和 PDF 上会单独显示一行「折扣 Discount」，客户看得清清楚楚。
放价管控：折扣超过管理员设定的上限（默认 15%）、或折后亏本 / 毛利过低时，保存前会弹出提醒并记入操作日志。如果管理员开启了「折扣超上限时禁止保存」，超限就存不了，需要找管理员批。
3.2 报价单上的二维码
报价单抬头卖方信息下面可以放一个二维码（微信 / LINE），方便客户直接扫码联系你。
- 先传自己的码：「设置 → 账户 → 我的二维码」，点「选择图片」，可以直接传微信截图。选完会弹出裁剪框——拖动方框对准二维码、拖右下角小方块缩放，把头像和多余文字裁掉，二维码占满方框，客户才好扫。确定即保存。
- 没传个人码的，报价单上会自动用管理员设置的默认二维码。
- 出单时确认：编辑页「基本信息」里有「在本报价单上显示二维码」勾选项，旁边就是本单要用的二维码缩略图——鼠标移上去（手机点一下）会放大，出单前扫一眼确认是不是自己的码。
- 这一单不想放二维码，去掉勾选即可，随单保存，不影响别的单。
- 想换码：点缩略图旁的「换成我的」或「换成默认」，再点保存。（只有存在另一张可换的码时按钮才出现。）
换了微信，老报价单会跟着变吗？不会。报价单在保存时就把当时的二维码存进了这张单，以后你换微信、公司换默认码，老单再打开、预览、导出，显示的还是原来那张。确实需要更新的，打开那张单点「换成我的」再保存即可。
3.3 预扣税 WHT 会从付款额里扣掉
泰国的预扣税（ภาษีหัก ณ ที่จ่าย）是买方代扣的：客户付款时先扣下这笔钱，直接替你们缴给税局，之后给你们一张扣缴凭证，年底抵你们自己的所得税。
- 所以客户实际转账的金额会少这一笔。报价单上的「付款额 Net Amount」就是客户真正要转的数：
付款额 = 总金额(不含税) + VAT − WHT，单据上 WHT 那行带负号。
- WHT 基数是「人工小计 × 税率」（默认 3%）——只对工时费计，货款不计。税率可在编辑页「基本信息 → WHT预扣(%)」按单调整。
- 没有工时费的单子（纯卖货），WHT 为 0，付款额就等于总金额 + VAT。
- 收款后记得向客户索取扣缴凭证，这是你们抵税的依据，丢了就等于白缴。
- 内部利润、毛利率按不含税总额计算，不受 WHT 影响——WHT 是预缴的税，不是成本。
3.4 付款额为什么是整数
付款额默认四舍五入到整泰铢（如 1,001,590.62 → 1,001,591），客户按整数转账，双方对账都省事。
可以不取整：编辑页合计区「付款额取整到整泰铢」取消勾选，这张单的付款额就精确到分（如 1,001,590.62），没有尾数调整；开票时「客户实付」不填也按这个精确金额开。
新报价单默认取不取整，由管理员在「设置 → 卖方设置」里定；已有的报价单不受影响。
想取整又不想出现尾数调整，就把不含税总额凑成 100 的整数倍（100 的 7% 正好是 7，VAT 就没有零头）。
- VAT 不受影响：税额按 7% 如实计算、如实打印，取整只落在「付款额」这一侧——VAT 是要申报的，不能为了凑整去改。
- 取整差额永远在 −0.50 ~ +0.49 泰铢之间，可正可负。这个差额只在编辑页合计区显示（黄色「尾数调整（内部，不进PDF）」一行），不会出现在客户的报价单和 PDF 上。
- 因此客户单据上「总金额 + VAT」与「付款额」会相差不到 0.5 泰铢，属正常取整，不影响任何税务口径。
- 内部利润、毛利率仍按不含税真实值算，不因取整而变化。
3.5 开税务发票 ใบกำกับภาษี
泰国税法：服务的计税点是收款，收到款当天就要开税务发票。系统里「收一笔开一张」。
- 报价单保存后，编辑页右上角点「开票」（仅管理员可开票，业务员看不到这个按钮）。有未保存的修改时要先保存。
- 选客户：下拉里选已有客户；没有就点「+ 新建客户」（会带入报价单上的名称、地址）。税号 13 位、地址必须填全，否则不能开。
- 全额：一次开完整张报价单，只能开一次。分期：第一次开时定下「共 M 期」，之后期次按顺序自动填好、不能改；填本期比例即可。最后一期不用填比例，系统自动取「合同总额 − 已开累计」，保证分毫不差。
- 作废了某一期，下次开票会自动回到那一期补开；如果最后一期已经开了，补开金额自动等于作废那期的缺口。想改总期数，要先把已开的分期全部作废。开票日期不能选今天以后，也不能早于本年最近一张发票（发票号要随日期递增，不能倒签）。
- 开票日期 = 收款日。付款到期一般留空（先付款后开票），留空时发票上整行不出现。
- 客户实付：客户只付整数，发票就按客户实际付的整数开。不填时与报价单付款额一致（报价单取整就四舍五入；报价单设为「不取整」就精确到分，没有差额行）；客户实际付的不一样就填实际数。差额在 VAT 之后单列一行：少付的小数记为「折扣 ส่วนลด」，多付的几分记为「尾数调整 ปัดเศษ」；VAT 不变。差额须小于 1 泰铢——多付几泰铢以上应退还客户，少付超过 1 泰铢属于折扣，要先在报价单上打折扣。有预扣税时，差额记在备注区「实际付款额」之前，含税总额照实。
- 贷款申请人（可不填）：填了就印在发票买方栏，不填不显示。分期时自动带出上一期填的名字。
- 点「预览」核对。预览带水印、没有发票号、不能下载。无误后点「确认开具」——此时才分配发票号，之后不能修改。
- 开具后可切换「中泰 / ไทย」下载 PDF。纯泰语版可直接给客户。所有发票都在顶部「发票」页里。
- 纸质发票：原件（ต้นฉบับ）打印签章后交给客户；再切到「副本」（สำเนา）打印一份自己存档，保存 5 年。减额单同样。每次打开单据默认是原件，避免误把副本发给客户。
- 明细显示方式（全额开票时可选，默认跟报价单的颗粒度一致）：明细报价＝逐项带单价和金额；分类报价＝逐项列出但不带单价金额，给分类小计；仅总价＝逐项列出但不带单价金额，只给总价。明细名称和数量始终列出（税法要求写明商品名称与数量）。分期发票每期一行，不受此选项影响。
- 右下角「含税总额」是发票的法定金额；下面「预扣税」「实际付款额」两行是备注，方便客户按报价单金额转账。
- 已开过发票的报价单不能删除，而且金额被锁定：明细的类目 / 数量 / 单价、增删行、折扣、税率都不能再改（明细名称、备注、条款、联系方式可以改）。确需变更时请管理员在编辑页顶部点「解锁修改金额」并填原因，只管下一次保存。
- 合同金额变了：已开出的发票不会跟着变。增加的部分另开发票，减少的部分请会计开减额单 ใบลดหนี้；发票本身开错才作废重开。
减额单 ใบลดหนี้（退款 / 减价 / 退货）
- 「发票」页找到原发票，点「开减额单」（也可在发票查看页点）。仅管理员可开。
- 填本次减额（不含税），或勾「全部冲减」；选减额原因（只能是税法规定的 7 种情形之一），再写一句说明（印在单据上，建议泰文或英文）。
- 预览核对后确认开具，得到独立编号（如 CN-2026-0001）。VAT 按差额 × 7% 计；全部冲减时 VAT 取原票剩余 VAT，分毫不差。
- 一张发票可以开多张减额单，但累计不能超过原发票金额。挂着有效减额单的发票不能作废，要先作废减额单。
- 报价单的「已开累计」会自动扣掉减额部分。如果是合同金额永久减少，开完后请管理员解锁并同步修改报价单金额，否则后续分期会把这部分重新开出来。
作废 ≠ 退款。发票开错（客户名称、税号、金额填错）才作废：只有管理员能操作，必须填原因，号码保留不再使用，客户手里的原件要收回。退款 / 减价 / 退货要开减额单 ใบลดหนี้（见上），不要用作废处理，否则双方申报对不上。
跨月作废：作废上个月（或更早）的发票时系统会再次确认——那个月的增值税申报 PP.30 可能已经交了，作废后要请会计补报。
第一次使用前，请管理员到「设置 → 开票信息」填好公司名称（英文/泰文）、泰文地址、税号、分支、银行账户。这些会原样印在发票上。
4. 看利润（内部信息，不会出现在客户PDF）
清单里黄色的成本、利润列，以及底部黄色的总成本 / 总利润 / 利润率卡片，只给你（填表人）看。
- 每行利润 =（单价 − 成本）× 数量，括号里是该行利润率。
- 成本来自价格库（采购价），可在该行临时调整。
这些成本和利润绝不会出现在导出给客户的 PDF 上，可放心使用。
5. 投资收益方案（可选，给业主看）
在编辑页展开「投资收益方案」面板，勾选"生成投资收益方案"，报价单 PDF 后会附一页给业主看的投资回报测算。
- 选收益模式：自用（按零售电价省电费，默认）或 上网卖电（按上网电价）。
- 点「按报价单自动填」：装机容量按光伏明细自动算、投资额取付款额（都可手动改）。
- 其余用默认即可：单位发电量 1400 度/kWp·年、零售 4.80 / 上网 2.20 泰铢/度、组件效率 首年98%/第10年90%/末年80%、25 年。
- 面板下方实时显示回本周期 / 总收益 / 首年收益 / 年均收益率；PDF 附页含收益曲线和逐年明细，支持中英/泰语。
这是给客户看的投资回报预估，PDF 会注明假设并附"实际以现场发电为准"的免责说明。组件效率按两段式质保曲线（首年→第10年→末年三个点线性插值）计算，默认 98%/90%/80% 与厂家质保一致，可按实际组件调整。
发电量算法说明（0.99 是怎么来的）
年发电量：第 1 年 = 装机 × 单位发电量；第 2 年起 = 第1年发电量 × 该年组件效率 ÷ 0.99。
这里的 0.99 是"归一化除数"，沿用业务预算表的算法。严格来说它应当等于首年组件效率（98% = 0.98）——因为第 1 年发电量对应 98% 效率，要换算到第 n 年效率，应除以 0.98（即 发电量(n) = 年1 × 效率(n) ÷ 效率(1)）。业务表用 0.99 是个近似（略偏保守，使后续各年发电量约低 1%）；系统沿用 0.99，以便与业务预算表口径一致。若想更严谨，可把它改回 0.98。
6. 预览 · 切换语言/配色 · 导出 PDF
- 在报价单列表点「预览」，或编辑页点「预览/导出PDF」。预览页左上角有「返回」可回到列表。
- 右下角 中英 / ไทย 切换语言：泰语版会把单据文字（含表头、合计、条款等）变泰语，明细用价格库里维护的泰语名。
- 右下角 配色 圆点切换 5 套颜色：蓝色/墨绿/深灰/酒红/橙金。
- 颗粒度 决定客户能看到多细的价格，三选一，详见下方 6.1。
- 一页排版（自动）：导出时系统会尽量把整张单排进一页。明细多时先自动紧凑表格（行距收紧、品牌/型号/备注字号略小），仍放不下才整体等比缩小，纸张始终是标准 A4。
- 实测：常规明细 30 行以内、长文字明细 24 行以内，都能排成一页；20 行时纸上字号约 6.5pt，正常阅读无压力。
- 超出能力范围时会明确提示并正常分页，不会默默排出一份错版的 PDF。预览页「功能 ▾」里也会提前显示黄色提醒。
- 带「投资收益方案」附页的单据本来就该多页，不做单页压缩。
- 导出有两种方式：
- 下载PDF（推荐，手机首选）：直接生成 PDF 文件，自带配色，保存后可立即分享给客户。
- 打印：走浏览器打印，电脑上可得到可选中文字的 PDF（打印对话框里选「另存为 PDF」，并勾选「背景图形 / Background graphics」以保留底色）。
手机上导出并发给客户
- 打开报价单预览，按需切换语言和配色。
- 点 下载PDF，稍等生成。
- iPhone：在弹出的预览里点右上角「分享」，选微信/LINE/邮件发给客户，或「存储到文件」。
安卓：文件会下载到手机，到通知栏或文件管理里找到该 PDF 再分享。
如果系统是在微信 / LINE 内置浏览器里打开的，下载可能受限——请改用手机自带的 Safari / Chrome 打开本系统再导出。
6.1 报价颗粒度（这个客户能看到多细）
控制导出给客户的清单里露出多少价格信息，三选一。它只管显示，不改任何金额——三档的总金额、VAT、WHT、付款额完全一样。
| 档位 | 单价 / 金额两列 | 分类小计四行 | 什么时候用 |
|---|
明细报价
默认 | 显示 | 显示 | 熟客、需要逐项核价、或对方要按项验收时。 |
| 分类报价 | 不显示 | 显示 | 客户想知道产品／材料／人工大致怎么分，但不必逐项比价。 |
| 仅总价 | 不显示 | 不显示 | 新客户初次询价、或不希望对方拿单项去比价时。 |
- 两个地方都能改：编辑页「基本信息 → 报价颗粒度」，或预览页「功能 ▾」里的颗粒度按钮。在预览页切换会立刻存进这张单。
- 跟着单据走，不跟着人走。每张报价单记住自己的档位，不同客户可以不同；换电脑、换浏览器都一样。新建的单子默认「明细报价」，复制单据会沿用来源单的档位。
- 三档都保留数量、单位、品牌、型号、参数——客户要核对给了多少块板、什么型号，藏掉容易在验收和合同上扯皮。只有总价、没有逐项单价，客户拿数量也反推不出单项价格。
- 小计和总额行的版式三档一致，都挂在清单表底部通栏显示。
- 若折扣不为零，「小计 → 折扣 → 总金额」三行在三档下都会显示。不想让客户看到折扣力度，就在编辑页把折扣并进单价里。
颗粒度和报价说明里写的「总价包干 Lump Sum」是两回事，互不影响：前者管给客户看多细，后者是价格可不可调的商务承诺。「总价包干 + 明细报价」是很常见的组合——价格锁死，但清单构成照样给对方看。
拿不准发哪档：新客户询价用仅总价，进入谈判后放到分类报价，签约或对方要逐项核价时再给明细报价。
7. 价格库
- 搜索：顶部输入框可按 明细/品牌/型号 搜。
- 新增/编辑：点「+ 新增条目」或某行「编辑」，填写：类目、类型(筛选分类)、明细(中英)、品牌、型号、参数、单位、销售单价、采购成本、泰语名称(泰语版明细用)、质保、采购渠道。
- 类型决定它在出单选择器里归到哪个分类筛选；留空则系统按名称自动判断。
- 采购目录里很多条目只有成本、没有售价，出单时按报价填「单价」即可。
维护好「泰语名称」，泰语版报价单的明细就会自动用泰语显示。缺泰语名时，可点价格库右上角「一键补全泰语名」，由阿里云翻译自动补齐（译一次永久复用，可再手动微调）。
泰语名维护状态（价格库上方「泰语」筛选，以及泰语名列的标记）：
- 缺失（标红「缺」）：还没填泰语名。泰语版报价单里这条会回退成中英显示。
- 通用占位（标黄「通用」）：泰语名只是这一类的统称、不区分具体型号——比如所有逆变器都填成 อินเวอร์เตอร์、储能都是 แบตเตอรี่เก็บพลังงาน、配件都是 อุปกรณ์เสริม。这是导入采购表时自动填的占位，能正常出单（泰语版旁边还有品牌/型号，本就是英文/拉丁），只是名字不够精确。
- 已填具体：泰语名是这条商品专属、区分了型号的译名。
泰语批量维护：点价格库右上角「泰语批量维护」，会把所有「缺失 / 通用占位」条目一次列出（中英 + 品牌型号对照），逐条改成更具体的泰语后一键保存，改完即变「已填具体」，以后出单自动复用。不改也不影响出单。
8. 设置
- 卖方设置（仅管理员可见可改）：公司名称、地址、联系方式、单号前缀、币种、银行账号（新建报价单时自动带出，单张单里还能单独改）、折扣上限 / 最低毛利 / 是否禁止超限保存、默认二维码。
- 账户（人人可用）：修改自己的登录密码（原密码 + 新密码，至少6位）；上传我的二维码——传了以后你出的报价单默认用这张，没传则用默认二维码。
- 用户管理（仅管理员）：添加同事账号、重置密码、禁用/启用、删除；每行还可「设为管理员 / 降为业务员」随时调整角色。
注意：不能改自己的角色（防止误把自己锁在管理页外），且系统始终保留至少一个启用中的管理员。内置的 admin 账号标有「内置」，不可禁用、删除或改角色（密码仍可重置），以免操作日志失去唯一的查看人。
- 操作日志（仅 admin 账号）：查看报价单的新建、修改、删除记录及具体改了哪些内容；用户角色变更也会留痕。
这一项只有系统内置的 admin 账号能看，其他管理员也看不到——日志是用来复核所有人（含管理员）操作的，看的人和被看的人应当分开。
9. 手机使用
- 「基本信息」「清单明细」是可折叠面板，点标题可展开/收起，减少滑动。
- 明细在手机上变成一行一张卡片，无需左右滑；同样只有数量/单价/成本可改。
- 预览会自动缩放适配手机屏幕宽度；顶部蓝色导航栏固定不动：左边「‹ 返回」，右边「下载PDF」（发票预览为「确认开具」），「⋯」里是语言、配色、颗粒度等设置。点「下载PDF」即可生成标准 A4 文件直接分享给客户。
- 左滑返回 / 安卓返回键：逐层返回——先关弹窗，再退出预览，再从编辑页回到列表；编辑页有未保存的修改时会先询问。
- 添加到手机桌面（像 App 一样用）：
iPhone：用 Safari 打开本系统 → 点底部「分享」→「添加到主屏幕」。
安卓：用 Chrome 打开 → 右上角菜单 →「安装应用 / 添加到主屏幕」。
之后从桌面图标打开即可全屏使用（需服务器启用 HTTPS）。
10. 常见问题
报价单号是怎么来的？
规则为 DS + 年月日 + 当日序号（当日从100起，如 DS260625100），自动生成，必要时可在编辑页手动覆盖。
税费怎么算的？
清单金额为不含税价。增值税 VAT = 不含税总额 × 7%；预扣税 WHT = 工时费小计 × 3%（由买方代扣代缴，仅作参考，不计入付款额）；付款额 = 不含税总额 + VAT。税率可在单据上修改。
报价单上的二维码扫不出来？
多半是上传时把头像、昵称一起截进去了，二维码本身太小。重新到「设置 → 账户 → 我的二维码」传一次，在裁剪框里把方框拖到只框住二维码（四周留一点白边即可），二维码占满方框就能正常扫。传完在编辑页把鼠标移到缩略图上放大看一眼，也可以直接用手机扫一下确认。
我换微信了，以前发出去的报价单会变吗？
不会。每张报价单在保存时就把当时的二维码存进了这张单，换码只影响之后新开的单。老单要更新，打开它点「换成我的」再保存。
忘记密码了？
请联系管理员协助重置。
数据安全吗？
所有数据都保存在公司服务器上，由管理员统一维护和备份。
