Revision History

This document will continue to evolve as existing sections change and new information is added. All updates appear in the following table:




15 FEB 2018

DCU Enhancements

Removed from December 2017 update.

17 JAN 2018

Created initial document.


This guide outlines the information you need to know about new or improved functionality in Oracle Commerce Cloud December 2017 Update and describes any tasks you might need to perform for the update. Each section includes a brief description of the feature, the steps you need to take to enable or begin using the feature, any tips or considerations that you should keep in mind, and the resources available to help you.

Give Us Feedback

We welcome your comments and suggestions to improve the content. Please send us your feedback at Please indicate you are inquiring or providing feedback regarding the Oracle Commerce Cloud What’s New for December 2017 Update in the body or title of the email.

Feature Summary

We continue to add many new features to Oracle Commerce Cloud and we now give you the option to take advantage of new functionality at a pace that suits you. The table below offers a quick view of the actions required to enable each of the new features.

Action Required to Enable Feature


Automatically Available

End User Action Required

Administrator Action Required

Oracle Service Request Required

Major New Features

B2B and B2C: Quick Order

B2B: Purchase Lists

B2B: Display Custom Attributes in Accounts and Contacts

Storefront: Shopper-Initiated Returns (API Only)

Audiences: Promotions by Audience

Audiences: Select Audiences for Reporting

Additional Features

Admin: Multi-Factor Authentication for Admin Access

Extensibility: Updated SSO Support

Extensibility: Shipping Calculator Webhook Fallback Logic

Selective Publishing: Sorting and Searching the Change List

Experience and Design: SEO--Lastmod Tag

Integrations: Asset-Based Ordering: Asset Operations

Assisted Selling Application: Appeasements at the Line Level

Major New Features

The major new features released in the Oracle Commerce Cloud December 2017 Update include:


Quick Order

Allows storefront users to quickly add known items to their order instead of browsing for items. Available for both B2B and B2C, the Quick Order widget can be placed on one or more storefront layouts (e.g. Home Page) in order to allow customers to quickly select items, enter a quantity, and add those items to their cart.

Leverages type-ahead search to simplify the finding of items and includes the ability to add multiple items to the cart at once. Provides another option for efficiently adding known items to an order.

NOTE: Must be placed on appropriate layouts in the Design tab and must be placed in a Pop-Up Stack.

Purchase Lists

Allows both B2B and B2C storefront users to add frequently purchased items to a saved list. Unlike wish lists which are already available out of the box in Commerce Cloud, items in purchase lists are products that persist in the list and are commonly reordered and/or typically ordered together. Has particular use for merchants selling grocery items, supplies, and similar products.

Leverages type-ahead search to simplify the finding of items to add to a purchase list. Provides another option for efficiently adding known items to an order and purchasing them.

Shoppers can have multiple purchase lists, but they cannot be shared. Purchase lists are associated with a shopper’s profile and therefore are accessible from any site a shopper has access to.

Display Custom Attributes in Accounts and Contacts

Custom properties that are added to the Account and/or Contact entities (via API only) are now visible in the UIs for both entities, improving usability for Admins. Once visible, the values of both can be edited by Admins.

Search capabilities on both Accounts and Contacts has been extended to support custom text properties.

NOTE: Sub-accounts do not currently inherit the values within custom account properties from parent accounts.


Shopper-Initiated Returns (API Only)

The initial phase of shopper-initiated returns is now available with the December 2017 Update.

New Storefront REST APIs have been added to support:

Merchants can now mark a product or SKU as non-returnable. In addition, a new return order email template has been added and the existing Agents returns feature has been updated to use the non-returnable product flag and display shopper-initiated returns.

Widgets will need to be customized to call the new returns endpoints to enable this feature.

NOTE: Order must be in the fulfilled state before a return can be initiated.


Promotions by Audience

Business users can now associate one or multiple audience segments with a promotion, providing more control over who can qualify for a particular promotion.

A new Availability tab has been added to the Promotions UI in the OCC Admin to make it easy to add audiences to promotions.

For example, if a merchant wants to provide a discount to employees only, the merchant would set up an audience called “employees” where the shopper is flagged as an employee of the company. The merchant would then create a promotion in the Admin UI as usual. And now, the merchant can navigate to the Availability tab in the Admin UI and choose the “employees” audience as the only one the promotion should apply to. When an employee is shopping on the site, s/he can redeem coupon codes and/or receive discounts based on employee status. Those shoppers not designated as employees would not receive the discount.

NOTE: By default, promotions apply to all audiences, so business users will need to specify an audience to limit which segment the promotion should apply to.

Select Audiences for Reporting

Allows merchants to identify specific audiences for which they want to start gathering reporting data. Audiences which have been selected for reporting now show a chart icon in the Audiences list.

Additional New Features and Other Changes

There are also a number of additional new features, changes, and improvements included in the Oracle Commerce Cloud December 2017 Update. By functional area, these include:

Browser Support

Browser support is up-to-date. Note: iOS 11.0 is now supported.

Language and Currency Support

Languages: No new languages added.

Thirty-six languages are currently supported: Arabic (ar) (Storefront only), Bulgarian (bg), Chinese—Simplified (zh_CN), Chinese—Traditional (zh_TW), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), English (en), English-GB (en-GB), Estonian (et), Finnish (fi), French (fr), French Canadian (fr_CA), German (de), Greek (el), Hungarian (hu), Italian (it), Japanese (ja), Korean (ko), Latvian (lv), Norwegian (no), Polish (pl), Portuguese—Brazil (pt_BR), Portuguese—Portugal (pt_PT), Romanian (ro), Russian (ru), Serbian - Cyrillic (sr), Serbian – Latin (sr_Latn),,Slovenian (sl), Spanish (es), Swedish (sv), Thai (th), Turkish (tr), Ukrainian (uk).

Currencies: No new currencies are supported.

Sixty-one currencies are currently supported: AED (UAE Dirham), ARS (Argentine Peso), AUD (Australian Dollar), BGN (Bulgarian Lev), BOB (Boliviano), BRL (Brazilian Real), CAD (Canadian Dollar), CHF (Swiss Franc), CLP (Chilean Peso), CNY (Chinese Yuan Renminbi), COP (Colombian Peso), CRC (Costa Rican Colon), CZK (Czech Koruna), DKK (Danish Krone), DOP (Dominican Peso), DZD (Algerian Dinar), EGP (Egyptian Pound), EUR (Euro), GBP (British Pound Sterling), GTQ (Guatemalan Quetzal), HKD (Hong Kong Dollar), HNL (Lempira), HRK (Croatian Kuna), HUF (Hungarian Forint), IDR (Indonesian Rupiah), INR (Indian Rupee), JPY (Japanese Yen), KES (Kenyan Shilling), KRW (South Korean Won), KZT (Tenge), LBP (Lebanese Pound), MAD (Moroccan Dirham), MXN (Mexico Peso), MYR (Malaysian Ringgit), NGN (Naira), NIO (Cordoba Oro), NOK (Norwegian Krone), NZD (New Zealand Dollar), PAB (Panamanian Balboa), PEN (Peruvian Nuevo Sol), PHP (Philippine Peso), PKR (Pakistani Rupee), PLN (Polish Zloty), PYG (Paraguayan Guarani), QAR (Qatari Riyal), RON (Romanian Leu), RSD (Serbian Dinar), RUB (Russian Ruble), SAR (Saudi Riyal), SEK (Swedish Krona), SGD (Singapore Dollar), THB (Thai Baht), TJS (Somoni), TRY (Turkish Lira), TWD (New Taiwan Dollar), UAH (Ukrainian Hryvnia), USD (US Dollar), UYU (Uruguayan Peso), VND (Vietnamese Dong), XAF (CFA Franc BEAC), ZAR (South African Rand.


Multi-Factor Authentication for Admin Access

To improve security for Oracle Commerce Cloud customers and adhere to industry PCI practices, multi-factor authentication is now needed to access the OCC Admin in all environments. This does not affect Agent or Assisted Selling Applications.

All customers must enter a one-time passcode (generated by Oracle Mobile Authenticator), in addition to their user name and password, every time they want to log in, including logging back in if automatically logged out. 

NOTE: This feature will be automatically enabled upon installation of the December 2017 Update. All existing users will receive an email containing instructions on downloading and setting up Oracle Mobile Authenticator with Commerce Cloud. New users created afterwards will get the setup information in their initial email. More details are available in this FAQ in Customer Connect, as well as the official December 2017 Update online documentation.


Updated SSO Support

Single Sign-On Shoppers (SSO) and “native” Commerce Cloud shoppers can now be supported at the same time.

Both the out-of-the-box login extension and the SSO login extension can be added to the same login widget and customized to provide the desired login experience. Can be used to support social login providers supporting SAML2.

Shipping Calculator Webhook Fallback Logic

Merchants can now designate one or more internal shipping methods as a fallback in the unlikely event that the Shipping Calculator Webhook service is unavailable. For example, merchants can create a flat rate, two-day fallback shipping method with the provider of their choice right in the Admin UI, ensuring an order is not lost if some sort of outage occurs.

Pricing and availability is determined the same way for fallback shipping methods as for existing internal shipping methods.

Recommended to have a minimum number of fallback shipping methods defined for all sites, shipping regions, currencies.

Selective Publishing

Sorting and Searching the Change List

Allows Admin users to sort assets in the publishing change list by oldest or latest modified date, as well as search the change list by entering a string query, making it easier to find the assets they want to select for publishing.

Experience and Design

SEO – Lastmod Tag

The lastmod tag has been added to the sitemap index file, timestamping when each XML sitemap file has been updated or modified. This feature adds atimestamp to each file in the sitemap index with the lastmod property:


This provides clearer instruction to search engines when sitemap files have changed.


Asset-Based Ordering: Asset Operations

Previously, asset information displayed was read-only, allowing only the ability to retrieve and display assets. Now, it is possible to create basic asset-based orders and for shoppers to renew, modify, and/or terminate operations on assets (e.g. service, subscriptions).

When merchants are selling subscriptions or services, they can now use this feature to allow shoppers to execute basic operations on those services directly via self-service channels, to do actions like renew, change, or cancel a membership, for example.

Includes out of the box integration with CPQ which serves as the asset management CX system, although it is possible to integrate with other asset master systems as well. Includes sample (not out of the box) Asset Actions webhook, as well as necessary Asset Integration ICS flow with CPQ, in addition to Asset List and Asset Details page layouts and widgets previously released.

Assisted Selling Application

Appeasements at the Line Item Level

Allows store associates with sufficient permissions to provide shopper appeasements at the line item level during order creation and displays all appeasement changes throughout the app experience, including shopping cart, order history, and returns.

This enhancement provides store associates with more control over guiding the shopper experience in-store and provides increased transparency and continuity across all channels.

NOTE: Does not include ability to amend an order once it has been placed. Amendments after an order has been placed should be handled in the Agent console.


A special Oracle logo highlighting Oracle's commitment to developing practices and products that protect the environment. copyrightlogo