Functionality
The method adds one or more items to a broker report.

• In the REPORTID parameter, you enter the identification for the
BrokerReport Business Object
to which items are to be added.

• The broker report must have one of the following statuses:

Items can still be added (manual processing
Report processed with BAPI

• Item data is stored in BROKERREPORTITEM.


• Selected items for a broker report item are stored in the
BROKERREPORTSELITEM parameter.

• Customer fields can be supplied using the EXTENSIONIN parameter.


• Event V545 runs to check the customer fields
for the broker report item.

• If the data for at least one delivered broker report item contains
errors, no broker report item is created.

• If the broker report items were created, the identifications for the
created items are stored in the BAPIBROKREPITEMNUMB parameter.

• The method is executed in the test run if the TESTRUN parameter
is filled with 'X'.

• Event V581 runs at the start of the method,
and you can use it to check the parameters for the method.

• Event V593 runs at the end of the method, and
you can use it to fill the ExtensionOut parameter.

Notes


• You require the authorization to change a broker report (activity 02 in
the I_VVBR_STM authorization object).

• If open items are specified for a broker report item, the clarification
code is checked and set, if required:
If no clarification code is specified in the broker report item, theclarification code defined in the default data for the broker report isset, dependent on the relationship between the reported amount and theclearing amount for the selected open items (equal amounts, under- oroverpayment).
If a clarification code is specified in the broker report, a check ismade to see whether the clarification code is permitted for therelationship between the reported amount and the clearing amount for theselected open items (equal amounts, under- or overpayment). If this isnot the case, the system replaces the clarification code that is definedin the default data for the broker report.
If the clarification code is enhanced or replaced by the system,information message I055 (IBRO) is stored in the RETURN parameter.
INCLUDE BAPI_CD_BROREP_BROREPID OBJECT DOKU ID TX
INCLUDE BAPI_CD_BROREP_TESTRUN OBJECT DOKU ID TX
INCLUDE BAPI_CD_BROREP_ITEM OBJECT DOKU ID TX
INCLUDE BAPI_CD_BROREP_ITEMNUMB OBJECT DOKU ID TX
INCLUDE BAPI_CD_BROREP_SUBPOSITIOND OBJECT DOKU ID TX
INCLUDE BAPI_CD_BROREP_SELITEM OBJECT DOKU ID TX

Note


• The system checks whether the open items match the selection
specifications in the broker report item.

• If required, the clarification code for the associated broker report
item is enhanced or set, according to the relationship between thereported amount and the clearing amount.
INCLUDE BAPI_CD_BROREP_EXTENSIONINP OBJECT DOKU ID TX

Notes


• Fill the SUB_POSITION in the BAPI_TE_IBROSTMP structure with the
line for the associate broker report item in the BROKERREPORTITEMparameter.

Description
You can fill the ExtensionOut parameter by using theV593 event.


INCLUDE BAPI_CD_BROREP_RETURN OBJECT DOKU ID TX
After calling, the RETURN parameter contains:
o If the method was called up in the test run: Information messageI501(IBRO).
o If the broker report items were created: Success message S012(BAPI).
o If the broker report items were not created: Error messageE013(BAPI) and an appropriate error message about why the broker reportitems were not created.


• Information message I055(IBRO), if the clarification code for a broker
report item was enhances or replaced.