包裝禮品電商平台 + ERP 串接
2024
豹發力（PFL）是台灣的包裝禮品供應商，販售封口袋、禮盒、包裝品、裝飾品、節日用品、組合品等多元商品，產品數量高達近兩千筆。
客戶原有的 ERP 系統管理著所有產品與客戶資料，希望建置一個同時支援 B2B（經銷商）與 B2C（一般消費者）的電商平台，並能與 ERP 雙向同步，避免人工重複輸入資料。
整個系統以 Laravel + Filament 為核心，串接 ERP 的產品、庫存、客戶、訂單模組，搭配綠界科技 ECPay 金流處理線上付款，實現從下單到 ERP 入帳的完整自動化流程。
與 KTNET TMS ERP 系統雙向同步，涵蓋產品資料（價格、庫存、描述）、客戶資料（B2B/B2C）、訂單（建立＋狀態回寫），採用 HMAC-SHA512 簽章認證
以 Filament 建構完整的電商後台，管理產品、訂單、客戶、業務員等資源，並提供 ERP 手動同步介面與流程圖視覺化
整合綠界科技金流服務，支援信用卡、ATM 轉帳、超商代碼等多元付款方式，B2B 訂單直接推送 ERP，B2C 付款完成後自動同步
ERP 同步五階售價機制，依客戶等級自動匹配對應價格。庫存數量即時從 ERP 同步更新，確保前台顯示與實際庫存一致
透過 ERP 廠商 API 的 /product/QueryList 與 /Stock/QueryList 端點，同步產品名稱、多階售價（五階）、EAN 條碼、庫存數量、上架狀態等欄位。支援手動指定商品代碼同步，或一鍵同步所有標記為可同步的產品。
客戶資料支援雙向同步：從 ERP 拉取客戶清單（依代碼首碼自動區分 B2B Client / B2C Customer），也能將本地新增的客戶推送回 ERP。同步內容涵蓋基本資料、公司資訊、發票設定、運費門檻、紅利點數等。
訂單採用事件驅動架構：B2B 訂單建立後立即推送 ERP，B2C 訂單則在 ECPay 付款完成後自動觸發。訂單推送包含主檔（客戶、地址、發票）、明細（商品 SKU、數量、單價）與紅利折抵。ERP 回傳的訂單編號與狀態會即時回寫同步。
大量同步作業透過 Laravel Queue 在背景執行，避免前台操作被阻塞。Filament 後台提供即時進度追蹤，CLI 指令支援排程自動化與手動觸發。
豹發力原本的 ERP 系統已經管理著近兩千筆產品與所有客戶資料，如果只做單向匯入，新增的客戶或訂單就無法回寫到 ERP，營運人員還是得手動謄寫資料。因此我們設計了雙向同步機制：產品/庫存從 ERP 拉到電商平台，訂單建立後又推回 ERP，並以 HMAC-SHA512 簽章確保雙向傳輸的資料安全與驗證來源正確性。
本專案於 2024 年完成，涵蓋產品、客戶、訂單三大同步模組，加上 ECPay 金流與 Filament 管理後台。像這種規模的 ERP 串接電商平台，開發時程通常落在 2–3 個月，實際天數會依 ERP 廠商 API 的完整度與資料欄位的複雜度（例如豹發力的五階售價機制）而有所增減。
不會，我們採用事件驅動架構區分兩種訂單流程：B2B（經銷商）訂單建立後立即推送 ERP，B2C（一般消費者）訂單則是在 ECPay 付款完成後才自動觸發同步，兩條路徑各自獨立觸發，也各自對應五階售價中不同客戶等級的售價機制，不會互相影響。
