SAP BTP & Cloud Barcode RESTapi
Escale sua estratégia de rotulagem de códigos de barras usando o SAP BTP Integration Suite. Este guia cobre o ciclo de vida técnico de ponta a ponta, da conectividade à transformação baseada em scripts.
Segurança OAuth 2.0
O Key Store do BTP gerencia os tokens Bearer, eliminando a necessidade de chaves de API fixas (hardcoded) no S/4HANA.
Processamento Groovy
Calcule dinamicamente as dimensões e formatos de código de barras com base nos payloads OData do S/4HANA.
Saída Multi-formato
Transmita diretamente SVG para aplicativos web Fiori ou PNG de alta resolução para impressoras térmicas de armazém.
Conectividade da Subaccount
Em sua SAP BTP Subaccount, navegue até Connectivity > Destinations. Defina um novo destino HTTP para rotear o tráfego através do backbone de nuvem da SAP.
| Propriedade | Valor |
|---|---|
| Nome | BARCODESOFT_CLOUD |
| URL | https://www.barcodesoft.com |
| Autenticação | NoAuthentication (Token gerenciado no iFlow) |
Processamento Dinâmico de Solicitação (Groovy)
Dentro do seu SAP Integration Suite iFlow, use um Groovy Script para garantir que os dados do código de barras estejam codificados em URL e em conformidade com GS1 antes de atingir o endpoint.
import com.sap.gateway.ip.core.customdev.util.Message;
import java.util.HashMap;
def Message processData(Message message) {
def map = message.getHeaders();
def rawData = map.get("S4_Material_Batch"); // Entrada vinda do S/4HANA
// Formata dados GS1: (01)GTIN(10)BATCH
def encodedData = java.net.URLEncoder.encode(rawData, "UTF-8");
message.setHeader("EncodedBarcodeData", encodedData);
return message;
}
Tratamento de Erros Empresariais
Integrações robustas devem lidar com tokens expirados ou entradas de dados inválidas. Configure seu **Exception Subprocess** no iFlow para capturar estes estados:
HTTP 401 (Unauthorized)
Acione o processo de integração local de "Auth" para atualizar o token Bearer automaticamente.
HTTP 400 (Bad Request)
Registre o payload no MPL (Message Processing Log) para identificar caracteres GS1 ilegais.
Melhores Práticas de Integração
- Caching: Armazene tokens de acesso em Variáveis BTP por toda a sua duração de 3600s.
- SVG sobre PNG: Use SVG para a UI do Fiori para garantir escalonamento nítido em dispositivos móveis.
- Configurações de DPI: Use
dpi=600para pequenos códigos DataMatrix 2D em Adobe Forms. - API Management: Aplique uma Política de Quota para evitar o uso excessivo da API durante jobs em lote.
Acesso instantâneo ao Barcodesoft Cloud
Uma assinatura fornece acesso ilimitado à geração de GS1-128, QR Code, DataMatrix e Code 128 para sua integração SAP. Credenciais enviadas imediatamente por e-mail[cite: 3, 4].
Assistência Técnica
Nossa equipe de engenharia é especializada em cenários de SAP BTP, Integration Suite (CPI) e ABAP para ajudá-lo a resolver integrações complexas.
Contatar SuportePronto para o Go-Live?
Acelere seu projeto com nossos templates de iFlow pré-configurados e checklists de implantação prontos para produção.