Functionality
You can use this method to create a customer inquiry with BOS.

Notes
Minimum requirements for creating a customer inquiry
The following parameters, at least, must be transferred:

• Inquiry header data via parameter InquiryHeaderIn

,,DOC_TYPE,,sales document type
,,SALES_ORG,,sales organization
,,DISTR_CHAN,,distribution channel
,,DIVISION,,division
The sales document type must be entered in correspondance with thelogon language.

• Partner data via parameter InquiryPartners

,,PARTN_ROL,,partner function AG (sold-to party),,
,,PART_NUMB,,customer number
If you do not enter a ship-to party, then ship-to party = sold-toparty.
The partner function must be consistent with the logon language.
Minimum entry requirements for creating a document item

• Document item data via parameter InquiryItemsIn

,,ITM_NUMBER ,,item number
,,MATERIAL,,material number
There are two options for number assignment:

• If you choose external number assignment via parameter
IntNumberAssignment, you must enter the item number in fieldITM_NUMBER.

• If you choose internal number assignment via parameter
IntNumberAssignment, the system assigns the item numbersaccording to your settings in Customizing. For internal numberassignment, field ITM_NUMBER must remain initial.
Minimum entry requirements for creating a document item with BOS
In addition to the document items, you must also transfer the followingparameters if you want to create a document item with BOS:

• The package number for the BOS PCKG_NO must be transferred via
parameter OrderItemsIn. This must correspond to the PCKG_NO
of the initial node (uppermost outline level with hierarchy level0) in transfer parameter InquiryItemsIn.
There must be exactly one schedule line for a document item with BOS.You must set a quantity of 1. You enter the dates via theschedule line data.
You must enter the following data via parameter InquirySchedulesIn
:
,,ITM_NUMBER,,item number
,,SCHED_LINE,,schedule line number
,,REQ_DATE,,schedule line date
,,REQ_QTY ,,inquiry quantity in sales unit of measure
Creating Services
You can transfer service data for the inquiry item via parametersInquiryServices and InquiryServicesText.
Customer fields - tables VBAK, VBAP, VBEP and ESLL can be transferred via parameter ExtensionIn.
Transfer of Configuration Data
If you are dealing with configurable data, you must transfer theconfiguation data in the following parameters:
,,InquiryCfgsRef,,,,configuration: reference data
,,InquiryCfgsInst,,,,configuration: instances
,,InquiryCfgsPartOf,,,,configuration: instances
,,InquiryCfgsValue,,,,configuration: characteristic values
Commit Control
This method does not include a database commit. This means that thecalling application must exit the commit so that changes can be made onthe database. The following method is available for this:BAPI_TRANSACTION_COMMIT.
Return Values
After you have created the customer inquiry successfully, the documentnumber is returned via parameter SalesDocument.
If errors occur during processing, they are returned to table parameterReturn. Information messages are also logged in this parameter.

Further information
SAP note number 93091 contains general information for BAPIs inSales and Distribution (SD).

Description
This parameter returns the customer inquiry number created by the BAPI.

Description
This parameter controls the program reaction when an error occurs.
INCLUDE BOS_BAPI_BEHAVEWHENERROR OBJECT DOKU ID TX

Default
SPACE

Description
Describes the significance of the link between two objects (in theirroles).

Description
This parameter contains document header data for the inquiry.
INCLUDE BOS_BAPI_ANKREUZLEISTE OBJECT DOKU ID TX

Value range
Field UPDATEFLAG contains the value SPACE or I(for creation).
The checkboxes are not to be filled.

Default
For field UPDATEFLAG:
SPACE,,create a new inquiry

Description
Indictaor for item number assignment
There are two options for number assignment:


• If you do not set the indicator, you must assign the item numbers
manually using field ITM_NUMBER in table parameter
InquiryItemsIn.

• If you set the indicator, the system assigns the item numbers (internal
number assignment) according to your settings in Customizing. Forinternal number assignment, field ITM_NUMBER in table parameterInquiryItemsIn must remain initial.
Example
In some cases you must use internal number assignment, for example, forarticles for which a BOM is exploded in the inquiry.
An inquiry with two items and one schedule line each is to be created.For this, there are the item numbers 10 and 20 in InquiryItemsInand InquirySchedulesIn. If the article for item 10 contains asales BOM, it can be exploded and a sub-item with item number 20 iscreated. This means that the reference (VBEP) to item (VBAP
) no longer exists. Internal number assignment is essential here.

Value range
Space,,external number assignment
X,,internal number assignment

Default
Space
INCLUDE BOS_BAPI_LOGICSWITCH OBJECT DOKU ID TX

Description
This parameter is for entering the SD document number.

Value range
There are two options for assigning the SD document number:


• You can assign the SD document number manually by entering it in the
appropriate field

• You can leave this parameter initial. The system then assigns the SD
document number according to your Customizing settings.

Description
This parameter is for entry of the sending system.
The entry is required if object references are to be written.

Description
The paramter serves as a test indicator.
If the indicator is set, the document is not saved.

Value range
Space,,document is saved.
X,,document is not saved.

Default
Space
INCLUDE BOS_BAPI_EXTENSIONIN OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX
INCLUDE BOS_BAPI_KONFIGURATION OBJECT DOKU ID TX

Description
This parameter contains condition data for the document item.
INCLUDE BOS_BAPI_KONDITION OBJECT DOKU ID TX

Description
This parameter contains the item data for the inquiry.
You must fill the follwing fields, at least, in order to be able to tocreate a service entry sheet.


• If you choose external number assignment via parameter
IntNumberAssignment, you must enter the item number in the
ITM_NUMBER field.

• If you choose internal number assignment via parameter
IntNumberAssignment, the system assigns the item numbers.Internal number assignment takes place according to your settings inCustomizing. Field ITM_NUMBER must remain initial.

• If you want to be able to create a BOS, a material with the appropriate
settings in field MATERIAL must be transferred.

• The PCKG_NO of the document item must correspond to the
PCKG_NO of the initial node (uppermost outline level withhierarchy level 0) in transfer parameter InquiryServices.
You can find information on the meaning of the individual parameterfields in the appropriate data element documentation in the ABAPdictionary.
INCLUDE BOS_BAPI_ANKREUZLEISTE OBJECT DOKU ID TX

Value range
Field UPDATEFLAG contains the value SPACE (for creation).
The checkboxes are not to be filled.

Default
For field UPDATEFLAG:,,SPACE,,
Checkboxes:,,SPACE
INCLUDE BOS_BAPI_PARTNERDATEN OBJECT DOKU ID TX
INCLUDE BOS_BAPI_EINTEILUNGSZEILEN OBJECT DOKU ID TX
There must be exactly one schedule line with quantity 1 for a documentitem with a BOS.
For this, you have to enter the following data (at least):
ITM_NUMBER,,item number
SCHED_LINE,,schedule line number
REQ_DATE,,schedule line date
REQ_QTY,,quantity in sales unit of measure
INCLUDE BOS_BAPI_ANKREUZLEISTE OBJECT DOKU ID TX

Value range
Field UPDATEFLAG contains the value SPACE (for creation).
The checkboxes are not to be filled.

Default
Field UPDATEFLAG:,,SPACE,,
Checkboxes: ,,SPACE

Description
This transfer parameter contains the service lines and the outlinelevels of the bills of services for the inquiry that is to be created.
INCLUDE BOS_BAPI_SERVICE_IDENTIFY OBJECT DOKU ID TX
INCLUDE BOS_BAPI_CREATESERVICELINE OBJECT DOKU ID TX
INCLUDE BOS_BAPI_CREATEOUTLINE OBJECT DOKU ID TX


• You can assign the PCKG_NO freely. The system converts the
number you enter into an internal value.
The top node of a BOS (uppermost outline level withhierarchy level 0) must be in the transfer parameter. For this, createan outline level and transfer the PCKG_NO and LINE_NO.The PCKG_NO must correspond to field PACKNO of theappropriate document item in the transfer structure InquiryItem.
INCLUDE BOS_BAPI_SERVICESTEXTS OBJECT DOKU ID TX

Value range
The following entries are possible for field TEXT_ID:
LTXT,,line long text / outline long text
LLTX,,service long text
If FORMAT_COL is empty, the standard format key * is assigned.
INCLUDE BOS_BAPI_TEXTE OBJECT DOKU ID TX

Description
If errors occur during processing, they are returned in the tableparameter Return. Information messages are also logged in thistable parameter.

Value range
If no error occurs, the return parameter is initial. Otherwise, theappropriate error messages with short text are displayed.