Sage X3 Cloud Barcode Integrationsleitfaden
Automatisierte Barcode-Erstellung für Sage X3 ERP und Crystal Reports
Die Modernisierung von Etikettierungsprozessen in Sage X3 erfordert eine sichere und leistungsstarke Lösung für Logistik und Bestandsverfolgung. Die Barcodesoft Cloud Barcode REST API bietet einen Zero-Footprint-Integrationsansatz, um GS1-konforme Barcodes zu erzeugen, ohne lokale Schriftarten oder Drittanbieter-Plugins auf Ihren Sage X3 Druckservern zu installieren.
Sage X3 Integrationsarchitektur
1. AUTHENTIFIZIERUNG
Sage X3 führt über 4GL oder das Administrationsmodul einen ausgehenden REST-Aufruf aus, um Anmeldedaten gegen ein sicheres Bearer-Token auszutauschen.
2. REST-AUFRUF
Eine dynamische URL-Anfrage wird an die Barcodesoft API gesendet und enthält Daten aus Sage X3 Tabellen (z. B. ITMMASTER, STOJOU).
3. RENDERING
Die API streamt ein hochauflösendes SVG- oder PNG-Bild direkt in Crystal Reports für den Druck von Etiketten oder Rechnungen.
Schritt 1: OAuth 2.0 Token-Anforderung
Um Ihre Verbindung zu sichern, rufen Sie den Token-Service mit der User_id, dem Secret und dem Scope auf, die in Ihrer Bestell-E-Mail angegeben wurden:
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]
Erfassen Sie das access_token zur Verwendung im Header "Authorization: Bearer".
Schritt 2: Konfiguration dynamischer Grafiken in Crystal Reports
Um dynamische Barcodes in Sage X3 Dokumenten (Rechnungen, Lieferscheinen, Etiketten) anzuzeigen:
- Fügen Sie ein Platzhalterbild in Ihren Crystal Report (.rpt) ein.
- Klicken Sie mit der rechten Maustaste auf das Bild und wählen Sie Format Graphic.
- Wechseln Sie zur Registerkarte Picture und klicken Sie auf die Formel-Schaltfläche neben Graphic Location.
- Geben Sie eine Formel ein, die den API-Endpunkt mit Sage X3 Datenfeldern kombiniert:
"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"
Erhalten Sie Ihre Sage X3 Integrationszugangsdaten
Nutzen Sie das volle Potenzial Ihres Sage X3 Etikettierungs-Workflows. Kaufen Sie ein Abonnement, um Ihre API-Zugangsdaten sofort per E-Mail zu erhalten und noch heute professionelle GS1- und QR-Codes zu generieren.
Sage X3 Integrations-FAQ
Müssen Schriftarten auf dem Sage X3 Server installiert werden?
Nein. Die Barcodesoft API ist ein Webservice, der Bilder (PNG/SVG) zurückliefert. Dadurch entfällt die Verwaltung von Schriftarten und die Konfiguration von Druckertreibern.
Wie gehe ich mit GS1-128 Application Identifiers um?
Fügen Sie einfach die AI in Klammern ein, z. B. (01) für GTIN oder (10) für Chargennummer, innerhalb des data-Parameters des REST-Aufrufs.
Kann ich QR-Codes für mobiles Asset-Tracking in Sage X3 verwenden?
Ja. Verwenden Sie den Endpunkt /v1/qrcode/, um scannbare 2D-Codes für Lagerverwaltungssysteme (WMS) oder Asset-Abfragen zu generieren.
Welche Auflösung eignet sich am besten für Thermoetiketten?
Wir empfehlen die Einstellung dpi=300 oder höher für industrielle Thermodrucker, um eine optimale Lesbarkeit hochdichter Barcodes sicherzustellen.
Entwicklertipps
- SVG-Präferenz: Verwenden Sie
imageformat=svgfür pixelgenauen Druck in Crystal Reports. - Token-Caching: Speichern Sie Ihr Bearer-Token in einer globalen Sage X3 Variable, um API-Aufrufe zu reduzieren.
- DPI-Einstellungen: Stellen Sie
dpi=300für Standard-Thermodrucker im Lager ein.