Ansicht
Dokumentation

FKK_SAMPLE_8023 - BILL: Maintain Billing Account Items (BAPI)

ROGBILLS - Synchronize billing plans   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Functionality

In the function modules processed in event 8021 to 8023, you can add customer-specific fields to the billing account. With event 8023 you process the items of the billing account.

BAPI_FKKBI_BILLACCOUNT_UPDATE

BAPI_FKKBI_BILLACCOUNT_UPDATE enables the creation of items of a billing account. Using the import parameter table I_ITEMS_BAPI_TAB, this BAPI receives the data from an external system. The BAPI converts the external data in an internal system format and saves it.

Conversion and assignment of fields, data transfer, parameters

If you add own fields to the billing account in the SAP system, in this event you must convert the own fields and assign them to the internal structure. You have to transfer the data for customer-specific fields when you call BAPI_FKKBI_BILLACCOUNT_UPDATE using table EXTENSIONIN. See the notes for customer enhancement of BAPIs (CA-BFA) in SAP Help Portal (help.sap.com).

The system calls event 8023 if table BILLACCINSERTITEM is filled. The system provides event 8023 with the external data using the import parameter I_ITEMS_BAPI_TAB. However, the related structures only contain the standard predefined fields.

The import table I_EXTENSIONIN is the container for additional data. It contains all entries that you have transferred to function module BAPI_FKKBI_BILLACCOUNT_UPDATE in table EXTENSIONIN.

Parameter table C_ITEMS_CUST_TAB

Parameter table C_ITEMS_CUST_TAB contains the data of the billing account items as you should save and process them in the system. Before event 8023 is called, the system transfers the data of the import parameter table I_ITEMS_BAPI_TAB to parameter table C_ITEMS_CUST_TAB. In parameter table C_ITEMS_CUST_TAB, the fields of the SAP standard are already filled - you must not change them.

You can enhance the structure FKKBIBILLACC_I_IDENTNO belonging to this parameter table via the customer include CI_FKKBIBILLACC_I and application-specific S includes.

You can fill these customer-specific and application-specific fields in this event using I_EXTENSIONIN.

Using the identification number

In order to reconcile the tables with one another, it must be possible to uniquely assign the individual entries of tables I_EXTENSIONIN and I_ITEMS_BAPI_TAB to one another. The identification number IDENTNO enables you to do this.

You can select the content of this field as required - it must agree in the respective tables though. If the identification number of one table does not correspond to the identification number of the other table, processing terminates.

Output of error messages

If you want to issue an error in event 8023, use function module BALW_BAPIRETURN_GET2 to create an error message that you export using parameter E_RETURN.

Example

Notes

• If necessary, you can change the export parameter C_EXTENSIONOUT. The system transfers the values of this table to the caller of the function module BAPI_FKKBI_BILLACCOUNT_UPDATE in the export table EXTENSIONOUT.

• Under certain circumstances, the function module BAPI_FKKBI_BILLACCOUNT_UPDATE has to process a large number of billing accounts. You should therefore avoid runtime-intensive processing steps in event 8023: Do not use database accesses to non-buffered master and transaction data.

• The function module BAPI_FKKBI_BILLACCOUNT_UPDATE can also automatically transfer customer-specific fields for which no conversion is necessary. See also the documentation of the function module BAPI_FKKBI_BILLACCOUNT_UPDATE.

• The function module for event 8023 fills customer-specific and application-specific fields. You must not change SAP standard fields. You must also not change the underlying structure of the billing account here. In particular, you must not add or delete items. The system ignores such changes.

Further information

Parameters

C_EXTENSIONOUT_TAB
C_ITEMS_CUST_TAB
E_RETURN_TAB
I_EXTENSIONIN_TAB
I_ITEMS_BAPI_TAB

Exceptions

Function Group

FKKBI_EDR_EVENT

RFUMSV00 - Advance Return for Tax on Sales/Purchases   ABAP Short Reference  
This documentation is copyright by SAP AG.

Length: 4645 Date: 20240523 Time: 035705     sap01-206 ( 93 ms )