Skip Headers

Oracle iStore Implementation and Administration Guide
Release 12.1
Part Number E13575-08
Go to Table of Contents
Go to previous page
Go to next page

Integrating Oracle iStore with Oracle Sales Contracts

This chapter covers the following topics:

Overview of Integrating Oracle iStore with Oracle Sales Contracts Chapter

This chapter describes the integration of Oracle iStore with Oracle Sales Contracts to provide Terms and Conditions (T&Cs) functionality in the Customer Application.

Overview of Oracle Sales Contracts

Oracle Sales Contracts, through its integration with Oracle Order Management, allows sales representatives and others involved in the sales cycle to create short- or long-term customer contracts, including terms and conditions (T&Cs), for use in Web-based stores, Oracle Quoting, and other Oracle E-Business Suite applications. The functionality leverages integration into Oracle's contract management system, and includes formal negotiation, complete with internal approval and customer acceptance processes. Oracle Sales Contracts users not only benefit from the fundamental capabilities required for sales negotiation, but from the additional contractual capabilities, such as T&Cs, price holds, and the capability to enforce the agreed upon-terms for future customer purchases. See the Oracle Order Management implementation and user documentation for more information.

Setting up Oracle Sales Contracts

Set up Oracle Sales Contracts according to the latest version of the Oracle Order Management Implementation Manual.

Note: To use the Terms and Conditions functionality, you must integrate with Oracle Quoting. See the chapter, Integrating Oracle iStore with Oracle Quoting, for more information.

Terms and Conditions

Merchants can make it mandatory that terms and conditions (T&Cs) get attached to an order during checkout in Oracle iStore's Customer Application. In the Checkout: Review Terms and Conditions page, implementers can give customers the option to view T&Cs in HTML format, and then let them accept or reject the terms of the order. The T&Cs are contracts set up through Oracle Sales Contracts module. Each of your customer responsibilities can be tied to a different standard contract. In Oracle Quoting, sales representatives can alter the standard contract and then publish the cart/quote back to the customer for review.

In addition, the Contract Expert feature of Oracle Sales Contracts provides the ability to dynamically add additional pre-approved clauses to a contract, based on attributes of an Oracle iStore shopping cart or quote.

Terms and Conditions Process Flow

The T&Cs process flow (also known as the contract negotiations process flow) is initiated when a customer disagrees to the T&Cs on an order. The following is the high-level process flow for T&Cs:

  1. A customer creates a shopping cart, or retrieves a published quote, and proceeds through the checkout pages, arriving at the Checkout: Terms and Conditions page.

  2. The Checkout: Terms and Conditions page displays just before the Checkout: Review and Place Order page, which is the final page in the checkout flow. For the actions that a customer can perform in this page, see the section, "Terms and Conditions Page", in the chapter, Implementing Carts and Orders. The T&Cs are presented in HTML format, with system variables -- such as customer and order information -- resolved into the T&Cs through APIs. In this scenario, the T&Cs attached to the order are the standard contract specified by the Oracle Quoting parameter, Default Contract Template.

  3. If the customer accepts the standard T&Cs, the order proceeds as normal. The T&Cs are attached to the sales order when the order is placed in Oracle Order Management.

  4. To reject the T&Cs, the customer selects the I Disagree button in the Checkout: Terms and Conditions page. This action initiates the Sales Assistance flow -- see the section, "Sales Assistance Process Flow" in the chapter, Implementing Customer Assistance. The only difference between this flow and the Sales Assistance flow is that the e-mails sent in this flow are related to Contract Negotiations instead of Sales Assistance. See the chapter, Integrating Oracle iStore with Oracle Workflow, for more information about the Contract Negotiations e-mail notifications.

  5. In a typical Contract Negotiations flow, the sales representative would launch the Contracts authoring tool via Oracle Quoting to change the T&Cs attached to the order. Once an order is placed with the quote, the T&Cs attached to the quote get passed along to Oracle Order Management with the sales order. See the chapter, Integrating Oracle iStore with Oracle Quoting, for more information on quote publishing. In addition, any contract documents that the sales representative has attached to the quote also are submitted with the order. Note that the customer will not be able to view contract documents attached to the order.

Express Checkout with Terms and Conditions

When customers submit orders for Express Checkout, they can preview the standard T&Cs associated with the shopping cart where they placed the items into their express checkout queue. If the customer doesn't agree with the T&Cs, they should cancel the express checkout order. See the chapter, Implementing Carts and Orders, for more information about Express Checkout.

Implementing Terms and Conditions

In addition to setting up the contract authoring tool (and any other related setups), the following steps are required to set up the T&Cs functionality for use with Oracle iStore.

Note: The system maintains reference to the T&C standard contract at the quote header level.

Implement Oracle CRM Application Foundation Notes Module

Comments associated with a T&Cs rejection scenario are stored in Oracle CRM (JTA) Notes; therefore, this module is a required dependency for the T&Cs functionality. See the Oracle Trading Community Architecture Administration Guide for information on how to set up the Notes module.

Set Profile Options

Set the following profile options:

Refer to the appendix, Profile Options, for more information on settings of these profile options.

Set up Contract Template Document Type

For Oracle iStore T&Cs to function properly, ensure that the contract template document is enabled for the document types, Sales Order and Quote.

Contract Expert

The Contract Expert feature of Oracle Contracts provides the ability to dynamically add additional pre-approved clauses to the T&Cs, based on attributes of a cart. This allows contract departments to minimize the number of standard clauses contained in a contract – the standard clauses appearing in the contract are only those that apply to the specific order. For example, rather than showing all clauses for database, applications server, and application when the customer is only buying database products, Expert would provide only the terms related to the database products and could be displayed in addition to any other standard terms.

How Contract Expert Works

Implementers set up a Contract Expert-enabled contract and set it as the default contract for Oracle iStore T&Cs. In the Customer Application, as a customer proceeds to review the T&Cs, Contract Expert runs in the background, and, using APIs, gathers attributes of the shopping cart and sends pre-defined contract clauses back to the terms and conditions page based on the cart attributes. If a customer requests help or disagrees with the T&Cs, the cart or quote is retrieved by the sales representative in Oracle Quoting. The sales representative initiates Contract Expert during the quote update process in order to pull in any additionally needed clauses. The sales representative then publishes the quote back to the customer. Other than the display of clauses in the Checkout: Terms and Conditions page, there is no user interface change with this functionality on the part of Oracle iStore.

Also note the following:

Express Checkout with Contract Expert

When a customer places an Express Checkout order with Contract Expert enabled, following is the behavior:

Cart Attributes Supported for Contract Expert

Following are the cart attributes supported for Contract Expert:

Implementing Contract Expert

Following are the steps to set up Contract Expert for Oracle iStore. For additional setups not covered here, see the Oracle Contracts Implementation and Administration Guide, the Oracle Sales Contracts Implementation Guide and the Oracle Quoting User Guide.

  1. In Oracle Contracts, set up a contract with the proper layout and numbered sections for Oracle iStore.

  2. Ensure that the contract has its Contract Expert flag enabled.

  3. Set the profile option, OKC: Use Contract Expert, to Yes at site level. This profile option determines whether Contract Expert can be used by an organization in the Oracle E-Business Suite. If set to No, Contract Expert is not enabled in Oracle Contracts.

  4. Set the contract as the default contract template for Oracle iStore, using the Oracle Quoting parameter, Default Contract Template. See the "Oracle Quoting Integration Parameters" topic in the appendix, Profile Options, for more information.

  5. Terms and Conditions must be made mandatory in Oracle iStore to use Contract Expert. Set the profile option, IBE: Enforce Terms and Conditions Review by User, to Yes.

Unstructured Contract Terms

Sales representatives in Oracle Quoting have the ability to download the structured contract terms to an .rtf file, make modifications as required and upload the document back into the system where they are considered contract terms (or a portion of the contract terms) on a publishable quote. Sales representatives also can upload a new document (of any file type) and have that document be considered the contract terms. This functionality is known as Unstructured Contract Terms, and the newly added terms are also called unstructured contract terms.

Note: The rules and functional descriptions in this section assume that Oracle Sales Contracts is enabled (the profile option, OKC: Enable Sales Contracts, is Yes), and that Oracle Quoting is implemented.

Unstructured Contract Terms Behavior with Oracle iStore

A published quote is considered to have contract terms if the contract source is Structured Terms or an Attached Document. If the source is Attached Document, Unstructured Contract Terms functionality is being used. When the contract source is Structured Terms, there is no change in the behavior of T&Cs.

If Unstructured Contract Terms is being used, but no attachment has actually been uploaded to the contract, then the following occurs in the Checkout: Review Terms and Conditions page:

Requirements for Displaying T&Cs in HTML

With Unstructured Contract Terms functionality, in order for the T&Cs page to display as intended in HTML format, an attached document must exists on the contract, and the following must be true of the attached document:

If the above conditions are true, the attached document is considered mergeable. If the contract source is Attached Document and any of the above conditions are not satisfied, Oracle iStore will show a hyperlink to the attached document in the T&Cs page; selecting the hyperlink will retrieve the document using the default application on the customer's computer (e.g., Microsoft Word). Oracle Contracts APIs evaluate the above conditions (which is done whether or not the contract attachment is considered mergeable).

Express Checkout with Unstructured Contract Terms

When an Express Checkout cart is submitted to the express checkout queue, the system does not validate the presence of any attached documents at that time. It is when the customer selects the review terms and conditions link that the validation is done, with the following behavior:

Note: With Express Checkout, contract terms are associated at the time of converting the cart to an order. The terms and conditions are not checked when the Express Checkout button is clicked.