Web Services

Charging Contract State Management

Process Component (Web Service)

Definition

Management of the states of charging contracts being migrated to SAP Convergent Charging.

Technical Data

Software Product and Version	SAP Convergent Charging 2022
Technical Details	contractstate
Namespace	http://schema.contractstate.ws.highdeal.com/
Proxy Instance in SAP CC System	Updater
Web Service Version	0
WSDL	https://<UPDATER_INSTANCE_HOST>:<UPDATER_WS_PORT_NUMBER>/contractstate?wsdl
Endpoint	https://<UPDATER_INSTANCE_HOST>:<UPDATER_WS_PORT_NUMBER>/contractstate
Application Area	IS-CC

Business Context and Use

This process component is used in a migration context of end customer related mater data (subscriber data). You want to migrate customer data from a former system to SAP Convergent Charging. This process component enables you to finalize the overall migration of customer data by restoring some counters and other credits to their appropriate values.

First, you have to implement the provisioning of charging contracts in SAP Convergent Charging
Second, you have to stop the former system and to update the states of the contracts according to the modifications that may have occurred before you stopped the former system.

This process component enables you to modify in bulk the states of charging contracts just created in the SAP CC system. Consult the overall implementation sequence of the customer data migration.

Notes

You can only modify the states of charging contracts having an operational status set to active.
This process component provides a service operation to read the current state of a charging contract.

This process component enables you to transfer charging contracts in the SAP CC system.

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 , subscriber range tables )
- Business agreements ( prepaid accounts and external accounts )
- Contracts ( charging contracts , subscriber mapping tables , subscriber range tables )
You must determine the states of the prepaid accounts and the states of the migrated charging contracts .

Then, you must implement the provisioning of this converted data to SAP CC by choosing one of the following solutions:

Solution 1: You must implement bulk provisioning of this converted data to SAP CC according to the following sequence:
- Create the necessary subscriber mapping tables
- Create the necessary subscriber range tables
- Create the necessary charging contracts in bundle mode or in mass mode
- Change the state of the charging contracts in bundle mode or in mass mode
- Create the necessary data tables relating to a charging contract or to a group of charging contracts ( subscriber mapping tables or subscriber range tables )
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.

Solution 2: You must implement the one step provisioning of this converted data to SAP CC according to the following sequence:
- Import customer data
- Change the operational status of the imported single or parent charging contract(s) to set it to active

Switch off the business traffic to SAP Convergent Charging

Make sure that no business traffic acquired from mediation systems can trigger the charging services related to the customer data been migrated. This can corrupt the state of this master data. Make sure that no activation process of periodic and one-off fees can be manually or automatically triggered by a user or a connected system.

Example

In an integrated SAP Solution scenario with SAP ERP of the SAP Business Suite, SAP ERP implements the necessary service operations of SAP CC to provide the migration services of master data related to end customers.

Included Service Operations

The following operations are related to the management of the state of charging contracts in bulk:

You can use the following single operation to change the state of a charging contract:

Change the state of a charging contract

You can use the following operation to read the current overall state of a charging contract:

Read the state of a charging contract

You can use the following operation to transfer the state and allowances of a charging contract:

Transfer the state and allowances of a charging contract

See here the technical details about these service operations.

Related Process Components

Data Migration (Order Capture and Contract Management): Charging Contract Management

Prerequisites

The charging contracts must be created in SAP Convergent Charging before you can read or change their state.

Integration

There is no specific integration information.

Constraints and Integrity Conditions

In a customer data migration context, you must ensure that no process can corrupt the master data been migrated. Until the end of the complete migration, make sure that:

No business traffic acquired from mediation systems can trigger the charging services related to the customer data been migrated
No activation process of periodic and one-off fees can be manually or automatically triggered by a user or a connected system

Do not use this process component and its included operations to implement online refilling services. Use the relevant process component Refilling provided by the SAP CC Web Services.

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).