This page provides Business administrators a user guide for the Foundation microservice for the Infosys Equinox Commerce platform.

Page Contents

Getting Started

Overview

Accessing the Foundation Console

The Infosys Equinox Foundation Admin Console is a centralized interface that allows administrators to manage and configure various aspects of the Infosys Equinox platform. This console provides a comprehensive set of tools and features designed to streamline administrative tasks, enhance security, and improve user experience. With its intuitive design and user-friendly navigation, the console simplifies the process of managing users, setting permissions, configuring settings, and monitoring system performance.

Once a business is created with the appropriate configurations and enabled microservices during implementation, the business admins can manage settings, create/manage stores, invite and manage teams, assign various roles for each business tool, and so on. It also provides a list of supported countries, currencies, locales, services, store types, and time zones for business.

Two distinct capabilities available in the Foundation Admin Console that allow admins to manage the business effectively are admin and operations. Admin controls are available to store and service admins to control all administrative aspects of the business, including enabling microservices, adding a microservice collection, creating a store with domain-specific data (like MLM, Retail, Telco, and Auto), and mapping stores to services.

Operation capabilities are used by teams to manage the day-to-day operation of each of the microservices.

Business admins can:

  • Switch between the admin and operations capabilities.
  • Invite other users to the business.
  • Customize the admin consoles.

For a detailed overview of the Foundation microservice, see the Foundation Microservice Overview.

Business On-Boarding Workflow

Once a company receives its Infosys Equinox Commerce deployment, business admins set up the commerce infrastructure. The process varies based on each business’s setup and needs. Below is a possible onboarding workflow for a new implementation:

Planning

  • Identify the store(s) to be created and gather relevant details (type, name, locales, currencies, etc.).
  • Determine the required microservices for each store and decide if each store will use a separate instance of each microservice or whether stores will share the same instance of one or more microservices (for example, cart and checkout, orders, inventory).
  • Identify company employees who will serve as editors and managers for each microservice.

Collection Management

  • Create collections within the business and configure them for each store per Infosys Equinox Commerce microservice (for example, promotion, inventory, customer).

Store Management

  • Create and configure store(s).
  • Associate the appropriate collection of each microservice with the store(s).

Authorization Management

  • Create Infosys Equinox Commerce accounts for microservice editor and manager roles (for example, Catalog Editors, Catalog Managers, Customer Service Representatives (CSRs), etc.)

For example, say Business X has four stores (for example, XS1, XS2, XS3, and XS4) with a separate and distinct catalog, price list, and promotion data and configurations. However, all four stores may use the same cart, order, and customers (user) microservice configurations. In this case, the following collections will need to be created for Business X:

image alt text

Service Glossary

  • Business – the parent of a store or set of stores. The basic use of a business is to manage common sets of users, catalogs, and other services for the stores associated with the business.
  • Business Admin – a role that manages business settings, creates and manages stores, and enables microservice(s) for a business.
  • Business-to-business (B2B) – a business model in which commerce transactions are carried out between two businesses.
  • Business-to-customer (B2C) – a business model in which commerce transactions are carried out between a business and an end-customer (storefront user).
  • Business-to-business-to-consumer (B2B2C) – this business model combines two or more businesses (B2B) and consumers (B2C) to provide comprehensive services to both businesses and customers, thereby providing mutually beneficial services.
  • Collection – provides a set of properties that control the behavior of the microservice when launched. Allows Business Admins to set up different information for each store so that a Business can have multiple stores, each with its own configuration for a specific microservice.
  • Microservice – a self-contained application that is the building block of a loosely coupled services architecture consisting of other microservices. The Infosys Equinox Commerce platform version 8.0 includes the following microservices:
    • Foundation
    • Accounts (B2B)
    • Address
    • App Marketplace
    • Authorization
    • Cart
    • Catalog
    • Customers (Users)
    • Feeds
    • Feed Job
    • Inventory
    • Lists
    • Location
    • Loyalty
    • Merchandising
    • Notification
    • Orders
    • Payment
    • Pricing
    • Promotions
    • Ratings and Reviews
    • Reporting
    • Search
    • Shipping
    • Subscription
    • Tax
  • Store – represents a specific physical location or online store of a business.
  • Storefront – a consumer-facing website that presents products, content, and promotions across multiple channels such as desktop, tablet, and mobile.

Accessing the Foundation Console

top | Configuring Search Parameters

Infosys Equinox’s cloud-based solution (SaaS) allows enabling multi-factor authentication (MFA) at the business instance level for admin users. By default, admin users must enter an email ID and password to log in. With MFA, they must also pass an additional security check using a unique OTP (One-Time Password) sent via email or SMS.

Infosys Equinox’s cloud-based solution (SaaS) offers the option to enable multi-factor authentication (MFA) at the Business instance level for admin users. By default, all admin users are required to enter an email ID and password to log in. But with MFA, the admin users can be required to pass an additional security check with a unique and random OTP (One-Time Password) code sent via email or SMS.

To access the Foundation console, 

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox): 
    image alt text
    If the MFA has not been enabled, the All Businesses page appears:
  2. If the collection property MFA_enabled alone has been enabled, a random and unique OTP code will be sent to the Admin user’s email address or SMS number. Enter the unique OTP from the email or SMS to access the system:

(or)
If both MFA_enabled and MFA_authenticator_enabled collection properties have been enabled, you need to set up an authenticator app during your first login. Once the app has been set up, provide the verification code from the authenticator app:

Note:

    • If an incorrect OTP is provided, the system blocks access and displays a verification error message:
    • After reaching a configurable failed retry threshold, the admin user is redirected back to the login screen to enter a valid email address and password again before the system sends a new OTP for verification.
    • MFA can be configured to set the number of failed retry attempts and the number of times a code can be sent. It also supports verification via email, SMS, or both.

Setting Up an Authenticator App

You can set up an authenticator app for an MFA. This is applicable to all the admin users of a business. The allowed authenticator apps are on your mobile device:

  • Google Authenticator 
  • Microsoft Authenticator
  • Duo Mobile

To set up an authenticator app,

  1. When you log in for the first time as an admin user after activating the account, the following screen appears:
  2. Install the required authenticator app on your mobile.
  3. Click the QR code shown on the above screen.
  4. Scan the QR code using your virtual MFA app or phone camera.
    You can see a new account is added to your authenticator app which shows the MFA verification code.

Configuring Search Parameters

Accessing the Foundation Console | All Businesses Page

On the Foundation landing page, you can search the businesses based on Business Name, Business ID, Default Locale, Default Currency, and/or Business Status, modify the search fields as needed, and select the number of pre-defined rows per screen.

Searching for Business(es)

To search for business(es),

  1. Click the Business Name, Business ID, Default Locale, Default Currency, and/or Business Status drop-down list in the header to open an entry field to provide search criteria.
    Note: For displaying a predefined number of businesses per screen, see Selecting Predefined Rows.
  2. Enter the desired search criteria in the search field:
  3. Click the Go button.
    The business(s), which match the search criteria appears:

Modify Searchable Fields

To modify the searchable fields,

  1. Click the vertical ellipse available at the beginning of the search field.
  2. Select or deselect the items to add or remove the searchable fields in the header:
  3. Click the Go button.
    The selected searchable fields appear in the header:

Selecting Predefined Rows

By default, 10 businesses per screen will appear, but the number of businesses per screen can be modified as follows:

  1. Click the row select option at the bottom-left of the page.

    Foundation_Business_RowSelect
  2. Select the desired number of rows:
    Foundation_Business_RowSelectInputs
    A list of businesses appears as per the row selection:
    Foundation_Business_RowSelectResult

Managing Businesses

Configuring Search Parameters| Revision History

On the All Businesses page, you can:

Note:

  • The pagination option appears on all screens that contain business information.
  • To navigate to the next page, click the page number.

Creating a New Business

For creating a business, see the video given below or refer to the step-by-step instructions.

To create a new business,

  1. On the All Businesses page, click the Add a Business button.
    The Create Business page appears:
  2. Enter/select the following required information:
    Field Description
    Business Name* 

    Enter a name that describes the business.

    Storage Service Link

    Enter the cloud storage location for system files. For example, https://s3.amazonaws.com.infosysequinox.stage.store.atfingertips.com
    Note: This field is not in use. It is used for reference purposes only.

    CDN Link

    Enter the Content Delivery Network link. For example, https://d16rliti0tklvn.cloudfront.net
    Note: This field is not in use. It is used for reference purposes only.

    Default Locale

    Select the default locale of the business. 
    Note: This field is not in use. It is used for reference purposes only.

    Default Currency

    Select the default currency of the business.
    Note: This field is not in use. It is used for reference purposes only.

    Events

    Enable or disable the event management system for the business. This is mainly used for the SaaS business model. If enabled, it creates business-specific secrets and enables the API gateway.

    Sample Data

    Enable this flag to set up the business with sample data (for a B2C/B2B/B2B2C store and the applicable microservices). All background data is set up for the business via feeds. Once completed, you will have a sample storefront set up readily for the business.
    Note: If disabled, you need to set up the business data manually.

    Business Logo

    Upload the business logo.

    Note: Fields marked with * are mandatory.
  3. Click the Create button to save the newly created business. The Business Overview page appears with the following tabs:
  • Note: Once the business has been created, on the All Businesses page you can view or edit the created business details.

Editing a Business

To edit a business, perform the following steps:

On the All Businesses page, click a particular business:
Foundation_Select_Business

The Business Overview page includes the following tabs:

Business Overview Page

On the Business Overview page, you can:

Editing Business Information

To edit the business information,

  1. In the Business Information tab, update the required business details:
  2. Click the Save button to save the updated business details.

Enabling or Disabling Microservices

On the Available Microservices page, a super admin user can enable the required microservices chosen by the client.

Note:

  • Disabled microservice(s) cannot be associated with the stores within the business.
  • If the client opts for a third-party service instead of an enabled service, the super admin can uncheck the service.

To enable or disable the microservices under the business,

  1. In the Business Overview page, click the Available Microservices tab:
    Foundation_All_Businesses
  2. Select the desired microservice(s) for your business. 
    Foundation_Available_Microservices_Save
    Note: Only the selected microservice will be available for use within the business.
  3. Click the Save button.

Managing Keys and Credentials

When you create a business, two or three sets of security keys and credentials are automatically generated for the business instance. In the Keys & Credentials tab, a business admin can view:

Note: API Gateway Keys and RabbitMQ Credentials are hidden if the Events slider is disabled under the Business Information tab.

Business Secret Keys
Overview

To invoke all Infosys Equinox API(s), you need to use x-auth-token. The business secret key is the key, which allows you to generate an x-auth-token (JWT token). Each business will have its own business secret key. This business secret key restricts other business(es) from accessing its data.

When a business needs to refresh its secret key, the business admin contacts the Infosys Equinox Commerce admin. The Infosys Equinox Commerce admin creates a new secret key and notifies the business admin via email. The new secret key is also displayed in the Business Secrets Keys section. A business can have up to two active secret keys. The Infosys Equinox Commerce admin can terminate the old secret key if needed.

Viewing Business Secret Keys

To view a business secret key, in the Business Secret Keys section, click Show against Business Secret Keys:

The business secret key is displayed:

Note: To refresh or terminate a business secret key, contact the Infosys Equinox Commerce admin.

API Gateway Keys
Overview

All Infosys Equinox API request(s) in Infosys Equinox Cloud must go through the API gateway with the API gateway key. The API gateway key is used for metering and throttling in the API gateway and authenticating the API(s) at the API gateway layer. Each business will have its own API gateway key, which must be used in its request.

To refresh the API gateway key, the business admin contacts the Infosys Equinox Cloud admin. The Cloud admin creates a new key and notifies the business admin via email about the new API gateway key creation. The new key appears in the API Gateway Keys section. A business can have multiple active API gateway keys. The Cloud admin can terminate keys as needed.

Viewing API Gateway Keys

To view an API gateway key, in the API Gateway Keys section, click Show against API Gateway Keys.

The API gateway key(s) and its creation date are displayed.

Note:

  • A business is allowed to use any of the available API gateway keys in this list.
  • To refresh or terminate an API gateway key, contact the Infosys Equinox Cloud admin.
RabbitMQ Credential
Overview

A business admin can view the login credentials in the RabbitMQ Credentials section and use them to configure RabbitMQ for consuming events in Infosys Equinox Cloud or Enterprise.

Viewing Login Credential

To view the credential, in the RabbitMQ Credentials section, click Show against Credential:
Foundation_Additional_Properties

The login credential is displayed.

Configuring Custom Properties

In the Advanced tab, business admins can add and/or view custom properties to customize the implementation.

For more information, see:

Foundation_Additional_Properties

Adding a Custom Property

To add a custom property,

  1. In the Advanced tab, click the Add Properties button.
  2. Enter a property name and its value:Foundation_Additional_Properties_Inputs
  3. Click the Save button to save the added custom property.
    Note: To add another custom property, click the Add Properties button again.
List of Custom Properties

This table lists out custom properties that you can configure at the business level:

Sl. #PropertyDescriptionTypePossible ValuesExample
1enableCustomRolesWhen this property is set to:
  • true: The Custom Roles option will be displayed in the left navigation panel for the business.
  • false: The custom roles will not be displayed for the business.
Note: For information on customizing roles, see Configuring Custom Roles.
Booleantrue, falsetrue
2domainThis property contains the domain details for automatic B2B or B2C store setup.JSONA valid JSON[{“key”:”Telco”,”path”:”e9a42671-9438-4ee6-8f48-6d3d80e61da4″},{“key”:”Auto”,”path”:”a2fa019e-bd0b-44e4-9aaf-cd5dd1ac0b6d”},{“key”:”MLM”,”path”:”eb3a94f8-caa3-4c31-96cf-a31b00f14016″},{“key”:”Retail”,”path”:”60575c82-ad6d-448e-a081-0fd93de4e48b”}]
3sheetPathThis property contains the cloud path of an Excel sheet used for automatic B2B or B2C store setup.URLA valid sheet pathhttps://d3gqeq5wcctqxw.cloudfront.net/catalogadmin
4EcareBotWhen this business property is set to true, the business assistant is displayed on all admin consoles.Booleantrue, falsetrue

Managing Stores

On the All Stores page, you can:

Foundation_Stores

Note:

  • To view the pages specific to the roles such as business admin or store ops, use the Go to menu available at the top-right side of the All Stores page.
  • The pagination option appears on all screens that contain store information.
  • To navigate to the next page, click the page number.

Configuring Search Parameters for a Store

Searching for Store(s)

To search for Store(s),

  1. Click the Store Name, Store ID, Store Type, Store Status, and/or Default Locale drop-down option in the header to open an entry field to provide search criteria.
  2. Enter the desired search criteria in the search field, and then click the Go button:
    The Store(s), which matches the search criteria appears.

Modifying Searchable Fields

To modify the searchable fields,

  1. Click the vertical ellipse available at the beginning of the search field.
  2. Select or deselect the items to add or remove the searchable fields in the header:
    The selected searchable fields appear in the header.
    Note: To reset the search field in the header, click the Reset button.

Selecting Predefined Rows

By default, 10 stores per screen will appear, but the number of categories per screen can be modified as follows:

  1. Click the pages drop-down option located at the lower left on the All Stores page.
  2. Select 10 Rows25 Rows, or 50 Rows from the drop-down list. The selected rows of categories appear on the screen.
    Note: To reset the search field in the header, click the Reset button.

Creating a Store

A Business Admin can create a store.

To create a store, see the video below or follow the step-by-step instructions.

To create a store, perform the following steps:

  1. Click Go in the upper right of the screen.
  2. Select Business Admin to view the Business Admin’s All Stores page.
  3. Click the Add a Store button on the All Stores page. The Create Store page appears:
    Foundation_CreateStore
  4. Enter/select the following required information:
    Field Description
    Store Name*

    Enter a name that describes the store.

    Store ID

    This field is generated automatically.

    Time Zone*

    Select the store’s time zone.

    Store Type*

    Select the store type:

    • Business to Business: Creates a B2B store.
    • Business to Customer: Creates a B2C store.
    • E-commerce: Creates an E-Commerce store.
      Note: This field is not in use. It is used for reference purposes only.

    Note: You can create a B2B2C (Business-to-Business-to-Customer) store type via the store property activateB2B2C

    Locales*

    Select the store’s locales.

    Default Locale*

    Select the store’s default locale.

    Ship To Regions*

    Select regions where items can be shipped.

    Default Ship To Region*

    Select the store’s default ship-to region.

    Currencies*

    Select the store’s currencies.

    Default Currency*

    Select the store’s default currency.

    Status

    When a store’s status is inactive, it will not be picked up by the business.

    Select:

    • Active to activate the store.
    • In-Active to deactivate the store. You can change the status to Active later if needed.
    Auto-associate collections

    Enable this toggle to automatically create and associate collections for all applicable microservices with the store.

    Note:

    • When disabled, you must manually create and associate collections with the store.
    • The store property autoCreateAssociation is created with the provided value.

    Sample Data

    Enable this toggle to create and set up the store automatically with the sample data as per the selected domain. Before you enable this toggle, ensure you first enable the Auto-associate collections toggle. This triggers the automatestore feed to complete the store automation process.

    Note: This field appears only when the domain and sheetPath business properties have been configured in the Business Overview’s Advanced tab. For more information, see Configuring Custom Properties.

    Domain*

    When you have enabled the toggle Sample Data, select one of the following domains:

    • Retail: Imports retail domain data into the store during the automation process.
    • Auto: Imports automobile domain data into the store during the automation process.
    • MLM: Imports Multilevel Marketing (MLM) data into the store during the automation process.
    • Telco: Imports telecommunication domain data into the store during the automation process.


    Note: The list of domains is configured in the business property domain.

    Note: Fields marked with * are mandatory.
  5. Click the Create button to create a store.
    If you have enabled the Sample Data toggle, the automatestore feed is triggered to complete the store setup steps. While the feed runs to complete the store setup:
      • The following screen is shown while creating an empty store:
      • The following screen is shown when a store is created without any data setup:
      • The following screen is shown before triggering the feeds automatically:
      • The following screen is shown when the feeds are started, indicating the store automation process time is approximately 15 minutes.

        Note: To continue the store automation process, click Ok
      • The following screen is shown when a particular feed is running. It shows the progress of the feed as highlighted in the screen:
      • The following screen is shown when there are errors after running the feed:

        Note:
        • To go back to the All Stores page, click Cancel.
        • To restart the store automation process, click Retrigger.
        • To view the feed (batch) histories, click the link available at the bottom.
      • The following screen is shown when the feeds are successfully triggered:
      • The following screen is shown when the store setup is completed successfully:
  6. Do any one of the following:
    • To open the Store Ops page of the store, click Go To Admin.
    • To launch the storefront configuration page of the store, click Go To Store. To reflect the data in the storefront, you need to update the new store ID: 

Store Overview Page

You can view the Store Overview page at:

Viewing the Store Overview Page

To view the Store Overview page,

  1. Click a particular store.
    Foundation_EditStore
    Note: Click the Edit button against a particular store to edit it. For more details, see Edit a store.
  2. Click Store Overview in the left navigation panel.
    The Store Overview page appears:
    Foundation_StoreOps_StoreOverview

Editing a Store

To edit a store,

  1. Click the Edit Store button on the Store Overview page.
    Foundation_StoreOps_EditStore.png
    The Store detail page appears:
    Foundation_ViewStore
  2. Make necessary changes as required under the Store Info tab.
  3. Click the Save button.
    Note: To discard the changes, click the Cancel button.

Associating Microservice Collections with a Store

Before associating microservice collections with a store, configure the collections. To configure the collections, see Managing Collections of a Microservice.

For associating microservice collections with a store, see the video given below:

To associate microservice collections with a store,

  1. In the Store Overview page, click the Service Association tab.
    Foundation_AssociateStore
    The Service Association tab of the Store Overview page appears:
    Foundation_ServiceAssociation
  2. Click the edit icon against a particular microservice to change the collection association.
    Foundation_ServiceAssociationPen
  3. Select a collection, to which you want to associate the store.
    Foundation_ServiceAssociation_Collection
    Configure service-wise specific instructions:
  4. Click the Associate button to associate the collection with the store.
  5. Click the Save button after associating the required microservice collections with the store.Foundation_ServiceAssociationSave

Associating the Store and a Catalog Collection with a Catalog

To associate the store and a Catalog Collection with a catalog, in the selected collection, select the required catalog under the Catalog Name column.


Note:

Associating a Pricing Collection with a Price List or Price Rule

To associate a Pricing Collection with a price list or price rule,

  1. In the selected collection, select the required price list under the Pricelist Name column.
    Note: You can use the search option to find a specific price list.
  2. Enable the Enable Price Rule toggle if you want to add a price rule for the selected collection.
  3. In the selected collection, select the required price rule under the Price Rule Name column.
    Note:

Associating a Pricing Collection with Multiple Shipping Regions

To associate a Pricing Collection with multiple shipping regions,

  1. In the Store Info tab, select the required shipping regions.
    The locales of the selected shipping regions are listed for the Pricing in the Service Association tab:
    Note: For more information, refer to Editing a Store.
  2. Go to the Service Association tab, and click the Add button to add the remaining shipping region(s).
     Another Pricing collection row appears in the Service Association tab.
  3. Select a locale of the shipping region to be associated in the newly added Pricing collection row.
    Note:

Associating the Store and an Inventory Collection with a Bin

To associate the store and an Inventory Collection with a bin, in the selected collection, select the required bin under the Inventory Name column.
Note:

Adding Store-Specific Properties

On the Advanced tab of the Store Overview page, the Business Admins can add and/or view custom properties to customize the implementation. 
You can add the below store properties:

Property Key Description TypePossible Values ExampleConsumable Services 
activateB2B2C 
Indicates whether the B2B2C store is enabled. A value of true means the B2B2C store creates Accounts and Customers (User) services, along with other selected services.
Booleantrue, falseTRUEStorefront Orchestration
allowedCountriesContains a list of permitted countries.StringList of comma-separated country codesUS,USA,CA,GRShipping
allowedPromotionPriceFacets

Contains a comma-separated list of PriceFacets that enable the discount functionality for additional components (PV, CV, and SB).
StringPV,CV,SB,GRPPV,CVStorefront Orchestration
allowedRewardTypesForOptInContains a list of default reward types. The reward types configured here will be eligible based on opt-in functionality and will be displayed in the storefront for users to opt-in. When users opt-in to the loyalty program, they will be able to earn loyalty rewards.Note:
  • Before providing values here, you need to create reward types. For more details, see the section Configuring Loyalty Rewards in the Loyalty Admin Guide.
  • You must mention the reward type. If no value is mentioned, the option to opt-in to the Loyalty Rewards program is not displayed in the storefront.
StringLOYALTY, STORE CREDITLOYALTYStorefront Orchestration and Admin Orchestration
autoCreateAssociation Indicates whether collections for all applicable microservices are automatically created and associated with the store. When enabled, collections are automatically created and associated with the store. When disabled, you must manually create and associate the collections with the store.Booleantrue, falseTRUEFoundation 
defaultAddressforShippingMethodHolds the default shipping address.JSON{
"AddressLine1": "132, My Street",
"City": "Newyork",
"Email": "email",
"FirstName": "John",
"LastName": "Smith",
"Country": "US",
"Mobile": "+16784567845",
"State": "Newyork",
"Zip": "10017"
}
Shipping
defaultCheckOutFlow
Activates the default checkout flow when set to true.
Booleantrue, falseTRUEOrders
enableBackOrderActivates the back order when set to true.Booleantrue, falseTRUEInventory
excludePriceFacetsContains a list of price facets to exclude from the storefront and the API response.StringSBSBStorefront Orchestration
fetchRewardsEventId Contains the ID of an event used to retrieve rewards before the reward points are credited to the account.StringOrder Shipped, Order CreatedOrder ShippedStorefront Orchestration and Loyalty
orderChannelTypesIdentifies the type of channel used to place the order.StringWeb, Phone, Walk in Center Web, PhoneOrder Admin
percentInPriceToPayByPointsSpecifies the percentage of the amount eligible to be paid using points. For example, if the eligible amount is $100 and you set the percentInPriceToPayByPoints to 50%, then 50% of $100 (which is $50 if the pointValueInPriceUnit is 1) will be eligible to be paid using points.
Note: The eligible amount to be paid using points is calculated based on the store property redeemloyaltyproperty.
String0-100100Storefront Orchestration and Admin Orchestration
pointValueInPriceUnitStores the conversion value of loyalty points to price units. For example, a value of 1 means one point is equivalent to one dollar.String0-1001Storefront Orchestration and Admin Orchestration
PriceRuleConfigMapStores a list of account types used in price rules to set different prices based on the account type.JSON{"id":"AccountType","name":"AccountType","options":["Retail Customer","Brand Affiliate - Individual","Brand Affiliate - Business Entity","Preferred Customer/Member"]}Admin
productPropertiesForPromotionHolds a product property to send to the Promotions service from the Storefront Orchestrations and Admin Orchestrations services.StringAny product propertypointEarnStorefront Orchestration and Admin Orchestration
productPropertyToAllowDiscountStores a product property to determine discount eligibility. For example, products with the pointDiscount attribute set to true are eligible for a discount.
Note:
  • For normal products, configure at the SKU level.
  • For bundle products, configure at the product level.
StringAny product propertypointDiscountStorefront Orchestration, Admin Orchestration, and Cart
productPropertyToEarnRewardsContains an attribute to determine a product’s eligibility for earning loyalty points. For example, products with the pointEarn attribute set to true are eligible to earn loyalty points.
Note:
  • For normal products, configure at the SKU level.
  • For bundle products, configure at the product level.
StringAny product propertypointEarnStorefront Orchestration and Admin Orchestration
redeemloyaltypropertyContains an attribute to determine if a product is eligible to redeem loyalty points. Products with the pointRedeem attribute set to true are eligible for loyalty point redemption.

For example, if an order includes:

  • Product1: priced at $100 with the pointRedeem attribute set to true

  • Product2: priced at $200 with the pointRedeem attribute set to false

The total value of products eligible for redemption is $100.

Note:
  • For standard products, configure at the SKU level.

  • For bundle products, configure at the product level.
StringAny product propertypointRedeemStorefront Orchestration and Admin Orchestration
sfStoreDetailsContains the store details for the storefront.JSON{
"associations": [
{
"serviceName": "pricing",
"properties": [
"currencyCode"
]
}
],
"store": {
"info": [
"id",
"name",
"status",
"defaultShippingRegion",
"globalStore"
],
"properties": [
"activateB2B2C",
"countryConfig",
"tierConfigMap",
"PriceRuleConfigMap",
"allowedRewardTypesForOptIn"
]
}
}
Storefront Orchestration
siteURLContains the storefront URL of the store.StringAny valid URLhttps://<<EnvironmentName>>.skavacommerce.com/Storefront
tierConfigMapContains the percentage and tier name displayed in the storefront. For example, T1 corresponds to a 5% discount and is labeled as Basic.StringValid JSON value{
"tier": {
"T1": {
"displayPercentage": "5%",
"displayName": "Tier 1"
},
"T2": {
"displayPercentage": "10%",
"displayName": "Tier 2"
},
"T3": {
"displayPercentage": "20%",
"displayName": "Tier 3"
}
}
}
Storefront
customization_jsContains the S3 URL of the minified JS file that customizes the admin console for all applicable services at the store level.URLNAhttps://d3gqeq5wcctqxw.cloudfront.net/equinox-platfom/admin-customization/admin-customization.min.jsFoundation Admin
customization_cssContains the S3 URL of the minified CSS file that customizes the admin console for all applicable services at the store level.URLNAhttps://d3gqeq5wcctqxw.cloudfront.net/equinox-platfom/admin-customization/admin-customization.min.cssFoundation Admin
discountModelRewardTypesContains a list of reward types to be considered as discounts. The default value is REWARDS.StringLOYALTY,POINTS,STORE CREDITLOYALTYLoyalty
enableVoucherSupportIndicates whether voucher support is enabled in the Cart service.BooleanTrue, FalseTrueAdmin and Storefront Orchestration (Cart)
livePriceEnabledIndexes the most recent schedule price for sorting and filtering operations.BooleanTrue, FalseFALSEFeed Jobs
enableVoucherSupportIndicates whether voucher support is enabled. When this property is set to:
  • true: Customers can earn vouchers.

  • false: Voucher support is not enabled.
FALSEAdmin Orchestration (Cart)
productPropertyToEarnVouchersSpecifies product property name to identify if the product is eligible for earning and redeeming vouchers.
The default value is earnVoucher.
earnVoucherFoundation
productPropertyToRedeemVouchers

Specifies the product property name to determine if the product is eligible for earning and redeeming vouchers. The default value is redeemVoucher.
redeemVoucherFoundation
enableAppMarketplaceIndicates the feature flag for the newly added App Marketplace Admin.
The default value is FALSE.
True, FalseFALSEAppMarketplace Admin
enableDashboard
Indicates the feature flag for the newly added Dashboard link under Store Overview.
The default value is FALSE.
True, FalseFALSECatalog, Foundation Admin
domain, sheetPathSpecifies a segment or domain and the data sheet path for that domain.--Foundation
cdnConfigWhen the seller publishes the site, and if the site has been cached by the CDN, the Storefront Orchestration service reads this property information and flushes the cache asynchronously.

Sample data:

{
"fnName":"CloudFrontCacheInvalidation",
"dId":"EQ7X50F2GQAO"
}
{}Foundation Admin (Emall)
sellerRoleAccountTypes
This property defines the Seller role account type. Once configured, the ROLE_SELLER_USER is assigned, allowing the seller user to sign up for Emall.
--Storefront Orchestration
setResetParamInResponseThis property determines whether to include the reset parameter in the response. If the flag is enabled, the reset parameter will not appear in the API response. By default, this property is disabled when set to false.falseFoundation
preferenceBasedSubscriptionThis property controls whether to enable the existing preference flow subscription or the multiple subscriptions flow. When set to:
  • true, it enables the preference-based subscription flow.

  • false, it enables the multiple subscriptions flow.
trueAdmin Orchestration
productCompareAppURLThis property allows users to view product comparisons based on the products added for comparison.

Users can see the “Descriptive Comparison of Products” section, generated by the Product Compare AI app, based on comparable attributes.

Enter the app URL in the value field.
Foundation Admin Console,
Ultra Storefront
EnablePromotionProximityWhen this property is set to:
  • true: Proximity promotion is enabled.

  • false: Proximity promotion is not enabled.
BooleanTrue, FalseFoundation Admin Console, Promotions Admin Console
quicksightDashboardInfoThis property displays a new card, “Analytics & Insights,” on the Store Ops page and the left navigation panel, allowing navigation to the Dashboard page.

Sample value:

{"Order": "dashboard_id", "Inventory": "dashboard_id"}

The dashboard ID for the service can be obtained from the QuickSight plugin.

Before configuring this property, ensure the QuickSight plugin is installed for the store.
quicksightDashboardInfo
enableCartApprovalIf this property value is set to:
  • true: Enables multiple shopping carts, such as converting a user cart to approval carts for workflow.

  • false: Only one cart is enabled.
BooleanTrue, FalsefalseAccounts
allowGuestUserToGetAttributesIf this property value is set to:
  • true: Guest users are allowed to retrieve account attributes.

  • false: The get account attributes API returns a 500 error for guest users.

BooleanTrue, FalsefalseStorefront Orchestration
EnablePriceParamContains the price parameters with conditions.BooleanPricing
priceRuleCustomTypeContains the custom attributes created for an account.Pricing
ComparebyAIThis property, used with productCompareAppURL, controls the display of the “Descriptive Comparison Products” section on the Compare Products page. The value can be:
  • true: The section is displayed.

  • false: The section is hidden.

Note: The app is deployed in Azure. The app will only be called if the app URL is configured in the store property productCompareAppURL.
BooleanTrue, FalsefalseUltra Storefront, Storefront Orchestration
productCompareAppURLThis property contains the app URL for the Product Compare AI app and requires the ComparebyAI store property to be configured when defined.App URLUltra Storefront, Storefront Orchestration
ProximityPromotionURLThis property contains the app URL for the Proximity Promotion AI app and requires the EnableProximityPromotion store property to be configured when defined.

Note: The app is being deployed in Azure. The app will only be called if the app URL is configured.
App URLUltra Storefront, Storefront Orchestration
bundleSuggestionAppURLThis property contains the app URL for the Bundle Suggestion AI app.App URLUltra Storefront, Storefront Orchestration
adminV2EnableThis property enables Ultra Admin Apps (for example, CSR, Shipment) on the StoreOps page.Foundation Admin
SubscriptionMessageThe property can be any value containing the %d format specifier to indicate the subscription percentage.subscriptionSuggestion%d Subscribe to the product and get %d off.Catalog
UserSKUOrderHistoryCountThis property with a numeric value (for example, 1 to signify number of orders) indicates the count of items a user has purchased.Catalog
UserSKUOrderHistoryTimeThis property with a numeric value (for example, 1 to signify the number of items) indicates the number of items a user has purchased in a month.Catalog
quicksightDashboardIdThis property is used to display the dashboard/reports in the Analytics and Insights page.is used to configure the dashboard name and respective dashboard IDs to display them on the Analytics & Insights page.

NATo display inventory, catalog, promotion, order, subscription, and loyalty dashboards, the JSON value can be:

{

"inventory" : "15ae701e-1f37-442d-bb20-1aa90ede4b07",

"catalog" : "f54a4f08-ff3d-4ccc-9702-bac448bd780a",

"promotion" : "60ce61e8-8528-4a5f-90d0-ad46ecb5b4ab",

"order" : "e54e0203-96f4-42b8-b95b-d0bb8cdf0d48",

"subscription" : "dcc32190-40c7-4f72-81fe-a1cdc6af5e4a",

"loyalty" : "39aa5f6f-0504-4968-9de9-7b3822cdf40c"

}
Foundation Admin
allowMerchandiseMilestonesThis property specifies whether to allow creating category milestone in the Merchandising service when the property is set to true. The default value is false.BooleanTrue, FalsefalseMerchandising Admin
phonenumberCountryCodeThis property stores the country code values available for user selection on the user and account details pages when providing a phone number. The default value is US(+1).List of comma-separated country codesAR(+54),AT(+43),US(+1)Customers (User) Admin
enableUserActivationFlowThis property invites users to fill their profile for activation in the B2B2C flow. The default value is false.BooleanTrue, FalsefalseUltra Storefront, Storefront Orchestration
enableZeroCheckoutThis property allows users to place an order without any payment.
Note: Payment validation is skipped if the cart value is zero and enableZeroCheckout is set to true. If the cart total is zero and the enableZeroCheckout property is false, an appropriate error is thrown. The default value is true.
BooleanTrue, FalsefalseUltra Storefront, Storefront Orchestration
discountRewardGroupsWhen the loyalty reward is applied as a promotion discount, the promotion object name will be taken from the promotion class object.
This property must be defined when the store property discountModelRewardTypes is configured with LOYALTY.
JSONNA{LOYALTY" : {"promotionClass": "Program", "promotionGroup" :"Group"}}Loyalty, Payment
enableInventoryQtyBlockValidationSpecifies whether the inventory is blocked during the order placement by a storefront user or not. When this property is set to:
  • true - blocks the inventory during the order placement by a storefront user.
  • false - does not block the inventory during the order placement. This is the default.
BooleanTrue, FalsefalseStorefront Orchestration
enableInventoryQtyBlockValidationadminSpecifies whether the inventory is blocked during the order placement by a CSR amin user or not. When this property is set to:
  • true - blocks the inventory during the order placement by a CSR admin user.
  • false - does not block the inventory during the order placement. This is the default.
BooleanTrue, FalsefalseAdmin Orchestration

To add custom properties:

  1. Click the Advanced tab on the Store Overview page.Foundation_ServiceAssociation_Advanced
  2. In the Advanced tab of the Store Overview page, click the Add Properties button.
    Foundation_Store_Additional_Properties
  3. Provide a property name and its value. Foundation_Store_Additional_Properties_Inputs

    For example, to customize the admin consoles at the store level, enter the following property keys:

    In the property value, upload CSS and JS files from your local computer by clicking the Add File button, or provide the S3 URL of these files.

    After uploading the custom JS and CSS files, the Accounts admin console will appear as shown below:
  4. Click the Save button to save the custom properties.
    Note: You can add more custom properties by repeating the above steps.

Updating StoreFront Orchestration-Specific Properties

In the SF Orchestration Properties tab of the Store Overview page, a business admin can update or view the below storefront orchestration-specific properties:

Service Property Key Description
Customers Allow customer deletion

Indicates whether customer deletion is permitted. When enabled, a CSR can delete a customer account.

Retention period for customer deletion

Defines the retention period before customer deletion.

Google Places API Key

Holds the Google Places API key for accessing Google Places APIs.

Inventory Enable Inventory Check

Indicates whether inventory checks are permitted.

Include Out Of Stock

Specifies whether out-of-stock products are displayed on the storefront site (for example, PLP, PDP). Enable to show out-of-stock products.

Pricing Price RuleConfig Map

Holds the configuration of price rules in JSON format.

Foundation_SFO_Properties

To update the storefront orchestration-specific properties:

  1. In the SF Orchestration Properties tab of the Store Overview page, make the required updates in the available SFO properties.
    Foundation_SFO_PropertiesPage
  2. Click the Save button to update the storefront orchestration-specific properties.

Managing Store Operations

To launch a Store Ops page,

  1. On the All Stores page, click a particular store:
    The Store Overview page is displayed:
    Foundation_StoreOps
    Note: To edit the store details, see Editing a Store.
  2. Click the Store Ops button on the Store Overview page.
    The Store Ops page appears:
  3. On the Store Ops page:

Indexing and Publishing Store Data

Infosys Equinox Commerce allows you to:

First, index the store data in the authoring environment, then publish it in the live environment to reflect changes on the storefront.

Refer to the following sections for prerequisites and steps for indexing or publishing data:

Indexing the Store Data

To retrieve product/SKU details for the storefront, and index the catalog, pricing, and merchandising data in the store’s SOLR collections.

In Infosys Equinox Commerce, choose from the following indexing types based on your business needs:

Full Indexing

To index the entire catalog, pricing, or merchandising data in the store’s collections, run full indexing.

Full Indexing Options:

Full Indexing Catalog and Pricing Data

Prerequisites

Before running full indexing for catalog and pricing, ensure the following:

  • Valid catalog and pricing data in the collection’s default project.
  • Active products have at least one active SKU with valid pricing information.

Scenarios for Not Indexing a Product

A product will not be indexed if:

  • The product status is inactive.
  • The current date is outside the product’s and/or SKUs’ start and end date and time (considered expired).
  • The product has no active SKUs.
  • There is no pricing information for any SKUs.

Steps for Full Indexing Catalog and Pricing Data

To run a full indexing feed on the catalog and pricing data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Full Indexing – Catalog & Pricing only in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Refreshing Data popup appears.
  4. Click the Proceed button to trigger the full indexing process of catalog and pricing data.
    Note:
    • To ignore indexing the data, click the Cancel button.
    • Once the full indexing process is triggered, you will get a success message.
    • The feeds such as CatalogEventPublisher, CatalogEventListener, CatalogB2BEventPublisher (for a B2B store), CatalogB2BEventListener (for a B2B store), PriceEventPublisher, PriceEventListener, PriceRuleEventPublisher (applicable only when a price rule is mapped with the store), and PriceRuleEventListener (applicable only when a price rule is mapped with the store), are triggered. For more details on these feeds, see https://developer.infosysequinox.com/microservices/search/search-feeds/.
    • To view the feed running details, go to the URL: https://<<EnvironmentName>>.skavacommerce.com/admin/feed/histories?businessId=<<BusinessID>>&page=1&size=10
      For example, the feed histories of the Search collection 373:

      Note
      : You can get the Search collection ID in the Service Association tab of the store.
    • You can also view the feed run history using the Swagger link: https://<<EnvironmentName>>.com/feedservices/swagger-ui/Job_History/getFeedRunHistories
  5. On the storefront site, verify that the catalog and prices for the SKUs are displayed correctly:


Full Indexing Merchandising Data

Prerequisites

Before running full indexing for merchandising, ensure the following:

  • Valid merchandising data is in the collection’s default project.
  • Active categories contain valid milestones for successful indexing.

Scenarios for Not Indexing a Category

A category will not be indexed if:

  • The category status is inactive.
  • The category lacks active milestones.
  • The category lacks valid milestones (applicable for the current period).
  • The category is not mapped to any valid site navigation milestones.

Steps for Full Indexing Merchandising Data

To run a full indexing feed on the merchandising data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Full Indexing – Merchandising only in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Refreshing Data popup appears.
  4. Click the Proceed button to trigger the full indexing process of merchandising data.
    Note:
    • To ignore indexing the data, click the Cancel button.
    • Once the full indexing process is triggered, you will get a success message.
    • The feeds such as MerchandiseEventListener and MerchandiseEventPublisher are triggered. For more details on these feeds, see https://developer.infosysequinox.com/microservices/search/search-feeds/.
    • To view the feed running details, go to the URL: https://<<EnvironmentName>>.skavacommerce.com/admin/feed/histories?businessId=<<BusinessID>>&page=1&size=10
      For example, the feed histories of the Search collection 373:

      Note: You can get the Search collection ID in the Service Association tab of the store.
    • You can also view the feed run history using the Swagger link: https://<<EnvironmentName>>.skavacommerce.com/feedservices/swagger-ui/Job_History/getFeedRunHistories
  5. On the storefront site, verify that the categories and its products are displayed correctly:
Delta Indexing

Infosys Equinox Commerce enables delta indexing to update only the changes made to catalog or pricing data since the last indexing.

Run delta indexing for:

Delta Indexing Catalog Data

Prerequisites

Before running delta indexing for the catalog, ensure that the collection’s default project contains valid, updated catalog data.

When this feed is triggered, any changes made to existing products and/or SKUs, as well as newly added products and/or SKUs, will be indexed.

Scenarios for Not Indexing a Product

A product will not be indexed in the following scenarios:

  • If the status of the product is inactive.
  • If the product does not have any active SKUs associated with it.
  • If there is no pricing information available in the associated SKUs.

Steps for Delta Indexing Catalog Data

To run a delta indexing feed on the catalog data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Delta Indexing – Catalog only in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Refreshing Data popup appears.
  4. Click the Proceed button to trigger the delta indexing process of catalog data.
    Note:
    • To ignore indexing the data, click the Cancel button.
    • Once the delta indexing process is triggered, you will get a success message.
    • Once the feed is triggered successfully, the progress of the feed can be viewed on the Feed History page. For more information, see Viewing a Feed History.
Delta Indexing Pricing Data

Prerequisites

Before running delta indexing for pricing, ensure that the collection’s default project contains valid, updated pricing data.

Steps for Delta Indexing Pricing Data

To run a delta indexing on the pricing data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Delta Indexing – Pricing only in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Refreshing Data popup appears.
  4. Click the Proceed button to trigger the delta indexing process of pricing data.
    Note:
    • To ignore indexing the data, click the Cancel button.
    • Once the delta indexing process is triggered, you will get a success message.
    • Once the feed is triggered successfully, the progress of the feed can be viewed on the Feed History page. For more information, see Viewing a Feed History.

Publishing the Store Data

Infosys Equinox Commerce allows you to publish the Catalog, Pricing, Merchandising, Promotions, Foundation, Accounts, and Search data from the authoring environment to the production environment. 

Depending on your business requirements, in Infosys Equinox Commerce, you can opt for any one of the following publishing types: 

Full Publishing of the Store Data

This option publishes the complete store data (such as Catalog, Pricing, Merchandising, Promotions, Foundation, Accounts (for B2B), and Search) from the authoring environment to the production environment.

Prerequisites

Before running the full publish feed, ensure the following:

  • Availability of valid Catalog, Pricing, Promotions, and Merchandising data in the respective collection’s default project. However, the Accounts and Foundation data are published directly to the production environment. 
  • Index the data only in the authoring environment’s SOLR server before publishing it to the production environment.

Steps for Full Publishing of the Store Data

To publish the complete store data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Full Publish in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Publish Store Data popup appears.
  4. Click the Proceed button to trigger the full publishing process of the store data.
    Note:
    • To ignore publishing the data, click the Cancel button.
    • Once the full publishing process is triggered, you will get a success message.
    • Once the feed is triggered successfully, the progress of the feed can be viewed on the Feed History page. For more information, see Viewing a Feed History.
    • For re-triggering a failed publish feed, see Retriggering a Failed Publish Feed.
    • The full publish process triggers the publishmaster feed. The publishmaster feed triggers the following applicable feeds:
      • catalogpublish
      • searchpublish
      • merchandisepublish
      • promotionspublish
      • pricepublish
      • accountpublish
      • foundationpublish
        These feeds publish the data from the respective services to the production environment.
Full Publishing of the Promotions Data

This option publishes the complete store data of the Promotions microservice from the authoring environment to the production environment.

Prerequisites

Before running the full publish feed, ensure the following:

  • Availability of valid Promotions data in the respective collection’s default project. 
  • Index the data only in the authoring environment’s SOLR server before publishing it to the production environment.

Steps for Full Publishing of the Promotions Data

To publish the promotions data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Promotion Full Publish in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Publish Store Data popup appears.
  4. Click the Proceed button to trigger the full publishing process of the store data.
    Note:
    • To ignore publishing the data, click the Cancel button.
    • Once the full publishing process is triggered, you will get a success message.
    • Once the feed is triggered successfully, the progress of the feed can be viewed on the Feed History page. For more information, see Viewing a Feed History.
    • For re-triggering a failed publish feed, see Retriggering a Failed Publish Feed.
    • The full publishing process of the promotions data triggers the publishmaster feed. The publishmaster feed triggers the promotionspublish feed. The feed publishes the data from the Promotions microservice to the production environment.
Delta Publishing of the Store Data

This option publishes only the latest changes made to the store data (such as Catalog, Pricing, Merchandising, Foundation, Accounts (for B2B), and Search) from the authoring environment to the production environment.

Prerequisites

Before running the delta publish feed, ensure the following:

  • Availability of valid Catalog, Pricing, and Merchandising data in the respective collection’s default project. However, the Accounts and Foundation data are published directly to the production environment. 
  • Index the data only in the authoring environment’s SOLR server before publishing it to the production environment. 

Steps for Delta Publishing of the Store Data

To publish only the recent changes from the store data,

  1. In the Store Ops page, click the Refresh/Publish Data dropdown.
    A list of indexing and publishing options appears.
  2. Select the option Delta Publish in the Refresh/Publish Data dropdown.
  3. Click the Go button.
    The Publish Store Data popup appears.

  4. Click the Proceed button to trigger the delta publishing process of the store data.
    Note:
    • To ignore publishing the data, click the Cancel button.
    • Once the delta publishing process is triggered, you will get a success message.
    • For re-triggering a failed publish feed, see Retriggering a Failed Publish Feed.
    • Once the feed is triggered successfully, the progress of the feed can be viewed on the Feed History page. For more information, see Viewing a Feed History.
    • Delta publish process triggers the publishmaster feed. The publishmaster feed triggers the following applicable feeds:
      • catalogpublish
      • searchpublish
      • merchandisepublish
      • pricepublish
      • accountpublish
      • foundationpublish
        These feeds publish the data from the respective services to the production environment.

Launching the Admin Console via the Store Operations Page

To launch the admin console of a microservice, click a particular service.
Save Metadata

Dashboard – Sales Metrics, Task Trays, Other Reports

Overview

The Dashboard offers a high-level, one-page view of the store’s order and sales statistics for the last 7 days. It includes key tasks for the business admin to address, recently updated items, a chart displaying the top 5 selling products, and inventory availability details.

Tasks can be customized in the collection property of the required service based on business requirements:

Accessing the Dashboard

To access the dashboard,

  1. Click available on the top left corner of the Store Overview page:
  2. Select Dashboard on the left navigation panel.


    The Dashboard page appears. For more information on the Dashboard page, see the next section.

Dashboard Page and Reports

These reports present the store’s current status and identify issues to be addressed using preset filters.

The following page explains the details available on the Dashboard page:

Call Out

Explanation

Displays the total number of orders and sales matrix, such as the total value of sales and the average order price.

Displays the catalog and pricing-related report types.

The task trays can be configured; for example:

  • Products with no images
  • Products with no SKU
  • SKUs to expire in 7 days
  • SKUs with no images
  • Catalog or Pricing projects that are submitted and pending approval for the last 7 days
  • SKUs with multiple products
  • SKUs with zero prices
  • Pricing projects to be approved, and so on

A business or store admin can click, which navigates to the required page with the preset filter results.

Displays the recently updated items for the last 7 days.

Displays the 5 top-selling SKUs for the last 7 days.

Displays the inventory availability details (such as preorder, backorder, low stock, and/or out-of-stock) of SKUs.

Configuring Collections for Microservices

In the Business Overview page, click Microservices in the left navigation panel. It shows the All Microservices page:

Foundation_MicroservicesPage

The All Microservices page can be used to navigate to collections of a microservice. There is no collection to be configured for the App Marketplace service.

Note:

  • If a microservice does not appear on the All Microservices page, it indicates that it has not been added to the business.
  • If a microservice appears on the All Microservices page but does not have an arrow, it indicates that it has been disabled for the business and cannot be configured.

Navigating to Collections of a Microservice

To navigate to the collections of a microservice, click a microservice:

Foundation_MicroservicesPageArrow

It shows the collections management page of the microservice:

Foundation_Microservices_Collections

Note:

  • The pagination option appears on all screens that contain collection information.
  • To navigate to the next page, click the page number.

Managing Collections of a Microservice

On the collections management page of a microservice, you can:

For managing collections of a microservice, see the video below or click the links above for step-by-step instructions:

Creating a Collection for the Microservice

To create a collection,

  1. In the collections management page of the microservice, click the Create Collection button:
    Foundation_Microservices_CollectionsCreate
    The Create Collection page appears.
  2. Enter/select the following required information:

    Field Description
    Collection Name*

    Enter the name of the collection.

    Collection Description*

    Enter a description that describes the collection.

    Status

    Enable or disable the status of the collection. You can:

    • Enable the toggle to activate the collection. This allows a business to pick the collection.
    • Disable the toggle to deactivate the collection. This prevents a business from picking the collection.
    Collection Properties

    Update the values of the collection properties.

    Note: Fields marked with * are mandatory.
  3. Click the Create button to create the collection.Foundation_Microservices_CollectionsCreatePage

Note: To know about the collection properties of the microservice, refer to Available Collection Properties.

Configuring a Collection of the Microservice

To configure a collection:

  1. In the collections management page of the microservice, click the Configure button against a collection
    Foundation_Microservices_CollectionsConfigure
    Note: You can open the Feeds dashboard of the respective microservice by clicking the Batch Jobs button.
    The Configure Collection page appears.
  2. Update the required information.Foundation_Microservices_CollectionsUpdate
  3. Click the Save button to configure the collection.

Launching the Admin Console via the Collections Management Page

To launch the admin console, in the collections management page of the microservice click the Launch button against a collection:
Foundation_Microservices_CollectionsLaunch
Note: 

  • The Launch button is available only for the Catalog, Pricing, and Inventory microservices.
  •  To open the Batch Jobs (Feeds) dashboard, click the Batch Jobs button.

The admin console page of the microservice appears:

Foundation_Microservices_CollectionsLaunchPage

Available Collection Properties

Below is the list of available collection properties by service.

For the Microservice Click the Link
Accounts Collection Properties
Address Collection Properties
Authorization Collection Properties
Cart Collection Properties
Catalog Collection Properties
Customers (User) Collection Properties
Inventory Collection Properties
Lists Collection Properties
Loyalty Collection Properties
Merchandising Collection Properties
Notification Collection Properties
Order Collection Properties
Payment Collection Properties
Pricing Collection Properties
Promotions Collection Properties
Search Collection Properties
Shipping Collection Properties
Subscription Collection Properties
Tax Collection Properties

Managing Teams

On the Team page, a user can be invited, and a role can be assigned to a user.

On the Team page, you can:

Note:

  • The pagination option appears on all screens that contain team information.
  • To navigate to the next page, click the page number.

Inviting User(s)

Overview

You can invite one or more users either as a:

  • Business admin to access all the stores of the business. For more information, see Business Admin Role.
  • Business user to access a particular store(s) as per the assigned role. These roles can be default or custom roles. For more information, see Business User Role.

 Here, the roles can be default or custom roles.

List of Default Roles for All Microservices

The following table outlines the default roles for various microservices:
Note: Click the links in the first column to navigate to the Roles & Privileges of that service.

Microservice Default Admin Roles
Accounts
  • ROLE_ACCOUNT_ADMIN
  • ROLE_ACCOUNT_REP
App Marketplace
  • ROLE_MARKETPLACE_ADMIN
  • ROLE_MARKETPLACE_USER
Address
  • ROLE_ADDRESS_ADMIN
Cart
  • ROLE_CART_ADMIN
Catalog
  • ROLE_CATALOG_ADMIN
  • ROLE_CATALOG_EDITOR
Customers (User)
  • ROLE_CSR_ADMIN
  • ROLE_CSR_ASSOCIATE
  • ROLE_CUSTOMER_ADMIN
Feed Job
  • ROLE_FEED_ADMIN
Foundation
  • ROLE_BUSINESS_EDITOR
  • ROLE_BUSINESS_VIEWER
  • ROLE_STORE_ADMIN
  • ROLE_STORE_EDITOR
  • ROLE_STORE_OPERATOR
  • ROLE_STORE_VIEWER
Inventory
  • ROLE_INVENTORY_ADMIN
Lists
  • ROLE_LIST_ADMIN
Loyalty
  • ROLE_LOYALTY_ADMIN
  • ROLE_LOYALTY_VIEWER
Merchandising
  • ROLE_MERCHANDISE_ADMIN
  • ROLE_MERCHANDISE_EDITOR
Notification
  • ROLE_MARKETING_MANAGER
Order
  • ROLE_ORDER_ADMIN
Payment
  • ROLE_PAYMENT_ADMIN
Pricing
  • ROLE__PRICE_ADMIN
  • ROLE_PRICE_EDITOR
Promotions
  • ROLE_PROMOTION_ADMIN
  • ROLE_PROMOTION_EDITOR
Ratings and Reviews
  • ROLE_RATINGSANDREVIEWS_ADMIN
  • ROLE_RATINGSANDREVIEWS_MODERATOR
  • ROLE_RATINGSANDREVIEWS_VIEWER
Reporting
  • ROLE_REPORTING_ADMIN
Search
  • ROLE_SEARCH_ADMIN
Shipping
  • ROLE_SHIPPING_ADMIN
Subscription
  • ROLE_SUBSCRIPTION_ADMIN
Tax
  • ROLE_TAX_ADMIN

Inviting User(s) as a Business Admin or Business User

To invite user(s) as a business admin or business user,

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
  2. Click on a particular business.
  3. Click the Team in the left navigation panel:
  4. Click the Invite Members button.
    The Invite User page appears:
    image alt text
  5. In the Email Address section, enter the required email address(es).
  6. Configure the role either for: 
    • Business Admin, enable the Business Admin toggle to provide business admin access.
    • Business User, select an appropriate role and associate the required store(s) of the business. For example, select the role ROLE_PROMOTION_EDITOR to provide the user(s) with an editor role in the Promotion Admin console.
      Note:
      • To add multiple roles for different stores, click image alt text and repeat this step. For example:
      • To remove a particular role, click .
  7. Click the Send Invite button:
    The following confirmation message is displayed on the screen:
    image alt text
    The business admin or business user receives an email for creating an Infosys Equinox Commerce account.
  8. Click the ACTIVATE button in the email.
    image alt text
  9. In the User Registration form, enter the necessary details and click the Register button.
    After successful registration, the business admin or business user can log in to the Infosys Equinox Commerce console by entering the registered email ID and password. 

Updating the Role of an Existing User

As a business admin user, you can update as follows for an existing user:

  • enable or disable the business admin access
  • add a new role in addition to the existing role to the same or another store
  • change the role and associate to the same or another store
  • remove an existing role
  • activate or deactivate the user
  • reset MFA for the user

To update the role of an admin user,

  1. Search for the user; for example,
    image alt text
  2.  Click on the user.
    The edit page appears:
  3. Update the role either as :
    • Business Admin, enable the Business Admin toggle to provide business admin access.

      Note: For activating/deactivating and resetting MFA for the user, refer to the next step in this section.
    • Business User, select the appropriate role and associate the required store(s) of the business. For example, select the role “ROLE_PROMOTION_EDITOR” to provide the user(s) with an editor role in the Promotion Admin console.
      Note:
      • To add multiple roles for different stores, click image alt text and repeat this step. For example:
      • To remove a particular role, click .
  4. For activating or deactivating the user, enable or disable the toggle accordingly.
  5. To reset the multi-factor authentication for the user, click the Reset button. You will see a successful message after clicking the Reset button.
  6. Click Update to update the user role.
    The user’s role has been updated and the user will receive an e-mail as shown below:

Configuring Custom Roles

Overview

In the Foundation Admin console, you can configure your own custom roles for the selected service(s) and associate privilege(s) and privilege group(s) that are required for the given role. Once created, you invite users via Teams and assign the configured roles to them for the selected store(s).

In Custom Roles, you can:

Note: You cannot delete predefined roles, which are available by default.

Before You Begin

You must configure the enableCustomRoles property with the value true in the Business Overview’s Advanced tab. For more information, see Configuring Custom Properties.

Once configured, Custom Roles is visible in the left navigation panel for the business with the predefined roles. To create a new custom role, see Creating a New Role with Privileges.

Viewing Custom Roles

To view the existing custom roles,

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
  2. Click on a particular business.
  3. Click Custom Roles in the left navigation panel:

    The List of Custom Roles page appears:

Creating a New Role with Privileges

To create a new role with the custom name and associate the required privileges or privilege groups,

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
  2. Click on a particular business.
  3. Click Custom Roles in the left navigation panel:

    The List of Custom Roles landing page appears:
  4. On the landing page of the custom roles, click the Create Role button.
    The Create Custom Roles page appears:
  5. Enter the role name and select the required service.
  6. Once you select the service, select the required privilege group. Once you select the privilege group, you can view the associated privileges.
  7. Click  to add more services with the corresponding privileges to create the role.
  8. Click the Create button.
    Once the role is created successfully, the role appears on the List of Custom Roles page.
    Note: For inviting users and assigning the configured roles to them for the selected store(s) in the Teams page,  see Managing Teams.

Editing the Existing Custom Role

You can edit existing custom roles; however, you cannot edit predefined roles created by default.

To edit a custom role,

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
  2. Click on a particular business.
  3. Click Custom Roles in the left navigation panel:The List of Custom Roles landing page appears:
  4. Click  to edit a particular custom role; for example:
  5. Update the role name if required.
  6. Deselect and then select another service if required.
  7. Once you select the service, select the required privilege group. After selecting the privilege group, you can view the associated privileges.
  8. Click to add more services with the corresponding privileges if required.
  9. Click the Update button:The changes are updated.

Deleting a Custom Role

You can delete the existing custom roles; however, you cannot delete the predefined roles that are created by default.

To delete a custom role,

  1. Log in to the Foundation service for your business (URL provided by Infosys Equinox).
  2. Click on a particular business.
  3. Click Custom Roles in the left navigation panel:
    The List of Custom Roles landing page appears:
  4. Click  to delete a particular custom role; for example:

    After clicking OK in a confirmation pop-up. The role is deleted successfully.

Managing Feeds

You can manage the feeds of the microservices via the Feeds Admin console. To view the Feeds Admin console, click Batch Jobs in the left navigation panel.


Note: You can also view the feeds of a specific microservice collection from the collections management page. For more details, see Managing Collections of a Microservice.

Managing Developer Apps

You can register the app in Developers Apps and publish it to the App Marketplace. See Developer Apps and App Marketplace.

 

All Businesses Page | top

Revision History
2024-11-20 | AN – Updated for 8.18 release.
2024-09-13 | SD – Updated store & business properties for 8.18.6 & 8.18.7 release.
2024-08-18 | JP – Improved content using AI.
2024-06-08 | JP – Updated store & business properties for 8.18 release.
2024-24-07 | JP – Updated store & business properties for 8.18 release.
2023-20-10 | JP, SW, AN – Updated content for 8.15.4 release.
2023-08-03 | AN – Updated content for 8.15.0 release.
2023-01-12 | AN – Updated content for 8.13 release.
2022-11-04 | AN – Updated contents for 8.13 release.
2022-11-01 | AN – Updated Swagger URL for release 8.12.
2022-10-10 | AN – Updated Full Indexing section.
2022-04-10 | JP – Fixed link and HTTP issues.
2021-12-21 | AN – Updated contents for 8.11 release.
2021-02- 09 | AN – Formatted the TOC.
2020-05-25 | JP – Updated the document for Release 8.8.0.
2020-03-13 | AM – Updated content for April 2020 release.
2020-01-22 | AN – Revamped the document.
2019-09-18 | JP – Updated content for September 2019 release.
2019-06-08 | PLK – Minor copyedits.
2019-05-08 | AN – Inserted images and fixed link issues.
2019-05-04 | PLK – Updated content for April 2019 release.
2019-01-22 | PLK – Page created, content uploaded, and TOC and links added.