目錄
透過利用這些 RESTful Web 服務,SAP 使用者可以直接在 ERP 工作流程中產生符合產業標準的高解析度條碼,如 GS1-128 和 QR Code。
1
認證策略
Barcodesoft Cloud Barcode RESTapi 使用 OAuth 2.0 協定。在請求圖像之前,SAP 必須獲取 Bearer Token(存取權杖)。
步驟 A:獲取權杖
訂單完成後,您將收到一封包含
訂單完成後,您將收到一封包含
User_id、Secret 和 scope 的電子郵件。
POST https://www.barcodesoft.com/api/auth/token
Payload: { "User_id": "...", "Secret": "...", "scope": "..." }
Payload: { "User_id": "...", "Secret": "...", "scope": "..." }
步驟 B:權杖管理: 儲存回傳的 access_token 並在過期前重複使用,以優化系統效能。
2
SAP 配置 (事務 SM59)
- 執行事務代碼 SM59。
- 新建一個 Type G 連線(外部伺服器的 HTTP 協定連線)。
- 目標主機:
www.barcodesoft.com| 服務埠:443 - 在安全性選項下確保 SSL 已啟用。
3
產生條碼
線性條碼 (例如 GS1-128)
https://www.barcodesoft.com/barcode/v1/linear/gs1128?data=(02)1234(10)5678&width=3in&height=1in&imageformat=png&dpi=300
二維條碼 (例如 QR Code)
https://www.barcodesoft.com/barcode/v1/qrcode/?data=Testing&size=2in&imageformat=svg&dpi=300
4
實作方法
SAPUI5 / Fiori
將圖像源直接綁定到 API URL。推薦格式:SVG,以確保在各種解析度下保持清晰。
Adobe Forms (ADS)
透過 ABAP 類別 CL_HTTP_CLIENT 獲取二進位流,並將其對應到 LiveCycle Designer 中的圖形內容欄位。
5
關鍵參數參考
| 參數 | 選項 | 說明 |
|---|---|---|
data |
字串 | 要編碼的內容 (需進行 URL 編碼) |
imageformat |
png, svg, webp | Web 端建議使用 SVG,列印建議使用 PNG |
dpi |
300, 600 | 位圖圖像的解析度,確保可掃描性 |
GS1 注意事項: 確保應用識別碼 (AI) 被括在括號內,以便 Barcodesoft Cloud Barcode RESTapi 正確解析。