BAPI PO CREATE1 – PURCHASE ORDER CREATION

Contents
1 Short Description
2 Function Module
3 Description
3.1 Functionality
3.2 Functionality in Detail
3.3 Authorization
3.4 Controlling adoption of field values via X parameter
3.5 Transfer
3.6 Return
3.7 Return messages
3.8 Restrictions
3.9 Example
3.10 Help in the Case of Problems
3.11 Customer Enhancements
3.12 Further information
4 Import
5 Export
6 Changing
7 Pattern

[edit]Short Description
Create Enjoy Purchase Orders

[edit]Function Module
BAPI_PO_CREATE1

[edit]Description
[edit]Functionality
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 *

[edit]Functionality in Detail
STYLE S_DOCUS1

[edit]Authorization
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)
[edit]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).

[edit]Transfer
Header data
The header data of the Enjoy purchase order is transferred in the table PoHeader.

Item data
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
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.

Partner roles
The partners can be maintained individually via the table PoPartner (with the exception of the partner role "vendor").

Import/export data
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.

Texts
Header and item texts can be transferred in the tables PoTextHeader and PoTextItem. Texts for services are imported in the table PoServicesText.

Version Management
You can make use of the Version Management facility via the table AllVersions.

[edit]Return
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.

[edit]Return messages
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

[edit]Restrictions
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
facility (Customizing))

Attach documents to the purchase order
See also further information in SAP Note 197958. STYLE *

[edit]Example
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 *

[edit]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 *

[edit]Customer Enhancements
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 *

[edit]Further information
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 *

[edit]Import
ExtensionIn
MemoryComplete
MemoryUncomplete
NoAuthority
NoMessageReq
NoMessaging
NoPriceFromPo
PoAccountProfitSegment
PoAccountX
PoAddrVendor
PoComponentsX
PoCondX
PoContractLimits
PoExpImpHeader
PoExpImpHeaderX
PoExpImpItemX
PoHeader
PoHeaderX
PoItemX
PoLimits
PoScheduleX
PoServices
PoServicesText
PoShipping
PoShippingX
PoSrvAccessValues
TestRun
Versions
[edit]Export
AllVersions
ExpHeader
ExpPoExpImpHeader
ExpPurchaseOrder
ExtensionOut
PoShippingExp
Return
[edit]Changing
PoAccount
PoAddrDelivery
PoComponents
PoCond
PoCondHeader
PoCondHeaderX
PoExpImpItem
PoItem
PoPartner
PoSchedule
PoTextHeader
PoTextItem
[edit]Pattern

CALL FUNCTION ‘BAPI_PO_CREATE1’
EXPORTING
POHEADER =
" POHEADERX =
" POADDRVENDOR =
" TESTRUN =
" MEMORY_UNCOMPLETE =
" MEMORY_COMPLETE =
" POEXPIMPHEADER =
" POEXPIMPHEADERX =
" VERSIONS =
" NO_MESSAGING =
" NO_MESSAGE_REQ =
" NO_AUTHORITY =
" NO_PRICE_FROM_PO =
" IMPORTING
" EXPPURCHASEORDER =
" EXPHEADER =
" EXPPOEXPIMPHEADER =
" TABLES
" 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

Views

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.

Advertisements
Categories: Uncategorized | 1 Comment

Post navigation

One thought on “BAPI PO CREATE1 – PURCHASE ORDER CREATION

  1. Pingback: How To Fix Sap Delivery Creation Error Log in Windows

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

Blog at WordPress.com.

%d bloggers like this: