Change the Initial State of Charging Contracts in Mass Mode

Business Context and Use

This service operation is used in a migration context of master data related to end customers (subscriber data) of the service provider.

The operation enables you to change the initial state of charging contracts in mass mode in SAP Convergent Charging. The mass mode means that you change the state of several charging contracts at the same time. The modifications apply for each successful single operation, even if the processing fails for one or several charging contracts. However, the initial state of the charging contracts for which the single operation fails are not modified.

See the description of the related business object charging contract state for more information.

Customer Data Migration

A former system manages master data related to the end customers of a service provider. You want to migrate this data to SAP Convergent Charging.

• You must extract this information
• You must implement the conversion of this data into master data (and data models) provided and managed by SAP CC before any activity:
  • Business partners (subscriber accounts, subscriber mapping tables )
  • Business agreements (prepaid accounts and external postpaid accounts)
  • Contracts (charging contracts, subscriber mapping tables )
• You must determine the initial states of the prepaid accounts and the initial states of the migrated charging contracts.
• You must implement the bulk provisioning of this converted data to SAP CC according to the following sequence:
  • Create or change subscriber accounts in bundle mode
  • Create or change external accounts in bundle mode
  • Create or change prepaid accounts in bundle mode
  • Change the initial state of prepaid accounts in bundle mode
  • Create the necessary the subscriber mapping tables
  • Create the necessary charging contracts in bundle mode (or in mass mode)
  • Change the initial state of charging contracts in bundle mode
  Two different processing modes are provided for these bulk operations: The bundle mode (all-or-none) or the mass mode (most). Determine the mode recommended for your business requirements.
• Switch the business traffic to SAP Convergent Charging

Related Service Operations

You can use the following operations to modify the initial state of charging contracts:

• Change the state of a charging contract
• Change the state of charging contracts in bundle mode

• Read the state of a charging contract

Features

This mass operation chargingContractStateChangeMass enables you to change the state of charging contracts in bulk.

It works as a container for several operations of type ChargingContractStateChange. The ChargingContractStateChange operations are performed sequentially. The modifications apply to the charging contracts for which the chargingContractStateChange operation is successful, even if it failed for other charging contracts.

The result of the operation is a list containing the results of the execution of the single operations chargingContractStateChange. It may contain successful and and failed results.

Note that idempotency does not apply to each of the chargingContractStateChange single operation contained in the chargingContractStateChangeMass operation but only to the chargingContractStateChangeMass mass operation itself.

Error Handling

Consider the error handling information specified for the mass operations. Refer to the information about error handling in the charging contract state object and in the ChargingContractStateChange operation.

The SAP CC system may return an error stack that details the issue.

Message Types

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

• chargingContractStateChangeMassRequest
• chargingContractStateChangeMassResponse

Prerequisites

Consider the prerequisites specified for the process component (Web service).

Integration

There is no specific integration information.

Constraints and Integrity Conditions

Consider the constraints and integrity conditions specified for the process component (Web service).