para obter um exemplo prático de um BAPI aqui está um link
www.erpgenie.com/abap/bapi/example.htm
O que são os BAPIs?
As Interfaces de Programação de Aplicações Empresariais (BAPIs) permitem o acesso a funções do SAP através de interfaces formais, estáveis e sem diálogo. Essas interfaces podem ser utilizadas por aplicações externas desenvolvidas por clientes e parceiros de software complementares, bem como por outras aplicações do SAP.
Os BAPIs são definidos como métodos de API de Tipos de Objetos Empresariais do SAP. Esses tipos de objetos são usados dentro do Framework Empresarial para permitir a comunicação baseada em objetos entre componentes. Os objetos empresariais e seus BAPIs permitem que a orientação a objetos seja utilizada no processamento central de informações nas empresas. Por exemplo, funções e dados existentes podem ser reutilizados, interoperabilidade técnica sem problemas pode ser alcançada e componentes não SAP podem ser implementados.
As aplicações podem usar BAPIs para acessar diretamente a camada de aplicação do Sistema R/3 e, como clientes, as aplicações podem usar a lógica empresarial do Sistema R/3. Os BAPIs fornecem ao cliente uma visão orientada a objetos dos objetos da aplicação, sem a necessidade de conhecer os detalhes da implementação.
Os BAPIs são sempre desenvolvidos definindo cenários. Esses cenários são usados para mapear e implementar processos empresariais em nível de sistema.
Grupo-alvo para a documentação
Esta documentação descreve as diretrizes que a SAP utiliza para desenvolver e implementar BAPIs, garantindo que o desenvolvimento de BAPIs seja o mais padrão possível. Esses padrões tornam os BAPIs fáceis de usar.
Este guia de programação é direcionado a desenvolvedores, parceiros e clientes da SAP que desejam implementar BAPIs.
Esta documentação foi escrita para a Versão 4.6C. A menos que indicado o contrário, essas diretrizes também se aplicam a versões anteriores, incluindo as versões 4.0.
http://help.sap.com/saphelp_46c/helpdata/en/43/b46c4853c111d395fa00a0c94260a5/frameset.htm
Design do BAPI
Uma vez identificados o cenário, os tipos de objetos empresariais e os BAPIs usados nele durante a análise, a assinatura do BAPI é definida conceitualmente na fase de design. O conteúdo deve ser descrito e os nomes dos parâmetros e a estrutura dos parâmetros devem ser definidos.
Como os BAPIs são interfaces empresariais e não interfaces técnicas, ao desenvolver um BAPI, é necessário cumprir o requisito central de que:
Um usuário deve ser capaz de implementar corretamente uma chamada a um BAPI em um aplicativo externo, usando apenas seu conhecimento do aplicativo e da documentação do BAPI. Não se espera que os usuários tenham nenhum conhecimento do R/3, para que possam ver o Sistema R/3 como uma "caixa preta".
Nesta fase, também deve ser decidido a partir das funções dos BAPIs se o BAPI é um método de instância ou um método de classe e se pode ser implementado como um BAPI padronizado.
Os métodos de instância referem-se a uma instância específica de um tipo de objeto empresarial, por exemplo, o BAPI SalesOrder.GetDetail recupera os detalhes exatos de um pedido de venda. Esses métodos são definidos como dependentes da instância no BOR.
Os métodos de classe não se referem a uma instância específica de um tipo de objeto empresarial, por exemplo, o BAPI SalesOrder.GetList fornece uma lista de todos os pedidos de venda existentes que correspondem a critérios específicos. Os métodos de criação padronizados também pertencem aos métodos de classe. Um método de criação cria uma nova instância, por exemplo, o BAPI SalesOrder.Create cria um novo pedido de venda no Sistema R/3. Esses métodos são definidos como independentes da instância no BOR.
As instâncias específicas de um tipo de objeto empresarial são identificadas por seus campos chave, desempenhando assim um papel especial nesse contexto. Na fase de design, as chaves dos BAPIs dependentes da instância devem ser identificadas como parâmetros especiais. Para mais detalhes, consulte Definir a Interface.
Ao projetar a assinatura do BAPI, você deve considerar:
O design do método (BAPI) e dos parâmetros deve seguir certas convenções. Veja também Convenções.