Show TOC

 Card Pool Cancellation

Definition

An Account Management (FS-AM) business objectthat 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 orderfrom the Card 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 Note

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

    End of the note.

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

  • Attributes from Order Management

  • Notice reason

  • Date of receipt of notice

  • 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 field to identify the channel used to process it.

Entry OriginProcessing 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:

Start of the navigation path Order Management Next navigation step Card Pool Cancellation Next navigation step Business Add-Ins (BAdIs) End of the navigation path

  • Start of the navigation path  Next navigation step General BAdIs End of the navigation path

  • Start of the navigation path  Next navigation step BAdIs for BAPIs End of the navigation path

    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. Start of the navigation path Order Management Next navigation step Basic Settings Next navigation step Configure Order Category End of the navigation path

  2. Start of the navigation path Order Management Next navigation step Card Pool Cancellation End of the navigation path

    ⇒ Define Number Range Interval for Card Cancellation

    ⇒ Define Reasons for Card Cancellation

    ⇒ Derive Cancellation Reasons for Participant Cards

    Start of the navigation path  Next navigation step Release Next navigation step Assign Release Procedure to Release Object End of the navigation path

    Start of the navigation path  Next navigation step Release Next navigation step Assign Rule to Release Steps End of the navigation path

    Start of the navigation path  Next navigation step Release Next navigation step Assign Release WF and Release Procedure WF to Release Procedure End of the navigation path

  3. Start of the navigation path Product Management Next navigation step Product Definition Next navigation step Card Products Next navigation step Create Card Product/Change Card Product Next navigation step Attributes Next navigation step Card Cancellation End of the navigation path

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

During the processing of card cancellations, the associated release object and different authorization objects control the program flow . For more information, see Authorization Administration in Account Management .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 the Editing Features section.

  • The notice 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 Card Pool Cancellation 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

  • 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 Framework for the Principle of Dual Control and SAP Business Workplace .

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