FlamePOS 安装指南
1. 本指南的用途
本指南说明如何安装 FlamePOS 1.1.0-VSMS-1.0.0、配置运行环境、连接数据库、配置打印机， 并为 TaxCore E-SDC 或 V-SDC 通信准备 VSMS 连接。
2. 安装包
安装包应包含下列文件与目录：
- 1.1.0-VSMS-1.0.0 版的
flamepos.jar或经批准的可执行包。 - 如单独提供，则包含应用依赖目录
lib/。 config/目录，内含小票模板、图标、打印版式与数据库配置。i18n/目录，内含程序文本。- 本次发行所需的数据库创建或升级文件。
- 所提交版本的发行说明与校验和。
3. 系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | 由安装人员认可的 Windows 或 Linux 桌面环境。 |
| 运行时 | 与所发行的 FlamePOS 版次兼容的 Java 运行时。此类应用通常使用 Java 8。 |
| 内存 | 作为 POS 终端使用时建议至少 4 GB 内存。 |
| 存储 | 至少 2 GB 可用空间，用于程序文件、日志、小票模板，以及适用时的本地数据库文件。 |
| 网络 | 能访问所配置的数据库，以及所选的 TaxCore E-SDC 或 V-SDC 地址。 |
| 打印机 | 在操作系统中配置好、并且 POS 用户账号可用的 80 毫米热敏小票打印机。 税务小票版式宽 226 点（约 79.7 毫米）。 |
4. 安装前检查清单
- 确认本次安装的纳税人／商户资料。
- 确认 TaxCore 开发者场所与证书身份。所提交的场所类型为总部，场所名称为 Wok & Flame。
- 确认 POS 终端编号。
- 确认小票打印机名称与纸宽。
- 确认数据库服务器、库名、用户名与密码。
- 使用 E-SDC 时，取得地址与分配的卡 PIN；使用 V-SDC 时，取得 HTTPS 地址、PAC 与 PKCS#12 客户端证书及其密码。
- 确认 FlamePOS 版本正是 1.1.0-VSMS-1.0.0。
5. 安装 Java 运行时
- 安装本次发行所认可的 Java 运行时。
- 打开终端或命令提示符。
- 确认 Java 可用：
java -version
把 Java 版本记入安装检查清单。
6. 安装 FlamePOS
- 创建程序目录，例如 Windows 上的
C:\FlamePOS或 Linux 上的/opt/flamepos。 - 把经批准的 FlamePOS 安装包复制到该目录。
- 确认目录中含有程序 JAR、配置目录、小票模板与依赖文件。
- 设置文件权限，使普通 POS 用户可以运行程序，但未经授权不能修改敏感配置。
7. 数据库配置
按所选的数据库类型配置连接。程序配置中包含数据库主机、端口、库名、用户名、密码与连接串等设置。
需要核对的字段举例：
- 数据库类型名称。
- 数据库地址或主机。
- 数据库端口。
- 数据库名称。
- 数据库用户名。
- 数据库密码。
8. VSMS / TaxCore 配置
为本次安装选择并配置一个签名方：
- 本地／开发 E-SDC 设
vsms.sdc_type=ESDC；虚拟 SDC 设vsms.sdc_type=VSDC。 - E-SDC 需设置
vsms.esdc.base_url与vsms.esdc.pin。 - V-SDC 需配置 HTTPS 地址与证书路径。PAC 与证书密码通过受保护的环境变量
FLAMEPOS_VSMS_VSDC_PAC与FLAMEPOS_VSMS_VSDC_CERTIFICATE_PASSWORD提供。 - 超时与失败处理设置。
- 测试（sandbox）或生产模式。
E-SDC 模式会执行 PIN 激活，不发送 PAC 头，也不使用客户端证书；V-SDC 模式需要 HTTPS 双向 TLS 与 PAC， 不执行 PIN 激活。FlamePOS 不会自动回退到另一个签名方。测试凭据只能用于测试； 生产凭据只能装在生产环境，且不得提交到源代码库或放进对外的支持包中。
图 1. V-SDC 测试环境启动，凭据输入不回显，并在启动前完成证书校验。真实的 PAC、密码与证书数据
绝不应出现在文档或支持包中。
9. 打印机设置
FlamePOS 1.1.0-VSMS-1.0.0 支持在 57 毫米至 80 毫米类别的热敏纸上打印税务小票， 所用版式是为 80 毫米纸卷设计的。57 毫米以内的纸卷与 A4 幅面的税务发票输出 不属于本配置。
- 在操作系统中安装小票打印机。
- 如可行，打印一张操作系统测试页。
- 打开 FlamePOS 的打印机配置。
- 选择用于税务小票输出的小票打印机。
- 如有使用，选择厨房与报表打印机。
- 打印一张 POS 测试小票，核对对齐、二维码可读性与必需的小票字段。
生产环境的安装应使用适合打印顾客小票的真实小票打印机。
10. 首次启动验证
- 启动 FlamePOS。
- 确认"关于"界面或标题显示版本 1.1.0-VSMS-1.0.0。
- 用管理员凭据登录。
- 打开后台 > 配置 > 商户，按需配置本地品牌信息并保存。
- 确认数据库连接与商品数据加载正常。
- 确认小票打印机的选择。
- 打开 Active TaxCore Tax Rates，核对签名方类型与当前的状态／税率应答。
- 在测试模式下做一笔普通现金销售，核对二维码、SDC 纳税人商号及其后的 SDC 场所名称、
POS 号
1083/1.1.0-VSMS-1.0.0，以及二维码下方的END OF FISCAL INVOICE。对于所提交的总部场所，两行标识都读作 Wok & Flame。 确认验证网址没有作为文字被打印出来。 - 在未连接刷卡设备的情况下，用外部／手工输入授权码的方式做一笔刷卡销售。
- 做一笔引用原销售税务发票的退货。
- 打印一张小票副本，核对 TaxCore 副本发票、副本标记、引用发票与二维码。
- 在受控的测试中临时模拟所选 SDC 不可用，确认该笔销售不会作为成功的税务发票完成， 也不会被转给另一个签名方。
11. 升级说明
升级既有安装之前，请备份数据库、配置文件、小票模板与日志。升级后请确认程序版本， 并在适用时做一笔测试环境的税务发票验证。
12. 卸载
- 停止该终端上的 FlamePOS。
- 按公司留存策略备份经营数据。
- 确认所需数据已归档后，再删除程序文件。
- 若该终端不再使用，请吊销或删除本地证书文件与敏感凭据。
E-SDC PIN、证书文件与密码、PAC 值、数据库密码与生产凭据都属于敏感信息。
不要把它们上传到公开的代码库，也不要通过不安全的方式在支持沟通中发送。
FlamePOS 1.1.0-VSMS-1.0.0 · 安装人员与 IT 支持 ·
全部手册