SAP[ TECHNICAL NOTE ]

Como integrar aplicações modernas ao SAP Business One sem comprometer a performance

Equipe de Arquitetura Ensuo

15/02/2026

7 min de leitura

O Gargalo Tradicional da Service Layer

A Service Layer do SAP Business One (disponível no HANA e SQL Server) é uma interface baseada em OData v3/v4 que expõe os objetos de negócio do SAP via HTTP REST. No entanto, uma falha comum em projetos de integração é conectar clientes web ou aplicativos diretamente à Service Layer a cada clique do usuário final.

Cada requisição de login/logout consome recursos de CPU do servidor do SAP e pode esgotar o limite configurado de sessões simultâneas (MaxInstances / MaxWorkerThreads). Quando múltiplos e-commerces, coletores e CRMs disparam requisições síncronas sem controle, ocorrem timeouts em cascata e degradação geral do sistema.

Implementação de Connection Pooling para B1Session

A solução recomendada pela engenharia é implementar um middleware em .NET ou Node.js que mantém um pool gerenciado de conexões autenticadas (B1Session). O middleware intercepta as chamadas externas, valida o payload e utiliza uma sessão ativa do pool para executar a transação.

Com este padrão, o tempo de resposta médio por requisição cai de aproximadamente 800ms para menos de 45ms, eliminando a sobrecarga de autenticação contínua.

// Exemplo conceitual de B1SessionPool em C#
public class SapServiceLayerPool
{
    private readonly ConcurrentBag<SapSession> _availableSessions;
    private readonly SemaphoreSlim _poolLock;

    public async Task<TResponse> ExecuteAsync<TResponse>(Func<HttpClient, Task<TResponse>> action)
    {
        var session = await AcquireValidSessionAsync();
        try
        {
            return await action(session.Client);
        }
        finally
        {
            ReleaseSession(session);
        }
    }
}

Padrão de pooling para reutilização de sessões autenticadas na Service Layer

Desacoplamento via Mensageria Assíncrona

Para operações volumosas (como inserção de lotes de pedidos ou apontamento de ordens de produção), sistemas externos não devem aguardar o processamento síncrono do SAP. O middleware deve receber o pedido, gravar em fila persistente (ex: RabbitMQ ou Redis Stream) e retornar imediatamente um protocolo HTTP 202 Accepted.

Caso o servidor do SAP seja reiniciado para manutenção ou fique temporariamente indisponível, a fila retém os eventos com segurança e retoma o processamento sequencial de forma idempotente assim que a conectividade for restaurada.

[ BLUEPRINT DA ARQUITETURA ]

App / E-commerce → [REST API Gateway]

↓

[Fila RabbitMQ Persistente] → [Worker de Integração .NET]

↓

[Pool de Sessões] → [SAP Business One Service Layer]

Sincronização Ativa com Change Data Capture (CDC)

Para levar dados do SAP para aplicações externas (como saldo de estoque ou alteração de preços), evite fazer polling contínuo (consultar a cada 30 segundos tabelas inteiras). Isso sobrecarrega os discos e a memória do banco de dados.

A arquitetura ideal utiliza Change Data Capture (CDC) no banco ou triggers de auditoria homologadas na base transacional que emitem mensagens leves somente quando um registro específico sofre alteração (Delta Sync).

Checklist de Segurança e Boas Práticas

1. Nunca execute comandos SQL INSERT/UPDATE diretos nas tabelas nativas do SAP (OINV, ORDR, OITM), pois isso corrompe a integridade referencial e anula o suporte oficial.

2. Utilize sempre a Service Layer ou a DI API para escrita transacional.

3. Implemente chaves de idempotência em todos os endpoints de faturamento para evitar geração duplicada de notas fiscais ou lançamentos contábeis.

4. Mantenha réplicas de leitura para relatórios e consultas analíticas de grande porte.

PONTOS ESSENCIAIS // SUMMARY

Nunca conecte interfaces públicas diretamente à Service Layer do SAP.
Utilize connection pooling para reaproveitar sessões autenticadas.
Desacople a escrita com filas de mensageria assíncrona tolerantes a falhas.
Adote Change Data Capture para envio de deltas de estoque e preços em tempo real.

[ LEITURA RECOMENDADA ]

OUTRAS NOTAS DE ENGENHARIA

SAP