1 Short Description
2 Function Module
3.2 Functionality in Detail
3.4 Controlling adoption of field values via X parameter
3.7 Return messages
3.10 Help in the Case of Problems
3.11 Customer Enhancements
3.12 Further information
Create Enjoy Purchase Orders
STYLE S_DOCUS1 Function module BAPI_PO_CREATE1 enables you to create purchase orders. The BAPI uses the technology behind the Enjoy purchase order transaction (ME21N). Alternatively, the IDoc type PORDCR1 is available. The data from this IDoc automatically populates the interface parameters of the function module BAPI_PO_CREATE1. STYLE *
Functionality in Detail
The following authorization objects are checked when an Enjoy purchase order is created (activity 01):
M_BEST_BSA (document type in PO)
M_BEST_EKG (purchasing group in PO)
M_BEST_EKO (purchasing organization in PO)
M_BEST_WRK (plant in PO)
Controlling adoption of field values via X parameter
For most tables, you can determine via your own parameters in the associated X parameter in each case (e.g. PoItemX) whether fields are to be set initial, values inserted via the interface, or default values adopted (e.g. from Customizing or master records) (for example, it is not mandatory to adopt the material group from an underlying purchase requisition – you can change it with the BAPI).
The header data of the Enjoy purchase order is transferred in the table PoHeader.
The item data of the Enjoy purchase order is stored in the table PoItem (general item data). The delivery schedule lines are stored in the table PoSchedule. Use the table PoAccount to specify the account assignment information. If account assignments have been specified for services and limits, you show the relevant account assignment line in PoAccount in the table PoSrvAccessValues via the package number of the service or the limit.
Services and limits
Services, free limits and limits with contract reference can be specified in the tables PoServices, PoLimits, and PoContractLimits.
Conditions are transferred in the table PoCond; header conditions in the table PoCondHeader. Price determination is reinitiated via the parameter CALCTYPE in the table PoItem.
Vendor and delivery address
The vendor’s address can be specified individually in the table PoAddrVendor; the delivery address in the table PoAddrDelivery. If you do not make any individual specification, the fields will be populated via the central address management facility. Note In this method, the following restrictions apply with regard to addresses: Addresses can only be created with this method – they cannot be changed. You can only change address data with the method BAPI_ADDRESSORG_CHANGE. When you create addresses, they are not checked by the method. An Enjoy purchase order may therefore contain faulty address data.
The partners can be maintained individually via the table PoPartner (with the exception of the partner role "vendor").
Import/Export data can be specified per item in the table PoExpImpItem. Foreign trade data can only be transferred as default data for new items.
Header and item texts can be transferred in the tables PoTextHeader and PoTextItem. Texts for services are imported in the table PoServicesText.
You can make use of the Version Management facility via the table AllVersions.
The PO number is returned in the parameter ExpPurchaseOrder. In addition, all information except the service and export/import tables is placed in the output structures.
Messages are returned in the parameter Return. This also contains information as to whether interface data has been wrongly or probably wrongly (heuristical interface check) populated. When a PO has been created successfully, the PO number is also placed in the return table with the appropriate message. STYLE * STYLE S_DOCUS1
With this function module, it is not possible to:
Create subcontracting components (you can only use existing ones)
Create configurations (you can only use existing ones)
Change message records (table NAST) and additional message data (this data can only be determined via the message determination
Attach documents to the purchase order
See also further information in SAP Note 197958. STYLE *
STYLE S_DOCUS1 Example of population of BAPI interface in the Function Builder Parameter: POHEADER COMP_CODE,,=,,1000 DOC_TYPE,,=,,NB ITEM_INTVL,,=,,00001 VENDOR,,=,,0000001000 PMNTTRMS,,=,, 0001 PURCH_ORG,,=,, 1000 PUR_GROUP,,=,, 001 CURRENCY,,=,, EUR Parameter: POHEADERX COMP_CODE,,=,, X DOC_TYPE,,=,, X ITEM_INTVL,,=,, X VENDOR,,=,, X PMNTTRMS,,=,, X PURCH_ORG,,=,, X PUR_GROUP,,=,, X Parameter: POITEM PO_ITEM,,=,, 00001 MATERIAL,,=,,100-100 PLANT,,=,,1000 STGE_LOC,,=,,0001 QUANTITY,,=,,15.000 TAX_CODE,,=,,V0 ITEM_CAT,,=,, 0 ACCTASSCAT,,=,,K Parameter: POITEMX PO_ITEM,,=,,00001 MATERIAL,,=,,X PLANT,,=,,X STGE_LOC,,=,,X QUANTITY,,=,,X TAX_CODE,,=,,X ITEM_CAT,,=,,X ACCTASSCAT,,=,,X Parameter: POSCHEDULE PO_ITEM,,=,,00001 SCHED_LINE,,=,,0001 DELIVERY_DATE,,=,,02.12.2002 QUANTITY,,=,,6.000 PO_ITEM,,=,,00001 SCHED_LINE,,=,,0002 DELIVERY_DATE,,=,,03.12.2002 QUANTITY,,=,,5.000 PO_ITEM,,=,,00001 SCHED_LINE,,=,,0003 DELIVERY_DATE,,=,,04.12.2002 QUANTITY,,=,,4.000 Parameter: POSCHEDULEX PO_ITEM,,=,,00001 SCHED_LINE,,=,,0001 PO_ITEMX,,=,,X SCHED_LINEX,,=,,X DELIVERY_DATE,,=,,X QUANTITY,,=,,X PO_ITEM,,=,,00001 SCHED_LINE,,=,,0002 PO_ITEMX,,=,,X SCHED_LINEX,,=,,X DELIVERY_DATE,,=,,X QUANTITY,,=,,X PO_ITEM,,=,,00001 SCHED_LINE,,=,,0003 PO_ITEMX,,=,,X SCHED_LINEX,,=,,X DELIVERY_DATE,,=,,X QUANTITY,,=,,X Parameter: POACCOUNT PO_ITEM,,=,,00001 SERIAL_NO,,=,,01 QUANTITY,,=,,15.000 GL_ACCOUNT,,=,,0000400000 COSTCENTER,,=,,0000001000 CO_AREA,,=,,1000 Parameter: POACCOUNTX PO_ITEM,,=,,00001 SERIAL_NO,,=,,01 QUANTITY,,=,,X GL_ACCOUNT,,=,,X COSTCENTER,,=,,X CO_AREA,,=,,X Parameter: POCOND ITM_NUMBER,,=,,000001 COND_ST_NO,,=,,001 COND_TYPE,,=,,PB00 COND_VALUE,,=,,79.900000000 CURRENCY,,=,,EUR CURRENCY_ISO,,=,,EUR COND_UNIT,,=,,KG COND_P_UNT,,=,,1 CHANGE_ID,,=,,U Parameter: POCONDX ITM_NUMBER,,= ,,000001 COND_ST_NO,,= ,,001 ITM_NUMBERX,,= ,,X COND_TYPE,,= ,,X COND_VALUE,,= ,,X CURRENCY,,= ,,X CHANGE_ID,,= ,,X Parameter: POPARTNER PARTNERDESC,,= ,,OA LANGU,,= ,,EN BUSPARTNO,,= ,,0000001100 PARTNERDESC,,= ,,GS LANGU,,= ,,EN BUSPARTNO,,= ,,0000001200 PARTNERDESC,,= ,,PI LANGU,,= ,,EN BUSPARTNO,,= ,,0000001000 STYLE *
Help in the Case of Problems
RESET N1 STYLE S_DOCUS1
SAP Note 197958 lists answers to frequently asked questions (FAQs). (Note 499626 contains answers to FAQs relating specifically
to External Services Management.)
If you have detected an error in the function of a BAPI, create a reproducible example in the test data directory in the
Function Builder (transaction code SE37). SAP Note 375886 tells you how to do this.
If the problem persists, create a Customer Problem Message for the componente MM-PUR-PO-BAPI, and document the reproducible
example where appropriate. STYLE *
STYLE S_DOCUS1 The following customer exits (function modules) are available for the BAPI BAPI_PO_CREATE1:
EXIT_SAPL2012_001 (at start of BAPI)
EXIT_SAPL2012_003 (at end of BAPI)
The following customer exits (function modules) are available for the BAPI BAPI_PO_CHANGE:
EXIT_SAPL2012_002 (at start of BAPI)
EXIT_SAPL2012_004 (at end of BAPI)
These exits belong to the enhancement SAPL2012 (see also transaction codes SMOD and CMOD). There is also the option of populating customers’ own fields for header, item, or account assignment data via the parameter EXTENSIONIN. STYLE *
RESET N1 STYLE S_DOCUS1
Further information on purchase order BAPIs is available in SAP Note 197958.
If you test the BAPIs BAPI_PO_CREATE1 or BAPI_PO_CHANGE in the Function Builder (transaction code SE37), no database updates
will be carried out. If you need this function, take a look at Note 420646.
The BAPI BAPI_PO_GETDETAIL serves to read the details of a purchase order. The BAPI cannot read all details (e.g. conditions).
However, you can use the BAPI BAPI_PO_CHANGE for this purpose if just the document number is populated and the invoker has change authorizations for purchase orders.
Frequently used BAPIs for purchase orders are BAPI_PO_CREATE, BAPI_PO_CREATE1, BAPI_PO_CHANGE, BAPI_PO_GETDETAIL,
BAPI_PO_GETITEMS, BAPI_PO_GETITEMSREL, and BAPI_PO_GETRELINFO.
For more information on purchase orders, refer to the SAP library (under MM Purchasing -> Purchase Orders) or the Help for
the Enjoy Purchase Order, or choose the path Tools -> ABAP Workbench -> Overview -> BAPI Explorer from the SAP Easy Access menu. STYLE *
CALL FUNCTION ‘BAPI_PO_CREATE1’
" POHEADERX =
" POADDRVENDOR =
" TESTRUN =
" MEMORY_UNCOMPLETE =
" MEMORY_COMPLETE =
" POEXPIMPHEADER =
" POEXPIMPHEADERX =
" VERSIONS =
" NO_MESSAGING =
" NO_MESSAGE_REQ =
" NO_AUTHORITY =
" NO_PRICE_FROM_PO =
" EXPPURCHASEORDER =
" EXPHEADER =
" EXPPOEXPIMPHEADER =
" RETURN =
" POITEM =
" POITEMX =
" POADDRDELIVERY =
" POSCHEDULE =
" POSCHEDULEX =
" POACCOUNT =
" POACCOUNTPROFITSEGMENT =
" POACCOUNTX =
" POCONDHEADER =
" POCONDHEADERX =
" POCOND =
" POCONDX =
" POLIMITS =
" POCONTRACTLIMITS =
" POSERVICES =
" POSRVACCESSVALUES =
" POSERVICESTEXT =
" EXTENSIONIN =
" EXTENSIONOUT =
" POEXPIMPITEM =
" POEXPIMPITEMX =
" POTEXTHEADER =
" POTEXTITEM =
" ALLVERSIONS =
" POPARTNER =
" POCOMPONENTS =
" POCOMPONENTSX =
" POSHIPPING =
" POSHIPPINGX =
" POSHIPPINGEXP =
Retrieved from "http://abap.wikiprog.com/wiki/BAPI_PO_CREATE1"
Category: BAPI PurchaseOrderFRE
This message is for the designated recipient only and may contain privileged, proprietary, or otherwise private information. If you have received it in error, please notify the sender immediately and delete the original. Any other use of the email by you is prohibited.