Siebel Pricing Administration Guide > Creating Product Offers >
Scenarios for Product Offers for Multiple Products Using Web Services
This topic describes how a telecommunications company might set up product offers for multiple products. You might use product offers differently, depending on your business model. Before you use any of the scenarios in this topic, the telecommunication company must have an eCommerce web site that can present the products and product offers that are defined in Siebel CRM application. Here is a simplified description of how residential customers could use this Web site to place an order:
- First, the user launches the telecommunication company's web site and clicks on the link to shop for residential products and services.
- The user enters the address where the service would be installed.
- The eCommerce Web site displays a list of services available in this location. In this example, the user selects the triple play bundle, which includes telephone, internet and television. Each of these options is defined as a product offer.
- The eCommerce Web site displays a list of add-ons based on the user's selection. For example, because the selected package includes television and home phone service, the user can select add-ons including Basic Movie Package, Sports package, and International calling package. Each of these specific add-on options is defined as a product offer, and users select the combination they want.
- After finishing choosing specific options, the user clicks the Review Order button. At this point, the eCommerce application invokes the Apply Multiple Offers to Create Order web service to generate the complete order detail along with the final price. The order is generated in memory and is not saved to the Siebel database.
- If user is satisfied with this order, the user clicks the Place Order button. At this point, the eCommerce application invokes the Order web service to save the order to the Siebel application.
This topic includes the following scenarios for using web services related to product offers for multiple products:
Scenario for a New Customer to Create a Quick Quote
In this scenario, a new customer gets a quick quote for a service bundle.
- A new customer browses the eCommerce Web site of a telecommunications provider. The customer enters his home zip code and views a list of available services. The customer decides to get a quick quote for a new promotion offered by the provider, called the Medium Triple Play Bundle, which includes Internet +Home Phone+ Basic TV Bundle for $120 /month.
- The eCommerce web application calls a Siebel web service to return a list of eligible product offers for the customer. The customer selects the following offers:
- Two add-ons for TV:
- Basic Movie package
- Spanish Combo channel
- One add on for Internet:
- To generate a quote, the eCommerce web application calls the Siebel web service ApplyMultipleProductOffers.
The web service requires the list of product offer ids along with the sequence in which they are selected. The web service has the option to save the quote in Siebel CRM or generate the quote in memory. Because this is an in-memory Quick Quote, you specify that the quote is not saved by populating the SaveFlag with N in the input message.
To view an example of this web service, navigate to the documentation library for Siebel applications on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/index.html), and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file, and see the following files to view the sample code:
- ...\Product Offer-Apply Multiple Product Offers\New Acquisition - InMemory - Request Message.txt
- ...\Product Offer-Apply Multiple Product Offers\New Acquisition - InMemory - Response Message.txt
- The web service output message is a document generated in memory with the structure shown in the following table.
|
|
|
|
1.0 |
Medium Triple Play Bundle |
|
Add |
2.0 |
Internet Service |
Medium Triple Play Bundle |
Add |
2.1 |
Fibe 100GB |
|
Add |
2.2 |
Online Security |
|
Add |
3.0 |
Voice Service |
Medium Triple Play Bundle |
Add |
3.1 |
Flat National |
|
Add |
4.0 |
TV Service |
Medium Triple Play Bundle |
Add |
4.1 |
Essential Plan |
|
Add |
4.2 |
Basic Movie Package |
|
Add |
4.3 |
Spanish Combo Package |
|
Add |
5.0 |
Internet Router |
Medium Triple Play Bundle |
Add |
NOTE: The newly generated order applies the default promotion constraints. Eligibility & Compatibility rules and Product Configurator constraints are enforced using the Configurator BatchValidate API. Pricing rules are enforced by invoking the Siebel Pricing workflows.
Scenario for a New Customer to Add Items to an Existing Quote
In this scenario, the customer reviews the quote described in Scenario for a New Customer to Create a Quick Quote and selects the premium set-top box instead of the default option for basic set-top box.
- To generate a quote, the eCommerce web application calls the Siebel web service ApplyMultipleProductOffers. Because we are updating an existing quote, you specify the quote structure in the input message. The web service applies the offers to the existing quote instead of generating a new quote.
To view an example of this web service, navigate to the documentation library for Siebel applications on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/index.html), and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. See the following files to view the sample code:
- ...\Product Offer-Apply Multiple Product Offers\New Acquisition - Add Equipment - Request Message.txt
- ...\Product Offer-Apply Multiple Product Offers\New Acquisition - Add Equipment - Response Message.txt
- The web service output message is a document generated in memory with the structure shown in the following table.
|
|
|
|
1.0 |
Medium Triple Play Bundle |
|
Add |
2.0 |
Internet Service |
Medium Triple Play Bundle |
Add |
2.1 |
Fibe 100GB |
|
Add |
2.2 |
Online Security |
|
Add |
3.0 |
Voice Service |
Medium Triple Play Bundle |
Add |
3.1 |
Flat National |
|
Add |
4.0 |
TV Service |
Medium Triple Play Bundle |
Add |
4.1 |
Essential Plan |
|
Add |
4.2 |
Basic Movie Package |
|
Add |
4.3 |
Spanish Combo Package |
|
Add |
5.0 |
Internet Router |
Medium Triple Play Bundle |
Add |
6.0 |
Premium Set-Top box |
Medium Triple Play Bundle |
Add |
NOTE: A line item has been added to the order for the Premium Set-Top Box.
- The customer can complete customizing the order by selecting more services, but in this case, the customer just clicks the Place Order button.
- The eCommerce web application calls the Siebel ApplyMultipleProductOffertoCreateOrder web service with SaveFlag set to Y.
Scenario for Upsell Offers
An existing customer has TV service with the Basic Movie package. This customer logs in to the telecommunication provider's e-Commerce site to pay his bill.
- The telecommunication provider's e-Commerce Web site displays upsell offers that can be added to the customer's existing TV service, and the customer selects the following options:
- Premium Movie Package
- On-Demand TV Service
- To generate a quote, the eCommerce web application calls the Siebel web service ApplyMultipleProductOffers. Because we are modifying the customer's existing service, you specify the asset-id in the input message.
To view an example of this web service, navigate to the documentation library for Siebel applications on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/index.html), and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. See the following files to view the sample code:
- ...\Product Offer-Apply Multiple Product Offers\Existing Customer - Upsell Add-ons - Request Message.txt
- ...\Product Offer-Apply Multiple Product Offers\ Existing Customer - Upsell Add-ons - Response Message.txt
- The web service output message is a document generated in memory with the structure shown in the following table.
|
|
|
|
1.0 |
TV Service |
Medium Triple Play Bundle |
- |
1.1 |
Essential Plan |
|
- |
1.2 |
Spanish Combo Package |
|
- |
1.3 |
Basic Movie Package |
|
Delete |
1.4 |
Premium Movie Package |
|
Add |
1.5 |
On-Demand TV |
|
Add |
NOTE: Basic Movie Package is replaced with Premium Movie Package
Alternative Use of the Web Service in This Scenario
Alternatively, the ApplyMultipleProductOffers Web service supports the document id in the input message. The document id is either an order or quote id that exists in the Siebel database. For example:
- The first web service call adds Premium Movie Package and saves the order to the Siebel database.
- The second web service call updates the order in Siebel with On-Demand TV service.
Scenario for Changing Service Plan
An existing customer has the Medium Double-Play Bundle, which includes Internet and Voice services. She logs in to the telecommunication provider's e-Commerce site to add TV service.
- The customer places an order for the Medium Triple-Play Bundle, which includes Internet, Voice, and TV services.
- To generate a quote, the eCommerce web application calls the Siebel web service ApplyMultipleProductOffers. Because we are changing from a Double Play bundle to a Triple Play bundle, you specify the asset-id of the Double Plan bundle in the input message. Because this is an in-memory quote, you specify that the order is not saved by populating the SaveFlag with N in the input message.
To view an example of this web service, navigate to the documentation library for Siebel applications on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/index.html), and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. See the following files to view the sample code:
- ...\Product Offer-Apply Multiple Product Offers\ Change Plan - InMemory Upgrade - Request Message.txt
- ...\Product Offer-Apply Multiple Product Offers\ Change Plan - InMemory Upgrade- Response Message.txt
- The web service output message is a document generated in memory with the structure shown in the following table.
|
|
|
|
1.0 |
Medium Double Play Bundle |
|
Delete |
2.0 |
Medium Triple Play Bundle |
|
Add |
3.0 |
Internet Service |
Medium Triple Play Bundle |
Update |
4.0 |
Digital Voice Service |
Medium Triple Play Bundle |
Update |
5.0 |
Internet Router |
Medium Triple Play Bundle |
Update |
6.0 |
TV Service |
Medium Triple Play Bundle |
Add |
7.0 |
Premium Set-top box |
Medium Triple Play Bundle |
Add |
NOTE: Existing Internet and Voice Services are transferred to the new Triple Play Bundle.
Scenario for Build Your Own Bundle
A new customer browses the e-Commerce site of a telecommunications provider and finds that the bundles of services offered on the site do not meet her requirements. She decides to create her own bundle of services by selecting individual options.
- The customer selects Build Your Own Bundle and chooses the following options:
- Internet - 500 mbps (highest speed)
- VoIP - Per minute call
- Basic Home Security package.
- To generate a quote, the eCommerce web application calls the Siebel web service ApplyMultipleProductOffers. Because this is an in-memory Quick Quote, you specify that the quote is not saved by populating the SaveFlag with N in the input message.
To view an example of this web service, navigate to the documentation library for Siebel applications on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/index.html), and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. See the following files to view the sample code:
- ...\Product Offer-Apply Multiple Product Offers\ BuildYourOwnBundle - Request Message.txt
- ...\Product Offer-Apply Multiple Product Offers\ BuildYourOwnBundle - Response Message.txt
- The web service output message is a document generated in memory with the structure shown in the following table.
|
|
|
|
1.0 |
Build Your Own Bundle |
|
Add |
2.0 |
Internet Service |
Build Your Own Bundle |
Add |
2.1 |
Fibe 500GB |
|
Add |
3.0 |
Voice Service |
Build Your Own Bundle |
Add |
3.1 |
Per Minute Plan |
|
Add |
4.0 |
Home Security |
Build Your Own Bundle |
Add |
4.1 |
Basic Package |
|
Add |
|