Guide d'intégration Cloud Barcode Sage X3
Génération automatisée de codes-barres pour Sage X3 ERP et Crystal Reports
La modernisation des flux d’étiquetage dans Sage X3 nécessite une solution sécurisée et haute performance pour la logistique et le suivi des stocks. L’API REST Barcodesoft Cloud Barcode offre une voie d’intégration sans empreinte locale permettant de générer des codes-barres conformes GS1 sans installer de polices locales ni de plugins tiers sur vos serveurs d’impression Sage X3.
Architecture d’intégration Sage X3
1. AUTHENTIFICATION
Sage X3 effectue un appel REST sortant via 4GL ou le module d’administration afin d’échanger les identifiants contre un jeton Bearer sécurisé.
2. APPEL REST
Une requête URL dynamique est envoyée à l’API Barcodesoft contenant des données issues des tables Sage X3 (par exemple ITMMASTER, STOJOU).
3. RENDU
L’API transmet directement une image SVG ou PNG haute résolution dans Crystal Reports pour l’impression d’étiquettes ou de factures.
Étape 1 : Obtention du jeton OAuth 2.0
Pour sécuriser votre connexion, appelez le service de jeton en utilisant le User_id, le Secret et le Scope fournis dans votre e-mail de commande :
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]
Capturez le access_token pour l’utiliser dans l’en-tête "Authorization: Bearer".
Étape 2 : Configuration des graphiques dynamiques Crystal Reports
Pour afficher des codes-barres dynamiques sur les documents Sage X3 (factures, bons de livraison, étiquettes) :
- Insérez une image de substitution dans votre rapport Crystal Reports (.rpt).
- Cliquez avec le bouton droit sur l’image puis sélectionnez Format Graphic.
- Accédez à l’onglet Picture puis cliquez sur le bouton de formule à côté de Graphic Location.
- Saisissez une formule concaténant le point d’accès API avec les champs de données 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"
Obtenez vos identifiants d’intégration Sage X3
Exploitez pleinement le potentiel de votre flux d’étiquetage Sage X3. Achetez un abonnement pour recevoir instantanément vos identifiants API par e-mail et commencez dès aujourd’hui à générer des codes GS1 et QR professionnels.
FAQ sur l’intégration Sage X3
Est-ce que cela nécessite l’installation de polices sur le serveur Sage X3 ?
Non. L’API Barcodesoft est un service web qui retourne des images (PNG/SVG). Cela élimine le besoin de gestion des polices et de configuration des pilotes côté imprimante.
Comment gérer les identifiants d’application GS1-128 ?
Incluez simplement l’AI entre parenthèses, par exemple (01) pour le GTIN ou (10) pour le numéro de lot, dans le paramètre data de l’appel REST.
Puis-je utiliser des QR codes pour le suivi mobile des actifs dans Sage X3 ?
Oui. Utilisez le point d’accès /v1/qrcode/ pour générer des codes 2D scannables destinés à la gestion d’entrepôt (WMS) ou à la consultation d’actifs.
Quelle résolution est recommandée pour les étiquettes thermiques ?
Nous recommandons de définir dpi=300 ou supérieur pour les imprimantes thermiques industrielles afin de garantir une excellente lisibilité des codes-barres haute densité.
Conseils pour développeurs
- Préférence SVG : Utilisez
imageformat=svgpour une impression parfaite dans Crystal Reports. - Mise en cache du jeton : Stockez votre jeton Bearer dans une variable globale Sage X3 afin de réduire les appels API.
- Paramètres DPI : Définissez
dpi=300pour les imprimantes thermiques d’entrepôt standard.