Configure a Master Retailer Inventory Catalog notifying Sub-Retailer(s) Virtual Catalog(s)

How-to Guide

Author:

Kirill Gaiduk

Changed on:

24 Oct 2024

Key Points

Create your Master-Retailer Inventory Catalog
Create your Sub-Retailer(s) Virtual Catalog(s)
Configure your Inventory Catalog Workflow for Cross-Retailer events sending

Prerequisites

Inventory Module Overview

Sales Channel Availability Management

Steps

Create Master-Retailer Inventory Catalog

1. Create an (or use an existing) Inventory Catalog.

Use the

`createInventoryCatalogue`

mutation or do it via the UI under your Master Retailer.

2. Verify that your Master-Retailer Reference is saved in the

`retailerRefs`

field.

3. Activate the Inventory Catalog.

Use the

`updateInventoryCatalogue`

mutation or do it via the UI.

Note

The Master-Retailer Inventory Catalog will be used as the inventory source for the Virtual Catalog(s) associated with the corresponding Sub-Retailer(s).

Create Sub-Retailer Virtual Catalog(s)

1. Create a (or update an existing) Virtual Catalog, ensuring it is linked to a corresponding Sub-Retailer.

Use the

`createVirtualCatalogue`

mutation or do it via the UI.

Add a Virtual Catalog attribute

`primaryRetailerRef`

with the Sub-Retailer Reference value. This will allow the Cross-Workflow event (

`VirtualCatalogueEvent`

) to be sent with the corresponding

`retailerId`

of the Retailer who owns the Virtual Catalog.

Alternative

The

`primaryRetailerRef`

attribute creation is preferable, but it is not the only option available, as Cross-Retailer events sending is based on the "Three-Level Fallback" logic.

Instead of the attribute, the Sub-Retailer Reference value could be set in the

`retailerRefs`

field (of the Sub-Retailer Virtual Catalog). With this configuration, your Sub-Retailer Reference value should be the first entry in the

`retailerRefs`

list for correct Cross-Retailer events sending.

As a fallback process, if the

`primaryRetailerRef`

attribute in the Sub-Retailer Virtual Catalog is missing and the

`retailerRefs`

field is empty, the

`retailerId`

field for the target Cross-Retailer event will be obtained from the Rubix (Orchestration Engine) Context (

`context.getEvent().getRetailerId()`

For more details, check the Cross-Retailer events sending section of the

`NotifyVirtualCataloguesByRefsOnNetworksMatch`

Rule description.

2. Assign your Master-Retailer Inventory Catalog to your Sub-Retailer Virtual Catalog.

Use the

`updateVirtualCatalogue`

mutation or do it via the UI.

Update the Sub-Retailer's Virtual Catalog reference to the Inventory Catalog (

`inventoryCatalogueRef`

) to your Master-Retailer Inventory Catalog Reference.

3. Activate your Sub-Retailer Virtual Catalog.

4. (Optional) Repeat the Steps 1-3 for all the required Sub-Retailer(s) Virtual Catalogs.

Configure your Inventory Catalog Workflow

1. Set the created Sub-Retailer(s) Virtual Catalog(s) Reference(s) to the

`virtualCatalogueRefs`

`NotifyVirtualCataloguesByRefsOnNetworksMatch`

Rule parameter.

The Rule executes a "Network-Match-Check" for the specified Virtual Catalogs and sends the Cross-Retailer event(s) to those that passed the check.

A Virtual Catalog passes the "Network-Match-Check" when its Network(s) finds a match with a given Inventory Position Location Network(s).

Alternatives

The Reference Inventory Catalog Workflow

`NotifyVirtualCataloguesByRefsOnNetworksMatch`

Rule could be replaced with the following ones:

```
`NotifyVirtualCataloguesByTypesOnNetworksMatch`
```
Rule
to specify the Virtual Catalogs for "Network-Match-Check" by Types (instead of by References)
```
`NotifyVirtualCataloguesOnNetworksMatch`
```
Rule
to execute the "Network-Match-Check" for all the existing Virtual Catalogs

2. Verify that the

`eventName`

Rule parameter has been provided as well.

Update your Inventory

1. Update your Inventory with:

2. Verify that the target Inventory Position(s) (of your Master-Retailer Inventory Catalog) has been updated.

3. Use the Events page to verify that a desired Cross-Retailer event(s) has been sent to the target Sub-Retailer Virtual Catalog(s).

4. Verify that the target Virtual Position(s) (of your Sub-Retailer(s) Virtual Catalog(s)) has been updated.

Configure a Master Retailer Inventory Catalog notifying Sub-Retailer(s) Virtual Catalog(s)

Key Points

Prerequisites

Inventory Module Overview

Sales Channel Availability Management

Steps

Create Master-Retailer Inventory Catalog

Create Sub-Retailer Virtual Catalog(s)

Configure your Inventory Catalog Workflow

Update your Inventory

Related artifacts

Inventory Catalog Workflow Template

NotifyVirtualCataloguesByRefsOnNetworksMatch

NotifyVirtualCataloguesOnNetworksMatch

NotifyVirtualCataloguesByTypesOnNetworksMatch

Related content

Inventory Reference Module

Optimize your Inventory Workflows with Inventory Reference Module 2.1.0

Kirill Gaiduk

Building Blocks

By Type

Helpful Resources

Quick Links