Lock a set of Charging Contract Collections

Service Operation (WS)

Definition

To lock a set of charging contract collections

Technical Data

Software Product and Version	SAP Convergent Charging 2022
Technical Details	chargingContractCollectionLockMass
Namespace	http://recharging.ws.highdeal.com/
Proxy Instance in SAP CC System	Dispatcher
Service Operation Version	0
Application Area	IS-CC
Direction	inbound
Mode	synchronous
Idempotency	false

Business Context and Use

This operation is used to lock a set of charging contract collections in the context of a recharging operation, so that the included charging contracts cannot be used by another business process until they are unlocked.

Rerating Scenario

A correction step precedes the recharging step of the rerating scenario. This step performs corrections when errors leading to the computation of wrong prices are identified. For example, such errors are related to the pricing logic, the properties of chargeable items, and so on.

The recharging step of the rerating scenario consists in sending again chargeable items which were previously charged so that SAP Convergent Charging computes the correct prices after the correction step.

You can implement the following customizing sequence of operations for the recharging step if you want to provide rerating services in your system landscape:

• Find the charging contracts which must be recharged together
• Lock the related charging contracts
• Find information on the feasibility of the recharging for a charging contract at a given date
• Prepare the execution of the recharging process
• Search the restoration points for the related charging contracts
• Restore the related charging contracts at a date corresponding to one of their restoration points
• Recharge the related chargeable items
• Unlock the related charging contracts

The recharging step may be followed by:

• An activation step, in order to trigger again recurring charges which have been undone during the recharging step. See the Activate charging contracts in bulk operation .
• A re-invoicing step in the connected billing system

Related Service Operations

You can also use the following operations for locking or unlocking charging contract collections:

• Lock a charging contract collection
• Unlock a charging contract collection
• Unlock a set of charging contract collections

Features

This operation contains a set of locking operations which are executed sequentially.

Authorizations

To know the role that is expected in the user profile of the SAP CC user specified in your request messages, refer to the SAP CC Security Guide .

Error Handling

If the execution of an included operation fails, the corresponding result will contain information about the error. The failure of an included operation fails does not stop the execution of the subsequent operations. Refer to the information about error handling related to the single operation.

Message Types

Consult the structures of the message types related to this service operation :

• chargingContractCollectionLockMassRequest
• chargingContractCollectionLockMassResponse

Prerequisites

The prerequisites of each of the included operations must be fulfilled.

Integration

There is no specific integration information.

Constraints and Integrity Conditions

There is no specific constraint.

Notes on SAP CC Implementation

You must have installed and configured the SAP CC Core Server system.

Configuration

Consult the SAP CC Configuration and Implementation Guide to know the necessary configuration or Customizing of the SAP CC system.

Before implementing SAP Convergent Charging in your SAP system landscape, you must configure the systems and the data (master data, business data).