BAPI

Uma BAPI liga uma definição orientada a objetos a uma implementação clássica:

1. No Business Object Repository, um tipo de business object, como um pedido de compra, declara métodos como criar, alterar ou obter detalhes. Cada um desses métodos de API é uma BAPI.
2. Por trás de cada método há um módulo de função habilitado para RFC, de modo que a BAPI pode ser chamada dentro do sistema ou remotamente via RFC.
3. O chamador passa parâmetros de importação e tabelas; a BAPI informa sucesso ou erros em um parâmetro de retorno tipado com a estrutura BAPIRET2, em vez de levantar exceções.
4. As BAPIs de alteração seguem um modelo transacional em que a própria BAPI não faz commit. O chamador decide quando gravar, normalmente chamando BAPI_TRANSACTION_COMMIT após uma ou mais chamadas de BAPI, ou a contraparte de rollback após um erro.

O BAPI Explorer, iniciado com a transação BAPI, navega pelos tipos de business object e suas BAPIs por componente de aplicação e mostra parâmetros e documentação. Uma BAPI é, portanto, um contrato no nível de negócio sobre um módulo de função, com o commit deixado a cargo do chamador.

As BAPIs são anteriores ao SAP Fiori e ao OData, mas continuam fazendo parte de muitos landscapes:

• Integrações ponto a ponto e via middleware que chamam o SAP ERP ou o SAP S/4HANA via RFC, por exemplo para criar ordens de venda a partir de uma loja virtual.
• Programas de migração de dados e processamento em massa que lançam documentos passando pelas mesmas verificações das transações de diálogo.
• Serviços OData construídos sobre BAPIs. On-premise, projetos SAP Gateway costumam mapear as operações de uma entidade para BAPIs existentes por meio da importação RFC/BOR do Service Builder, e a SAP documenta um padrão RAP que chama uma BAPI dentro de um RAP business object por meio de uma classe wrapper.

Na Alder Manufacturing, um portal de fornecedores que cria pedidos de compra para a Cedar Office Supply pode ainda lançar por meio de uma BAPI de pedido de compra encapsulada em uma API mais nova. As BAPIs muitas vezes sobrevivem como o motor sob uma interface moderna, e não como a própria interface.

A SAP classifica as BAPIs como APIs clássicas. Elas não são APIs liberadas no sentido do ABAP Cloud, portanto código escrito na versão de linguagem ABAP for Cloud Development não pode chamá-las diretamente.

A SAP publica uma lista de APIs clássicas para a Private Edition e orienta os desenvolvedores a estudá-las no BAPI Explorer. Os relatórios de clean core contam as referências a APIs clássicas listadas separadamente das APIs liberadas. Em um landscape clean core, a BAPI é, portanto, tolerada como ponte, e não tratada como a interface-alvo.

1. Esquecer o commit. A chamada retorna sem erros, mas nada é gravado, porque o chamador nunca acionou BAPI_TRANSACTION_COMMIT.
2. Ignorar a tabela de retorno. As BAPIs informam erros como mensagens no parâmetro de retorno; um programa que só verifica exceções não lança nada e informa sucesso.
3. Confundir os rótulos de "liberada". O BAPI Explorer mostra BAPIs liberadas no Business Object Repository, o que não é o mesmo que uma API liberada sob um contrato de liberação do ABAP Cloud.
4. Encapsular sem um responsável. Um wrapper C1 em torno de uma BAPI precisa de um responsável que o substitua quando a SAP liberar uma API sucessora.

A maioria dos defeitos com BAPIs vem do modelo transacional e do tratamento de mensagens, não da lógica de negócio dentro da BAPI.