2011

Aprendendo a Usar BAPIS

Natan Cavalcanti
SAPNAT
11/5/2011

Aprendendo a Usar BAPIS

Contedo
INTRODUO..................................................................................................................................................... 3
1.0 - Como pesquisar uma BAPI ........................................................................................................................ 4
2.0 - Testando e Mapeando uma BAPI .............................................................................................................. 7
3.0 - Efetuando uma Sequncia de Teste ........................................................................................................ 17
4.0 - Criando uma Especificao Funcional Simples ........................................................................................ 24
Consideraes Finais ....................................................................................................................................... 29

Natan Cavalcanti - www.sapnat.com.br

Pgina 2

Aprendendo a Usar BAPIS

INTRODUO
BAPIS so Mdulos de Funes Standard SAP que possuem infinitas utilizaes. Cada BAPI possui uma
funo especfica totalmente desenvolvida pela SAP.
comum solicitarmos aos programadores ABAP para desenvolver determinado cdigo / programa para
desempenhar diversas funes, sem ao menos pesquisar se dentro do SAP j existe ou no uma funo
Standard que atenderia plenamente nossas necessidades sem termos que re-inventar a roda.
Dessa forma, importante ressaltar que a Pesquisa e a Utilizao de BAPIS so boas prticas antes de
efetuar qualquer desenvolvimento.
BAPIS quando comparadas com Batch Input so infinitamente superiores pelos seguintes principais
motivos:

No necessrio mapear todas as possveis 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 prxima etapa de
processamento e ao trmino exibir um relatrio de erros standard

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

Neste documento, sero apresentados os segredos para a perfeita utilizao de BAPIS, a saber:

Sero descritos os procedimentos para pesquisa e mapeamento dos Campos pertencentes a uma
determinada BAPI

Tambm ser possvel verificar como Testar um Mdulo de Funo (BAPI) antes mesmo de
empreg-lo em um determinado Programa. Isso muito vantajoso, pois atravs dos testes que o
usurio poder criar sua Especificao Funcional

Por fim, ser apresentada uma especificao funcional bem simples com o mapeamento dos
campos necessrios para se fazer um Programa de Carga de Saldos Iniciais.

Natan Cavalcanti - www.sapnat.com.br

Pgina 3

Aprendendo a Usar BAPIS

1.0 - Como pesquisar uma BAPI
1 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 disponveis em MM clique em Administrao de Materiais:

Natan Cavalcanti - www.sapnat.com.br

Pgina 4

Aprendendo a Usar BAPIS

Como exemplo, testaremos a BAPI de movimentao de mercadorias, portanto, abara Administrao de

Estoque:

Natan Cavalcanti - www.sapnat.com.br

Pgina 5

Aprendendo a Usar BAPIS

Com isso, voc localizou o nome da BAPI que faz o trabalho: BAPI_GOODSMVT_CREATE
A prxima etapa conhecer quais campos devero ser preenchidos para que a BAPI funcione.
Comece com o Cabealho:

Natan Cavalcanti - www.sapnat.com.br

Pgina 6

Aprendendo a Usar BAPIS

Monte uma planilha em Excel com estes campos, assim ficar mais fcil para montar a especificao
funcional.

2.0 - Testando e Mapeando uma BAPI

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

Execute a BAPI:
A seguinte tela dever ser exibida:

Natan Cavalcanti - www.sapnat.com.br

Pgina 7

Aprendendo a Usar BAPIS

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

Inicialmente, vamos preencher o Cabealho do Documento de Material a ser criado:

Clique em:
A seguinte imagem dever ser exibida:

Para preencher a estrutura, escolha uma melhor visualizao clicando em:

A seguinte imagem dever ser exibida:

Natan Cavalcanti - www.sapnat.com.br

Pgina 8

Aprendendo a Usar BAPIS

Preencha os campos da BAPI:

Natan Cavalcanti - www.sapnat.com.br

Pgina 9

Aprendendo a Usar BAPIS

Clique em:
Clique em:

Natan Cavalcanti - www.sapnat.com.br

Pgina 10

Aprendendo a Usar BAPIS

Prxima etapa preencher o Goodsmvt_Code:

A lista abaixo so as possveis opes:
1. GM_Code 01: Goods receipt for purchase order
2. GM_Code 02: Goods receipt for production order
3. GM_Code 03: Goods issue
4. GM_Code 04: Transfer posting
5. GM_Code 05: Other goods receipt
6. GM_Code 06: Reversal of goods movements
7. GM_Code 07: Subsequent adjustment with regard to a subcontract order

No nosso caso, trata-se da opo 05.

Prxima etapa preencher o Goods Moviment Item:

Natan Cavalcanti - www.sapnat.com.br

Pgina 11

Aprendendo a Usar BAPIS

No caso, somente os seguintes campos foram preenchidos:

Natan Cavalcanti - www.sapnat.com.br

Pgina 12

Aprendendo a Usar BAPIS

Analisando o Saldo em Estoque:

Nota-se que h saldo somente no Centro F001.

Natan Cavalcanti - www.sapnat.com.br

Pgina 13

Aprendendo a Usar BAPIS

Uma vez que os dados foram preenchidos, possvel salvar o teste para futuras consultas. Clique em:

Indique um nome do teste para constar no diretrio de teste

Para verificar os dados em futuras necessidades, clique em:

Natan Cavalcanti - www.sapnat.com.br

Pgina 14

Aprendendo a Usar BAPIS

Ok, agora possvel executar a BAPI:

Pressionando F8
O sistema exibe o Resultado:

Natan Cavalcanti - www.sapnat.com.br

Pgina 15

Aprendendo a Usar BAPIS

Verifique o Resultado em:

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

Se o usurio checar a MB03

Receber o seguinte erro:

Simples, a BAPI funcionou perfeitamente, porm, faltou o COMMIT.

Natan Cavalcanti - www.sapnat.com.br

Pgina 16

Aprendendo a Usar BAPIS

3.0 - Efetuando uma Sequncia de Teste
O que deve ser feito ento:
SE37:

Natan Cavalcanti - www.sapnat.com.br

Pgina 17

Aprendendo a Usar BAPIS

Clique em:

Duplo clique em:

A imagem ser exibida:

Natan Cavalcanti - www.sapnat.com.br

Pgina 18

Aprendendo a Usar BAPIS

F8

Note que o Sistema gerou outro documento de material

Natan Cavalcanti - www.sapnat.com.br

Pgina 19

Aprendendo a Usar BAPIS

F8 para executar a prxima BAPI (COMMIT)

No houve erro no retorno

Natan Cavalcanti - www.sapnat.com.br

Pgina 20

Aprendendo a Usar BAPIS

V para MB03:

Agora sim, o Documento foi gerado.

Natan Cavalcanti - www.sapnat.com.br

Pgina 21

Aprendendo a Usar BAPIS

Natan Cavalcanti - www.sapnat.com.br

Pgina 22

Aprendendo a Usar BAPIS

Na MMBE:

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

Este exemplo bem simples para entender o funcionamento de BAPI.
Faa seu prprio teste com outros movimentos, ou com entrada de mercadoria via Pedido de Compras (
claro que um pouco mais complexo).

Natan Cavalcanti - www.sapnat.com.br

Pgina 23

Aprendendo a Usar BAPIS

4.0 - Criando uma Especificao Funcional Simples

As prximas linhas so a Especificao Funcional da Carga Inicial de SALDOS via planilha em Excel.
O objetivo fazer com que o Programa SAP leia e interprete uma Planilha elaborada em Excel, coletando os
campos necessrios para que a BAPI Funcione.
A BAPI utilizada nesta Especificao Funcional a mesma utilizada nos tpicos anteriores.

Especificao Funcional
Detalhamento

Titulo:
Programa de Carga de Saldos Iniciais

Mdulo:

MM Materials Management

Responsvel Funcional:

Natan Cavalcanti

ID:

N/A

Tipo:

Converso - CATT

Tarefa:

Novo

Complexidade:

Baixa

Prioridade:

Alta

Cpia de Standard:

N/A

Descrio Breve: Programa de Converso responsvel pela Carga de Saldos Iniciais

Natan Cavalcanti - www.sapnat.com.br

Pgina 24

Aprendendo a Usar BAPIS

1 Descrio do Processo

Ser desenvolvido um programa de converso para efetuar Cargas de Saldos Iniciais no Estoque.
Dever ser utilizada uma planilha em Excel como origem de dados.

2 Requisitos de Segurana

Nenhum

3 Fluxo do Processo

Criao de Planilha com dados de Saldos Iniciais de Estoque (provenientes de inventrio inicial da
Empresa / Centro)
Dados so importados pelo programa de converso
Dados so
transferidos para BAPI_BAPI_GOODSMVT_CREATE
Saldos de Materiais so atualizados
de acordo com as Planilhas fornecidas.

4 Tela de Seleo

Na tela de seleo o usurio dever indicar o nome e o local de origem do arquivo a ser lido pelo
programa de converso.

5 Relatrios e Formulrios (SapScript) - Layout

Nenhum

Natan Cavalcanti - www.sapnat.com.br

Pgina 25

6 Interfaces e Converses Input/Output Arquivo Layout

O 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_HEADER
Parmetro

Descrio

Valor

Origem

PSTNG_DATE

Data Atual do Sistema

Varivel

Planilha

DOC_DATE

Data Atual do Sistema

Varivel

Planilha

HEADER_TXT

Texto de Cabealho

Varivel

Planilha

GOODSMVT_CODE
Parmetro

Descrio

Valor

Origem

GM_CODE

Cdigo de Transao

05

Fixo

GOODSMVT_ITEM
Parmetro

Descrio

Valor

Origem

MATERIAL

Cdigo de Material

Varivel

Planilha

PLANT

Centro

Varivel

Planilha

STGE_LOC

Depsito

Varivel

Planilha

BATCH

Lote

Varivel

Planilha

PROD_DATE

Data de Produo

Varivel

Planilha

MOVE_TYPE

Tipo de Movimento

561

Valor Fixo

ENTRY_QNT

Quantidade

Varivel

Planilha

Natan Cavalcanti - www.sapnat.com.br

Pgina 26

7 Interfaces e Converses Tipo de Processo (BI, Call Transaction, BAPI, IDOC)

N/A

8 Interfaces e Converses (Inbound) - SHDB

N/A

9 Interfaces e Converses Erros

N/A

10 On-Lines - Layout de Telas

N/A

Natan Cavalcanti - www.sapnat.com.br

Pgina 27

11 Dados para Testes

Para testes, utilizar os seguintes dados para efetuar Cargas de Saldos Iniciais:

Carga de Saldos
Iniciais - Exemplo.csv

GOODSMVT_HEADER
PSTNG_DATE
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009

DOC_DATE
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009
13.05.2009

GOODSMVT_CODE GOODSMVT_ITEM
HEADER_TXT
GM_CODE
MATERIAL
PLANT STGE_LOC BATCH ENTRY_QNT
CARGA DE SALDOS INICIAIS
5
1 2000 A100
1050
CARGA DE SALDOS INICIAIS
5
3 2000 A100
900
CARGA DE SALDOS INICIAIS
5
6 2000 A100
150
CARGA DE SALDOS INICIAIS
5
7 2000 A100
120
CARGA DE SALDOS INICIAIS
5
8 2000 A100
500
CARGA DE SALDOS INICIAIS
5
9 2000 A100
670
CARGA DE SALDOS INICIAIS
5
10 2000 A100
876

O Documento em anexo dever ser encaminhado ao usurio chave para preenchimento e orientao:

Carga de Saldos
Iniciais - Como Fazer.xls

Data de Criao
07.05.2009
07.05.2009

Dados de Cabealho
GOODSMVT_CODE
Data do Documento
Texto Cabealho
GM_CODE
07.05.2009
CARGA DE SALDOS INICIAIS
05
07.05.2009
CARGA DE SALDOS INICIAIS
05

Natan Cavalcanti - www.sapnat.com.br

Cdigo Material
21
25

Dados de Item
Planta / Centro Depsito
2000
A100
2000
A100

Lote

Quantidade
1050
900

Pgina 28

Consideraes Finais
Agora que voc j viu como se utiliza uma BAPI, poder repetir os mesmos procedimentos para fixao.
Em seguida, poder testar outras BAPIS, so algumas BAPIS que eu considero importantes (dentro do
Mdulo MM):

MIRO automtica

Criao e Ampliao de Materiais

Criao de Pedidos de Compras

Registro de Inventrio

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.

Dvidas, crticas, elogios ou sugestes: natan@sapnat.com.br

Obrigado !

Natan Cavalcanti - www.sapnat.com.br

Pgina 29