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 和二维码。
Sage X3 集成常见问题
是否需要在 Sage X3 服务器上安装字体？
不需要。Barcodesoft API 是一种返回图像（PNG/SVG）的 Web 服务，无需进行字体管理或打印机驱动配置。
如何处理 GS1-128 应用标识符（AI）？
只需在 REST 调用的 data 参数中加入括号形式的 AI，例如 GTIN 使用 (01)，批号使用 (10)。
我可以在 Sage X3 中使用二维码进行移动资产跟踪吗？
可以。使用 /v1/qrcode/ 端点生成可扫描的二维代码，用于仓库管理（WMS）或资产查询。
热敏标签推荐使用什么分辨率？
我们建议工业热敏打印机使用 dpi=300 或更高，以确保高密度条码具有良好的可读性。
开发者提示
- 推荐 SVG： 在 Crystal Reports 中建议使用
imageformat=svg以实现高质量打印。 - Token 缓存： 建议将 Bearer Token 存储在 Sage X3 全局变量中，以减少 API 调用次数。
- DPI 设置： 标准仓库热敏打印机建议设置
dpi=300。