Update Asset

Owned by Enterprise IT
May 10, 2024

You can update an existing Asset Request using the following API Request with Asset Master parameters.. 

To authenticate the below API, see API Authentication and Authorization.

Service NameHTTP Method

AM_UpdateAsset_Details (Denali SP1 HF06, SIERRA SP1 HF20, DENALI HF13, DENALI SP1 HF13, DENALI SP3 HF08 onwards)

AM_UpdateAsset

POST

Notes:

  • To access AM_UpdateAsset_Details (Json format), refer the URL: <customer domain name>REST/Summit_RESTWCF.svc/RESTService/CommonWS_JsonObjCall_json.
  • To access AM_UpdateAsset (String format), refer the URL: <customer domain name>REST/Summit_RESTWCF.svc/RESTService/AM_UpdateAsset. 
  • At UI configuration level, if the attribute is configured as mandatory then the Attribute Name and Attribute Value fields should be mandatory.

Sample Request

Json Format
}
 "ServiceName": "AM_UpdateAsset_Details",
 "objCommonParameters": {
 "_ProxyDetails": {
 "ProxyID": 0,
 "ReturnType": "JSON",
 "APIKey": "VCzYxzanmTiGn5Ry9i6rPgsUgn9IBEtXJqnw0S380FQ=",
 "AuthType": "APIKEY"
 },
 "oAM_Asset_MasterParam": {
 "_Instance": "IT",
 "_Category_ID": "Laptop",
 "_Asset_ID": "101"
 },
 "oAM_Asset_DetailsParam_items": {
 "items": [
 {
 "_Attribute_Name": "Fix Asset ID",
 "_Attribute_Value": "234244"
 },
 {
 "_Attribute_Name": "Warranty/AMC Start Date",
 "_Attribute_Value": "2021-06-01"
 },
 {
 "_Attribute_Name": "Warranty/AMC End Date",
 "_Attribute_Value": "2023-06-01"
 },
 {
 "_Attribute_Name": "Date of Purchase",
 "_Attribute_Value": "2023-06-01"
 },
 {
 "_Attribute_Name": "PO Number",
 "_Attribute_Value": "29898/987"
 },
 {
 "_Attribute_Name": "PO Date",
 "_Attribute_Value": "2021-06-01"
 },
 {
 "_Attribute_Name": "Asset Value",
 "_Attribute_Value": "1000"
 },
 {
 "_Attribute_Name": "Depreciation Amount",
 "_Attribute_Value": "10000"
 },
 {
 "_Attribute_Name": "Invoice Number",
 "_Attribute_Value": "187687"
 },
 {
 "_Attribute_Name": "Invoice date",
 "_Attribute_Value": "2021-05-01"
 },
 {
 "_Attribute_Name": "SAP GRN Number",
 "_Attribute_Value": "123123"
 },
 {
 "_Attribute_Name": "SAP GRN Date",
 "_Attribute_Value": "2021-05-01"
 },
 {
 "_Attribute_Name": "CAPEX Number",
 "_Attribute_Value": "123123"
 },
 {
 "_Attribute_Name": "CAPEX Date",
 "_Attribute_Value": "2021-05-01"
 },
 {
 "_Attribute_Name": "LifeTime of asset",
 "_Attribute_Value": "5"
 }
 ],
 "hasMore": true
 },
 "oAM_Asset_Allocation": {
 "_ReAllocate": "false"
 }
 }
}

Request Parameters

Parameter NameTypeDescriptionMandatory

_Instance

STRING

Name of the Instance.

For Example: IT

TRUE

_Category_ID

STRING

The category name of an asset.

TRUE

_Asset_ID

STRING

Unique identification number of an Asset.

TRUE

Items

STRING

The list of asset attributes.

TRUE

_Attribute_Name

STRING

Asset attribute name.

FALSE

_Attribute_Value

STRING

Asset attribute value.

FALSE

hasMore

STRING

By default, the value is true.

TRUE

oAM_Asset_Allocation

STRING

The Fixed Assets that are available for allocation and allocate them to users.

TRUE

_ReAllocate

BOOLEAN

Re-allocate of fixed assets to another user.

  • True - Re-allocate to another user.
  • False - Cannot re-allocate to another user.

TRUE


Sample Response
{
 "Errors": "",
 "Input": null,
 "Message": "",
 "OrgID": 0,
 "Output": "Successfully updated the asset details.",
 "OutputID": 0,
 "OutputObject": null,
 "TokenID": "C2A3011862474E06C238E86CC460BE1166D50A62CDAC2D2887BF79D9360B622E0479BE62D264F0
7FBA6BBA4640683A0025D115BE826D3AA7F27432FFD1DCEF42AC842A7AC8679E2AF80A67E06EC813E2C9A5C938D654
C51EB94D12D7B10626C8C28FD9BDE2408E67E9BE76C9FDD35B63D69B0E47A08E7B91B9D36B6EC107F817F2BC1EA670
8C16844BD38C7836EDCFA5D58C2909A0DB8012D700867D2B4AE1CCA067F368"
}

Sample Request

String Format
{
"_ProxyDetails": {
 "ProxyID": 0,
 "ReturnType": "JSON",
 "APIKey": "fVDxr5l/mZqmcdPOeGY4EQue7bCQjIth0jOiOMBu/mY=",
 "AuthType": "APIKEY"
 },
"oAM_Asset_MasterParam":{"_Instance":"IT","_Category_ID":"Laptop","_Stores":"India\\Bangalore\\M
ylasandra\\Mylasandra Store","_Asset_ID":"4"},
"oAM_Asset_DetailsParam {
 "_Attribute_Name": "Bond No.",
 "_Attribute_Value": "100/2015-16"
 },
 {
 "_Attribute_Name": "GRN no.",
 "_Attribute_Value": "GRN-305"
 }
 ],"oAM_Asset_Allocation":{"_ReAllocate":"false”}
}  

Request Parameters

Parameter NameTypeDescriptionMandatory

_Instance

STRING

Name of the Instance.

For Example: IT

TRUE

_Category_ID

STRING

The category name of an asset.

TRUE

_Asset_ID

STRING

Unique identification number of an Asset.

TRUE

_Attribute_Name

STRING

Asset attribute name.

FALSE

_Attribute_Value

STRING

Asset attribute value.

FALSE

oAM_Asset_Allocation

STRING

The Fixed Assets that are available for allocation and allocate them to users.

TRUE

_ReAllocate

BOOLEAN

Re-allocate of fixed assets to another user.

  • True - Re-allocate to another user.
  • False - Cannot re-allocate to another user.

TRUE

Sample Request
 "{\"Errors\":\"\",\"Message\":\"\",\"OrgID\":0,\"Output\":\"Successfully updated the asset 
details.\",\"OutputObject\":null,\"TokenID\":null}" }

Status and Error Codes

For more information, see: Status and Error Messages.