EmployeeBankDetail

Definition

The Bank details business object contains specifications about
employees' bank accounts so that, for example, transfers can take place.

Use

Information about bank details is stored in the Bank details infotype (0009) of Personnel Administration.

An employee can have amounts transfered to his accounts, for example, for the following transfer cases:

Structure

The Bank detail business object contains several bank types. The
different bank types are represented in the subtypes of the Bank details
infotype (0009) according to the transfer purpose. The following subtypes are available in the standard system:

Available Methods

• Approve : Unlock bank details [ BAPI_BANKDETAIL_APPROVE ]
  
• Change : Change bank details [ BAPI_BANKDETAIL_CHANGE ]
  
• Create : Create bank details [ BAPI_BANKDETAIL_CREATE ]
  
• Createsuccessor : Create subsequent bank details record [ BAPI_BANKDETAILCREATESUCCESSOR ]
  
• Delete : Delete bank details [ BAPI_BANKDETAIL_DELETE ]
  
• Delimit : Delimit bank details [ BAPI_BANKDETAIL_DELIMIT ]
  
• Getdetail : Display bank details [ BAPI_BANKDETAIL_GETDETAIL ]
  
• Getdetailedlist : Read instances with data [ BAPI_BANKDETAILGETDETAILEDLIST ]
  
• Getlist : Read instances [ BAPI_BANKDETAIL_GETLIST ]
  
• Request : Create locked bank details record [ BAPI_BANKDETAIL_REQUEST ]
  
• Simulatecreation : Simulation: Create bank details [ BAPIBANKDETAILSIMULATECREATION ]
  

Approve

You can use this method to unlock a Bank Details record (0009).

It enables you to implement the "double verification principle" inconjunction with the REQUEST method. According to this principle, atleast two users must take part in writing an active record to the
database. One user creates a locked record using the REQUEST method.The other user unlocks or 'activates' this record using the APPROVE method.

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

For more information on the REQUEST method, read the documentation on the function module BAPI_BANKDETAIL_REQUEST.

Change

You can use this method to change a Bank Details record (0009).

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

Create

You can use this method to create a Bank Details record (0009).

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

Createsuccessor

You can use this method to create a subsequent Bank Details record (0009).

Example:

An employee wants his pay to be transferred to a bank account that he has just opened as of 01/01/1997.

You can use the CREATESUCCESSOR method to create a subsequent Bank Details
record (0009) for the new bank account on 01/01/1997. The subsequent record contains the data of the previous record, only thenew account number has to entered in Bank account field.

The previous record is delimited on 12/31/1996.

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE
beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

Delete

You can use this method to delete a Bank Details record (0009).

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

Delimit

You use this method to chronologically delimit a data record for the Bank details infotype (0009).

Notes

Messages are returned in the RETURN parameter. The return codes and their meanings can be found in this parameter documentation.

The key fields used by the method are described under the parameters.

This method can only be used if the ENQUEUE method of the EMPLOYEE business object has been called up first. For more information about the ENQUEUE method, see the documentation on the
BAPI_EMPLOYEE_ENQUEUE function module.

Getdetail

You can use this method to read a Bank Details record (0009).

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

Getdetailedlist

Using this method, you can read data records on the Bank Detailsinfotape (0009) which fall within the given time period.

Notes

Messages will be returned in the RETURN parameter. You will find return codes and their meanings in the parameter documentation.

Key fields used in this method are described in the parameter.

Getlist

You can use this method to read the keys (instances) of Bank Details records (0009) which are within the specified time interval.

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

Request

You can use this method to create a locked Bank Details record (0009).

It enables you to implement the "double verification principle" inconjunction with the APPROVE method. According to this principle, atleast two users must take part in writing an active record to the
database. One user creates a locked record using the REQUEST method.The other user unlocks or 'activates' this record using the APPROVE method.

Notes

Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.

You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

For more information on the APPROVE method, read the documentation on the function module BAPI_BANKDETAIL_APPROVE.

Simulatecreation

You can use this method to simulate creation of a Bank Details record (0009).

During the simulation all necessary consistency checks are performed, but the record is not written to the database.

Notes

Messages are transferred to the RETURN parameter. The relevant
parameter documentation contains the return values and their meanings.

The key fields used by the method are described in the parameter documentation.