Fonction SAP BAPI_BKK_BALNOT_CREATE_SINGLE - Create Balance Notification

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
BANKAREA BAPI_IBKK_ACCNT_IDENTIF-BANKAREA C 4 X Bank Area
BANKNUMBER BAPI_IBKK_ACCNT_IDENTIF-BANKNUMBER C 15 X Bank Key
BANK_COUNTRY_KEY BAPI_IBKK_ACCNT_IDENTIF-BANK_COUNTRY_KEY C 3 X Bank country key
BANK_COUNTRY_KEY_ISO BAPI_BKK_DTE_INTCA C 2 X Country ISO code
EXTERNALACCOUNTNO BAPI_IBKK_ACCNT_IDENTIF-EXTERNALACCOUNTNR C 35 External Account Number
KEYDATE BAPI_IBKK_STAT_RUNDATA-STATDATE D 8 Key date
PROCESS_EXTENSION BAPI_IBKK_ACCNT_COMM_PARAM-PROCESS_EXTENSION C 1 X Indicator, Extension IN/OUT
TESTRUN BAPI_IBKK_ACCNT_COMM_PARAM-TESTRUN C 1 X Execution in Test Run Mode ('X' = Yes, ' '= No)

Paramètre Reférence Long. Facultatif Description
BALNOTHEADER BAPI_IBKK_BALNOT_HEADER 382 X Balance Notification Header
BALNOTRECEIVER BAPI_IBKK_STAT_ADRESS 1825 X Correspondence Address
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 create a balance notification for an account on aspecific date. The Create Balance Notification methodreturns the following values:

  • Balance notification details such as the account identification details,
  • the account balance, and the date of the balance notification
    • Name and address details of the balance notification recipient

    • The method logs details of errors in the return parameter (RETURN).
      To create a balance notification, it is mandatory to specify a value inthe External Account Number (EXTERNALACCOUNTNO) and Key Date
      (KEYDATE) parameters.
      To ensure that the account is correctly identified, you must specify avalue for either of the following import parameters:
      • Bank Key (BANKNUMBER) and Bank Country Key
      • (BANK_COUNTRY_KEY)
        • Bank Area (BANKAREA)
        • 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), without a prior posting beingnecessary.
          Customer Enhancements
          INCLUDE BAPI_CUST1
          INCLUDE BAPI_CUST_INOUT
          INCLUDE BAPI_CUST2
          Return Messages
          INCLUDE BAPI_RET

          Further information
          For more information, see Generating Balance Notifications
          in the SAP Library under SAP ERP Central Component -> Financials ->SAP Banking -> Bank Customer Accounts (BCA).

          Description
          This parameter allows you to specify thebank area for the balance notification.
          The method Create Balance Notification(BAPI_BKK_BALNOT_CREATE_SINGLE) internally identifies the account byusing any of the following parameters:

          • Bank Key (BANKNUMBER) and Bank Country Key
          • (BANK_COUNTRY_KEY)
            • Bank Area (BANKAREA)

            • Note: The system returns an error message if you do not specify avalue for either of these parameters.

              Description
              The bank key parameter identifies thebank that will process the balance notification.
              The method Create Balance Notification(BAPI_BKK_BALNOT_CREATE_SINGLE) internally identifies the account byusing any of the following parameters:

              • Bank Key (BANKNUMBER) and Bank Country Key
              • (BANK_COUNTRY_KEY)
                • Bank Area (BANKAREA)

                • Note: The system returns an error message if you do not specify avalue for either of these parameters.

                  Description
                  The bank country key parametercontrols the validation of external account numbers.
                  The method Create Balance Notification(BAPI_BKK_BALNOT_CREATE_SINGLE) internally identifies the account byusing any of the following parameters:

                  • Bank Key (BANKNUMBER) and Bank Country Key
                  • (BANK_COUNTRY_KEY)
                    • Bank Area (BANKAREA)

                    • Note: The system returns an error message if you do not specify avalue for either of these parameters.

                      Description
                      This parameter contains the country for theBank Area parameter (BANKAREA).
                      The system returns an error message if you enter an invalid value.

                      Description
                      This parameter identifies the account for which the balance notificationis to be created and is a mandatory value for creating a balancenotification. This account must have the internal status Active.
                      The system returns an error message if you enter an invalid value.

                      Description
                      This parameter contains the date on which the balance notification is tobe created and is a mandatory value to create a balance notification.

                      Description
                      This parameter specifies whether the details entered by the customers ina Business Add-In of this method, must be retrieved.
                      For information on the meaning of the parameter, see the documentationfor 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
                      Set this parameter to execute the method in the simulation mode. Allchecks are then carried out, without an entry being made in thedatabase.
                      This is used for write BAPIs to check the entries for the objectinstance in the database before actually creating the instance. Theobject instance is not actually created; it is merely simulated.

                      Value range
                      ' ' (no value)
                      This value means that the database is updated.
                      'X'
                      This value means that the BAPI is called in simulation mode and that nodata is written to the database.

                      Description
                      This parameter contains the balance notification details such as theaccount balance, the notification period, and the account identificationdetails.
                      For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.

                      Description
                      This parameter contains the details of the balance notificationrecipient such as the business partner number and the address details.
                      For more information about the individual parameter fields, see the dataelement documentation in the ABAP Dictionary.
                      INCLUDE BAPI_EXTIN
                      INCLUDE BAPI_EXTOUT
                      INCLUDE BAPI_TABLE

                      Value range
                      Messages for Value Checks
                      Type ID,, Message Number,, Messages
                      1B,, 001,, Bank area &1 does not exist
                      1E,, 030,, Account number & does not exist: Check your entry
                      1E,, 037,, Internal account number & does not exist: Check your entry
                      1E,, 071,, Account number &1 does not exist in bank area &2
                      1E,, 072,, Internal account number &1 does not exist in bank area &2
                      1E,, 073,, Account & does not exist
                      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 occurred during generating directinput data
                      1BKKBAPI,, 012,, Instance of BADI definition &1 could not be created
                      1BKKBAPI,, 013,, Error on opening instance of object type &1. Externalreference &2 &3