Account Location Object

Account locations are associated with accounts and an account can have one or more account locations. The account location is the location where actual work is to be preformed and typically the account represents the billing entity. For residential customers the account and account location are typically the same. 

Account Location Object Formats

JSON Format
{
    "Address": {
        "AddrLine1": "", 
        "AddrLine2": "", 
        "AddrLine3": "", 
        "AddrLine4": "",
        "AddrType": "", 
        "City": "", 
        "Country": "", 
        "Intersection" : "",
        "Lat" : "",
        "Lon" : "",
        "Region": "", 
        "Zip": ""
    }, 
    "Contacts": [
        {
            "Email": "", 
            "FirstName": "", 
            "IsPrimary": true, 
            "LastName": "", 
            "Phones": [
                {
                    "PhoneNum": "", 
                    "PhoneType": ""
                }
            ]
        }
    ], 
	"Edited": false,
    "Email": "", 
	"Integrations": {
		"Financial": {
			"ID": "",
			"Extensions": {
				"": ""
			}
		}
	},
	"IsActive": true,
    "LanguageID": "", 
    "LocationNum": "", 
    "Name": "", 
    "Notes" : "",
    "POReq": false, 
    "ServiceAreaID": "",
    "SigReq": true, 
    "StorageLocationID": ""
}

Account Location Object Properties

(info) Required properties are in bold.

PropertyTypeDescription
Addressobject

The address details for the account location.

Contactscollection

An optional collection of contacts at the account location.

Editedboolean 

Default value is false

Identifies if the mobile worker edited account location information in mobile application.

Valid values are:

  • false = The account location information has not been modified. This is the default value if this property is not specified.
  • true = The account location information has changed. 
EmailstringThe primary email address for the account location.
Integrationsobject

ServiceMobility integrates with many external systems. This optional object contains external system's unique identifier and/or sync token for Account Location object.

See: Integrations

4.5.0

IsActiveboolean

Default value is true

Identifies if the account location is active and can be used in mobile application.

Valid values are:

  • false = The account location is inactive.
  • true = The account location is active. This is the default value if this property is not specified.

4.3.0

LanguageIDstringThe language code identifier associated with the account location.
LocationNumstringThe unique account location number.
NamestringA simple name of the account location.
NotesstringGeneral notes about the account location.
POReqbooleanIdentifies if a purchase order number is required at the time of the visit. If this field is not present, it will default to false.
ServiceAreaIDstring

The service area the account location is associated with.

3.20.0

SigReqboolean

Identifies if a signature is required to complete the work order process. The application has a default global setting related to signature capture. If this property is specified, then its value will override the system default.

Valid values are:

  • false = Signature capture is not required for the account location.
  • true = Signature capture is required for the account location.
StorageLocationIDstringThe inventory storage location identifier for the account location.