Sage X3 Cloud Barcode Integration Guide

Automated Barcode Generation for Sage X3 ERP & Crystal Reports

Modernizing labeling workflows in Sage X3 requires a secure, high-performance solution for logistics and inventory tracking. The Barcodesoft Cloud Barcode REST API offers a zero-footprint integration path to generate GS1-compliant barcodes without installing local fonts or third-party plugins on your Sage X3 print servers.

Sage X3 Integration Architecture

1. AUTHENTICATION

Sage X3 performs an outbound REST call via 4GL or the Administration module to exchange credentials for a secure Bearer Token.

2. REST CALL

A dynamic URL request is sent to the Barcodesoft API containing data from Sage X3 tables (e.g., ITMMASTER, STOJOU).

3. RENDERING

The API streams a high-resolution SVG or PNG image directly into Crystal Reports for label or invoice printing.

Step 1: OAuth 2.0 Token Acquisition

To secure your connection, call the token service using the User_id, Secret, and Scope provided in your order email:

POST https://www.barcodesoft.com/api/auth/token
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials&client_id=[User_id]&client_secret=[Secret]&scope=[Scope]

Capture the access_token for use in the "Authorization: Bearer" header.

Step 2: Crystal Reports Dynamic Graphic Configuration

To display dynamic barcodes on Sage X3 documents (Invoices, Packing Slips, Labels):

  1. Insert a placeholder image into your Crystal Report (.rpt).
  2. Right-click the image and select Format Graphic.
  3. Navigate to the Picture tab and click the formula button next to Graphic Location.
  4. Enter a formula that concatenates the API endpoint with Sage X3 data fields:
"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"

Get Your Sage X3 Integration Credentials

Unlock the full potential of your Sage X3 labeling workflow. Purchase a subscription to receive your API credentials instantly via email and start generating professional GS1 and QR codes today.

Cloud barcode API order
Instant Setup SVG & PNG Output GS1-128 Compliant

Sage X3 Integration FAQ

Does this require installing fonts on the Sage X3 server?

No. The Barcodesoft API is a web service that returns images (PNG/SVG). This eliminates the need for font management and printer-side driver configuration.

How do I handle GS1-128 Application Identifiers?

Simply include the AI in brackets, such as (01) for GTIN or (10) for Batch Number, within the data parameter of the REST call.

Can I use QR codes for mobile asset tracking in Sage X3?

Yes. Use the /v1/qrcode/ endpoint to generate scannable 2D codes for warehouse management (WMS) or asset lookup.

What resolution is best for thermal labels?

We recommend setting dpi=300 or higher for industrial thermal printers to ensure high-density barcode readability.

Developer Tips

  • SVG Preference: Use imageformat=svg for pixel-perfect printing in Crystal Reports.
  • Token Caching: Store your Bearer Token in a Sage X3 global variable to reduce API calls.
  • DPI Settings: Set dpi=300 for standard warehouse thermal printers.

Technical Support

Questions about Sage X3 REST integration?

Contact Support