FastPrint Agent 专业打印服务解决方案

一、产品概述

FastPrintAgent 是一款轻量、高性能的企业级分布式打印中间件，基于成熟的 FastReport 报表引擎开发。产品采用标准 RESTful HTTP 架构，支持通过 HTTP POST 提交 JSON 数据实现打印，适配全开发语言无缝对接。

程序支持 Windows 系统服务常驻、桌面客户端双模式运行，彻底解决企业异构系统打印集成难、多网点打印分散、报表开发繁琐、多打印机调度复杂等行业痛点。内置可视化无代码模板设计能力，支持单据打印、在线预览、PDF 导出归档，是企业信息化、工业自动化场景的通用标准化打印服务。

二、核心优势

• 解耦业务，专注核心：将打印能力从业务系统中完全抽离，独立托管所有打印逻辑。业务系统无需关注打印机、模板、底层打印细节，仅通过标准 HTTP API 提交数据即可完成打印，实现业务逻辑与打印能力彻底解耦。
• 企业级统一打印中台：可为企业内部多套异构业务系统提供标准化统一打印服务，杜绝各系统重复适配打印功能的冗余开发，实现企业打印能力统一托管、统一调度、统一运维。
• 全开发语言兼容：全面支持 C++、C#、Java、Python、Delphi、PHP、Go 等所有主流开发语言，统一通过 POST JSON 方式调用打印能力，无需适配底层打印机驱动。
• 多打印机集中管控：通过向不同的IP地址的打印服务程序发打印指令，使用统一的 HTTP 接口，可指定任意打印机，按需下发打印任务，实现多打印机一体化调度。
• 零代码可视化模板设计：内置 FastReport 可视化设计器，零代码快速制作单据、报表、票据模板，完美支持复杂表格、条码、二维码、电子签章、金额大写汇总等企业级报表元素。
• 双形态高稳定运行：支持 Windows 系统服务开机自启、7×24 小时无人值守后台运行，搭配可视化桌面客户端，同时满足生产稳定性与开发调试便捷性。
• 一站式开发调试工具箱：内置全套打印辅助工具，涵盖 JSON 处理、图片编解码、模板设计、日志追溯能力，大幅降低系统对接、报表调试、问题排查成本。

三、适用场景

专为企业信息化、工业自动化、商用零售、政务医疗场景量身打造，全面覆盖各类标准化打印需求：

• 企业信息化场景：ERP、进销存、OA 办公、财务报销、CRM 客户管理系统单据与报表打印
• 工业工控场景：MES 生产系统、工位工控机、质检设备、自动化生产线批量报表打印
• 商用零售场景：商超收银单据、门店订单、物流面单、售后工单批量打印
• 医疗政务场景：为HIS、LIS、政务等系统提供可靠的报表打印与PDF电子归档
• 餐饮行业场景：适配餐饮门店、连锁餐饮、食堂后厨等场景，支持点餐小票、结账单、后厨工单、外卖订单、消费清单等各类餐饮单据快速批量打印，满足餐饮行业高频、高效、多设备同步打印需求
• 异构系统集成场景：老旧系统、多语言混合系统快速接入统一打印服务，消除跨系统打印适配壁垒
• 分布式集群打印场景：多厂区、多门店、多终端环境下打印机统一调度、负载分散、集中运维管理

四、核心功能详情

4.1 标准化接口能力

统一 HTTP POST 接口、标准化 JSON 入参，通用适配所有业务系统，支持打印、预览、PDF 文件导出三大核心能力，跨终端通用。

4.2 灵活部署能力

双重运行模式：Windows 系统服务（开机自启、无人值守）+ 桌面可视化客户端。支持分布式多机器部署，适配企业长期稳定运行的生产环境。

4.3 企业级报表能力

基于 FastReport 成熟报表内核，支持复杂嵌套表格、明细数据汇总、金额大写自动转换、Base64 电子签章嵌入、自定义页面排版，完全满足企业正式单据、财务报表、生产报表的输出规范。

4.4 全能调试工具箱

• JSON 工具：支持代码格式化、压缩、折叠，快速校验、调试请求数据
• 多媒体工具：图片与 Base64 字符串双向互转，适配电子签章、头像、凭证图片嵌入场景
• 模板工具：一键唤起设计器，自动绑定测试数据，快速开发报表模板
• 日志工具：全量留存打印请求记录，双击日志自动回填调试界面，快速复现、排查问题

五、快速开始

5.1 安装部署步骤

1. 下载 FastPrint Agent 安装包，解压至电脑任意目录（建议纯英文路径，避免中文乱码）
2. 右键以管理员身份运行「安装服务.bat」，自动完成 Windows 服务安装
3. 服务自动启动，默认监听端口：9798（支持在参数设置中自定义修改）
4. 部署完成后，系统右下角托盘生成 FastPrint Agent 图标，左键点击打开主界面
5. 在「计算机管理-服务和应用程序-服务」中查看 ASuperService，状态为「正在运行」即部署成功

5.2 调用基础规范

• 请求方式：HTTP POST
• 请求头：Content-Type: application/json
• 基础服务地址：http://127.0.0.1:9798

5.3 最简调用示例

可直接复制，使用Postman 调试：

{
  "printTemp": "SalesOrder",
  "printer": "",
  "printCn": 1,
  "printData": {
    "title": "销售订单",
    "orderNo": "SO20240520001",
    "customer": "张三",
    "items": [
      {"product": "笔记本电脑", "quantity": 1, "price": 5999},
      {"product": "鼠标", "quantity": 2, "price": 99}
    ]
  }
}

打印接口地址：http://127.0.0.1:9798/api/print-report

5.4 全功能示例

支持嵌套明细、金额汇总、大写转换、Base64 电子签章、PDF 导出等全功能场景。打开 FastPrint Agent 主界面 → 帮助 → JSON 示例，可查看调试完整示例。

六、API 接口文档

6.1 接口列表

接口功能	请求地址
直接打印	http://127.0.0.1:9798/api/print-report
打印预览	http://127.0.0.1:9798/api/show-report
PDF 导出	http://127.0.0.1:9798/api/export-pdf

6.2 请求参数说明（严格区分大小写）

参数名	类型	必填	参数说明
printTemp	string	是	FastReport 模板文件名，存放于程序 PrintTemplate 目录，仅传名称，无需带 .frx 后缀
printer	string	是	目标打印机全称；优先级：指定打印机 > 程序默认打印机 > 系统默认打印机
printCn	int	是	打印份数，默认值为 1
exportFileName	string	否	PDF 导出完整路径，1.仅调用 export-pdf 接口生效，2.需保证目录拥有写入权限，3.示例："D:\\PDF\\test.pdf"，4.为保证导出的PDF中文显示正常，防止出现中文乱码、空白、字体缺失，模板设计时，模板中所有展示中文文本的控件，必须选用微软雅黑、宋体、黑体等系统兼容的中文字体，避免使用无中文适配的特殊字体
printData	object	是	1.业务打印数据集。2.字段后缀添加 _base64image 可自动识别 Base64 图片并渲染。3.支持中文键名，模板可视化设计时更直观。4. printData 下不能再嵌套对象（Object），可增加多个数组（Array）；请参考帮助-JSON示例

6.3 响应参数说明

成功响应

{
    "state": "success",
    "code": 200
}

失败响应

{
    "state": "error",
    "code": 500,
    "message": "缺少printer字段"
}

七、客户端使用指南

7.1 系统托盘功能

程序后台常驻系统右下角托盘，左键点击图标可快速打开主操作界面。

7.2 主界面核心功能

7.2.1 打印调试

• JSON 编辑器：支持格式化、压缩、代码折叠，快速规整、调试业务数据
• 快捷操作：模板设计、打印预览、直接打印、PDF 导出
• Base64转换：实现图片与 Base64 字符串双向互转，适配电子签章、图片场景

7.2.2 模板设计

• 支持手动粘贴 JSON 数据，或双击历史日志自动回填调试数据
• 一键唤起 FastReport 设计器，自动绑定数据集，无需手动配置
• 自动识别 PrintTemplate 目录模板，无对应模板则自动新建空模板并自动保存，设计完成后，保存即可直接调用

7.2.3 日志查询

• 全量记录所有打印请求：请求时间、模板名称、打印机、完整请求 JSON
• 双击日志记录自动加载至调试界面，快速复现问题、定位报错

7.2.4 参数设置

支持自定义 HTTP 监听端口、默认打印机配置，灵活适配本地及局域网环境。

7.2.5 帮助

集成注册入口、全套 JSON 示例、使用教程，降低对接门槛。

八、模板设计教程

1. 打开 FastPrint Agent 主界面，切换至「打印调试」标签页
2. 粘贴业务 JSON 数据，或从历史日志读取已有调试数据
3. 点击「模板设计」，系统自动生成基础模板并唤起 FastReport 设计器，自动绑定数据集
4. 拖拽文本、表格、图片、条码等控件，完成报表布局与样式调整
5. 选中控件，绑定 printData 对应业务字段，完成数据关联
6. 调整字体、页边距、分页规则，预览确认打印效果
7. 保存模板，文件自动存入程序 PrintTemplate 目录
8. 接口调用时，传入模板名称（无后缀）即可加载对应模板打印
9. 更详细的请参考 FastReport 专业教程

九、授权注册说明

• 免费试用：安装即激活 30 天全功能免费试用，无任何功能阉割、无调用限制
• 正式授权：打开主界面-帮助页面，复制本机机器码，联系服务商获取专属注册码完成激活
• 授权优势：一机一码硬件绑定，防复制、防篡改、防外泄，完全适配企业商用合规场景

版本类型	授权方式	适用场景
标准版	单台电脑永久授权	个人开发者、小微企业、单台工控机、单设备独立部署场景
企业版（主力推荐）	企业内部不限设备授权 + 半年专属技术支持	多设备办公企业、工厂车间、医疗机构、连锁门店、多系统集群部署场景

正式授权采购、技术对接、功能定制、私有化部署请联系：倪杰 13506316883（微信同号）

十、版本迭代规划

后续版本将新增 MQTT 通信协议支持，适配云服务器、物联网设备、工控设备消息推送打印场景，拓展轻量化、低延迟的设备接入能力。

十一、联系方式

正式授权采购、技术对接、功能定制、私有化部署：倪杰 13506316883（微信同号）