Create or Change Subscriber Accounts in Bundle Mode

Service Operation (WS)

Definition

To create or change subscriber accounts in bundle mode (all-or-none)

Technical Data

Software Product and Version	SAP Convergent Charging 5.0
Technical Details	subscriberAccountMaintainBundle
Namespace	http://provisioning.ws.highdeal.com/
Proxy Instance in SAP CC System	Updater
Service Operation Version	0
User Operation Auditing	Yes
Audit Domain	See the audit domain of the single operation
Application Area	IS-CC
Direction	inbound
Mode	synchronous
Idempotency	true

Business Context and Use

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

The operation enables you to create or change subscriber accounts in bundle mode in SAP Convergent Charging. The bundle mode means that you maintain several subscriber accounts at the same time but the modifications apply only if the processing is successful for each subscriber account.

Business Partner Management

Your CRM application or another provisioning system manages master data related to the business partners and replicates data in SAP CC by maintaining some subscriber data for end customers of the service provider. Data includes: Subscriber accounts, subscriber mapping tables, subscriber range tables.

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 accounts in bundle mode or in mass mode
  • Create the necessary external accounts in bundle mode or in mass mode
  • Create the necessary prepaid accounts in bundle mode or in mass mode
  • Change the state of the prepaid accounts in bundle mode or in mass mode
  • Change the schedule of the blocked/locked/closed statuses of each relevant prepaid account
  
  
  • 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.

Related Service Operations

You can use the following operations to maintain subscriber accounts:

• Create or change a subscriber account
• Create or change subscriber accounts in mass mode

You can use the following operations to perform queries on existing subscriber accounts:

• Read a subscriber account
• Read the full version of a subscriber account

Features

This bundle operation enables you to maintain multiple subscriber accounts in bulk.

It works as a container for several single operations of type SubscriberAccountMaintain. The single operations are performed sequentially by the SAP CC system. The modifications apply only if all the single operations contained in the bundle operation are successful. If the operation fails for one subscriber account, no modification is done.

Two situations occur:

• All the single operations are successful. The result of the operation is a list of successful results for all the operations subscriberAccountMaintain contained in the subscriberAccountMaintainBundle operation.
• One operation fails. The process stops immediately and the result of the operation is a list of successful results and one failed result.

Note that idempotency does not apply to each of the subscriberAccountMaintain single operation contained in the subscriberAccountMaintainBundle operation but only to the subscriberAccountMaintainBundle operation itself.

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

Consider the error handling information specified for the bundle operations. Refer to the information about error handling in the subscriber account business object and in the single operation.

Message Types

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

• subscriberAccountMaintainBundleRequest
• subscriberAccountMaintainBundleResponse

Prerequisites

There is no prerequisite.

Integration

There is no specific integration information.

Constraints and Integrity Conditions

In a migration context of master data related to end customers (subscriber data) of the service provider, consider the constraints and integrity conditions specified for this context.

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