2 Launch Cloud Service PDC (BRM) Integration

This chapter outlines the configuration steps required to integrate Launch with Pricing Design Center (PDC) or Billing Revenue Management (BRM). The integration helps customers who want to take advantage of the latest capabilities of the Oracle Launch Cloud Service while leveraging their existing investment in BRM.

Related Guides

Table 2-1 contains information about other useful sources of information for the integration process.

Table 2-1 Related Guides

Reference Description
Launch Cloud Service User's Guide Describes how you can create, publish, and manage product offers.
REST API Reference for Launch Cloud Service Provides the REST API reference document for Launch Cloud Service.
Oracle PDC-BRM Documentation PDC/BRM documentation to create client credentials and security requirements for PDC/RSM deployment

Supported Versions

The minimum required application for this feature is:
  • Launch release version 25.01 or later and
  • Oracle PDC/BRM 12 PS8 plus Patch 35361657

Supported Integration and Mapping

Launch-PDC Integration uses the mapping service which enables you to create a proxy API that can push the data into PDC/BRM. The mapping service currently works for the following entities in Launch. All other entities are ignored. Table 2-2 lists the entities that can currently be mapped.

Table 2-2 Supported Integration and Mapping

Launch Entity PDC Entity What can you synchronize?

Simple product offering

Charge offer of Subscription type

Definition

Pricing

Charging terms

Simple product offering with fees and alterations

Charge offer of Subscription type / Item / Account type (based on Launch definition).

Definition

Pricing and Adjustments

N/A

Discount offer of Subscription type. The name of the discount offer will be post fixed with _DISCOUNT.

For DBE customers, the _DISCOUNT post fix won't be there. Discount offers will be post fixed with _DISCOUNT only for NON-DBE customers.

Charging terms

Simple offering of device/accessory type

Charge offering of Account type

Definition

Pricing

Attribute based pricing

Charge Selector

Definition

Pricing

Package

Package

Definition

Components

Commitment terms

Service Bundle

Bundle

Definition

Components

Commitment terms

Attribute based pricing

Charge Selector

Definition

Pricing

Attribute based adjustment

Discount Selector

Definition

Pricing

Setting up Launch PDC/BRM Integration

There are a few setups required to be done in Launch, Industry Framework and BRM for Publish from Launch-to-PDC.

Setup Task List

Table 2-3 Setup Task List

No. Application Task Mandatory? Description

1.

Industry Framework

Create Integration User

Yes

This is required to facilitate the integration between the two applications.

2.

Launch

Register destinations

Yes

This is required to configure the right spoke instance to receive the publishing events.

3.

Launch

Configure Entity Profile

Yes

This is required to ensure that Launch can model catalog definitions based on PDC/BRM.

4.

Industry Framework

Configure the spoke systems

Yes

This is required to ensure to configure the spoke system instance for receiving publishing events.

5.

PDC REST Services Manager

Create client credentials and security requirements

Yes

N/A

6.

Launch and PDC/BRM

Set up Configuration entities

Yes

This is required to meet the Launch and PDC configuration setup.

Setup Task Details

  1. Create a new user with the user name FABRIC_SYSTEM_USER and the role Communications Catalog Administrator using the Security Console. If you have already created this as a part of the Launch setup, no additional setup is required.

  2. Register Destination in Launch for publishing to PDC/BRM instance. Usually, you would have many PDC/BRM instances such as (Development, SIT, UAT and Production). Each instance of BRM instance is a destination that needs to be setup for Launch to publish to the correct PDC instance.

    Configure destinations in Launch to appropriate life cycle status for which you would like to publish to external application. For example, you can configure a destination for test instance to the Ready to Publish life cycle status and configure one for production instance to the Active status.

    While adding destinations, use:
    1. Name – The target pre-selection key from the Connection Descriptor in the Industry Framework.

    2. Type - The target name used in Catalog Sync configuration.

    3. Internal – Set this to ON.

    Here’s the list of steps to create a Siebel destination:

    1. Navigate to the Launch user interface > Administration > Lifecycle Status.

    2. Select the new lifecycle configuration version in the PENDING state.

    3. Choose the Edit option for the In design state and click Add Destination.

    4. Provide the Name, Type, and Publish Sequence. Click Add.

      Note:

      Destination Name and Type should match the spoke system configuration in the CX Industries Framework.
    5. Select the PDC destination name in the Destinations field and save it.
    6. Choose the Activate option for the PENDING lifecycle configuration version.
    7. Verify that the new lifecycle configuration version changed to the ACTIVE state.

    For more information on how to configure the Destination in Launch, see REST API Reference for Launch Cloud Service and "Publish Catalog Entities" in Launch Cloud Service Implementation Guide.

    Note:

    The destination Name setup in Launch should be an exact match to the system descriptor creation using config.ms in CXIF. This helps in identifying the correct Siebel instance for one-time migration (“Source” field in migration job) and in the mapping for Publishing to the appropriate Siebel instance. Ensure that you use the same name for system parameter name in system Descriptors while applying the configuration in step 5.
  3. Configure the Entity Profile to ensure that PDC/BRM supported product modeling is followed by Launch using the Entity Profile tile in Administration space.

    No two applications are the same when it comes to modeling capabilities and so is the case between PDC/BRM and Launch. Though the result might be the same, the constructs might be different between the applications, and while integrating the applications, you need to factor in any restrictions of the target(spoke) application to ensure an error-free publishing of catalog definitions. Some of the common patterns between PDC and Launch can be classified as:

    • Both the applications have the same construct capabilities and restrictions for an entity at par - for example, Balance Element, Product Offering, Service Specification entities, and so on.

    • Both the applications have minimal common capabilities and/or additional capabilities or restrictions in one and not in the other - for example, PDC/BRM and Launch can have commitment terms, but Launch has the provision to configure multiple commitment terms to an offer, while only one commitment term is supported in PDC/BRM package.

  4. Configure your external application in the Industry Framework for each instance. For more information, refer to the topic Integrate External Applications to add a Spoke End Point in the article Implement CX Industries Framework, on My Oracle Support, Doc ID 2720527.1.

  5. Create client credentials and security requirements for PDC/BRM. See PDC/BRM documentation for information about creating client credentials and security requirements for PDC/RSM deployment.

  6. Ensure that the services, events and service-event maps, general ledger IDs (GLID), tax codes, and balance elements required for charge or discount offers are set appropriately.

    Before setting up integration, complete the following conditional tasks in PDC/BRM and Launch.

    1. GLID name on Launch and BRM system should be same.

      1. In Launch → Setup and Maintenance, go to standard lookup ORA_ATC_GLID and set the GLID. Example: Create 101 GLID in launch.

      2. In PDC, use pin_glid application to create the general ledger ID. Create 101 GLID in PDC.

    2. Tax code name on Launch and BRM system should be same.

      1. a. In Launch, use the REST API operation to create https:///<HOST>/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/taxServiceProvider. Example: Tax001 should be setup as taxCode in taxSupplier in Launch.

      2. In PDC, set up the same set of tax codes as configured in Launch.

    3. Balance element name, code, numeric code on Launch needs to be same as PDC.

      1. In Launch, use the REST API to create the Balance element https:///<HOST>/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/balanceElement.Example: Name: US Dollar, code - USD, numeric code – 840 and so on.

      2. In PDC, configure the Balance Element (Name, Code, Numeric code), along with other attributes that should match with attributes in Launch.

    4. Usage specification name and metering rule name in Launch needs to be same as the configured Usage event and RUM name on PDC side.

      1. In Launch, use the REST API to create the usage specification https://<HOST>/crmRestApu/atcProductCatalog/11.13.18.05/tmf-api/usageManagement/v2/usageSpecification. The fields name, meteringRule.name should match with PDC. Example: EventDelayedTelcoGSMTelephony, meteringRule.name – Duration

      2. In PDC, configure the serviceEventMap with the same event name and RUM.

    5. The Service specification code in service specification in Launch and Service Event Map Name on BRM side should be same.

      1. Launch Service Specification service code needs to be configured. Example: The service code /service/telco/gsm/telephony needs to be same on both systems.

      2. In PDC, configure the ServiceEventMap.

Sample Mapping

Table 2-4 shows a sample mapping between Launch and PDC entities.

Table 2-4 Sample Mapping

Entity Launch PDC

Usage Specification

EventDelayedTelcoGSMTelephony

Metering Rule: Duration

EventDelayedTelcoGSMTelephony (Event)

RUM: Duration

UOM (Unit of Measure)

ORA_ATC_UOM

UOM

Tax Code

TAX001

TAX001

Product Offering Billing Service Type

Populate the Service code - /service/telco/gsm/telephony in ORA_ATC_BILLING_SERVICE_TYPE and then use it on product offering billing service type

Service - /service/telco/gsm/telephony (BRM)

serviceTelcoGSMTelephony(PDC)

Configure the service-event maps.

Product Specification

Wireless PS
  • Populate the Usage Specification -EventDelayedTelcoGSMTelephony

Populate the Service Specification - Wireless CFS

N/A

GLID

101

101

Balance Element

Name: US Dollars

Code: USD

Numeric code: 840

Name: US Dollars

Code: USD

Numeric code: 840

Price Tag

CT01

CT01

Impact Category

Common business configuration impact category IC_INTERNATIONAL

IC_INTERNATIONAL

Supported Scenarios

Table 2-5 lists the supported integration scenarios.

Table 2-5 Supported Scenarios

S.No. What you can publish? Launch Entity PDC Entity

1.

Simple Offer with one time price

Simple product offering of service type

Supported fee types are Purchase and Cancel

Charge offering of service type

( EventBillingProductFeePurchase EventBillingProductFeeCancel )

2.

Simple Offer with recurring price

Simple product offering of service type

Supported recurring frequency - Monthly, Bi-Monthly, Semi Annual, Annual, Quarterly, Arrear and Forward Arrear

Charge offering of service type with the event of the below recurring frequency with the scaled fee.

(

EventBillingProductFeeCycleCycle_forward_annual - Occurrence

EventBillingProductFeeCycleCycle_forward_semiannual - Occurrence

EventBillingProductFeeCycleCycle_forward_quarterly - Occurrence

EventBillingProductFeeCycleCycle_forward_bimonthly - Occurrence

EventBillingProductFeeCycleCycle_forward_monthly - Occurrence)

EventBillingProductFeeCycleCycle_arrear - Occurrence

EventBillingProductFeeCycleCycle_forward_arrear - Occurrence

)

3.

Simple Offer with one time, recurring and usage fee (any metering rule)

Simple product offering of service type

Charge offering of service type with the one time, recurring, and usage fee

4.

Simple Offer with a one- time, recurring price along with one time, recurring fixed/% discount

Simple offering with fees and adjustments of type fixed discount or percentage discount

Charge offering of service type with the one time, recurring, and usage fee. Discount offering with a fixed or percentage discount for the one-time fee

5.

Simple Offer with a usage fee and usage discount

Simple offering with usage fees, metering rule, UOM with usage percentage or fixed discount

Charge offering of service type with the usage fee. Discount offering with a fixed or percentage discount for the usage fee

6.

Simple Offer - Tiered pricing

Simple offer with one time/recurring tiered pricing

Charge offer of service type with one time/recurring tiered pricing

7.

Simple offer - Usage tiered pricing

Simple offer with usage tiered pricing

Charge offer with usage tiered pricing

8.

Re-use of price plans in Simple offer

Simple offer with reused price plans

Charge offer with reused rate plans

9.

Simple offer with Time Limited Discounts sync from Launch to BRM (Only absolute validity)

Simple offer with one time/recurring/usage limited time discount

Charge offer/Discount offer with rate plan validity

10.

Factor the following integration scenarios cloning, revisions

Clone

Simple offer revision

Simple offer Retire

Simple offer Obsolete

Charge offer revise

Charge offer obsolete

Charge offer obsolete

11.

Launch - BRM - Simple offering with allowances

Simple offering with single allowance

Charge offering of service type with the non- currency resource granted part of one time, recurring, and usage fee for consumption. Discount offering for non-currency resource consumption

12.

Launch - BRM - Simple offering with Allowance and Overage

Simple offering with single allowance and overage

Charge offering of service type with the non- currency resource granted part of one time, recurring, and usage fee for consumption. Discount offering for non-currency resource consumption

13.

Launch - BRM - Simple offering with Attribute based pricing (one time, recurring and usage)

Simple offer with attribute-based pricing for usage with service specification and usage specification characteristics.

Simple offer with attribute-based pricing for one time and recurring with service specification and customer specification characteristics.

Charge offer with charge selector

14.

Launch BRM - Simple offering with one-time, recurring fees and discounts along with Charging terms

Simple offer with charging terms

Charge offer/Discount offer with rate plan configuration or charging details like proration and increments

15.

Launch - BRM - Simple offering with one-time, recurring fees and usage fees (reuse of price plan alteration)

Simple offer with reused discount price plan

Discount offer with reused discount rate plan

16.

Simple Offer with a one time, recurring, usage volume discount (tiered, volume)

Simple offer with one time/recurring/usage tiered and volume discount

Charge offer and Discount offer with one time/recurring/usage tiered and volume discount

17.

Service Bundle (No nesting of bundles)

Service bundle

Bundle

18.

Package with commitment terms (no nested bundles or commercial bundles, aggregate groups)

Package

Package with commitment terms

19.

Service Bundle with commitment terms (No nesting of bundles)

Service bundle

Bundle with commitment terms

20.

Package (no nested bundles or commercial bundles, aggregate groups)

Package

Package

21.

Simple Offer with attribute-based adjustments for usage

Simple offer with attribute-based adjustment for usage (customer specification, service specification, usage specification)

Charge offer and Discount offer with Discount Selector

22.

Publish other type of product offering (like discounts)

Simple offering with other type of product offering + discount

Discount offers

23.

Simple Offer with multiple allowances and consumption model

Simple offer With multiple allowances and consumption model

Charge offer and Discount offer (consumption model)

24.

Simple Offer with usage prices based on zoning

Simple offer with Value Map zoning

Charge offer using charge selector with value map zoning

25.

Simple Offers with adjustments based on triggers

Simple offer, triggers on adjustments (Total Charge, Total Quantity, Price Tag, Expression as trigger conditions)

Discount offer with discount trigger (price tag in Launch maps to impact category in discount filter)

26.

Simple offers with multiple price lists

Simple offers with multiple price lists. (Fees are created with different price lists within the same simple offers.)

Charge offers with Charge selectors. The charge selectors are used to configure charge rate plans based on price lists.

27.

Simple offers with adjustments and user/share balance

Simple offers with adjustments and user/sharer balance

Discount offers with different types of discounts which applies to user/sharer balance.

28.

Simple offers with Balance Consumption Model

Simple offers with Balance Consumption Model without Allowance configured in usage fee (Consumption Discount Model).

Discount offers with Balance Consumption Model

29.

Simple offers with standard zone

Simple offer with attribute based pricing for usage based on standard zone

Charge offer using charge rate plan with standard zone

30.

Simple offers with price tags for run time price overrides

Simple offer with price tags on product offering prices

Charge and discount offers with rates having price tags

31.

Simple offers with multiple usage prices

Simple offers with multiple usage prices. Attach appropriate usage specification for each usage fee

Charge and discount offers with multiple usage events