SAP Function SAMPLE_INTERFACE_00010910 - Check Number Assignment: Request New Numbers

Parameter Reference Type Length Default Optional Text
I_ACNUM_EXT IBKKA2-ACNUM_EXT C 35 Account Number
I_BANKL IBKK_BKKRS-BANKL C 15 X Bank Key
I_BANKS IBKK_BKKRS-BANKS C 3 X Bank Country
I_BKKRS IBKKA1-BKKRS C 4 Bank Area
I_CASHB_TYPE IBKKA1-CASHB_TYPE C 4 Check Type
I_ISSUEDATE BKKA1-CASHB_IDAT D 8 Issue Date
I_NCHEQUES IBKK_CHEQ-NCHEQUES N 7 Number of Requested Checks

Parameter Reference Type Length Text
E_CHEQNO_FROM IBKKA2-CASHB_EX C 20 Check Number From
E_CHEQNO_TO IBKKA2-CASHB_EX C 20 Check Number to
E_RC SYST-SUBRC I 4 Return Code (=0: Everything O.K, <>0: Error)
E_STATE BKKA1-CASHB_STAT C 2

Parameter Reference Length Optional Text
T_MESG IBKKMESG 224 Table for Messages

Functionality
By calling up this event ("Request Check") you can request checknumbers from the central check system.
You transfer for which account (I_ACCOUNT_EXT) of a bank (bank countryI_BANKS, bank ID number I_BANKL) you want to issue checks. ParameterI_NCHEQUES indicates how many checks are required.I_ISSUEDATE shows the issue date, I_CASHB_TYPE shows the check type(EC check,...). The system expects you to enter a check number range(E_CHECKNO_FROM, E_CHECKNO_TO).
If this event returns value E_STATE = '07', the checks are created inthe system with status 'Issue Requested'. In this case, you have toconfirm printing of the checks. There are two ways of doing this:
-Call RFC-enabled function module BKK_RFC_SET_STATE_ISSUED
-Menu -> Check Management -> Confirm Print
The checks do not count as being issued until you have confirmed theprinting. If you try and cash a check with status 'Issue Requested', anerror occurs.
If the event returns value E_STATE <> '07', the checks are given status'Issued'. You cannot confirm check printing and the checks count asissued.
Normally, the return code will be 0, but in the case of error, a value >0.

Example
Sample function module SAMPL_INTERFACE_00010910 makes use of theindicator stored in the Customizing settings that defines whetherthe check number is unique per account or per bank area. If theindicator is set, the sample function module assigns the positionnumbers in a bank area per position type and account.
If the indicator is not set, it supplies the next unused positionnumbers per position type.
Example: In bank area 01 there is an account A and an account B. AEuro-check with position number 1 is assigned for account A. You alsowant to create a Euro-check for account B.
If the indicator is set, this sample function module issues a checkwith position number 1(E_CHECKNO_FROM = 1 and E_CHECKNO_TO = 1). If the indicator is not set,the check is issued with position number 2(E_CHECKNO_FROM = 2 and E_CHECKNO_TO = 2).

Description
Check number (external) from

Description
Check number (external) to

Description
Return code (= 0: everything O.K, < > 0: error(s))

Description
Account number (external)

Description
Bank key (bank identification number)

Description
Bank country

Description
Bank area

Description
Check type

Description
Issue date

Description
Number of checks requested