Integration & DataGlossary

What Is SAP BAPI (Business Application Programming Interface)?

Also known as: BAPI, SAP BAPI function, BAPI_PO_CREATE1, BAPI explorer

Definition

A BAPI is a stable, remote-callable SAP function module that exposes a business object method, such as creating a purchase order or posting a goods movement, while running the same validation and authorization checks as the SAP screens.

SAP BAPI (Business Application Programming Interface) Explained

BAPIs are defined in the Business Object Repository (transaction SWO1) and browsed in the BAPI Explorer. Technically each one is an RFC-enabled function module, viewed in SE37, with structured import, export and table parameters and a RETURN table that carries success, warning and error messages. Names follow patterns such as BAPI_PO_CREATE1, BAPI_SALESORDER_CREATEFROMDAT2, BAPI_GOODSMVT_CREATE, BAPI_MATERIAL_SAVEDATA and BAPI_PRODORD_CREATE.

BAPIs that change data do not commit by themselves. The caller must check the RETURN table for errors and then call BAPI_TRANSACTION_COMMIT, or BAPI_TRANSACTION_ROLLBACK on failure. Forgetting the commit is the most common integration bug: the call appears to succeed, but nothing is saved. Calls from outside SAP arrive via RFC using SAP Java Connector, .NET Connector, PyRFC or through middleware.

BAPIs are designed as released, stable interfaces, so they survive upgrades better than direct table writes or batch input recordings of screens. Posting through them preserves authorization checks, number ranges, pricing, account determination and user exits. Direct updates to tables such as MARD or VBAP bypass all of that and produce inconsistent data that SAP does not support.

In S/4HANA, many classic BAPIs are still supported, while SAP also publishes released OData and SOAP APIs through the API Business Hub for cloud scenarios. Choose the BAPI for on-premise RFC integration, and the released API for clean-core and cloud extension scenarios.

Why It Matters

It is the supported way to write into SAP from scanners, portals, MES and automation, because validation and authorization stay intact.
A missing commit or unread RETURN table causes silent data loss in integrations.
Choosing BAPIs over direct table writes keeps upgrades and audits safe.
AI agents that write back to SAP should do so through BAPIs with human approval, not through screens or database access.

In Practice

A shop floor terminal reports 50 finished pieces. The integration calls BAPI_GOODSMVT_CREATE with movement type 101 for production order 1000234, reads RETURN, finds only type S messages, and then calls BAPI_TRANSACTION_COMMIT with WAIT set. If RETURN contained type E, the integration would call rollback and show the message to the operator instead.

Frequently Asked Questions

Why does my BAPI call succeed but no data is saved?

Update BAPIs need an explicit BAPI_TRANSACTION_COMMIT after the call. Also check the RETURN table, because errors are returned as messages rather than raised as exceptions.

Can I call SAP BAPIs from Python?

Yes. PyRFC, which uses the SAP NetWeaver RFC SDK, calls BAPIs over RFC. Middleware and SAP Cloud Connector are alternatives, and the RFC user needs the right authorizations.

What replaces BAPIs in S/4HANA?

Many BAPIs remain supported. SAP also provides released OData, SOAP and event APIs for cloud and clean-core extensions, which are preferred where available.

Related Terms

API (Application Programming Interface)

An API (Application Programming Interface) is a defined contract that lets one software system request data or trigger functions in another, specifying the available operations, the structure of requests and responses, and the rules for authentication and error handling.

Middleware

Middleware is software that sits between applications and handles the communication, transformation, routing, and reliability concerns of moving data between them, so that the applications themselves do not need to know about each other directly.

SAP IDoc (Intermediate Document)

An IDoc (Intermediate Document) is SAP's standard format for exchanging business data such as orders, shipping notices and master data between SAP and other systems, using ALE for system to system links and EDI for partners.

AI Agent

An AI agent is a system that wraps a language model with tools, memory, and a goal so it can plan a sequence of steps, call external systems, observe the results, and iterate until the objective is met or a limit is reached.

MCP (Model Context Protocol)

MCP (Model Context Protocol) is an open standard that defines how AI applications connect to external tools and data sources, so any compliant client can use any compliant server without custom integration code for each pair.

Working with SAP BAPI (Business Application Programming Interface) in a live environment? Our engineers do this every day - and our AI agents automate most of it.

Talk to an Expert Browse the Full Glossary

Back to Glossary

Try it here, free

SAP BAPI_GOODSMVT_CREATE ABAP Code Generator

Open full tool

Fill in plant, material, quantity and movement type to get a working ABAP skeleton for posting a goods movement through the standard BAPI.

Fill in

Report name

Goods movement code

Movement type

Material number

Plant

Storage location

Quantity

Unit of measure

Generated code

Free, optional. Reopen it on any device.

Download:

Goods movement posting

REPORT ZR_POST_GOODS_MOVEMENT.

DATA: ls_header  TYPE bapi2017_gm_head_01,
      ls_code    TYPE bapi2017_gm_code,
      ls_headret TYPE bapi2017_gm_head_ret,
      lt_item    TYPE STANDARD TABLE OF bapi2017_gm_item_create,
      ls_item    TYPE bapi2017_gm_item_create,
      lt_return  TYPE STANDARD TABLE OF bapiret2,
      ls_return  TYPE bapiret2,
      lv_error   TYPE abap_bool.

ls_header-pstng_date = sy-datum.
ls_header-doc_date   = sy-datum.
ls_header-header_txt = 'Posted by ZR_POST_GOODS_MOVEMENT'.
ls_code-gm_code      = '05'.

ls_item-material  = 'FG-100045'.
ls_item-plant     = '1010'.
ls_item-stge_loc  = '0001'.
ls_item-move_type = '501'.
ls_item-entry_qnt = 25.
ls_item-entry_uom = 'EA'.
APPEND ls_item TO lt_item.

CALL FUNCTION 'BAPI_GOODSMVT_CREATE'
  EXPORTING
    goodsmvt_header  = ls_header
    goodsmvt_code    = ls_code
  IMPORTING
    goodsmvt_headret = ls_headret
  TABLES
    goodsmvt_item    = lt_item
    return           = lt_return.

LOOP AT lt_return INTO ls_return WHERE type CA 'EAX'.
  lv_error = abap_true.
  WRITE: / ls_return-type, ls_return-message.
ENDLOOP.

IF lv_error = abap_true.
  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.
ELSE.
  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
    EXPORTING
      wait = abap_true.
  WRITE: / 'Material document:', ls_headret-mat_doc, ls_headret-doc_year.
ENDIF.

Goods movement codes

01 goods receipt for purchase order, 02 goods receipt for production order, 03 goods issue, 04 transfer posting, 05 other goods receipts, 06 reversal of goods movements, 07 subsequent adjustment for subcontracting. Movement type 501 must be valid for code 05.

Skeleton for ECC and S/4HANA on-premise. Items for purchase order receipts need PO number and item (PO_NUMBER, PO_ITEM). In S/4HANA the long material field MATERIAL_LONG may be required for 40-character material numbers. Test with the TESTRUN parameter first and verify structure names in SE37 for your release.

Want posting logic wrapped in a safe API?

Optional: discuss how to expose SAP postings through an approval-based interface instead of direct calls.

Optional. The tool and every export work without this. No spam.

ArchRay builder

Design the on-prem AI stack: model, GPUs, RAG pipeline, guardrails

See memory, speed and cost as you swap parts, then export the diagram. Free, in your browser.

Open the builder

Keep exploring

Free tools

ERP fixes and how-tos

Integrations

TermsIDoc (Intermediate Document)SAP IDoc (Intermediate Document)API (Application Programming Interface)