Ansicht
Dokumentation

FKK_SAMPLE_8021 - BILL: Maintain Billing Account Header Data (BAPI)

PERFORM Short Reference   PERFORM Short Reference  
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 8021 you process the header data of the billing account.

BAPI_FKKBI_BILLACCOUNT_UPDATE

BAPI_FKKBI_BILLACCOUNT_UPDATE enables you to create and change billing accounts. Using the import parameter BILLACCINSERT or BILLACCUPDATE, this BAPI receives the data from an external system. It converts the external data to an internal format of the SAP system and saves it.

Conversion and assignment of fields, data transfer, parameters

If you add own fields to the EDR 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 in table EXTENSIONIN. See the notes for customer enhancement of BAPIs (CA-BFA) in SAP Help Portal (help.sap.com).

The system calls event 8021 if the import parameters BILLACCINSERT or BILLACCUPDATE is filled. The external data is provided to the event using the import parameters I_HEAD_INS_BAPI or I_HEAD_UPD_BAPI. 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. The customer-specific fields can now be written to the changing parameter C_HEAD_CUST.

Parameter C_HEAD_CUST

Parameter C_HEAD_CUST contains your customer-specific header data of the billing account that is to be saved and processed in the system. You can enhance the structure FKKBIBILLACC_H_CI_SI belonging to this parameter using the includes CI_FKKBIBILLACC_H and application-specific S includes.

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

Output of error messages

If you want to issue an error in event 8021, 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 values of this table are transferred 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 8021: 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 for the function module BAPI_FKKBI_BILLACCOUNT_UPDATE.

Further information

Parameters

C_EXTENSIONOUT_TAB
C_HEAD_CUST
E_RETURN_TAB
I_EXTENSIONIN_TAB
I_HEAD_INS_BAPI
I_HEAD_UPD_BAPI

Exceptions

Function Group

FKKBI_EDR_EVENT

Addresses (Business Address Services)   Addresses (Business Address Services)  
This documentation is copyright by SAP AG.

Length: 3558 Date: 20240523 Time: 065636     sap01-206 ( 78 ms )