Edit an Asset

Request Data

 Modify an existing asset object. New values for any asset attributes may be assigned to the asset.

Required Information
Name	Description
action	adminassets
operation	edit
version	2
format	xml
target	The asset to modify. If specified a reqtype (request type) must be specified as well.
reqtype	Flag to identify the key being used to identify the asset. Acceptable values: tag Key is a Zonar RFID tag number. In version 2.X a type must also be specified. exsid Key is the external system id. vin Key is the Vehicle Identification Number (VIN). dbid Key is the internal database id number. This is the most reliable key to use. fleet Key is the asset fleet number. In version 2.X a type must also be specified.
type	When using reqtype of tag or fleet this must also be specified in version 2. See asset types for more details.
fleet	Cust assigned ident Any text, 20 char max. Must be unique.
newtype	Asset type label. The type the asset will have when the edit is completed. Assets must have a type assigned to them.
location	Location name this asset is assigned to. Must be a valid location name.
Optional Information
If any optional information is omitted, the asset will be assigned an empty or default value.
name	License tag number. Any text, 20 character max.
vin	VIN number Any text, 40 char max Must be unique.
exsid	Unique identifier used by the external maint system. Any text, 40 Char max. Must be unique.
inservice	The asset inservice date. Unix epoch timestamp. (UTC)
tagid	Zonar RFID tag number. Integer, the tagid type combination must be unique if supplied.
mfg	Asset manufacturer.
mileoffset	Offset to be applied to mileage readings obtained from RFID equipped hubometers in inspections for this asset.
engine_hour_offset	The asset engine_hour_offest is derived by taking the difference between the asset's chronometer and the GPS unit's chronometer. Most often, the GPS unit's chronometer will be 0, but this needs to be verified. The gps zones reported in the engine hour are restricted to the last know location of the asset before or at power-off.
status	This gives the option to set an asset to active 1 or inactive 2. If no type is set then the default is active.
radioaddress	Address used by wireless data link for hand held download stations.
subtype	Label of the subtype for the new asset.
homeloi	home LOI1 for this asset.
odometer_offset	Requires start date parameter.
start	The date odometer_offset is applied to.

¹ LOI means Location of Interest; called "Zone" in the GPS tools and reports found within the Ground Traffic Control web application.

Data Returned

Returned information:

A success or error message.

Example Request

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=adminassets
&operation=edit&format=xml&version=2&name=POE3134&vin=12345678989&fleet=FLT1234
&type=Standard&location=Portland&newtype=Standard&exsid=7654

Example Success Reply

Example Error Reply