SortingGo Print Service 是什么?
它是安装在 Windows 电脑上的后台服务与 Web 管理平台,负责标签设计、数据格式管理、打印机管理与打印。它不是 APP,也不是云端打印服务;局域网内即可运作。
Web 后台网址与默认 Port 是什么?
默认 Port 是 28088。Windows 本机可用 http://localhost:28088 打开;手机或其他设备需改用 Windows 电脑的局域网 IP,例如 http://192.168.1.50:28088(手机上的 localhost 是手机自己,连不到电脑)。
手机 APP 连不上 Print Service 怎么办?
依序检查:①在 Windows 本机浏览器打开服务网址确认服务启动;②在手机浏览器打开同一网址,失败多半是防火墙或 Wi-Fi 用户隔离;③确认 APP 输入的 IP、Port 正确;④重新建立 API Key 测试。成功时 APP 会显示连接成功与标签格式数量。
没有互联网可以使用吗?
可以。局域网打印与 Web 后台都能在内网运作;只有下载新版、授权启用或外部服务可能需要互联网。
哪些信息不应提供给 AI 或客服?
不要提供完整 API Key、密码、Signed Entitlement 授权凭证、内网凭证或含个人信息的订单数据。需要协助时,提供版本、发生时间、错误消息截图与遮蔽后的部分信息即可。
如何反馈问题?
请提供 Print Service 版本、Windows 版本、APP 版本与手机型号、打印机品牌型号与连接类型、发生时间、错误截图、打印记录 ID 与日志片段。切勿附上完整 API Key、密码或授权凭证。
数据库在哪里?要怎么备份?
安装程序部署时数据放在 C:\ProgramData\SortingGoPrintService,主要数据库是 data\labelprint.db。备份时建议先停止服务,再复制 labelprint.db、labelprint.db-wal 与 labelprint.db-shm 三个文件。
参照数据来源是做什么用的?
上传商品主档、客户主档等 Excel 后,在「数据格式管理」绑定 join 字段,标签就能使用 Excel 中的字段(条码、售价、产地…),打印时由服务端自动查表带入,不必把这些字段放进每次的打印数据。
重新导入会发生什么事?
重新导入会以整份 Excel 取代该来源的既有数据。key 为空的数据行会略过;key 重复的数据行由后面的行覆盖前面的。导入完成时会显示略过与覆盖的笔数。
为什么参照数据来源无法删除?
该来源正被某个数据格式绑定使用时无法删除。请先到「数据格式管理」移除相关绑定,再回来删除。删除会移除全部数据行且不可还原。
打印时查不到 key 会怎样?
查无 key 的数据行,参照字段会以空白带入,标签照常打印、不会报错。若标签上参照字段大量空白,请检查 join 字段值与参照来源的 key 是否一致。
内置的默认数据格式与标签范本会覆盖我修改过的内容吗?
不会。服务启动时若数据库已存在相同 ID 的数据格式或标签范本,不会覆盖你调整过的内容。
删除数据格式会有什么影响?
删除数据格式会一并删除绑定该格式的标签格式,操作前请先确认,必要时先用「导出」备份成 JSON。系统使用的默认格式不可删除。
参照数据来源绑定是什么?
把数据格式的某个字段设成 join 字段,对到参照数据来源的 key,并取一个虚拟字段前缀(例如 pinfo)。绑定后标签设计器可使用「pinfo.条码」这类参照字段,打印时由服务端查表带入实际值。变更后记得「保存此数据格式」。
公式字段怎么用?
公式字段在打印前由服务端依公式产生,使用 {字段} 加字符串常量以 + 串接,例如 {商品编号}+','+{数量}。可引用原始字段、其他公式字段与参照字段,常用于组合条码内容。
可以直接用 Excel 表头建立字段吗?
可以,用「选择范例 Excel」并套用表头即可批次建立字段。注意:此功能会清空该数据格式已设置的字段、参照绑定与公式字段设置,再以范例 Excel 表头重新建立,套用后记得保存。
图片组件支持哪些格式?有大小限制吗?
支持 PNG、JPEG、WebP;不支持 SVG 与 GIF。建议文件不超过 512KB、原始宽高不超过 1200px。图片呈现方式可选完整显示(contain)、填满裁切(cover)或拉伸填满(stretch)。
小计标签的明细表与汇总字段怎么运作?
每个小计版面只能有一个明细表;明细笔数超过每页容量时自动续印下一张。汇总字段(笔数或加总)固定显示整组合计,分成多张时会自动加上页码标记,例如「(1/2) 合计 123」。
标签打印出来偏移、被裁切或比例不对怎么办?
检查标签版面的纸张宽高与 DPI 是否符合实际标签纸(例如 60x40 mm)与打印机分辨率(203 或 300 DPI),再确认打印机本身的纸张设置与校正。Windows 驱动模式可用「Windows 驱动校正」微调 X/Y 位移与缩放。
组件位置可以精细微调吗?
可以。选取组件后用方向键以 0.5mm 为单位微移,按住 Shift 可放大为 1.0mm;也可在属性面板直接输入 X/Y 坐标与宽高(mm)。
标签格式可以备份或搬到另一台电脑吗?
可以。用「导出」把标签格式存成 JSON 文件,在目标环境用「导入」还原;也可用「复制版面」建立副本再修改。误改时可用「复原」还原成上次保存的版面。
支持哪些打印机连接方式?
三类:网络(TCP raw,常见 Port 9100)、USB/蓝牙串口(COM Port)、Windows 系统打印机。蓝牙 SPP 在 Windows 通常呈现为 COM Port;BLE 标签机则由 SortingGo APP 的 Device BLE 模式处理,不需在此建立。
指令协议(TSPL、ZPL、EPL、ESC/POS)怎么选?
指令协议要依打印机支持能力选择:TSC 兼容机多用 TSPL/TSPL2,Zebra 兼容机用 ZPL/ZPL II,旧式 Zebra/Eltron 用 EPL,热敏收据机用 ESC/POS。若要避免内置字体造成乱码,将打印内容模式改成图像,系统会先把文字渲染成点阵图再通过所选协议发送。若打印出一堆指令文字或空白,通常就是协议或内容模式选错。
中文或多语言打印出乱码怎么办?
先确认指令协议正确,再切换「文字编码(字符集)」逐一测试(支持 auto、utf-8、big5、gbk、shift_jis、cp949、cp874、cp1258、cp1252),测试标签会打印出所选字符集的语言样本。Raw 模式受打印机内置字体限制,若需保证各语言可打印,改用 Windows 驱动(PDF/Bitmap)模式。
Windows 打印机的输出模式有什么差别?
Raw 指令模式直接送 TSPL/ZPL 等指令,速度快但受打印机字体限制;Windows 驱动模式(PDF/Bitmap)由系统渲染,多语言最稳但需要 Microsoft Edge;GDI 备援模式不使用浏览器渲染。大量打印可调整「打印渲染性能模式」(低频稳定/中频平衡/高频性能)。
打印机没反应怎么诊断?
先在此页执行「测试打印」,再依序检查:打印机电源与连接、网络打印机的 IP/Port、COM Port 是否存在且未被占用、Windows 打印机名称是否正确。仍失败时到「打印记录」查看详情,或下载 .bin 指令文件用「导入指令文件测试打印」重放。
可以重放之前的打印指令吗?
可以。到「打印记录」详情下载已编译的 .bin 指令文件,再到「打印机管理」用「导入指令文件测试打印」原封不动送到打印机重放,不经过标签格式编译。仅支持网络/串口/Windows RAW 打印机,Windows 驱动模式不支持。
导入 Excel 打印有什么限制?
文件上限 10 MB,且有行数、列数、单元格长度与总格数限制;含公式的单元格会被拒绝。解析不会在服务器暂存文件,也不会建立或影响参照数据来源。笔数多时建议分批打印。
PDF 导出失败怎么办?
PDF 渲染需要 Microsoft Edge 可由服务账号启动。请确认 Edge 已安装、查看服务日志,并试着简化模板(例如先移除大图片)再测试;仍失败时升级到最新版 Print Service。
为什么标签上有「试用」与 SortingGo 标记?
非 PRO/ENT 授权(FREE、LITE、STD 或未授权)时,所有输出会强制加上试用与 SortingGo 标记,打印功能本身不受限。移除标记需要有效的 Pro/Ent 授权,可到「授权状态」页查看目前判断结果。
多笔打印工作会互相干扰吗?
不会。同一台实体打印机的工作会进入序列化队列依序执行,不同打印机各自排队。短时间送出大量工作时打印需要等待,请不要重复点击打印,以免打印出重复标签。
测试打印成功,正式打印一定会成功吗?
不保证。正式打印仍受标签模板、实际数据内容、纸张与打印机状态影响。建议先用少量真实数据打印确认,再进行大批量打印。
打印记录可以查哪些信息?
可依状态(pending、printing、compiled、completed、failed 等)、来源(Web 或 API)、日期区间筛选。每笔记录包含时间、数据格式、标签格式、设备、种类、张数、份数、试用标记与状态,并可查看指令详情。
打印记录会自动清除吗?
默认保留 90 天,设为 0 代表不自动清除。自动清除在服务重新启动或每 24 小时排程检查时执行,不是保存设置后立即删除。需要立即删除可用「手动清除打印记录」,但该操作无法恢复。
打印记录可以导出吗?
可以导出 Excel,最多导出符合筛选条件的 5000 笔。若需要更多,请缩小日期区间分次导出。
为什么有些记录没有指令可下载?
Windows 驱动模式(PDF/Bitmap)打印不产生 raw 指令文件,或该笔工作尚未执行到编译阶段,所以没有 .bin 可下载。Raw 指令打印的记录可在详情下载 .bin,用于重放诊断。
可以只补印部分标签吗?
单笔标签工作可展开明细后勾选要补印的项目;小计标签因为是一组明细汇总成一张,一律整组补印。
补印可以换打印机或印多份吗?
可以。补印对话框可选择任一台服务器端打印机作为目标,份数范围 1~99。Web 补印至少需要一台服务器端打印机,若没有请先到「打印机管理」建立。
补印会移除原本的试用标记吗?
不会。补印会保留来源记录的试用状态;若原记录带试用标记,补印出的标签仍会有试用与 SortingGo 标记。
手机 BLE 打印的记录可以在 Web 补印吗?
可以。APP Device BLE 模式的打印记录也会出现在补印查询中,Web 补印时会改送到你选定的服务器端打印机。
API Key 是做什么用的?
API Key 是 SortingGo APP(或外部系统)调用 Print Service 打印 API 的凭证。在 APP 的「设置 > 打印设置」输入服务器地址与 Key 后即可连接打印。
API Key 明文之后还看得到吗?
看不到。明文只在建立时显示一次,离开页面后无法再次查看,请立即复制保存。遗失时直接建立新 Key 并撤销旧的即可。
APP 显示「API Key 无效」怎么办?
通常是 Key 输入错误或已被撤销。在此页撤销旧 Key 并建立新的,把新 Key 输入到 APP 的打印设置再测试连接。撤销后使用中的 APP 会立即无法调用打印 API。
管理员与普通用户差在哪?
普通用户可进行打印与查询;管理员另可管理用户、API Key、授权与高风险设置(如清除打印记录)。建议日常操作用普通用户账号,管理作业才用 admin。
默认账号密码是什么?为什么要改?
首次安装的默认账密是 admin / sortinggo。这是公开信息,任何能连到服务的人都可能登录,请在首次登录后立即修改密码。新用户密码至少 8 位。
各指令协议(TSPL、ZPL、EPL、ESC/POS)分别支持哪些语言?要怎么选?
文字指令模式能不能打印出某个语言,取决于打印机内置字体,不是单靠软件设置就能保证:TSPL/TSPL2 已内置各语言的字体对映,中英日韩泰越都有尝试支持;ZPL/ZPL II 默认只有拉丁字体,要打印中文、日文、韩文、泰文、越南文,必须在打印机设置中填入「ZPL 国际字体」(打印机内存中内置或自行安装的亚洲/国际字体文件名,例如 E:SIMSUN.FNT),未设置时只能打印英文、西班牙文等拉丁文字;ESC/POS 已支持中文、日文、韩文,但泰文没有对应码表、无解;EPL 不支持任何非拉丁语言。若不确定打印机是否真的有对应字体,最保险的做法是把「打印内容模式」改成图像,系统会把文字渲染成点阵图再送出,不受打印机字体限制,保证各语言都能打印出来。打印后若跳出警告,会标明是哪个字段、哪种语言在当前设置下打印不出来,并附上建议做法。
怎么移除试用标记?
需要有效的 Pro 或 Ent 授权:在此页导入授权中心签发的 Signed Entitlement(compact JWS)并启用,或在信任模式下由 APP 传入 PRO/ENT 授权等级。FREE、LITE、STD 仍可打印,但输出会带试用标记。
授权启用失败或仍显示试用标记怎么办?
查看「Trial Mark 诊断」的判断结果:常见原因有授权已过期、签章验证失败、未设置验证公钥、授权方案不是 Pro/Ent,或授权缺少 label_print_no_trial 权限。确认贴上的是完整 compact JWS,必要时重新向授权中心取得。
退款有什么限制?退款后会发生什么事?
只能在购买后 30 天内、且用 Owner Session(Email + License Key 一起验证,不能只靠 Email 恢复的 Recovery Session)自助申请退款。一经确认,该 License 立即被服务器标记为已退款,之后任何设备都无法再激活或刷新授权,且无法撤销。触发退款的那台设备本机缓存会立即清除;但如果同一 License 还有其他设备在用(Professional 最多两台),那些设备的本机缓存可能继续有效到各自最长 30 天到期为止,这是离线设计下的已知现象,不是故障。
正常停用、Emergency Reset、忘记 Key 恢复,三者有什么不同?
「正常停用」在还能操作的设备上执行,立即释放名额且不计入 Reset 次数,换机或不想再用时优先用这个。「Emergency Reset」用在设备已经丢失、损坏或无法自行操作时,需要先用 Email + License Key 取得 Owner Session 验证所有权才能对该设备执行,计入 rolling 365 天最多 12 次配额,执行后该设备授权立即失效且无法撤销。「忘记 License Key」是连 Key 都遗失时的恢复渠道,只需 Email 就能取得一个受限的 Recovery Session:可以查看设备列表、可以执行 Reset,但不能申请退款或重新核发 Key,这两项一定要用 Email + Key 验证出的 Owner Session。