IndustriesUnifiedInventorySettings in SFDX

Architectural Overview#

The IndustriesUnifiedInventorySettings metadata type controls organization-level parameters for Unified Inventory Management within Salesforce Industry Clouds. In complex vertical ecosystems—such as Manufacturing Cloud, Automotive Cloud, Energy & Utilities Cloud, and Communications Cloud—inventory is distributed across field warehouses, service vehicles, dealer networks, and third-party logistics (3PL) partners.

Architecturally, IndustriesUnifiedInventorySettings provides real-time stock reconciliation, location grouping, serialized product tracking, and inventory reservation services. Enabling this metadata type provisions the standard schema and platform events necessary to orchestrate stock reservation across order management and field service fulfillment pipelines.

Directory and File Conventions#

In Salesforce DX source format, this setting is represented as a single XML file within the settings directory:

Key Metadata Fields#

The XML schema for IndustriesUnifiedInventorySettings provides configuration options for inventory calculation and reservations:

Declarative XML and Package Manifest Examples#

Source XML (IndustriesUnifiedInventory.settings-meta.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<IndustriesUnifiedInventorySettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableUnifiedInventory>true</enableUnifiedInventory>
    <enableRealTimeReservation>true</enableRealTimeReservation>
    <enableSerializedTracking>true</enableSerializedTracking>
    <reservationTimeoutMinutes>30</reservationTimeoutMinutes>
</IndustriesUnifiedInventorySettings>

Package Manifest (package.xml)#

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types>
        <members>IndustriesUnifiedInventory</members>
        <name>Settings</name>
    </types>
    <version>68.0</version>
</Package>

Retrieval and Deployment#

To retrieve IndustriesUnifiedInventorySettings from an org:

# Retrieve by metadata name
sf project retrieve start --metadata Settings:IndustriesUnifiedInventory

# Retrieve using manifest
sf project retrieve start --manifest manifest/package.xml

To deploy IndustriesUnifiedInventorySettings to a target environment:

# Deploy to designated org
sf project deploy start \
  --metadata Settings:IndustriesUnifiedInventory \
  --target-org packaging-org \
  --wait 10

Senior Architect Deployment Best Practices and Gotchas#

Concurrency and Locking Considerations#

When configuring enableRealTimeReservation, architects must anticipate database locking risks during peak order placement windows. Unified inventory uses optimistic locking and platform events to coordinate stock counts across location groups.

Scratch Org and CI Testing#

Include the inventory settings in your scratch org configuration to ensure continuous integration pipelines can validate fulfillment and reservation logic:

{
  "orgName": "Manufacturing Unified Inventory Scratch Org",
  "edition": "Enterprise",
  "features": ["ManufacturingCloud", "IndustriesUnifiedInventory"],
  "settings": {
    "industriesUnifiedInventorySettings": {
      "enableUnifiedInventory": true,
      "enableRealTimeReservation": true
    }
  }
}

Frequently asked questions

What is IndustriesUnifiedInventorySettings in Salesforce?

It configures unified stock tracking, location-based availability, and inventory reservations across Salesforce Industry Cloud applications.

Where is IndustriesUnifiedInventorySettings stored in an SFDX project?

It is stored under force-app/main/default/settings as IndustriesUnifiedInventory.settings-meta.xml and retrieved as Settings:IndustriesUnifiedInventory.

What industry clouds use IndustriesUnifiedInventorySettings?

It is primarily leveraged by Manufacturing Cloud, Automotive Cloud, Energy and Utilities Cloud, and Communications Cloud for unified stock visibility.

Can unified inventory reservation rules be deployed via SFDX?

Yes, once IndustriesUnifiedInventorySettings is deployed and active, reservation workflows, flows, and inventory objects can be deployed safely.