Project Settings

Manage internationalization

• For Currencies, select the currencies for the countries where your products are sold. They will be available when assigning Prices to Products or when creating Discounts.
• For Languages, select the languages used to localize Product information and other project-specific data.
  Modifying available languages does not affect the display language of the Merchant Center interface (for example, menu items and button text). To view or modify the interface language, click your user profile and go to My Profile > Personal Settings > Language and region.
• For Countries, the countries where you sell your products in. They will be available when configuring Shipping Methods, taxes, or Channels.
• For Zones, define groups of countries (Zones) to set up delivery costs for different geographic locations.
  To add a Zone, click Add zone, select the countries, and save the changes.
  To configure Zones for states or sub-country units, use the Zones.

Add a Tax Category

In Composable Commerce, taxes comprise of the following: Tax Category, Tax Rate, and Tax subrate.

A Tax Category groups Tax Rates together. A Tax Rate defines the tax percentage for a state or country; it can also include Tax subrates—the sum of all subrates equal the total Tax Rate. Tax subrates are applied to different tax types when the total tax is a combination of multiple taxes—for example, local, state/provincial, and federal taxes.

To create taxes, do the following:

1. Go to Settings > Project settings and click the Taxes tab.
2. Click Add tax category.

3. Enter the basic details for the Tax Category.

   • For Tax name, enter the name for the Tax Category.
   • Optional: For Key, enter a unique identifier value for the Tax Category.
   • Optional: For Description, enter a description for the Tax Category.
4. In the Tax rates section, click Add rate and do the following:
   • For Name, enter the name for the Tax Rate.
   • Optional: For Key, enter a unique identifier value for the Tax Rate.
   • Optional: For State/Province, enter the state or province for which the Tax Rate applies.
   • For Country, select the country for which the Tax Rate applies.
   • For Rate, enter the percentage (in decimal format) of the Tax Rate.
   • For Tax included in price, choose whether the tax should be included in the price.
5. Optional: To add subrates, click Add subrate and do the following:
   • For Name, enter the name for the subrate.
   • For Rate, enter the percentage (in decimal format) of the subrate.
   The total of all subrates must be equal to the Tax Rate.

6. Click Add tax rate.
7. Click Create tax category.

Add a Shipping Method

Shipping Methods represent the various ways you can deliver products to your customers. The associated delivery charges (or shipping rates) can be defined based on specific geographical Zones. Shipping rates can be fixed or tiered.

• If a shipping rate is fixed, the shipping cost always remains the same, even if the contents or conditions of a Cart change.
• If a shipping rate is tiered, the shipping cost changes based on a few factors: for example, the shipping cost decreases if the Cart value increases.

To add Shipping Methods, do the following:

1. Go to Settings > Project settings and click the Shipping methods tab.
2. Click Add shipping method.

3. Enter the basic information for the Shipping Method.

   • For Shipping method name, enter localized names for the Shipping Method.
   • Optional: For Description, enter localized descriptions for the Shipping Method.
   • For Tax category, select the Tax Category (configured for the Project).
   • Optional: For Key, enter a unique identifier value for the Shipping Method.
   • Optional: For Predicate, enter a condition for when the Shipping Method should apply to a Cart. For more information about predicates and their syntax, see Predicates.

   • Optional: If present, select a Custom Field and enter a value for it.

     Custom Fields are defined using the Custom Fields API.
4. Click Add zone.

5. Select a Zone (configured for the Project) and do the following:

   • For fixed shipping rates, click Add currency-specific rates, select the currency (configured for the Project) and enter the shipping rates. Optionally, you can offer free shipping beyond a certain purchase threshold.
     By default, Shipping Methods use fixed shipping rates. To change, see Configure the shipping rate
   • For tiered shipping rates, do the following:
     • For Cart Value shipping rates, select the currency (configured for the Project), enter the cart value and the shipping rate (for carts exceeding the defined value).
     • For Cart Classification shipping rates, select the currency (configured for the Project), select the key, and enter the shipping rate.
     • For Cart Score shipping rates, select the currency (configured for the Project), enter the score, choose if it's a fixed value or function, and enter the shipping rate.
6. Click Create shipping method.

Add a Channel

Channels can be used to model warehouses or stores. They link entities (such as inventory or price) to a specific source, like a warehouse or a physical retail location—for example, inventory can be connected to a supply channel that would describe from which supplier a stock comes from.

1. Go to Settings > Project settings and click the Channels tab.
2. Click Add channel.

3. Enter the basic information for the Channel.

   • For Channel key, enter a unique identifier value for the Channel.
   • Optional: For Channel name, enter localized names for the Channel.
   • Optional: For Channel description, enter localized descriptions for the Channel.
   • For Channel roles, select the roles for the Channel. It defines the purpose of the Channel.
4. Optional: For Geolocation, enable the toggle and enter the geographic coordinates of the physical location of the Channel.
5. Optional: For Address, enable the toggle and enter the address details.

6. If present, select a Custom Field for the Channel and enter a value for it.

   Custom Fields are defined using the Custom Fields API.
7. Click Save.

Configure the shipping rate

By default, a fixed shipping rate applies to orders. To change the configuration, do the following:

1. Go to Settings > Project settings and click the Shipping methods tab.
2. In Shipping rate control, click Fixed shipping rates only.

3. Click the toggle and select the input type for tiered shipping rates.

4. If you selected Cart Classification, enter a unique identifier key value. It allows you to categorize shipping rates for unique key values.
5. Click Confirm.

Add a Store

Stores can be used to model physical retail locations, brand stores, or country-specific stores, allowing you to limit access to a subset of resources within a Project. These Stores can include Carts, Orders, Shopping Lists, Customers, Business Units, Quotes, Quote Requests, Staged Quotes, Shipping Methods, Cart Discounts, and Products specific to them.

1. Go to Settings > Project settings and click the Stores tab.
2. Click Add store.

3. Enter the basic information for the Store.

   • For Store key, enter a unique identifier value for the Store.
   • Optional: For Store name, enter localized names for the Store.

4. Configure the settings for the Store.

   • Optional: For Inventory supply channels, select the (supply) Channels. They determine the inventory availability for the Store.

   Product data sent to the storefront will only include inventory entries linked to the selected (supply) Channels, as well as inventory entries not linked to any Channel. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   • Optional: For Product distribution channels, select the (distribution) Channels. They determine the Embedded and Standalone Prices availability for the Store.

   Product data sent to the storefront will only include prices linked to the selected (distribution) Channels, as well as prices not linked to any Channel. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   • Optional: For Country(ies), select the countries. They determine the Embedded and Standalone Prices availability for the Store.

   Product data sent to the storefront will only include prices linked to the selected countries, as well as prices not linked to any country. Line items in Carts and Orders, associated with the Store, are filtered the same way.

   • Optional: For Languages, select the languages (configured for the Project).

   Product data sent to the storefront will only include localized data linked to the selected languages, impacting Product details, search results, and Cart Line Items.

   • Optional: For Product Selections, select the Products Selections. They determine the product catalog available for the Store.

   Product data sent to the storefront will only include active Product Selections.

5. Click Create Store.

Business Units

The Business Units tab lets you configure default behaviors for Business Units created by buyers, and manage Associate Roles and their associated permissions. For more information, see Business Units.

To configure Business Unit settings, follow these steps:

1. Click the edit icon next to Business unit settings and select whether newly created Business Units are Inactive or Active by default.
2. For Default associate role, select a default role. This list is populated by the Associate Roles you define.
3. Click Save.

Add associate role

Associate Roles let you group granular permissions. These roles can then be assigned to Associates within a Business Unit, defining what actions they can perform.

To add a new Associate Role, do the following:

1. Click Add associate role.
2. Under General information tab, enter the following:
   • For Role name, enter a descriptive name for the role.
   • For Role key, enter a unique key for the role.
   • For Assignable by buyers, toggle to allow buyers to assign this role to other associates. If inactive, only sellers will have access to this role.
3. Under Associate permissions tab, configure access permissions:
   • For Select predefined permissions, select a template to quickly apply a set of common permissions, or manually select permissions across various categories under Choose permissions.

   • Optional: If present, select a Custom Field and enter a value for it.

     Custom Fields are defined using the Custom Fields API.
4. Click Save.

Miscellaneous

• Recommended categories: enables Category suggestions for Products during creation or editing. You can choose from the following recommendation criteria:
  • Attribute: suggests Categories containing Products with matching Attribute names.
  • Product type: suggests Categories containing Products of the same Product Type.
• Rich text editor for product descriptions: provides advanced text formatting options to apply for your Product descriptions. If activated, any applied styling is converted into HTML code that your storefront can retrieve.
• Order states visibility: controls the visibility of the following Order states drop-downs in the Merchant Center:
  • Hide payment state dropdown
  • Hide shipment state dropdown
  • Hide order state dropdown
    If your customer service representatives use the Merchant Center to manage orders manually (including updating these states), ensure these checkboxes are not selected so that the dropdown menus remain visible. By default, these checkboxes may be selected (hidden), as indicated in the UI.

• URL rewrite for external images: allows to display external Product images in the Merchant Center according to the naming format of the image hosting service. By default, Merchant Center does not show Product images hosted on external servers. You can configure the following:
  • Size: thumb: URL rewrite (search and replace) rules for thumbnail images.
  • Size: small: URL rewrite (search and replace) rules for small images.
• Disable email format validation for customer emails: allows to disable the validation of the email format in email fields when creating or editing a Customer.
• Promotion Prioritization: configures how Product Discounts and Cart Discounts interact when applied to a Cart. Line Item prices can be impacted by both types of discounts.
• Hide legacy single Customer Group assignment method: removes all references to the outdated method of assigning a Customer to a single Customer Group.