Activate a charging contract including its associated charging contracts

service operation

Definition

To activate a charging contract stored in SAP CC, including all the associated charging contracts in case a parent/linked relationship exists

Technical Data

Software Product and Version	SAP Convergent Charging 4.1
Technical Details	chargingContractActivate
Namespace	http://activation.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 service operation enables you to trigger the recurring and one-shot charges related to one or a set of charging contracts.

You implement this operation in an external billing system to prepare the invoicing and billing processes. This operation ensures that all periodic fees anterior to a reference date are computed by the SAP CC system before launching the creation of invoices.

Features

This service operation triggers the recurring and one-shot charges of one charging contract, until the specified reference date. If the specified charging contract is concerned by a parent/linked relationship, then all the associated charging contracts are included in the scope of the activation operation.

The recurring and one-shot charges are triggered in chronological order:

If no error occurs, the charges are triggered for the (set of) charging contract(s) until the specified reference date.
If an error occurs at a given date for a given charging contract:
- The activations of all the charges for all the contracts are cancelled for this date
- The charges activated for the anterior dates are kept
When such a situation occurs, resolving the cause of the error and executing the operation again with the same parameters will resume at the date when the error occurred.

The content of the response of this operation can be configured by modifying its context. The list of possible options is the following:

Operation Result on Error
- notificationReturned: specifies if the notifications generated by the "No Access" component must be returned in the result

Authorization

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

Error Handling

The SAP CC system may return a charging error classified into a category and an error stack detailing the issue and its cause.

Categories

Use the following error categories to customize the behavior of your application or system:

Prerequisite Missing	The master data required for the execution of the operation request is missing, or the request is incorrect and does not target the correct master data.	Applicable for this service operation: Next follows a non-exhaustive list of errors linked to the Prerequisite Missing category: The subscriber account does not exist The charging contract does not exist The charging contract is not associated to the subscriber account
Invalid	The parameters of the request are not valid. The request must be corrected before sending it again.	Applicable for this service operation: Next follows a non-exhaustive list of errors linked to the Invalid category: The subscriber account identifier is empty The charging contract identifier is empty The reference date is empty
Invalid Configuration	The configuration of the SAP CC system is not valid. It must be corrected before sending the request again.	Applicable for this service operation
Illegal State	The master data used by the operation is not in a valid state. This is usually a normal behavior of the process and should be acknowledged as a failure.	Applicable for this service operation
Temporary Illegal System State	The connected SAP CC system is currently not in an appropriate state to execute the operation request. The request can usually be sent again later without any modification. If the error persists, the system administrators must be informed about it.	Applicable for this service operation
Illegal System State	The operation request failed because of a technical error or an unexpected issue. The system administrators must be informed about this error.	Applicable for this service operation

Note

This list of errors is not exhaustive.

Troubleshooting

Refer to the SAP CC Error Code Reference (SAP Site) for more information about a returned error code and the corrective actions necessary for troubleshooting your implementation project.

Message Types

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

Prerequisites

Both the specified charging contract and subscriber account must exist in the SAP Convergent Charging system.
The specified charging contract must be associated to the specified subscriber account.

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 system landscape, you must configure the systems and the data (master data, business data).