SAP Function BAPI_BKK_ACCNT_GET_AV_AMOUNT - Get Available Amount

Parameter Reference Type Length Default Optional Text
BANKAREA BAPI_IBKK_ACCNT_IDENTIF-BANKAREA C 4 Bank Area
EXTERNALACCOUNTNO BAPI_IBKK_ACCNT_IDENTIF-EXTERNALACCOUNTNR C 35 External Account Number
LANGUAGE BAPI_IBKK_ACCNT_COMM_PARAM-LANGUAGE C 1 SY-LANGU X Language Key
LANGUAGEISO BAPI_IBKK_ACCNT_COMM_PARAM-LANGUAGE_ISO C 2 X Language according to ISO 639
PROCESSEXTENSION BAPI_IBKK_ACCNT_COMM_PARAM-PROCESS_EXTENSION C 1 X Indicator, Extension IN/OUT

Parameter Reference Type Length Text
ACCOUNTIDENTIFICATION BAPI_IBKK_ACCNT_IDENTIF u 162 Account Identification
ACTLIMBAL BAPI_IBKK_ACNT_LIMIT_BAL u 76 Current Balance and Limits

Parameter Reference Length Optional Text
AVAMOUNTS BAPI_IBKK_AVAMOUNTS 83 X Available Amounts of Account
EXTENSIONIN BAPIPAREX 990 X Ref. structure for BAPI parameter ExtensionIn/ExtensionOut
EXTENSIONOUT BAPIPAREX 990 X Ref. structure for BAPI parameter ExtensionIn/ExtensionOut
RETURN BAPIRET2 548 X Return Parameter

Functionality
Use this method to retrieve the following details for an account:

  • Available amount

  • Current balance

  • Limit details

    • The method logs the errors that occurred during the processing in thereturn parameter (RETURN).
    Note: The method Get Available Amount does not update thedatabase.
    To transfer the available amount details, you must specify values in theimport parameters Bank Area (BANKAREA) and External AccountNumber (EXTERNALACCOUNTNO). Additionally, you can transfer a valuefor either of the import parameters Language Key (LANGUAGE) orISO Language Key (LANGUAGEISO).
    INCLUDE BAPI_BKK_LANGUAGE

    Notes
    This method works with buffering. This means that other change methodsof instances created or changed by this method can be executed in thesame Logical Unit of Work (LUW).
    Customer Enhancements
    INCLUDE BAPI_CUST1
    INCLUDE BAPI_CUST_INOUT
    INCLUDE BAPI_CUST2
    INCLUDE BAPI_CUST_ENH_FURTHER_INFO
    Return Messages
    INCLUDE BAPI_RET

    Description
    This parameter returns details of the account identifiers (such as theinternal and external account numbers).
    INCLUDE BAPI_DATAELEMENT

    Description
    This parameter returns details of the account balance on the currentposting date and the limits (both internal and external) for theaccount.
    INCLUDE BAPI_DATAELEMENT

    Description
    This parameter contains the bank area for an accountand is a mandatory value to retrieve the available amounts for anaccount. The system returns an error message if you transfer an invalidvalue.

    Value range
    The value range for this parameter corresponds to the values that youdefine in the IMG activity Define BankArea.

    Description
    The external account number parameter contains theunique identifier for an account and is a mandatory value.
    If the account number is numeric, it can be transferred with leadingzeros (internal display) or without leading zeros (external display).The system returns an error message if you specify an invalid value.

    Description
    This parameter determines the language in which the descriptive textsand notes are transferred.

    Value range
    You can specify the language in either of the parameters LanguageKey (LANGUAGE) or ISO Language Key (LANGUAGE_ISO).
    INCLUDE BAPI_BKK_LANGUAGE

    Default
    The default value for this parameter is the logon language (SY-LANGU).

    Description
    This parameter determines the language in which the additional texts andnotes are transferred.
    Note: This parameter is used only if you have not selected theLanguage Key (LANGUAGE) parameter.

    Value range
    You can specify the language in either of the parameters LanguageKey or ISO Language Key (LANGUAGE_ISO).
    INCLUDE BAPI_BKK_LANGUAGE

    Description
    This parameter specifies whether the details entered by the customers ina Business Add-In of this method, must be retrieved.
    You will find information on the meaning of the parameter in thedocumentation for the data element Execute Extension(s)(BAdI).

    Value range
    ' ' (no value)
    This value means that the customer enhancements are not executed.
    'X'
    This value means that the customer enhancements are executed.

    Description
    This parameter contains details of the available amount (such as thecurrent posting data and the available amount) for an account. Thesystem computes the following available amounts:
    Description,, Available amount is equal to:
    Available amount (without limit),, Account balance - Total value ofholds
    Available amount (external),, Account balance - Total value of holds +Total value of external limit
    Available amount (internal),, Account balance - Total value of holds +Total value of internal limits
    INCLUDE BAPI_DATAELEMENT
    INCLUDE BAPI_EXTIN
    INCLUDE BAPI_EXTOUT

    Description
    INCLUDE BAPI_TABLE

    Value range
    Messages for Value Checks
    Type ID,, Message Number,, Messages
    1E,, 071,, Account number &1 does not exist in bank area &2
    1P,, 176,, No authorization to & from & ( display/account)
    Additional Messages
    Type ID,, Message Number,, Messages
    1BKKBAPI,, 101,, BAPI call failed
    1BKKBAPI,, 218,, Message protocol could not be opened
    1BKKBAPI,, 213,, Internal Error &1 occured during generating directinput data
    1BKKBAPI,, 008,, Activity &1 for object &2 is not maintained
    1BKKBAPI,, 012,, Instance of BADI definition &1 could not be created
    1BKKBAPI,, 013,, Error on opening instance of object type &1. Externalreference &2 &3