Home
Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ product, from installation and deployment to operating and customization.
Extending
Using Commerce+'s xC programming model, you can use HCL-provided extension points to extend existing Commerce logic. You can implement these extensions with the xC Customization toolkit provided by HCL. Commerce+ also provides Packaged Business Capability integrations that extend the product's reach and functionality.
Developing stores
Commerce+ offers customizable features for storefronts using the Next.js framework. Commerce+ supports headless commerce to use any front end storefront.
Ruby storefronts
The Ruby storefront offers customizable features for storefronts using the Next.js framework. It uses the headless store data template and supports business-to-consumer (B2C) and business-to-business (B2B) use cases. The store includes pages for browsing, shopping, checkout, and account management, and uses Elastic for search functions.
Ruby storefront B2C and B2B features
Commerce+ offers various features for Ruby storefronts (B2C and B2B) listed on this page.
Primary addresses
The primary address is the default address in your Ruby storefront account. It is stored in your profile for easy access during checkout and order management. This address is used for billing, shipping, and communication purposes.
Editing
You can edit the Primary Address from the Address Book page.

Documentation
This Help Center provides documentation on all aspects of the HCL Commerce+ product, from installation and deployment to operating and customization.
- Overview
  Welcome to the HCL Commerce+ overview. Explore these feature overviews to learn how Commerce+ operates. Refer to the related links listed at the end of each topic to access expanded product documentation.
- Deploying
  This section provides details on deploying HCL Commerce+. It explains how to download the Docker images and Git bundles that comprise the product, how to create a minimal environment, and how to plan for a full deployment. It details supported software versions, patches, and configurations to ensure the platform performs well.
- Migrating
  The following topics show how to migrate an existing HCL Commerce Version 9.1 environment to Commerce+. The process consists of an initial migration of your database contents. This is followed by a code migration. Both are fully described.
- Operating
  The topics in this section focus on tasks that are performed by business users, marketers, and customer support representatives to connect with partners and attract and satisfy customers.
- Administering
  The site administrator performs the tasks needed to support day to day operations of the Commerce+ site.
- Extending
  Using Commerce+'s xC programming model, you can use HCL-provided extension points to extend existing Commerce logic. You can implement these extensions with the xC Customization toolkit provided by HCL. Commerce+ also provides Packaged Business Capability integrations that extend the product's reach and functionality.
  - Customizing
    The topics in the Customizing section describe tasks performed by an application developer to customize Commerce+.
  - Developing stores
    Commerce+ offers customizable features for storefronts using the Next.js framework. Commerce+ supports headless commerce to use any front end storefront.
    - Stores in Commerce+
      Commerce+ supports different types of stores. The assets of these stores can be edited using the Commerce Lab.
    - Ruby storefronts
      The Ruby storefront offers customizable features for storefronts using the Next.js framework. It uses the headless store data template and supports business-to-consumer (B2C) and business-to-business (B2B) use cases. The store includes pages for browsing, shopping, checkout, and account management, and uses Elastic for search functions.
      - Creating a custom storefront
        You can create a server-side rendered storefront using the Commerce+ Next.js Store SDK. The Next.js Store SDK allows your front end development of a storefront using an easy extension paradigm.
      - Ruby B2B storefront
        The Ruby B2B storefront is enabled for B2B e-commerce. The sample B2B storefront is called Ruby B2B. The Ruby B2B storefront features include B2B features, in addition to all of the available features in the B2C storefront.
      - Ruby storefront (B2C)
        The Ruby storefront (B2C) is built on the Next.js framework, ensuring seamless browsing, easy navigation, and secure transactions. Notably, this new storefront provides server-side rendered pages to assist with Search Engine Optimization (SEO) and page previews.
      - Ruby storefront B2C and B2B features
        Commerce+ offers various features for Ruby storefronts (B2C and B2B) listed on this page.
        My account page
        The My Account page displays the personal details, recent order details and other account tools of the registered shoppers and enables them to edit their personal information page and reorder their past order items.
        Locating stores with a store locator
        The Store Locator feature allows the shopper to easily locate a physical store of their choice by using online maps. This feature is especially designed to enable them to physically pick up the products bought online, from a store of their choice.
        Using buy online, pickup in store (BOPIS)
        The BOPIS feature allows the user to pick up the products purchased online from a physical store of their choice, without any pickup charges.
        Saving products for later
        When you decide to postpone the purchase of an item in the shopping cart, you can save it for a potential future purchase.
        Managing shopping carts
        You can view the items added for purchase in the shopping cart.
        Multiple shipment
        Shoppers purchasing products via react-based stores could only place an order for a single shipping address can now choose a multiple shipment option when placing an order. This document provides information on the multiple shipment facility provided to shoppers for the Ruby storefront.
        Multiple payment
        Shoppers buying products in Ruby storefront can pay a part of the total cart value by using various payment options such as cash on delivery or credit cards with the introduction of the multiple payment option.
        Primary addresses
        The primary address is the default address in your Ruby storefront account. It is stored in your profile for easy access during checkout and order management. This address is used for billing, shipping, and communication purposes.
        Creating
        You can create a new address and set it as the primary address for your Ruby storefront account.
        Editing
        You can edit the Primary Address from the Address Book page.
        Multiple language and currency support
        Ruby storefronts (B2C and B2B) support multiple languages and currencies. You can view content and pricing in their preferred language and currency.
        Product comparison
        The product compare feature allows you to compare items from the Product Listing Page (PLP) in tabular form on a dedicated screen.
        Kit details
        A kit is a collection of items that are sold together as one catalog entry. The default layout for the page displays the kit name, image, price, short description, long description, descriptive attributes, and more. You can check inventory availability for the kit and add the kit to their cart or current order.
        Bundle details
        The Bundle page displays various combinations of items (bundles) in tabular form, which allows you to select attributes for products and their variants. The default layout for the page displays the bundle name, image, price, short description, long description, descriptive attributes, and more. Users can check inventory availability for the components in the bundle and add the bundle to their cart or current order.
        Quick order
        You can place orders within the Ruby storefront using the quick order functionality without navigating through product details and listing pages. This feature enables you to add multiple items to the shopping cart and proceed with the purchase.
        Checkout
        The checkout page displays the shipping and payment details for the items in the shopping cart.
        Guest shopping
        Guest shopping allows users to browse and purchase from the Ruby storefront without creating an account. This feature enhances the user experience in both B2C (Business-to-Consumer) and B2B (Business-to-Business) models by offering a flexible purchasing process.
        Volume pricing
        Volume pricing is a pricing structure where the cost per product decreases as the quantity purchased increases.
        Coupon wallet
        A coupon wallet is a storage for the coupons a shopper receives.
        Enabling schema org metadata
        Schema org metadata is added to the Ruby storefront pages for better search engine optimization (SEO). Schema org is a collaborative community activity that creates, maintains, and promotes schemas for structured data on the internet, web pages, email messages, and beyond.
        Enabling open graph tags
        Open Graph tags function is added to Ruby storefront pages to enhance search engine optimization (SEO) and improve how content appears when shared on social media platforms.
        ATP storefront integrations
        This feature allows you to view backordered products labeled Available for Backorder along with an expected availability date. You can place orders for out-of-stock items and schedule delivery or pickup for the expected date. The Schedule for Later option provides flexibility by enabling you to select a future date for delivery or a pickup date and time for pickup.
        In-progress orders and saved carts
        In-progress orders allow users to save their shopping carts for later checkout. This feature enables users to add items, make modifications, and complete the purchase at their convenience without losing their selections. This functionality is available for both B2C and B2B Ruby storefronts. To use this feature on Ruby storefronts, the user must navigate to Account Settings and click In-Progress Orders.
        Video support
        On Product Detail Pages (PDP), videos appear alongside product images, providing an interactive shopping experience. Customers can click the video icon to play the video and use the built-in video player to watch product demonstrations, unboxings, or usage examples, helping them make informed purchase decisions.
      - GDPR/Privacy Policy
        Commerce+ provides the GDPR (privacy policy) enablement process.
      - Multiple Extended Site (eSite) access
        The Next.js store supports multiple eSite access with a single deployment.
    - The Customer Service Hub
      The Customer Service hub, also known as the CSR tool, provides your Customer Service Representatives (CSRs) an authority to manage Accounts and Orders for a selected store.
    - Remote store toolkit
      You can migrate store development environments to Open Liberty and a modern Java Development Kit (JDK) by using Commerce+ remote store dev kit migration to standardize environments and minimize reliance on legacy tooling.
- Securing
  These topics describe the security features of Commerce+ and how to configure these features.
- Performance
  Topics in the Performance section describe the means by which to plan, implement, test, and re-visit the optimization of Commerce+ site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with Commerce+, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the Commerce+ reference documentation.

Editing the Primary Address for Ruby storefronts (B2C and B2B)

You can edit the Primary Address from the Address Book page.

About this task

When you create an account and enter address details, the address is saved as the Primary Address, but it is incomplete. To complete it, editing is require.

Procedure

Open the Ruby storefront landing page.
Navigate to the Address Book.
The Address Book page opens.
Click the Edit button.
The Edit Address page opens.
Enter the address details.

Note: You can not change the address type for the selected primary address from the Address Book page.
Click the Save changes button, to save the changes.

Note: Click the Cancel button to discard the changes.

Results

The edited address is saved as the Primary Address for future orders and communications.