Integrar o SAP com o sistema próprio: os caminhos e quando usar cada um

Integrar um sistema próprio ao SAP tem cinco caminhos principais. A escolha costuma ser feita em uma reunião e sustentada por cinco anos, o que justifica gastar meia hora entendendo as diferenças.

A pergunta que ordena tudo: isso precisa ser em tempo real? Quase toda escolha errada começa respondendo "sim" por hábito, quando a resposta honesta era "até amanhã de manhã está bom".

Os cinco caminhos

OData / APIs REST

O caminho moderno e o padrão no S/4HANA. Serviço exposto pelo SAP, consumido por HTTP, JSON de um lado e ABAP do outro.

Bom para: aplicação web ou móvel que consulta e grava em tempo real, volume baixo a médio, integração que precisa de resposta imediata.

Cuidado com: volume alto. OData não foi feito para mover cem mil registros — é chamada a chamada, e o custo por chamada aparece.

BAPI / RFC

A interface clássica de função. Chamada remota direto na lógica de negócio do SAP, com toda a validação que a transação faria.

Bom para: gravar transação de negócio respeitando as regras do SAP. É o caminho mais seguro para criar pedido, lançar documento, movimentar estoque.

Cuidado com: acoplamento. Exige conectividade direta e credencial com permissão real. Em integração que sai para a internet, prefira expor OData na frente.

IDoc

O mecanismo de mensagem assíncrona do SAP, com décadas de estrada. Documento estruturado, enfileirado, com monitoramento e reprocessamento nativos.

Bom para: volume alto, parceiro externo, processo que tolera minutos de atraso. EDI com cliente e fornecedor vive disso.

Cuidado com: a curva. Monitorar IDoc é uma disciplina própria. Quem não sabe ler WE02 vai sofrer.

O ponto que quase sempre decide a favor dele: IDoc que falha fica parado, visível e reprocessável. Chamada REST que falha some, a menos que alguém tenha construído a fila.

SAP Integration Suite (CPI)

A camada de integração da BTP. Orquestra, transforma, monitora e guarda o histórico.

Bom para: muitas integrações, formatos diferentes, necessidade de monitoramento central. Quando passam de cinco ou seis interfaces, a camada se paga.

Cuidado com: custo e curva. Para duas interfaces simples é canhão para mosquito.

Arquivo

CSV num diretório, lido por um job. Antiquado, e às vezes certo.

Bom para: carga em lote, sistema legado que só exporta arquivo, processo diário sem urgência.

Cuidado com: é o que mais quebra em silêncio. Arquivo não chegou, job rodou vazio, ninguém percebeu. Se for esse o caminho, o alerta de "arquivo não chegou" é parte do projeto, não um extra.

Escolhendo em três perguntas

1. Precisa de resposta imediata? Sim → OData ou BAPI. Não → IDoc ou arquivo, que são mais robustos e mais baratos de operar.

2. Qual o volume por dia? Até alguns milhares → qualquer um. Dezenas de milhares → IDoc ou arquivo em lote; OData registro a registro vai sofrer.

3. Quem mantém daqui a dois anos? Se o time interno não conhece BTP, construir em CPI cria dependência externa permanente. Às vezes vale assim mesmo — mas tem que ser decisão, não descoberta.

O erro que aparece só meses depois

Não é o caminho errado. É a falta de tratamento do que dá errado.

Integração funciona no teste porque o dado está certo e os dois lados estão no ar. Em produção, o fornecedor manda um código que não existe, a rede cai no meio, o mesmo pedido chega duas vezes.

Três perguntas que raramente estão no escopo inicial e sempre aparecem na operação:

• O que acontece com a mensagem que falha? Fila, descarte ou perda silenciosa?
• Dá para reprocessar sem duplicar? Se o mesmo pedido chegar duas vezes, vira dois

pedidos?

• Quem é avisado, e como? Pessoa com nome, não caixa compartilhada que ninguém lê.

Quem responde essas três no desenho entrega uma integração que dura. Quem deixa para depois entrega uma que funciona até o primeiro dia atípico.

Sobre não integrar

Vale considerar: o processo precisa mesmo de dois sistemas?

Às vezes a integração existe para sustentar uma planilha que virou sistema, e o caminho mais barato é trazer o processo para dentro do SAP. Integração é custo permanente — monitoramento, manutenção, quebra a cada upgrade dos dois lados.

A pergunta vale ser feita uma vez, no começo. Depois de construída, ninguém mais pergunta.