Salesforce Docs Portal

Create a Location Graph for Omnichannel Inventory

A location graph consists of locations and location groups. You can create the graph using the Omnichannel Inventory console app, Connect in Apex, or Connect REST API.

  1. Create at least one location type.
  2. For each location that fulfills orders, create a Location record.

    If you’re using D2C Commerce, the location graph can have only one location.

    1. Set Should Sync With OCI to True.
    2. Set Is Inventory Location to True.
    3. Specify the location type.
    4. Set the visitor address to the physical address of the location.
    5. Set the external reference to a unique value.
      If you’re using Salesforce B2C Commerce, use the external reference to associate the location with a dedicated B2C Commerce inventory list.
  3. For each storefront, sales channel, or logical group of locations, create a Location Group record.

    If you’re using D2C Commerce, the location graph can have only one location group.

    1. Set Should Sync With OCI to True.
    2. Set Is Enabled to True.
    3. Set the external reference to a unique value.
      If you’re using Salesforce B2C Commerce, use the external reference to associate the location with a dedicated B2C Commerce inventory list.
  4. For each location, create a Location Group Assignment record for each location group that it belongs to.
    A location doesn’t have to belong to a location group.
    1. Create a location group assignment for each location.
      A location can belong to multiple location groups.
    2. Assign at least one location to each location group.
  5. Commit the changes to Omnichannel Inventory.

Adding or removing locations or location groups after loading inventory availability data can trigger large availability data and cache updates. If you need to make changes, schedule the update during low-order traffic times or change one item at a time.

  • Schedule location graph changes for times with low-order traffic.
  • If you have scheduled imports, pause them until the changes are complete.
  • Add or remove only one location or location group at a time.
  • After making a change, wait for the update to finish before importing new inventory availability data.

When using Omnichannel Inventory console app, be sure to select Sync with OCI when creating locations and location groups.