Document toolboxDocument toolbox

Storage Location Object

The Storage Location object contains managed inventory items. Storage locations are assigned to technician's and usually refer to their vehicle inventory. Storage locations can also be assigned to an account location which then allows for managing inventory at a customer location. A good example of customer managed inventory would be printer toner, air filters, water bottles, etc. 

Once a storage location is initially created and assigned, this API should no longer be used to manage it. Instead is should be managed with the Inventory Load and Physical Inventory Count APIs. The reason is because this API represents a complete replacement of the storage location object and because a technician may have just consumed inventory which has not been upload to the system yet, replacing it could immediately cause the counts to be out of sync.

A storage location can only be assigned to a single technician or account location at a time.

On this page:

Storage Location Object Formats

JSON Format
 {
	"ModifiedUTC": "2013-01-01T12:00:00.000Z",
	"StorageLocationID": "",
	"StorageLocationType": "",
	"Address": {
		"AddrLine1": "",
		"AddrLine2": "",
		"AddrLine3": "",
		"AddrLine4": "",
		"AddrType": "",
		"City": "",
		"Country": "",
		"Intersection": "",
		"Lat": "",
		"Lon": "",
		"Region": "",
		"Zip": ""
	},
	"Contacts": [{
		"Email": "",
		"FirstName": "",
		"IsPrimary": true,
		"LastName": "",
		"Phones": [{
			"PhoneNum": "",
			"PhoneType": ""
		}]
	}],
	"Items": [{
		"ProdNum": "",
		"BatchNum": "",
		"DamagedQty": 0.0,
		"Deleted": false,
		"Qty": 0.0,
		"SerialNum": "",
		"ProdAttrs": {
			"Desc": "",
			"IsBatch": false,
			"IsInvCtrl": false,
			"IsSerialized": false
		}
	}],
	"Name": ""
}

Storage Location Object Properties

(info) Required properties are in bold.

PropertyTypeDescription
Addressobject

The address details for the warehouse (StorageLocationType = 1002). This is a required field when storage location is type of warehouse

See: Account Location Related Objects Address Object

Contactscollection

A collection of contacts for the warehouse

See: Account Location Related Objects Contact Object

NamestringIdentifies the name of the warehouse. This is a required field when storage location is type of warehouse
Itemscollection

A collection of items that are in the current storage location.

See: Item Object

ModifiedUTCdatetimeThe date and time, in UTC format, when this object was last modified.
StorageLocationTypestring

Contains a Storage Location Type System Category value identifying the type of storage location.

Valid values are:

Codes

Activity CodeReservedDescription
1001Yes

Vehicle.

Identifies the storage location as a vehicle.

1002Yes

Warehouse.

Identifies the storage location as a warehouse.

StorageLocationIDstringThe unique storage location identifier.