Show TOC

Object documentationCancellation

 

Business object for Account Management (FS-AM) that you can use to trigger the cancellation of a loan. For more information, see Loans.

If the borrower wants to cancel a loan, you create a binding cancellation order by creating and activating an order from the category cancellation. This cancellation order informs the borrower and the payment distribution system of the gross cancellation amount. This comprises the following data:

  • Effective capital of the loan

  • Interest at due date

    Note Note

    If you have set the interest calculation condition up so that interest is calculated when settlement is triggered, unbilled interest that was due until the settlement run is displayed as interest under Overdue Items in the Gross Balance details during an incoming payment when an unscheduled settlement is triggered.

    End of the note.
  • Rebate of insurance premiums

Structure

The structure description of the Cancellation function is divided into attributes, methods and customer enhancements. For more information, see Order Management.

Attributes

  • Reason for Cancellation

  • Reason for reversal for Cancellation

  • Correspondence for activation

  • Correspondence for reversal

Methods

In Account Management (FS-AM), you can use the following channel for processing objects:

  • Dialog

Dialog

The Cancellation function can use the Entry Origin or Processing Origin field to identify the channel used to process it. This can be the dialog channel for which the system displays the entry origin BOCANC (Loan Cancellation Dial). You can call the dialog processing using transaction BCA_OR_CNCL.

You can call the following methods using dialog processing:

  • Create and enter

  • Create and activate (internally it triggers immediate execution)

  • Change and enter

  • Change and delete

  • Change and activate (internally it triggers immediate execution)

  • Change and reverse

  • Display

Business Application Programming Interface

BAPIs are not available.

Direct Input

Direct input is not implemented for cancellation. The payment distribution system can reverse or execute the order using an RFC connection. The system then displays BACNCL (Loan Cancellation RFC) as the processing origin.

The methods can change the order status of the cancellation.

Customer Enhancements

You can use the following Business Add-Ins (BAdIs) for the cancellation of a loan:

BAdI Definition

Interface

Method

BCA_OR_CNCL_CHECKS

IF_BCA_OR_CNCL_CHECKS

CHECK_ENTRY

CHECK_CONSISTENCY

BCA_OR_CNCL_ORDER_EVENTS

IF_BCA_OR_CNCL_ORDER_EVENTS

ACTIVATE

CLOSE

CREATE

DEACTIVATE

DELETE

OPEN

PREPARE

RESET_ACTIVITY

REVERSE

SAVE

SET

BCA_OR_CNCL_AUTH

IF_BCA_OR_CNCL_AUTH

AUTHORIZE_F_BOCL_FCT

AUTHORIZE_F_BOCL_ORG

AUTHORIZE_F_BOCL_RSN

AUTHORIZE_F_BOCL_ACT

BCA_OR_CNCL_CORR

IF_BCA_OR_CORRESPONDENCE

IF_FKK_CORR_OUTPUT_REQUEST~OUTPUT_CORR_REQUEST

IF_BCA_OR_CREATE_CORR_REQ~CREATE_CORR_REQUEST

Integration

When you process rescissions, the corresponding release object and the various authorization objects have a controlling function for the program flow.

The system calls the following objects from Account Management (FS-AM) for processing:

Objects Checked by the System

The system checks the account and displays messages accordingly if one or more of the following requirements have not been met:

  • The loan account exists.

  • The account has the contract status Active, Used.

  • The account is not In Release.

  • The account has the 0030 Cancellation feature, the traffic light symbol is green and this feature is not locked.

    For more information, see Editing Features.

  • The system runs authorization checks.

  • You have made entries in all of the mandatory fields.

  • The planned payment date of the cancellation amount is defined.

  • The planned execution date is defined.

  • The declaration date for the order is inside of the legal period for the loan account.

  • The outstanding net cancellation amount is greater than zero.

  • The planned payment date is a working day.

Objects Changed by the System

The order itself does not change any objects directly.

Objects Generated by the System

  • Change document

    The system generates a change document that meets auditing requirements.

  • Work item

    The system generates a work item for the release process, if required on the basis of the Customizing settings. For more information, see Release Object: OR_CNCL (Cancellation).

  • Posting lock document in Posting Lock Management (PLM) to lock other business operations.

  • Payoff order (full binding payoff) to handle the payment processing of the cancellation.

  • If required, the system generates correspondence for the following operations:

    • Activate

    • Reverse