POST public-api/assets/createFixedAssets

This method creates a new fixed asset. A fixed asset is unique across all sites and locations. The existing fixed asset is retrieved by calling API function GetAssetsByTags() or one of the searches. Requires Create Asset permission. Accepts a maximum of 500 records at a time.



Request Information

URI Parameters

None.

Body Parameters

Collection of AssetInfo
NameDescriptionTypeAdditional information
RowNumber

Internal. This is used to help identify errors if any.

integer

None.

AssetTag

Required. It is the primary identifier of an asset and it will be unique.

string

None.

AssetDescription

A brief description for the asset.

string

None.

AssetClassId

Internal. This helps to differentiate between a Fixed Asset (1) and a Multi-Quantity Asset (2).

integer

None.

AssetTypeNumber

Required. This is the identifier of the asset type (i.e. Laptop, Phone, Text Book).

string

None.

AssetTypeDescription

Read Only. It is the description of the asset type inherited from the asset type record.

string

None.

DepartmentCode

The department in which the asset belongs to.

string

None.

DepartmentName

The name of the department the asset belongs to.

string

None.

SiteName

Required. It is a site name where the asset is located.

string

None.

SiteDescription

Read Only. It is a site description.

string

None.

LocationCode

Required. It is the location of the asset inside of the site where the asset is located.

string

None.

GroupTag

This is the unique tag associated with the parent asset (group) the asset belongs to.

string

None.

IsGroup

If true then the asset will behave as a group and allow other assets to become associated with it.

boolean

None.

TransactAsWhole

If true then any transaction that applies to this group asset will apply to all associated children assets.

boolean

None.

AuditAsWhole

If true then any audit performed on this group asset will apply to all associated children assets. Put another way, counting this asset during an audit will count everything inside of or associated with it.

boolean

None.

SupplierNumber

The unique identifier of the vendor the asset was purchased from.

string

None.

SupplierContactEmail

Read Only. It is a vendor's contact email.

string

None.

SupplierContactName

Read Only. This is the name of the vendor's contact.

string

None.

SupplierEmail

Read Only. This is the vendor's email.

string

None.

SupplierName

Read Only. This is the name of the vendor.

string

None.

SupplierWebsite

Read Only. This is the vendor's website.

string

None.

AssetSerialNumber

This is the serial number of the asset, typically unique.

string

None.

ConditionDescription

This indicates the current condition of the asset, the condition must already exist in the system.

string

None.

ManufacturerName

This is the name of the manufacturer of this asset.

string

None.

AssetModelName

This is the model number of the asset.

string

None.

CategoryDescription

This is the category the asset belongs to (i.e. electronics, laptops, books). The category must already exist in the system.

string

None.

CheckoutLength

This is the length of time the asset is typically checked out.

integer

None.

CheckoutLeadTime

This indicates how much time is needed between when an asset is checked in and when it can be checked back out.

integer

None.

AssetIsCheckedOut

Read Only. If the asset is checked out this will be true.

boolean

None.

AssetShouldDepreciate

If the asset type is depreciable then the individual asset can be set to depreciate by setting this flag to true and setting a purchase cost.

boolean

None.

AssetSalvageValue

This indicates that the value of the asset will depreciate down to before it should be disposed.

decimal number

None.

AssetDepreciatedValue

Read Only. This field will only contain a value for any asset for which depreciation settings have been configured and calculated. After depreciation has been calculated for this asset, this field will contain the Assets Depreciated Value. See Depreciation in the help for more details.

decimal number

None.

BookValue

Read Only. The equation to calculate is BookValue = AssetPdCost - AssetCurrentDepreciation. This field will only contain a value for any asset for which depreciation settings have been configured and calculated. After depreciation has been calculated for this asset, this field will contain the Assets Depreciated Value. See Depreciation in the help for more details.

decimal number

None.

AssetDepreciationBeginDate

This is the date from which the asset begins to depreciate.

date

None.

AssetDefaultCost

For Multi-Quantity assets this is the default cost of the asset. For Fixed Assets, this is the purchase cost.

decimal number

None.

AssetAssignee

This is the name of the person to whom the asset is checked out to. This could be a Customer, Employee, or Vendor.

string

None.

AssetAssigneeNumber

This is the unique identifying number of the Customer/Employee/Vendor to whom the asset is checked out to.

string

None.

AssetRecordStatus

Read Only. This indicates the current status of the asset. 1 is for active and 2 is for inactive.

RecordStatus

None.

NewDefaultAttachment

This is the name of the attachment to use as the default.

string

None.

HasAttachment

This will be True if this asset has attachments.

boolean

None.

AssetTransQuantity

This is for Multi-Quantity assets. It Indicates the amount/quantity available at the location.

decimal number

None.

OwnerName

Read Only. This is the name of the employee who takes ownership of this asset.

string

None.

OwnerNumber

This is the unique identifier number of the employee who takes ownership of the asset.

string

None.

OwnerFirstName

Read Only. This is the first name of the owner.

string

None.

OwnerLastName

Read Only. This is the last name of the owner.

string

None.

WarrantyProvider

This is the provider of the warranty for the asset.

string

None.

WarrantyBeginDate

This is the date on which the warranty begins.

date

None.

WarrantyEndDate

This is the date on which the warranty ends.

date

None.

AssetPdPoNumber

This is the purchase order number of the asset.

string

None.

AssetPdPurchaseDate

This is the date on which the asset was purchased.

date

None.

AssetPdCost

This is the cost of the asset when it was purchased.

decimal number

None.

Latitude

This is the geographical latitude of the asset.

decimal number

None.

Longitude

This is the geographical longitude of the asset.

decimal number

None.

Altitude

This is the geographical altitude of the asset.

decimal number

None.

TimeUTC

The geographical timezone in UTC indicating where the asset is located.

date

None.

Accuracy

This indicates the accuracy with which the geolocation was captured.

decimal number

None.

CustomFields

This ia a list of custom fields associated with the asset.

Collection of DcfValueInfo

None.

AttachmentsToAdd

This is a list of attachment GUIDs to add to this asset. The attachment must exist in the system already and this just links the attachment with this asset.

Collection of string

None.

AttachmentsToDelete

This is a list of attachment GUIDs to remove from this asset.

Collection of string

None.

AttachmentNames

This is a list of attachments associated with the asset. This list is the GUID of the attachment and the file name of the attachment.

Collection of Pair of string [key] and string [value]

None.

AssetDueDate

Read Only. This indicates if the asset is checked out and has a due date.

date

None.

AssetCreatedDate

Read Only. This is the date the asset was created in our system.

date

None.

AssetLastUpdatedDate

Read Only. This is the date the asset was last updated in our system.

date

None.

Request Formats

application/json

Sample:
Attachments
[
  {
    "RowNumber": 0,
    "AssetTag": "01001-975D39FFE2044DFF9BDF551153AF512F",
    "AssetClassId": 0,
    "AssetTypeNumber": "Lenovo Thinkpad x230",
    "SiteName": "One-Building 0-975d39ffe2044dff9bdf551153af512f",
    "LocationCode": "B1.Floor1.Room3.0.975d39ffe2044dff9bdf551153af512f",
    "IsGroup": false,
    "TransactAsWhole": false,
    "AuditAsWhole": false,
    "AssetDefaultCost": 0.0,
    "AssetRecordStatus": 0,
    "HasAttachment": false,
    "AssetTransQuantity": 1.0,
    "WarrantyBeginDate": "2018-10-20T00:00:00"
  }
]



Response Information

Resource Description

WaspResultOfResults
NameDescriptionTypeAdditional information
Data

Type specific result that always depends on the function called.

Results

None.

Messages

List of Messages. All APIs should return messages. If an API function returns an error you can find more information about the error or errors in this collection of messages.

Collection of WtResult

None.

BatchNumber

This is a global batch number generated by a mass group of transaction records to be returned to the consumer on each call to rolling transaction rules. This requests that each group of Move/Add/Remove transaction batches is tied together. In prior products (such as Mobile Asset Cloud), all are set to null and the only time when the batch number is generated is for multiple check-out transactions but the old is to generate for each responsible party.

integer

None.

HasError

True if an API function result has an error message in the results. If this is false, the function succeeded but other informative messages may be available.

boolean

None.

HasHttpError

True if an API function call could not be fully posted to the server or the results could not be fully returned.

boolean

None.

HasMessage

True if any message is available.

boolean

None.

HasSuccessWithMoreDataRemaining

True if the server sent part of the data and there is more data available. Use with paging APIs to fetch data one page at a time.

boolean

None.

TotalRecordsLongCount

This is the total number of records available in the database based on the query and filer conditions provided. It is possible that the value can change from call to call as users add and delete records so this should not be used to page through multiple recordsets of data. This is used, for example, to set relative scroll bar sizes. When paging through data using functions like the assetadvancedinfosearch, calculating TotalRecordsLongCount for every page full of data is an time-consuming operation. To avoid that extra calculation, and help prevent throttling, assign TotalRecordsLongCount to TotalCountFromPriorFetch in the AdvancedSearchParameters to skip recalculating this total page count and to page thru the records faster.

integer

None.

Response Formats

application/json

Sample:
Attachments
{
  "Data": {
    "ResultList": [
      {
        "ResultCode": 0,
        "Message": "",
        "HttpStatusCode": 200
      }
    ],
    "SuccessfullResults": 1,
    "TotalResults": 1
  },
  "Messages": [
    {
      "ResultCode": 0,
      "Message": "Success.",
      "HttpStatusCode": 200,
      "FieldName": ""
    }
  ],
  "HasSuccessWithMoreDataRemaining": false,
  "HasError": false,
  "HasMessage": true,
  "HasHttpError": false
}