Como Usar BAPISINTRODUÇÃO

1.0 – Como pesquisar uma BAPI

2.0 – Testando e Mapeando uma BAPI

3.0 – Efetuando uma Sequência de Teste

5.0 – Uma Aplicação Simples

4.0 – Criando uma Especificação Funcional Simples

Considerações Finais

*Atenção, clique nas imagens para ampliá-las

INTRODUÇÃO 

BAPIS são Módulos de Funções Standard SAP que possuem infinitas utilizações. Cada BAPI possui uma função específica totalmente desenvolvida pela SAP.

É comum solicitarmos aos programadores ABAP para desenvolver determinado código / programa para desempenhar diversas funções, sem ao menos pesquisar se dentro do SAP já existe ou não uma função Standard que atenderia plenamente nossas necessidades sem termos que re-inventar a roda.

Dessa forma, é importante ressaltar que a Pesquisa e a Utilização de BAPIS são boas práticas antes de efetuar qualquer desenvolvimento.

BAPIS quando comparadas com Batch Input são infinitamente superiores pelos seguintes principais motivos:

Não é necessário mapear todas as possíveis telas de erros e de avisos, assim como é feito no mapeamento do Batch Input

Se algum erro ocorrer durante o processamento, o Sistema poderá pular para a próxima etapa de processamento e ao término exibir um relatório de erros standard

BAPI costuma possuir uma velocidade de processamento superior quando comparado com Batch Input

 

Neste documento, serão apresentados os segredos para a perfeita utilização de BAPIS, a saber:

Serão descritos os procedimentos para pesquisa e mapeamento dos Campos pertencentes a uma determinada BAPI

Também será possível verificar como Testar um Módulo de Função (BAPI) antes mesmo de empregá-lo em um determinado Programa. Isso é muito vantajoso, pois é através dos testes que o usuário poderá criar sua Especificação Funcional

Por fim, será apresentada uma especificação funcional bem simples com o mapeamento dos campos necessários para se fazer um Programa de Carga de Saldos Iniciais.

 

1.0 – Como pesquisar uma BAPI

 No menu SAP, digitar a Tcode BAPI:

Digite ENTER.

O Sistema deverá exibir a seguinte tela:

Note que o menu lateral é muito parecido com o menu do SAP

Para localizar as BAPIS disponíveis em MM clique em “Administração de Materiais”:

Como exemplo, testaremos a BAPI de movimentação de mercadorias, portanto, abara Administração de Estoque:

Com isso, você localizou o nome da BAPI que faz o trabalho: BAPI_GOODSMVT_CREATE

A próxima etapa é conhecer quais campos deverão ser preenchidos para que a BAPI funcione.

Comece com o Cabeçalho:

Monte uma planilha em Excel com estes campos, assim ficará mais fácil para montar a especificação funcional.

 

2.0 – Testando e Mapeando uma BAPI

 

Depois de analisar todos os campos, você poderá testar a BAPI e ir mapeando aos poucos, então abra outra janela e execute a Tcode SE37:

Execute a BAPI (Pressione F8):.

A seguinte tela deverá ser exibida:

Agora vem a parte chata, mapear o funcionamento da BAPI.

Inicialmente, vamos preencher o Cabeçalho do Documento de Material a ser criado.

Clique em:

A seguinte imagem deverá ser exibida:

Para preencher a estrutura, escolha uma melhor visualização clicando em:

A seguinte imagem deverá ser exibida:

Preencha os campos da BAPI:

Clique em:

Clique em:

 

Próxima etapa é preencher o Goodsmvt_Code.

A lista abaixo são as possíveis opções:

1. GM_Code 01: Goods receipt for purchase order2. GM_Code 02: Goods receipt for production order3. GM_Code 03: Goods issue4. GM_Code 04: Transfer posting5. GM_Code 05: Other goods receipt6. GM_Code 06: Reversal of goods movements7. GM_Code 07: Subsequent adjustment with regard to a subcontract order

No nosso caso, trata-se da opção 05:

Próxima etapa é preencher o Goods Moviment Item:

No caso, somente os seguintes campos foram preenchidos:

Analisando o Saldo em Estoque:

Nota-se que há saldo somente no Centro F001.

Uma vez que os dados foram preenchidos, é possível salvar o teste para futuras consultas. Clique em:

 

Indique um nome do teste para constar no diretório de teste

 

Para verificar os dados em futuras necessidades, clique em:

 

Ok, agora é possível executar a BAPI:

Pressionando F8

O sistema exibe o Resultado:

Verifique o Resultado em:

O Sistema criou um documento de material 49….3821.

Se o usuário checar a MB03

Receberá o seguinte erro:

Simples, a BAPI funcionou perfeitamente, porém, faltou o COMMIT.

 

3.0 – Efetuando uma Sequência de Teste

 

O que deve ser feito então ?

SE37:

 

Indicar uma sequência de Testes (BAPI + COMMIT)

 

Clique em:

 

O seguinte resultado deverá ser exibido:

 

Clique em:

Duplo clique em:

A imagem será exibida:

F8

Note que o Sistema gerou outro documento de material

Clique em: 

A seguinte tela deverá ser exibida:

Pressione F8 para executar a próxima BAPI (COMMIT)

Note que não houve erro no retorno.

Vá para Transação MB03, note que o Sistema apresenta o número do Documento Gerado:

 

Ao digitar ENTER, nota-se que desta vez o Documento foi realmente criado:

 

 

 

 

 

Na transação MMBE:

 

Nota-se que agora há saldo no Centro E002 Empresa SN01.

Este exemplo é bem simples para entender o funcionamento de BAPI.

Faça seu próprio teste com outros movimentos, ou com entrada de mercadoria via Pedido de Compras (é claro que é um pouco mais complexo).

 

4.0 – Criando uma Especificação Funcional Simples

Agora que você já tem uma boa noção de como localizar e mapear uma BAPI, vamos agora verificar como criar uma Especificação Funcional da Carga Inicial de SALDOS via planilha em Excel, utilizando uma BAPI.

O objetivo é fazer com que o Programa SAP leia e interprete uma Planilha elaborada em Excel, coletando os campos necessários para que a BAPI Funcione.

A BAPI utilizada nesta Especificação Funcional é a mesma utilizada nos tópicos anteriores.

 Especificação Funcional 

Detalhamento 

Titulo: Programa de Carga de Saldos IniciaisMódulo: MM – Materials ManagementResponsável Funcional: Natan CavalcantiID: N/ATipo: Conversão – CATTTarefa: NovoComplexidade: BaixaPrioridade: AltaCópia de Standard: N/ADescrição Breve: Programa de Conversão responsável pela Carga de Saldos Iniciais 

 

 

1 – Descrição do ProcessoSerá desenvolvido um programa de conversão para efetuar Cargas de Saldos Iniciais no Estoque.

Deverá ser utilizada uma planilha em Excel como origem de dados.

 

2 – Requisitos de SegurançaNenhum

 

3 – Fluxo do ProcessoCriação de Planilha com dados de Saldos Iniciais de Estoque (provenientes de inventário inicial da Empresa / Centro) à Dados são importados pelo programa de conversão à Dados são transferidos para BAPI_BAPI_GOODSMVT_CREATE à Saldos de Materiais são atualizados de acordo com as Planilhas fornecidas. 

 

4 – Tela de Seleção

Na tela de seleção o usuário deverá indicar o nome e o local de origem do arquivo a ser lido pelo programa de conversão.

 

5 – Relatórios e Formulários (SapScript) – LayoutNenhum

 

6 – Interfaces e Conversões – Input/Output Arquivo LayoutO Arquivo de Entrada deverá ser salvo em CSV (origem poderá ser em Excel).

A seguir o layout do arquivo de entrada (aqui será apresentada no formato vertical, considerar que cada linha é na verdade uma coluna):

 

 

GOODSMVT_HEADERParâmetro Descrição Valor OrigemPSTNG_DATE Data Atual do Sistema Variável PlanilhaDOC_DATE Data Atual do Sistema Variável PlanilhaHEADER_TXT Texto de Cabeçalho Variável Planilha 

GOODSMVT_CODEParâmetro Descrição Valor OrigemGM_CODE Código de Transação 05 Fixo 

GOODSMVT_ITEMParâmetro Descrição Valor OrigemMATERIAL Código de Material Variável PlanilhaPLANT Centro Variável PlanilhaSTGE_LOC Depósito Variável PlanilhaBATCH Lote Variável PlanilhaPROD_DATE Data de Produção Variável PlanilhaMOVE_TYPE Tipo de Movimento 561 Valor FixoENTRY_QNT Quantidade Variável Planilha  

7 – Interfaces e Conversões Tipo de Processo (BI, Call Transaction, BAPI, IDOC)N/A

 

 

8 – Interfaces e Conversões (Inbound) – SHDB 

N/A

 

9 – Interfaces e Conversões – ErrosN/A

 

10 – On-Lines – Layout de TelasN/A

 11 – Dados para TestesPara testes, utilizar os seguintes dados para efetuar Cargas de Saldos Iniciais:

 

Faça o download deste arquivo aqui:

Dados Exemplo 18.00 KBPlease login to download

 

O Documento em anexo deverá ser encaminhado ao usuário chave para preenchimento e orientação:

 

 Faça o download deste arquivo aqui:

Como Fazer 21.00 KBPlease login to download

Considerações Finais

 

Agora que você já viu como se utiliza uma BAPI, poderá repetir os mesmos procedimentos para fixação. Em seguida, poderá testar outras BAPIS, são algumas BAPIS que eu considero importantes (dentro do Módulo MM):

 

MIRO automática

Criação e Ampliação de Materiais

Criação de Pedidos de Compras

Registro de Inventário

Entre outras

 

Mais uma vez, espero que este documento possa ser útil em alguma Etapa de sua longa e trabalhosa carreira de Trabalho e de muitas Descobertas no Mundo SAP.

 

Dúvidas, críticas, elogios ou sugestões: natan@sapnat.com.br

 

Obrigado !