Guia de Integração Cloud Barcode Sage X3
Geração Automatizada de Códigos de Barras para Sage X3 ERP e Crystal Reports
Modernizar os fluxos de trabalho de etiquetagem no Sage X3 exige uma solução segura e de alto desempenho para logística e rastreamento de inventário. A API REST Barcodesoft Cloud Barcode oferece um caminho de integração sem instalação local para gerar códigos de barras compatíveis com GS1 sem instalar fontes locais ou plugins de terceiros nos servidores de impressão Sage X3.
Arquitetura de Integração Sage X3
1. AUTENTICAÇÃO
O Sage X3 realiza uma chamada REST de saída via 4GL ou módulo de Administração para trocar credenciais por um token Bearer seguro.
2. CHAMADA REST
Uma solicitação de URL dinâmica é enviada para a API Barcodesoft contendo dados das tabelas do Sage X3 (por exemplo, ITMMASTER, STOJOU).
3. RENDERIZAÇÃO
A API transmite uma imagem SVG ou PNG de alta resolução diretamente para o Crystal Reports para impressão de etiquetas ou faturas.
Etapa 1: Aquisição do Token OAuth 2.0
Para proteger sua conexão, chame o serviço de token usando o User_id, o Secret e o Scope fornecidos no e-mail do seu 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 o access_token para uso no cabeçalho "Authorization: Bearer".
Etapa 2: Configuração de Gráficos Dinâmicos no Crystal Reports
Para exibir códigos de barras dinâmicos em documentos do Sage X3 (faturas, romaneios, etiquetas):
- Insira uma imagem de espaço reservado em seu relatório Crystal Reports (.rpt).
- Clique com o botão direito na imagem e selecione Format Graphic.
- Vá até a aba Picture e clique no botão de fórmula ao lado de Graphic Location.
- Digite uma fórmula que concatene o endpoint da API com os campos de dados do 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"
Obtenha suas Credenciais de Integração Sage X3
Desbloqueie todo o potencial do seu fluxo de trabalho de etiquetagem Sage X3. Adquira uma assinatura para receber suas credenciais de API instantaneamente por e-mail e comece hoje mesmo a gerar códigos GS1 e QR profissionais.
FAQ de Integração Sage X3
Isso exige a instalação de fontes no servidor Sage X3?
Não. A API Barcodesoft é um serviço web que retorna imagens (PNG/SVG). Isso elimina a necessidade de gerenciamento de fontes e configuração de drivers de impressora.
Como devo lidar com os Identificadores de Aplicação GS1-128?
Basta incluir o AI entre parênteses, como (01) para GTIN ou (10) para número de lote, dentro do parâmetro data da chamada REST.
Posso usar QR Codes para rastreamento móvel de ativos no Sage X3?
Sim. Utilize o endpoint /v1/qrcode/ para gerar códigos 2D escaneáveis para gerenciamento de armazém (WMS) ou consulta de ativos.
Qual resolução é melhor para etiquetas térmicas?
Recomendamos configurar dpi=300 ou superior para impressoras térmicas industriais, garantindo alta legibilidade de códigos de barras de alta densidade.
Dicas para Desenvolvedores
- Preferência SVG: Use
imageformat=svgpara impressão perfeita no Crystal Reports. - Cache de Token: Armazene seu token Bearer em uma variável global do Sage X3 para reduzir chamadas de API.
- Configurações DPI: Configure
dpi=300para impressoras térmicas padrão de armazém.