👔 洗衣門市出庫資料雲端同步系統

門市出庫自動化、13 欄位紙本對齊、24+ 家門市自動識別、每小時背景排程與 Telegram 即時告警推播完整指南

⚡ 24 家門市超簡易安裝 3 步驟（完全免手動設定）

針對總公司 24+ 家門市體系，本工具已內建「POS 主檔智慧門市自動識別機制」，安裝時完全不需要手動修改任何設定檔：

步驟 1. 複製資料夾

將 門市出庫同步工具 整包資料夾，複製到門市電腦的洗衣系統主目錄下（如 C:\WASH\ 或 D:\WASH\）。

步驟 2. 雙擊安裝排程

在 門市出庫同步工具 內，直接滑鼠雙擊 【安裝每小時排程.bat】（跳出 UAC 管理員詢問時點「是」）。

步驟 3. 安裝完成並上線

視窗顯示綠色成功訊息即完成！系統已向 Windows 註冊每小時背景自動排程，並自動綁定該分店名稱！

💡 為什麼不需要手動設定店名？
因為每家門市主程式目錄中都有 WORKSET.DBF，裡面存有該門市的代碼 BARNO（例如 001 中原店、002 南京店、011 五股店、055 南京站店）。同步工具執行時會自動讀取該代碼並鎖定門市名稱，免去人工設定失誤！

📱 Telegram 即時同步通知與異常告警機制

系統已整合專屬 Telegram Bot 告警推播，無論是同步成功、或是門市電腦發生斷網與異常，您都能在手機上第一時間掌握：

🟢 正常同步成功推播

每小時背景同步有新出庫單據完成時，Telegram 自動發送綠色摘要：

🟢【洗衣門市出庫同步成功】 🏪 門市：南京站店 (055) 📅 時間：2026-08-27 12:45:00 📦 同步筆數：15 筆 💰 營收金額：NT$ 3,250 🌐 雲端後台：https://caldry.tw/admin/dispatch

🚨 異常中斷與斷網警報

若門市網路中斷、伺服器異常或程式崩潰，Telegram 第一時間發出紅色警報：

🚨【洗衣門市出庫同步異常】 🏪 門市：中原店 (001) 📅 時間：2026-08-27 12:45:00 ❌ 失敗筆數：12 筆 ⚠️ 錯誤訊息：無法連線至 API 伺服器 ⚠️ 請確認門市網路連線

⚙️ 如何開啟 / 關閉 Telegram 通知？

開啟 config.json，修改 notify_on 參數即可：

📋 13 欄位實體單據完整對應規範

工具從 WSD_X.DBF 與主檔精準解析並對齊紙本「門市出庫明細表」之 13 項標準欄位：

# 紙本報表欄位 DBF 來源欄位 API JSON 鍵名 標準格式 / 範例 業務說明
1 門市名稱 WORKSET / Config branch_name 南京站店 (055) 自動從 WORKSET.DBF 辨識
2 洗衣單 WSDNO receipt_no 000940 (6碼) 洗衣單號（自動補零）
3 整理號 WSDWSEQ sorting_no / item_no 004915 (6碼) 衣物整理序號
4 收件日期 WSDRDTD received_date 2026-08-25 (民國 115/08/25) 收件日期
5 衣服品項 WSDITMN garment_name 襯衫、西裝上衣、薄床組雙 衣服品名規格
6 洗法 (價格類別) WSDPRONO / f0003 wash_method 會水 會乾 普水 普乾 會: 會員價, 普: 一般價
7 應交件日 WSDETKD due_date 2026-08-28 預計交付取件日期
8 時 WSDRDTT time_slot 12 收件時段
9 單價 WSDUPRC unit_price NT$ 180 單項洗滌金額
10 加工 WSDFCOD processing 0 (加工代碼) 加工作業與加工費用
11 花色 WSDCLRN color 黑、藍白條、卡其 衣物顏色或花紋
12 配件 備註分解 / 標記 accessories 枕2、附防塵套、附腰帶1 點收配件明細
13 備註 / 客戶 WSDRMKN / WSDCSNO remarks / customer_no 加強領口 / 客戶: 000466 特殊要求與 6 碼客戶代號

📁 工具目錄結構與檔案功能說明

檔案名稱 類型 使用場景與說明
安裝每小時排程.bat 批次檔 【推薦】 雙擊執行，自動向 Windows 註冊每小時背景同步任務。
啟動同步工具.bat 批次檔 開啟視覺化操作視窗，提供即時預覽、手動篩選、CSV/JSON 匯出與手動上傳。
立即背景同步.bat 批次檔 立即在背景比對並同步今日出庫單據（不彈出大視窗）。
移除自動排程.bat 批次檔 若該電腦需要暫停或卸載背景排程，雙擊即可一鍵清除。
config.json 設定檔 包含 API 網址、notify_on Telegram 推播開關與門市參數。
logs/ 日誌資料夾 自動記錄每日同步歷程（sync_YYYY-MM-DD.log）。

❓ 常見問題與維運排查指引 (Q&A)

Q1：如果門市電腦斷網或同步掛掉了，我要怎麼知道？

A： 系統具備多重監控機制：

  1. Telegram 即時警報：若同步失敗或中斷，Telegram 會立即向您發送紅色警報與錯誤訊息。
  2. 總公司雲端後台監控：登入 https://caldry.tw/admin/dispatch，頂部統計即時呈現各門市出庫狀況，若某分店未出單一目了然。
  3. 本機 Logs：可隨時查看門市電腦內的 logs/sync_YYYY-MM-DD.log。

Q2：門市人員如果事後修改了出庫單的單價、洗法或備註，雲端會更新嗎？

A：會自動更新！ 系統採用 MD5 內容特徵指紋技術，每小時比對時若發現單據內容被修改過（狀態為 modified），會自動再次送往雲端，並由總部後端以 updateOrCreate 覆蓋更新為最新內容！

Q3：門市平日需要手動開啟同步工具嗎？

A：完全不需要！ 安裝 安裝每小時排程.bat 後，系統每小時會完全靜默在背景自動同步，門市前台店員照常使用原本洗衣系統收件出庫即可，作業零負擔。

Q4：若想暫時關閉 Telegram 推播，該如何設定？

A： 開啟 config.json，將 "notify_on": true 修改為 "notify_on": false 儲存即可，完全不影響出庫同步。