Entering content frame

Object documentation Card Pool Cancellation Locate the document in its SAP Library structure

Definition

An Account Management (FS-AM) business object that represents the cancellation of a card pool, taking special cancellation rules into account.

Use

Use this object to terminate card pool contracts. Card pool cancellation is depicted as an order from theCard Pool Cancellation (CGC) category in Account Management (FS-AM).

A card pool can be canceled if the following prerequisites are met:

...

·        The card pool has the status Active.

·        The card pool has not been canceled.

·        The participant cards are active, returned, or locked.

Note

If a participant card is locked (locks are managed on participant card level only), every lock reason must have the Cancellation Allowed indicator.

An order for card pool cancellation can only be created or changed if it has the status Activated or Activated in Release.

The cancellation order can be changed or reversed, as long as the card pool does not have the status Executed or Deactivated and the processor has not yet been informed of the cancellation. You cannot make any changes to the order once the Status Executed flag has been transferred.

The follow-up action is stored in the card pool product for each product of a participant card when a card pool is canceled. Possible follow-up actions:

·        Cancel

·        Set lock

·        Set system renewal lock

Structure

An order for card cancellation consists of the following subprocesses:

...

       1.      Check card pool data

       2.      Generate default values

       3.      Check cancellation data

       4.      Create cancellation order

       5.      Register cancellation in the Card Management system

The structure definition for card pool cancellation is divided into attributes, methods, and customer enhancements. Everything in the Order Management section also applies to card cancellation.

Attributes

·        Order Management attributes.

·        Cancellation reason

·        Date of receipt of cancellation

·        Immediate execution

Methods

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

·        Dialog

·        Business Application Programming Interface (BAPI)

·        Direct Input (DI)

The card pool cancellation function uses the Entry Origin or Processing Origin fields to identify the channel used to process it.

Entry Origin
Processing Origin

Short Description

Channel

BOCG

Order for card pool cancellation (dialog)

Dialog

BAPCG

Order for card pool cancellation (BAPI)

BAPI

BDTCG

Order for card pool cancellation (EDT)

BAPI

The following overview shows which channel to use for calling up the different methods for card cancellation:

Method

Channel

Dialog

BAPI

DI

Create and enter

x

 

 

Create and activate

x

x

 

Create, activate, and execute immediately

x

x

 

Change and enter

x

 

 

Change and delete

x

 

 

Change and activate

x

x

 

Change, activate, and execute immediately

x

x

 

Deactivate

x

x

 

Display

x

 

 

Read

 

x

 

Read current card cancellation

 

x

 

The methods can change the order status of card pool cancellations. See Order Status of Card Pool Cancellation.

Dialog

You can call up the following transactions in dialog mode:

Transaction Code

Short Description

BCA_OR_CGC

Cancel Card Pool

Business Application Programming Interface

You can call up the following methods using the BAPI Explorer:

Method*

Short Description

BankCardPoolCancel.ChangeAndActivate

Change and activate card pool cancellation

BankCardPoolCancel.CreateAndActivate

Create and activate card pool cancellation

BankCardPoolCancel.Deactivate

Deactivate card pool cancellation

BankCardPoolCancel.Execute

Execute card pool cancellation

BankCardPoolCancel.GetActiveByBankCard

Card pool cancellation – read current order number

BankCardPoolCancel.GetDetail

Read card pool cancellation

*You can also execute all methods as a test run.

Direct Input

Direct input is not implemented for card pool cancellation. You can make external data transfers (EDT) using the BAPIs that have entry origin and processing origin BDTCG.

Customer Enhancements

The following Business Add-Ins (BAdIs) are available for card pool cancellation.

You can find an overview of the BAdIs in Customizing for Account Management (FS-AM) in the following IMG activities:

Order Management ® Card Pool Cancellation ® Business Add-Ins (BAdIs)

·        ® General BAdIs

·        ® BAdIs for BAPIs

General BAdIs

Short Description

BCA_OR_CGC_ADD

Cancel card pool

 

BAdIs for BAPIs

Short Description

BCA_CGC_CREATE_BAPI

Create and activate card pool cancellation

BCA_CGC_CHANGE_BAPI

Change and activate card pool cancellation

BCA_DEACTIVE_BAPI

Deactivate card pool cancellation

BCA_CGC_EXECUTE_BAPI

Execute card pool cancellation

BCA_CURR_BY_CGC_BAPI

Read current order number for card pool cancellation

BCA_CGC_DETAIL_BAPI

Read card pool cancellation

Integration

You make the settings for card pool cancellation in Customizing for Account Management (FS-AM) in the following IMG activities:

...

       1.      Order Management ® Basic Settings ® Configure Order Category

       2.      Order Management ® Card Pool Cancellation

 ® Define Number Range Interval for Card Cancellation

 ® Define Reasons for Card Cancellation

 ® Derive Cancellation Reasons for Participant Cards

 ® Release ® Assign Release Object to Release Procedure

 ® Release ® Assign Rule to Release Steps

 ® Release ® Assign Release WF and Release Procedure WF to Release Procedures

       3.      Product Management ® Product Definition ® Card Products ® Create Card Product/Change Card Product ® Attributes ® Card Cancellation

You also need to make the settings in Customizing for Account Management (FS-AM) for objects generated by the system when processing card cancellation.

When processing card cancellations, the associated release object and different authorization objects control the program flow. The system calls up and processes the following Account Management (FS-AM) objects when processing card cancellations.

Objects Checked by the System

...

The system checks the card pool and displays appropriate messages if one or more of the following requirements have not been met:

·        The card pool exists.

·        The card pool has the status Active.

·        The card pool is not in the release process.

·        The card pool has the 0204 cancel card pool feature, the traffic light symbol is green, and this feature is not locked.

For more information, see Editing Features.

·        The cancellation reason is permitted.

·        The cancellation date complies with the cancellation rule stored for the cancellation reason entered.

·        The card pool has a valid output mode for the Cancel Card Pool process .

Objects Changed by the System

·        Card pool

The system changes the following card pool data:

¡        Date of event 0025 Cancel when activating the card pool cancellation.

¡        The cancellation date is entered in the card pool.

¡        If the card pool cancellation is initiated by the customer, this is entered in the ‘Canceled By’ field.

¡        If the cancellation date has been reached, the status Canceled is entered.

¡        If the cancellation date has not yet been reached, the status Being Canceled is entered.

¡        Date of event 0003 Last Change.

·        Transfer to the processor

Card pool cancellation must be transferred to the processor as a master data change.

¡        The card pool cancellation is scheduled for data transfer with the output mode (01 – Direct or 02 – Batch).

Objects Generated by the System

·        Structure linkChange 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 Structure linkFramework for the Principle of Dual Control and Structure linkSAP Business Workplace.

If the entry origin or processing origin is BDTCG, the system does not generate a work item.

 

 

Leaving content frame