Functionality
This method enables you to create purchase orders.

Notes
The following authorization objects are checked with the activity 01(Create):

• M_BEST_BSA,,Document type in purchase order


• M_BEST_EKG,,Purchasing group in purchase order


• M_BEST_EKO,,Purchasing organization in purchase
order

• M_BEST_WRK,,Plant in purchase order

Transfer
The PO header data is passed on in the table POHeader and theitem data in the table POItems. If the account assignmentcategory is set in an item, account assignment data can be passed onfor each PO item in the transfer table PoItemAccountAssignment.The account assignment category determines which objects that haverelevance to costing must be passed on in the account assignment data.If the account assignment category is K, for example, a cost centermust be passed on.
If the item is to be ordered from a one-time vendor, the latter'sordering address must be passed on in the table POAddress.
The table POItemSchedules must be passed on with the deliverydate (among other data) for each item.
Limits
Limit data relating to the PO item can be passed on in the tablesPOLimits und POContractLimits.
Services
Service data relating to the PO item can be passed on in the tablesPOServices und POSrvAccAssValues
See also the documentation on the parameters, in particular thedocumentation on the parameters POHeaderAddData,HeaderAddDataRelevant, POItemAddData, andItemAddDataRelevant.
Return
The purchase order number is returned in the parameter Number.
Messages returned
INCLUDE BAPI_RET

Description
INCLUDE BAPI_KEYFIELD

Description
You set the indicator only if fields are to be adopted fromPoHeaderAddData. In the standard system, the indicator is notset.

Description
You set the indicator only if fields are to be adopted fromPoHeaderAddData. In the standard system, the indicator is notset.

Description
The parameter contains the ordering address of the one-time vendor.
INCLUDE BAPI_DATAELEMENT

Description
The parameter contains general PO header data (such as the vendornumber, document type, purchasing organization).
INCLUDE BAPI_DATAELEMENT

Description
You should pass on this parameter only if you wish to transfer alreadyexisting purchase orders from another system into the SAP System.
If the parameter HeaderAddDataRelevan is set, all fieldsfrom PoHeaderAddData are adopted in the purchase order even ifcertain fields contain initial values.
Example:
In the case of vendor number 4711, the Incoterms in the vendor masterrecord have the value "FOB Hamburg".


• If you wish to create a new purchase order with this method, do not set
the parameter HeaderAddDataRelevan . As a result, the Incotermsin the purchase order will be adopted from the vendor master record(FOB Hamburg).

• If you wish to transfer an old purchase order with this method, and if
no Incoterms are stored in the old purchase order, set the parameterHeaderAddDataRelevan. In the parameter PoHeaderAddData,the fields INCOTERMS1 and INCOTERMS2 are passed on with initial values.This causes the data from the vendor master record to be overwritten.
Note that you must pass on all the data of the old purchase order inPoHeaderAddData because all fields are to be adopted inthe new purchase order.

Description
If this indicator is set, faulty items are skipped.

Description
This table contains data on the business partners to be stored in thepurchase order.
Each record of this table contains 3 fields:
The language-dependent partner role name
The language in which the partner role is specified
The number of the business partner in the vendor master record

Value range
Only the partner roles invoicing party (internal code: RS) andgoods supplier (internal code: WL) are currently supported.

Description
The table contains the purchase requisition limits with reference to acontract.
INCLUDE BAPI_DATAELEMENT

Description
The table contains the PO item data (e.g. material number, itemcategory, plant).
INCLUDE BAPI_DATAELEMENT

Description
The table contains the account assignment data pertaining to the POitem.
INCLUDE BAPI_DATAELEMENT

Description
You should pass on this parameter only if you wish to transfer alreadyexisting purchase orders from another system into the SAP System.
If the parameter ItemAddDataRelevant is set, all fieldsfrom PoItemAddData are adopted in the purchase order, even ifcertain fields have initial values.
See also the documentation on the parameter PoHeaderAddData.
INCLUDE BAPI_DATAELEMENT

Description
At least one entry must be passed on in this table for each item passedon, because the delivery date (DELIV_DATE) is not included in the itemdata, for example.
You can pass on the date category in its internal or external form:


• Internal (DEL_DATCAT, e.g. 1 for current date)


• External (DEL_DATCAT_EXT, e.g. T for current date)

INCLUDE BAPI_DATAELEMENT

Description
The table contains the texts pertaining to the PO item.
INCLUDE BAPI_DATAELEMENT

Description
The table contains the limits for the purchase order.
INCLUDE BAPI_DATAELEMENT

Description
The table contains the services and specification outlines of thepurchase requisition.
A line is marked as a specification outline line via the fieldOUTL_IND. The assignment of service lines to the outline lines iscarried out via the fields PCKG_NO (of the service line) and SUBPCKG_NO(of the outline line).
The hierarchy of the outline is formed via the fields LINE_NO andHI_LINE_NO. The field HI_LINE_NO refers to the field LINO_NO of thehierarchically superior outline level.
INCLUDE BAPI_DATAELEMENT

Description
INCLUDE MMPUR_BAPI_POSERVICESTEXT OBJECT DOKU ID TX

Description
The table contains the values of the accountt assignments at servicelevel and a link to the overall account assignment of the PO item (tablePOItemAccountAssignm, SERIAL_NO field).
The actual account assignment data (cost center etc.) is stored in theaccount assignment table POItemAccountAssignm and is identifiedvia this link.

Description
INCLUDE BAPI_TABLE

Value range
Type,,ID,,Number,,Message
E,,W5,,061,,An error has occurred in enhancement &
,,,,,,(Please check)