Interface ISessionConfirmation

All Known Subinterfaces:
ISessionStopChargingAsyncOperation, ISessionStopChargingOperation, ISessionUpdateChargingAsyncOperation, ISessionUpdateChargingOperation
All Known Implementing Classes:
SessionChargingOperation

public interface ISessionConfirmation
This Java interface defines the key methods necessary for managing a reservation confirmation or reservation cancellation during session-based charging; implement the prepareConfirm(..) method and the prepareCancel(..) method to finalize a reservation in a charging session.

Note

You can also extend a reservation. Consider the ISessionConfirmAndReserve interface.

Implementation in Your Client Application

Use prepareConfirm(..) and prepareCancel(..).

The two methods are available in the following container operations:

Async. comm. Sync. comm.
createSessionUpdateAsyncOperation(..) createSessionUpdateOperation(..)
createSessionStopAsyncOperation(..) createSessionStopOperation(..)

Do not use the SessionChargingOperation Java class to develop your Java-based client application.

See Also:
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    prepareCancel(String reservationId)
    This method allows you to cancel a reservation during a session-based charging.
    void
    prepareConfirm(String reservationId, ChargeableItem confirmationItem)
    This method allows you to confirm a reservation in a charging session included in a multiservice session (or customer session).
  • Method Details

    • prepareConfirm

      void prepareConfirm(String reservationId, ChargeableItem confirmationItem)
      This method allows you to confirm a reservation in a charging session included in a multiservice session (or customer session).

      First, the SAP CC system retrieves the stored charging session and its data and re-rate the reservation item to compute a first rating result used by your charging client to cancel the previous balance reservation. The transactions from this rating result are provided to the TIF.

      Second, the SAP CC system consolidates a chargeable item for confirmation using both the reservation one from the rating session and the confirmation one if present. This chargeable item is rated and previously reserved counters are committed into the back-end database. A second rating result is then available for the client application to confirm the balance reservation. The transactions from this rating result are also provided to the TIF.

      Finally, the charging session is removed and the reservation identifier becomes available for next reservations.

      Parameters:
      reservationId - The reservation identifier that must be unique within a multiservice session; This ID identifies a charging session.
      confirmationItem - The reservation item; It is optional, null, or partially defined.
    • prepareCancel

      void prepareCancel(String reservationId)
      This method allows you to cancel a reservation during a session-based charging.

      You add this reservation cancellation request in an update or stop operation of a multiservice session.

      Once the session operation (update or stop) is received, the SAP CC system retrieves the charging session first and cancels the related counter reservations coming from either a previous reservation or a reservation extension. The rating result that is returned is empty in case of cancellation.

      The charging session is removed and the reservation identifier becomes available for next reservations and new charging sessions.

      Parameters:
      reservationId - The reservation identifier that must be unique within a multiservice session; This ID identifies a charging session.