¶ Adeus, SDK: Descubra como o Service Layer está revolucionando o SAP Business One
Por que insistir em DI API e UI API é atrasar sua empresa e como migrar de vez para o modelo moderno e escalável com Service Layer e aplicações web.
¶ Resumo
Muitos desenvolvedores que trabalham com SAP Business One ainda utilizam o SDK tradicional, baseado nas APIs DI API e UI API. Essas ferramentas são antigas, exigem o SAP instalado no Windows e dificultam a automação de testes, a integração com outras plataformas e o uso do sistema na nuvem.
Já o Service Layer traz uma abordagem mais moderna. Ele oferece APIs leves, baseadas em REST e acessíveis via HTTP/HTTPS, permitindo a criação de aplicações com tecnologias como Vue, React, Node.js, PHP, Flutter e até soluções serverless.
Este artigo reflete minha opinião após anos atuando com integrações SAP Business One em diferentes consultorias, onde esses problemas se repetem com frequência e ainda são realidade em muitos projetos.
Em resumo: o Service Layer abre as portas para um desenvolvimento mais flexível, escalável e preparado para o futuro.
¶ A Era do SDK: uma herança pesada
Por muitos anos, a SAP ofereceu um kit de desenvolvimento (SDK) para quem precisava integrar ou personalizar o SAP Business One. Esse kit era composto por duas partes principais:
- DI API – usada para acessar e manipular diretamente os dados e objetos do sistema, como clientes, pedidos e notas fiscais.
- UI API – utilizada para alterar ou complementar a interface do SAP Business One, criando novas telas ou interagindo com botões e formulários.
Embora esse modelo tenha sido essencial no passado, ele foi criado para um cenário onde tudo rodava localmente, no Windows, e isso não combina mais com as necessidades atuais de nuvem, mobilidade e agilidade.
¶ Problemas comuns:
Quem ainda usa o SDK tradicional do SAP Business One enfrenta várias dificuldades que tornam o desenvolvimento mais lento e limitado:
- Depende do Windows e do SAP Client instalado: A aplicação só funciona em ambientes com o SAP instalado, o que limita o uso em servidores e plataformas modernas.
- Instalação e atualização são manuais e complicadas: É difícil automatizar o deploy, o que inviabiliza o uso de CI/CD (integração e entrega contínuas).
- Integrações são rígidas e difíceis de reaproveitar: Levar uma integração feita para outro ambiente ou sistema é trabalhoso e exige muitas adaptações.
- Atualizações de versão do SAP ou do .NET podem quebrar tudo: Pequenas mudanças podem causar falhas, exigindo correções manuais e retrabalho.
- A arquitetura é travada e pouco flexível: Tudo fica acoplado ao SAP Client, dificultando a escalabilidade e a modernização.
¶ Problemas reais do modelo tradicional
Usar o SAP Business One com o SDK antigo (DI API/UI API) pode funcionar, mas traz limitações que atrapalham a evolução dos sistemas:
- Não funciona bem com apps mobile ou sistemas na nuvem: Ele depende do SAP instalado localmente, o que impede o uso em smartphones ou servidores modernos.
- É difícil de testar e manter o código atualizado: Fazer testes automatizados ou controlar versões do sistema se torna trabalhoso e pouco prático.
- Precisa instalar o SAP Client em cada máquina: Toda vez que for rodar ou atualizar o sistema, é necessário instalar ou configurar o client manualmente.
- Não se encaixa bem em tecnologias modernas como containers e microserviços: Isso dificulta o uso de ferramentas como Docker, CI/CD e arquiteturas escaláveis.
Em resumo: é um modelo que trava a inovação e exige muito esforço para tarefas que poderiam ser simples.
¶ Service Layer: REST, JSON e liberdade
O Service Layer do SAP Business One (disponível a partir da versão 9.1 para SAP HANA) é uma API moderna baseada em padrões da web. Ele permite integrar e criar aplicações com muito mais liberdade. O que ele oferece:
- Usa JSON para enviar e receber dados de forma simples e leve.
- Faz autenticação por sessão, com cookies e HTTPS, mantendo a comunicação segura.
- É multiplataforma, ou seja, funciona em qualquer sistema que saiba fazer requisições HTTP.
- Opera via HTTP/HTTPS, sem precisar do SAP Client instalado.
Em vez de depender de instalações locais, você pode conectar seu sistema ao SAP de forma mais flexível, usando qualquer linguagem ou tecnologia web.
¶ Desenvolvimento desacoplado: liberdade para inovar
Com o Service Layer, você não precisa mais ficar preso à interface padrão do SAP Business One. A lógica do sistema pode ser colocada em um backend moderno, enquanto o frontend pode ser desenvolvido da forma que fizer mais sentido para o seu projeto.
Este é um exemplo de arquitetura que funciona muito bem no mercado atual, mas você pode adaptar conforme suas necessidades, usando qualquer linguagem ou tecnologia web:
- Frontend: Vue.js, React, Angular, Flutter (ou qualquer framework moderno)
- Backend: Node.js, PHP, Python, Go – todos funcionam bem com o Service Layer
- Infraestrutura: Docker, Kubernetes, NGINX, hospedado na nuvem (GCP, AWS, Azure)
¶ Desmistificando os medos da transição
¶ Performance?
O Service Layer do SAP Business One é leve e rápido porque não guarda informações entre as requisições (isso é chamado de stateless). Além disso, ele pode usar memória para acelerar respostas (cache) e funciona muito bem com sistemas que distribuem as requisições entre vários servidores (load balancer), o que garante mais velocidade e estabilidade.
¶ Segurança?
O Service Layer usa autenticação por sessão (login via cookie) e trafega com HTTPS para proteger os dados. Apesar de não suportar OAuth2 ou tokens JWT nativamente, é possível criar uma camada intermediária (como uma API em Node.js ou PHP) que ofereça esses padrões modernos de autenticação ao usuário final, aumentando a segurança da solução.
¶ Cobertura?
O Service Layer já permite trabalhar com praticamente todos os dados importantes do SAP, como clientes, pedidos, notas fiscais e produtos. Se você precisar de algo que ainda não está disponível, é possível usar outras formas de integração, como Calculations Views e conta com um endpoint que possibilita fazer queries em SQL de banco de dados, dando acesso a tudo dentro do SAP Business One.
¶ O futuro do SAP B1: leve, escalável e inteligente
Empresas que adotam o Service Layer estão dando um passo importante rumo à modernização do SAP B1. Benefícios:
- Menos dependência do SAP instalado nas máquinas: Você não precisa mais do client local para usar ou integrar com o sistema.
- Possibilidade de criar seus próprios aplicativos: Desenvolva portais, dashboards e apps sob medida, usando as APIs do SAP.
- Integração facilitada com BI, apps mobile e marketplaces: Conecte o SAP a ferramentas como Power BI, aplicativos Android/iOS e plataformas de venda.
- Mais velocidade para evoluir o ERP: Implementações e melhorias são feitas de forma mais ágil, sem travar em ambientes antigos.
- Pronto para a nuvem: O Service Layer permite que o SAP funcione melhor em infraestruturas modernas, como cloud e containers.
¶ Conclusão
O SDK tradicional do SAP B1 (DI API e UI API) teve sua importância no passado, mas hoje se tornou um limitador para empresas que querem crescer e inovar.O Service Layer representa o caminho mais moderno e eficiente para quem busca:
- Aplicações web e mobile mais modernas.
- Integrações flexíveis e desenvolvimento desacoplado.
- Arquitetura escalável e pronta para a nuvem.
- Automação com CI/CD e entregas contínuas.
- Mais liberdade para inovar com agilidade.
Isso não é apenas uma tendência. É a evolução natural para quem quer preparar o SAP Business One para o presente e o futuro.
¶ Fontes e materiais oficiais
- Working with SAP B1 Service Layer (PDF)
- Service Layer API Reference
- Exploring the Service Layer API Architecture – SAP Learnin