Location
Represents a physical or virtual place of business — such as a warehouse, plant, store, site, or delivery vehicle — used across Manufacturing/Automotive/Consumer Goods Cloud to model where inventory is held, where assortments are assigned, and where operations occur. Locations can be organized into a hierarchy via ParentLocationId and RootLocationId. This object is available in API version 68.0 and later.
Supported Calls
create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()
Special Access Rules
Available only in orgs with Manufacturing Cloud, Automotive Cloud, or Consumer Goods Cloud features (including Inventory Management and Location/Assortment management) enabled.
Fields
CloseDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date this location closed or is scheduled to close.
ConstructionEndDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date construction of this location finished.
ConstructionStartDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date construction of this location began.
CurrencyIsoCode
Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The ISO currency code associated with this location. Possible values are: AED (UAE Dirham), USD (U.S. Dollar), and every other active currency ISO code configured for the org. The default value is USD.
Description
Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: A free-text description of this location.
DrivingDirections
Type: string
Properties: Create, Filter, Nillable, Sort, Update
Description: Free-text driving directions to reach this location.
Email
Type: email
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The primary email address associated with this location.
ExternalReference
Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: An external identifier used to correlate this record with the same location in an external or source system.
Fax
Type: phone
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The fax number for this location.
InternalOrganizationUnitId
Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The internal organization unit that owns or operates this location.
Relationship Name: InternalOrganizationUnit
Refers To: InternalOrganizationUnit
IsInventoryLocation
Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates whether inventory can be tracked and stored at this location. The default value is false.
IsMobile
Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates whether this location is mobile (for example, a delivery van) rather than a fixed site. The default value is false.
LastReferencedDate
Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp when the current user last accessed this record or a related record.
LastViewedDate
Type: dateTime
Properties: Filter, Nillable, Sort
Description: The timestamp when the current user last viewed this record.
Latitude
Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The geolocation latitude of this location.
Location
Type: location
Properties: Nillable
Description: The compound geolocation field composed of the Latitude and Longitude values.
LocationLevel
Type: int
Properties: Filter, Group, Nillable, Sort
Description: The depth of this location within the location hierarchy, relative to its root location.
LocationType
Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: The type of place this location represents. Possible values are Plant, Site, Van, Virtual, and Warehouse. The default value is Warehouse.
LogoId
Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The content asset used as this location’s logo/image.
Relationship Name: Logo
Refers To: ContentAsset
Longitude
Type: double
Properties: Create, Filter, Nillable, Sort, Update
Description: The geolocation longitude of this location.
Mobile
Type: phone
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The mobile phone number associated with this location.
MobileLocationType
Type: picklist
Properties: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: When IsMobile is true, indicates the type of mobile location. Possible values are Bike, Car, CargoUnit—Cargo Unit, and Truck. The default value is Car.
Name
Type: string
Properties: Create, Filter, Group, idLookup, Sort, Update
Description: The name of this location.
OpenDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date this location opened for business.
OwnerId
Type: reference
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: The user or queue that owns this record.
Relationship Name: Owner
Refers To: Group, User
ParentLocationId
Type: reference
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The immediate parent location in the location hierarchy.
Relationship Name: ParentLocation
Refers To: Location
Phone
Type: phone
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The primary phone number for this location.
PossessionDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date possession of this location was taken (for example, on lease or purchase).
RegistrationNumber
Type: string
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: A government or business registration number associated with this location.
RemodelEndDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date a remodel of this location finished.
RemodelStartDate
Type: date
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: The date a remodel of this location began.
RootLocationId
Type: reference
Properties: Filter, Group, Nillable, Sort
Description: The top-level (root) location at the base of this location’s hierarchy branch.
Relationship Name: RootLocation
Refers To: Location
TimeZone
Type: picklist
Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description: The time zone this location operates in, expressed as an IANA time zone identifier (for example, America/New_York).
Associated Objects
This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.