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 トークンに交換します。
2. REST 呼び出し
ITMMASTER や STOJOU などの Sage X3 テーブルデータを含む動的 URL リクエストが Barcodesoft API に送信されます。
3. レンダリング
API は高解像度 SVG または PNG 画像を Crystal Reports に直接ストリーミングし、ラベルや請求書の印刷に使用します。
ステップ 1: OAuth 2.0 トークン取得
接続を保護するために、注文メールで提供された User_id、Secret、および Scope を使用してトークンサービスを呼び出します。
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]
"Authorization: Bearer" ヘッダーで使用するために access_token を取得してください。
ステップ 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 コードをすぐに生成できます。
Sage X3 統合 FAQ
Sage X3 サーバーにフォントをインストールする必要がありますか？
いいえ。Barcodesoft API は画像（PNG/SVG）を返す Web サービスです。これにより、フォント管理やプリンタードライバー設定が不要になります。
GS1-128 アプリケーション識別子はどのように処理しますか？
REST 呼び出しの data パラメーター内に、GTIN 用の (01) やロット番号用の (10) などの AI を括弧付きで含めてください。
Sage X3 のモバイル資産管理に QR コードを使用できますか？
はい。/v1/qrcode/ エンドポイントを使用して、倉庫管理（WMS）や資産検索用のスキャン可能な 2D コードを生成できます。
感熱ラベルに最適な解像度は何ですか？
高密度バーコードの可読性を確保するため、産業用感熱プリンターでは dpi=300 以上を推奨します。
開発者向けヒント
- SVG 推奨: Crystal Reports で高品質印刷を行うには
imageformat=svgを使用してください。 - トークンキャッシュ: API 呼び出しを削減するため、Bearer トークンを Sage X3 のグローバル変数に保存してください。
- DPI 設定: 標準的な倉庫用感熱プリンターでは
dpi=300を設定してください。