Apply Stores and Channels

Zen Electron’s multi-brand digital commerce requirements

This document outlines the requirements for the digital commerce platforms of Zen Electron's two brands: Electronics High Tech and Zenith Living.

Let's now look at how we can solve Zen Electron's requirements, and how Stores and Channels can play be implemented.

Project settings

Categories

Here are examples of what kind of Category tree each brand requires:

• Computers & Tablets
  • Computers
  • Components
  • iPads, Surface & Tablets
  • Networking
  • Tech Services
  • Computer Accessories
• Gaming

• Computers
  • Shop by brand
  • Monitors
  • Software
  • Home internet & Wi-Fi
  • Printers & Ink
  • Hard drives & data storage
  • Office furniture
• Cameras

We can see some similarities in the taxonomy, but ultimately they are not the same and each brand is not willing to adopt the other brands taxonomy.

To support the requirements, we will create two root-level Categories, one for each brand. The root-level Category for each brand will be the name of each respective brand, and then the Category tree will be created underneath it.

The only limitation of this solution is that duplicate URL slugs per locale are illegal. Zen Electron can accept having slightly different URL slugs for duplicate names, whilst keeping the same category name, so we can continue with this option. For example, ‘computers’ is a duplicate and we will need to change one of its slugs to ‘‘computers’ or some other variation.

When you are working with the Categories, you will be able to determine which root they belong to by looking at the top-level Category in the hierarchy; specifically, the parent of the brand's Category tree. When your application needs to understand this is best done by holding Category tree IDs.

Category affiliation is determined by the root-level category. For efficient application logic, storing each branch of the Category with the IDs is recommended. This is because when querying for Products, the default response will return the Category ID without any hierarchy hints. Note that GraphQL will allow you to explictly request detailed Category information including the ancestors.

If we want to be able to retrieve the Categories belonging to a specific brand, we would add a Custom Field to the Category and use this to determine which Category belongs to which brand. Then we can query the Categories and pass this field in the query parameter to ensure that the response only returns Categories related to the brand that we want, which will give us the information needed to build a hierarchical Category menu for each brand.

When assigning Products to Categories, we will know which Category belongs to which brand by the Category path or the custom type of the Category.

Product management

We have the following requirements concerning the product catalog to solve:

Product Types

Product Tailoring

Product Selections

Note: It’s important to give the Product Selections a good name, so that you know what they contain, just by reading the name.

Next we will create a Store for each brand, with the following settings:

• Assign the appropriate Product Selections to each brand
• Assign the required languages for each store
  • Zenith Living: en-NZ
  • Electronics High Tech; ZH, en-AU, en-NZ
• Countries
• Set a Store key (this will be important for Store specific shipping rates)

The Zen Electron Store should look similar to this:

{
  "id": "fbb33836-d683-46b2-98aa-fe00c241ba8d",
  "version": 1,
  "createdAt": "2024-10-07T05:14:23.851Z",
  "lastModifiedAt": "2024-10-07T05:14:23.851Z",
  "lastModifiedBy": {
    "isPlatformClient": true,
    "user": {
      "typeId": "user",
      "id": "c950c084-f5d0-4a42-8761-229d5c7a8598"
    }
  },
  "createdBy": {
    "isPlatformClient": true,
    "user": {
      "typeId": "user",
      "id": "c950c084-f5d0-4a42-8761-229d5c7a8598"
    }
  },
  "key": "zenith-living",
  "name": {
    "en-AU": "Zenith Living"
  },
  "languages": ["en-AU"],
  "distributionChannels": [],
  "supplyChannels": [],
  "productSelections": [
    {
      "productSelection": {
        "typeId": "product-selection",
        "id": "7665f708-aede-4718-bf22-9ca696752f9e"
      },
      "active": true
    },
    {
      "productSelection": {
        "typeId": "product-selection",
        "id": "0d3b40b0-e317-4f42-bcaa-8259adcb0100"
      },
      "active": true
    }
  ],
  "countries": [
    {
      "code": "AU"
    }
  ]
}

Now we have all the settings needed to allow us to have a different catalog for each brand.

Lets see how this would look like as a diagram:

Alternative Product Selection strategies

For example, let's say we have a "shared products" selection and brand-specific products for "Zen Electron" and "Electronics High Tech".

• Zenith Living (Exclusion): This Product Selection would contain all the products except those specific to Zen Electron and the shared products.
• Electronics High Tech (Exclusion): This Product Selection would contain all products except those specific to Electronics High Tech and the shared products.

Comparison of inclusion and exclusion approaches

Choosing the right approach depends on the specific needs and characteristics of the product catalog and the number of brands involved. Consider the anticipated growth of the product catalog and the frequency of adding new products when making this decision. For catalogs with a large shared component and frequent additions, the exclusion method may be more efficient.

This approach still requires careful naming conventions for Product Selections. For example, prefixes like "exclude-" or suffixes like "-not-sold" indicate the selection's purpose (for example, "exclude-zen-electron-products" or "electronics-high-tech-not-sold"). This improves readability and reduces confusion. The same Store configuration demonstrated earlier applies, with the only difference being the logic behind the assigned Product Selections.

Shipping

The brands share some Shipping Methods in common, whilst each has the right to set their own shipping Rates.

• You used Create Cart in Store to create the Cart.
• You set the store field in CartDraft.

Note that there is no update action to set the Store on an existing Cart. This means that you need to use one of the above options to set the Store on the Cart when the Cart is created.

{
  "id": "1d738bad-aa92-4387-ae32-a9c781afb951",
  "version": 6,
  "createdAt": "2024-10-07T05:30:21.173Z",
  "lastModifiedAt": "2024-10-07T05:39:03.265Z",
  "lastModifiedBy": {
    "isPlatformClient": true,
    "user": {
      "typeId": "user",
      "id": "c950c084-f5d0-4a42-8761-229d5c7a8598"
    }
  },
  "createdBy": {
    "isPlatformClient": true,
    "user": {
      "typeId": "user",
      "id": "c950c084-f5d0-4a42-8761-229d5c7a8598"
    }
  },
  "name": "Premium Platinum Delivery",
  "localizedName": {
    "en-AU": "Premium Platinum Delivery"
  },
  "localizedDescription": {
    "en-AU": "Zen Electron"
  },
  "taxCategory": {
    "typeId": "tax-category",
    "id": "52dca5ab-959c-4ad6-a653-d187bbc989d9"
  },
  "zoneRates": [
    {
      "zone": {
        "typeId": "zone",
        "id": "92584e63-60a0-4182-b0dc-e866d375c835"
      },
      "shippingRates": [
        {
          "price": {
            "type": "centPrecision",
            "currencyCode": "AUD",
            "centAmount": 990100,
            "fractionDigits": 2
          },
          "tiers": []
        }
      ]
    }
  ],
  "active": true,
  "isDefault": true,
  "predicate": "store.key = \"zenith-living\"",
  "references": []
}

These are the current postcodes that are classified as Metropolitan for delivery purposes (by Australia Post):

• Postcode 1000 to 1935
• Postcode 2000 to 2079, 2085 to 2107, 2109 to 2156, 2158, 2160 to 2172, 2174 to 2229, 2232 to 2249, 2557 to 2559, 2564 to 2567, 2740 to 2744, 2747 to 2751, 2759 to 2764, 2766 to 2774, 2776, 2777, 2890 to 2897.
• Postcode 3000 to 3062, 3064 to 3098, 3101 to 3138, 3140 to 3210, 3800, 3801.
• Postcode 4000 to 4018, 4029 to 4068, 4072 to 4123, 4127 to 4129, 4131, 4132, 4151 to 4164, 4169 to 4182, 4205, 4206.
• Postcode 5000 to 5113, 5115 to 5117, 5125 to 5130, 5158 to 5169, 5800 to 5999.
• Postcode 8000 to 8999
• Postcode 9000 to 9275, 9999

We have a few solutions for this case:

1. Put all the address postcodes in the Shipping Predicate. For example, shippingAddress.postalCode in ("1000","1001","1002","1003")
2. Use a Custom Field on Carts that indicates if the address is a metro area or not, and use this Custom Field on the Shipping Predicate. Write logic to update this value on the Cart based on the address. This might be done by your BFF or API Extensions.

Customers

Pricing

The following requirements can be solved using Prices scoped to Channels:

Example of the expected Price fields:

{
  "value": {
    "type": "centPrecision",
    "currencyCode": "AUD",
    "centAmount": 15800,
    "fractionDigits": 2
  },
  "channel": {
    "typeId": "channel",
    "id": "ac2e77df-ff8c-44eb-8048-f9789123767a"
  }
}

Now we need to update each Store and add the matching Product Distribution Channel.

Inventory

The following requirements can be solved using Supply Channels:

We will create Supply Channels for each inventory location and assign each of these Channels to a Store. When a Cart has a Store value set, then it can only use Supply Channels that belong to that Store, ensuring that the inventory is isolated per Store.

Note: Inventory-to-shipping mapping strategies are outside the scope of this module.

Merchant Center access

Test your knowledge