Check the Charge of a Set of Chargeable Items in Mass Mode

Service Operation (WS)

Definition

To call multiple chargeable item check charge operations in one request.

Technical Data

Software Product and Version	SAP Convergent Charging 2023
Technical Details	chargeableItemCheckChargeMass
Namespace	http://charging.v1.ws.highdeal.com/
Proxy Instance in SAP CC System	Dispatcher
Service Operation Version	1
Application Area	IS-CC
Direction	inbound
Mode	synchronous
Idempotency	false

Business Context and Use

This service operation allows to call multiple chargeable item check charge operations in one roundtrip and can be used for optimization purposes.

You can consult Charge a single chargeable item in check mode (blank charging) for more information.

Note

This is the latest version of this service operation. It replaces the previous version 0.
With this version, decimal numbers are no longer restricted to the (28,6) precision. For decimal numbers stored in the database, the precision is limited to the precision supported by the database.

Related Service Operations

You can also use the following operations for charging chargeable items:

Features

This mass service operation embeds multiple check charge operations which are all executed by the system regardless of whether they succeed or fail.

The result of the mass operation contains the list of results of all included operations.

The context can be specified either at the mass operation level or at the operation level.

The context specified in the mass operation apply to all the operations, except for operations that redefine different options.

Result Configuration

You can specify if the result of each single operation includes:

Information about the charging process
Information about the identified target charging contract
Information about the charged chargeable item
Information about the generated accounting operation(s)
Information about the charged account(s)
Information about the generated charged item(s)
Information about the generated business notification(s)
Information about the errors

The list of possible options is the following:

Sender Information (see senderInfo)
- jobId: specifies an identifier for the sender of the operation
Charging Operation Output (see chargingOutputContext)
- chargeableItemExported: specifies if chargeable items must be exported in the output of the charging operation
- itemImmediatelyLoaded: must not be enabled for this service operation (available only for single and bundle operations)
Operation Result (see chargingResultContext)
- chargingProcessInfoReturned: specifies if information about the charging process must be returned in the result of each single operation
- chargingContractInfoReturned: specifies if information about the target charging contract must be returned in the result of each single operation
- chargeableItemInfoReturned: specifies if information about the chargeable item must be returned in the result of each single operation
- accountOperationReturned: specifies if the generated account operations must be returned in the result of each single operation
- accountInfoReturned: specifies if information about the impacted accounts must be returned in the result of each single operation
- chargedItemReturned: specifies if the generated charged items must be returned in the result of each single operation
- notificationReturned: specifies if the generated notifications must be returned in the result of each single operation
Operation Result on Errors (see chargingResultOnErrorContext)
- notificationReturned: when the charging has been aborted by a No Access component, specifies if the error notification (i.e., the "No access" notification) must be returned in the result.
  Regardless of this setting, user alerts are never returned for a charging operation that has been aborted.

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 a single operation fails, the corresponding result will contain information about the error.

The failure of a single operation does not prevent 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 :

Prerequisites

The prerequisites of each single operation 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).

Additional Information

Consult the SAP CC Application Help for more information about the charging process in blank mode.
Consult the SAP CC Java API Reference (Core Library) for more information about the offline charging services and the blank charge operation in the com.highdeal.cnd.message Java package.