ServiceTerritory
Represents a dealer location where service resources are located and
service appointments are performed. This object is available in API version 58.0 and
later.
Supported Calls
create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()
Special Access Rules
Automotive and Automotive Scheduler must be
enabled.
Fields
Address
- Type: address
- Properties: Filter, Nillable
- Description: An address to associate with a dealer’s location.
City
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The city of the associated address. The Automotive appointment booking flows for test drives and vehicle services use the dealer name or city name as search input for the appointment location. Maximum length is 40 characters.
Country
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The country to associate with the territory. Maximum length is 80 characters.
Description
- Type: textarea
- Properties: Create, Nillable, Update
- Description: The description of the territory.
GeocodeAccuracy
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Description: The level of accuracy of a location’s geographical coordinates compared with its physical address. Usually provided by a geocoding service based on the address’s latitude and longitude coordinates. Possible values are:
- Address
- Block
- City
- County
- ExtendedZip
- NearAddress
- Neighborhood
- State
- Street
- Unknown
- Zip
IsActive
- Type: boolean
- Properties: Create, Defaulted on create, Filter, Group, Sort, Update
- Description: Indicates whether the service territory is meant to be used (true) or not (false). If a territory is inactive, you can’t add members to it or link it to service appointments. The default value is false.
LastReferencedDate
- Type: dateTime
- Properties: Filter, Nillable, Sort
- Description: The date when the record was last modified.
LastViewedDate
- Type: dateTime
- Properties: Filter, Nillable, Sort
- Description: The date when the record was last viewed.
Latitude
- Type: double
- Properties: Create, Filter, Nillable, Sort, Update
- Description: Used with Longitude to specify the precise geolocation of the address where the service appointments is completed. Acceptable values are numbers between –90 and 90 with up to 15 decimal places.
Longitude
- Type: double
- Properties: Create, Filter, Nillable, Sort, Update
- Description: Used with Latitude to specify the precise geolocation of the address where the service appointment is completed. Acceptable values are numbers between –180 and 180 with up to 15 decimal places.
Name
- Type: string
- Properties: Create, Filter, Group, idLookup, Sort, Update
- Description: The name of a dealer location. The Automotive appointment booking flows for test drives and vehicle services use the dealer name or city name as search input for the appointment location.
OperatingHoursId
- Type: reference
- Properties: Create, Filter, Group, Sort, Update
- Description: The territory’s operating hours, which indicate when service appointments within the territory can occur. Service resources who are members of a territory and work types related to a territory automatically inherit the territory’s operating hours unless different hours are specified on the resource or the work type record. This field is a relationship field.
- Relationship Name: OperatingHours
- Relationship Type: Lookup
- Refers To: OperatingHours
OwnerId
- Type: reference
- Properties: Create, Defaulted on create, Filter, Group, Sort, Update
- Description: The owner of the record. This field is a polymorphic relationship field.
- Relationship Name: Owner
- Relationship Type: Lookup
- Refers To: Group, User
ParentTerritoryId
- Type: reference
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The territory’s parent service territory, if it has one. A service territory hierarchy can contain up to 10,000 territories. This field is a relationship field.
- Relationship Name: ParentTerritory
- Relationship Type: Lookup
- Refers To: ServiceTerritory
PostalCode
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The postal code of the address associated with the territory. Maximum length is 20 characters.
State
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The state of the address associated with the territory. Maximum length is 80 characters.
Street
- Type: textarea
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: The street number and name of the address associated with the territory.
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.
- ServiceTerritoryChangeEvent: Change events are available for the object.
- ServiceTerritoryFeed: Feed tracking is available for the object.
- ServiceTerritoryHistory: History is available for tracked fields of the object.
- ServiceTerritoryOwnerSharingRule: Sharing rules are available for the object.
- ServiceTerritoryShare: Sharing is available for the object.