Find dependent Charging Contracts

Service Operation (WS)

Definition

To find the charging contracts which depend on a specified charging contract

Technical Data

Software Product and Version	SAP Convergent Charging 5.0
Technical Details	dependentChargingContractFind
Namespace	http://recharging.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 operation is used to search for charging contracts which depend on a charging contract.

Two charging contracts depend on one another if:

• They belong to the same subscriber account.
• They are both linked to the same parent contract, or one of the charging contracts is the parent of the other one.

Rerating Scenario

A correction step precedes the recharging step of the rerating scenario. This step performs corrections when errors leading to the computation of wrong prices are identified. For example, such errors are related to the pricing logic, the properties of chargeable items, and so on.

The recharging step of the rerating scenario consists in sending again chargeable items which were previously charged so that SAP Convergent Charging computes the correct prices after the correction step.

You can implement the following customizing sequence of operations for the recharging step if you want to provide rerating services in your system landscape:

• Find the charging contracts which must be recharged together
• Lock the related charging contracts
• Find information on the feasibility of the recharging for a charging contract at a given date
• Prepare the execution of the recharging process
• Search the restoration points for the related charging contracts
• Restore the related charging contracts at a date corresponding to one of their restoration points
• Recharge the related chargeable items
• Unlock the related charging contracts

The recharging step may be followed by:

• An activation step, in order to trigger again recurring charges which have been undone during the recharging step. See the Activate charging contracts in bulk operation .
• A re-invoicing step in the connected billing system

Features

The result of this operation contains the list of charging contracts which depend on the specified charging contract.

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

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 specified does not exist The subscriber account specified does not have associated charging contracts The charging contract specified does not exist The charging contract specified does not belong to the subscriber account specified
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: No subscriber account identifier was specified in the request
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: Next follows a non-exhaustive list of errors linked to the Invalid Configuration category: The recharging feature is deactivated
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

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 :

• dependentChargingContractFindRequest
• dependentChargingContractFindResponse

Prerequisites

• The relevant subscriber account exists
• The relevant charging contracts exist
• The relevant charging contracts belong to the 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 SAP system landscape, you must configure the systems and the data (master data, business data).