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 天到期為止,這是離線設計的已知現象,不是故障。
正常停用、緊急 Reset、忘記 Key 復原,三者有什麼不同?
「正常停用」在還能操作的裝置上執行,立即釋放名額且不計入 Reset 次數,換機或不想再用時優先用這個。「緊急 Reset」用在裝置已經遺失、損壞或無法自行操作時,需要先用 Email + License Key 取得 Owner Session 驗證所有權才能對該裝置執行,計入 rolling 365 天最多 12 次配額,執行後該裝置授權立即失效且無法復原。「忘記 License Key」是連 Key 都遺失時的復原管道,只需 Email 就能取得一個受限的 Recovery Session:可以查看裝置清單、可以執行 Reset,但不能申請退款或重新核發 Key,這兩項一定要用 Email + Key 驗證出的 Owner Session。