Guía de Integración Cloud Barcode para Sage X3
Generación Automatizada de Códigos de Barras para Sage X3 ERP y Crystal Reports
Modernizar los flujos de trabajo de etiquetado en Sage X3 requiere una solución segura y de alto rendimiento para logística y seguimiento de inventario. La API REST Barcodesoft Cloud Barcode ofrece una ruta de integración sin instalación local para generar códigos de barras compatibles con GS1 sin instalar fuentes locales ni complementos de terceros en sus servidores de impresión Sage X3.
Arquitectura de Integración Sage X3
1. AUTENTICACIÓN
Sage X3 realiza una llamada REST saliente mediante 4GL o el módulo de Administración para intercambiar credenciales por un token Bearer seguro.
2. LLAMADA REST
Se envía una solicitud URL dinámica a la API de Barcodesoft que contiene datos de tablas Sage X3 (por ejemplo, ITMMASTER, STOJOU).
3. RENDERIZADO
La API transmite una imagen SVG o PNG de alta resolución directamente a Crystal Reports para imprimir etiquetas o facturas.
Paso 1: Obtención del Token OAuth 2.0
Para asegurar su conexión, llame al servicio de token utilizando el User_id, el Secret y el Scope proporcionados en el correo electrónico de su pedido:
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]
Capture el access_token para utilizarlo en el encabezado "Authorization: Bearer".
Paso 2: Configuración de Gráficos Dinámicos en Crystal Reports
Para mostrar códigos de barras dinámicos en documentos Sage X3 (facturas, albaranes, etiquetas):
- Inserte una imagen de marcador de posición en su informe Crystal Reports (.rpt).
- Haga clic derecho sobre la imagen y seleccione Format Graphic.
- Vaya a la pestaña Picture y haga clic en el botón de fórmula junto a Graphic Location.
- Introduzca una fórmula que concatene el endpoint de la API con los campos de datos de 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"
Obtenga Sus Credenciales de Integración Sage X3
Desbloquee todo el potencial de su flujo de trabajo de etiquetado Sage X3. Compre una suscripción para recibir sus credenciales API instantáneamente por correo electrónico y comience hoy mismo a generar códigos GS1 y QR profesionales.
Preguntas Frecuentes sobre la Integración Sage X3
¿Es necesario instalar fuentes en el servidor Sage X3?
No. La API de Barcodesoft es un servicio web que devuelve imágenes (PNG/SVG). Esto elimina la necesidad de administrar fuentes y configurar controladores de impresora.
¿Cómo manejo los Identificadores de Aplicación GS1-128?
Simplemente incluya el AI entre paréntesis, como (01) para GTIN o (10) para número de lote, dentro del parámetro data de la llamada REST.
¿Puedo usar códigos QR para el seguimiento móvil de activos en Sage X3?
Sí. Utilice el endpoint /v1/qrcode/ para generar códigos 2D escaneables para gestión de almacenes (WMS) o consulta de activos.
¿Qué resolución es mejor para etiquetas térmicas?
Recomendamos configurar dpi=300 o superior para impresoras térmicas industriales a fin de garantizar una alta legibilidad de códigos de barras de alta densidad.
Consejos para Desarrolladores
- Preferencia SVG: Utilice
imageformat=svgpara impresión perfecta en Crystal Reports. - Almacenamiento en Caché del Token: Guarde su token Bearer en una variable global de Sage X3 para reducir las llamadas API.
- Configuración DPI: Configure
dpi=300para impresoras térmicas estándar de almacén.