Sage X3 Cloud Barcode 整合指南
適用於 Sage X3 ERP 與 Crystal Reports 的自動條碼產生
要現代化 Sage X3 的標籤工作流程，需要一套安全且高效能的物流與庫存追蹤解決方案。 Barcodesoft Cloud Barcode REST API 提供一種零安裝整合方式， 無需在 Sage X3 列印伺服器上安裝本機字型或第三方外掛，即可產生符合 GS1 標準的條碼。
Sage X3 整合架構
1. 驗證
Sage X3 透過 4GL 或管理模組執行對外 REST 呼叫，以將憑證交換為安全的 Bearer Token。
2. REST 呼叫
系統會向 Barcodesoft API 傳送動態 URL 請求，其中包含來自 Sage X3 資料表（例如 ITMMASTER、STOJOU）的資料。
3. 影像輸出
API 會將高解析度 SVG 或 PNG 影像直接串流至 Crystal Reports，以用於標籤或發票列印。
步驟 1：取得 OAuth 2.0 Token
為了保護您的連線安全，請使用訂單電子郵件中提供的 User_id、Secret 與 Scope 呼叫 Token 服務：
POST https://www.barcodesoft.com/api/auth/tokenContent-Type: application/x-www-form-urlencoded
grant_type=client_credentials&client_id=[User_id]&client_secret=[Secret]&scope=[Scope]
取得 access_token 以便在「Authorization: Bearer」標頭中使用。
步驟 2：Crystal Reports 動態圖形設定
若要在 Sage X3 文件（發票、出貨單、標籤）中顯示動態條碼：
- 在 Crystal Reports (.rpt) 中插入一個佔位圖片。
- 在圖片上按右鍵，然後選擇 Format Graphic。
- 前往 Picture 分頁，然後點擊 Graphic Location 旁邊的公式按鈕。
- 輸入將 API 端點與 Sage X3 資料欄位串接的公式：
"https://www.barcodesoft.com/barcode/v1/linear/code128?data=" + {ITMMASTER.ITMREF_0} + "&width=3 in&height=1in&imageformat=png"
"https://www.barcodesoft.com/barcode/v1/linear/gs1128?data=" + {ITMMASTER.ITMREF_0} + "&width=3in&height=1in&imageformat=png"
"https://www.barcodesoft.com/barcode/v1/qrcode/?data=" + {ITMMASTER.ITMREF_0} + "&width=3 in&height=1 in&imageformat=jpg"
"https://www.barcodesoft.com/barcode/v1/datamatrix/?data=" + {ITMMASTER.ITMREF_0} + "&width=2 cm&height=1cm&imageformat=webp"
取得您的 Sage X3 整合憑證
充分發揮 Sage X3 標籤工作流程的潛力。購買訂閱後， 您將立即透過電子郵件收到 API 憑證，並可立即開始產生專業的 GS1 與 QR Code。
Sage X3 整合常見問題
是否需要在 Sage X3 伺服器上安裝字型？
不需要。Barcodesoft API 是一種回傳影像（PNG/SVG）的 Web 服務，因此無需管理字型或設定印表機驅動程式。
如何處理 GS1-128 應用識別碼（AI）？
只需在 REST 呼叫的 data 參數中加入括號格式的 AI，例如 GTIN 使用 (01)，批號使用 (10)。
我可以在 Sage X3 中使用 QR Code 進行行動資產追蹤嗎？
可以。使用 /v1/qrcode/ 端點產生可掃描的 2D 條碼，用於倉儲管理（WMS）或資產查詢。
熱感標籤建議使用什麼解析度？
我們建議工業級熱感印表機設定 dpi=300 或更高，以確保高密度條碼具有最佳可讀性。
開發人員提示
- SVG 建議： 在 Crystal Reports 中建議使用
imageformat=svg以獲得最佳列印品質。 - Token 快取： 建議將 Bearer Token 儲存在 Sage X3 全域變數中，以減少 API 呼叫次數。
- DPI 設定： 標準倉庫熱感印表機建議設定
dpi=300。