Asset depreciation rules

Depreciation rules contain information about the depreciation method, convention, and useful life for an asset, which are used to calculate depreciation for an asset.

When you assign a classification to an asset, the classification's depreciation rules are copied over to the asset. You can then create, update, or delete the depreciation rules on the asset to customize them as needed.

List asset depreciation rules

get/objects/fixed-assets/asset-depreciation-rule

Returns a collection with a key, ID, and link for each asset depreciation rule. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples 
Response samples 
application/json
{
  • "ia::result": [
    • {
      • "id": "80",
      • "key": "80",
      • "href": "/objects/fixed-assets/asset-depreciation-rule/80"
      },
    • {
      • "id": "81",
      • "key": "81",
      • "href": "/objects/fixed-assets/asset-depreciation-rule/81"
      },
    • {
      • "id": "82",
      • "key": "82",
      • "href": "/objects/fixed-assets/asset-depreciation-rule/82"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "totalSuccess": 3,
    • "totalError": 0
    }
}
Create an asset depreciation rule
post/objects/fixed-assets/asset-depreciation-rule
Creates a new asset depreciation rule.


SecurityOAuth2 
Request 
Request Body schema: application/json
required
key
string
System-assigned unique key for the asset depreciation rule.


 
 Example:  "9"
usefulLife
integer
An estimate of the expected service life of an asset. Specify a useful life in months or years as determined by the posting rule configuration. The value must not exceed 500 if usefulLifeUnits is set to months, and must not exceed 100 if usefulLifeUnits is set to years.


 
 Example:  60
object
Posting rules determines which journals the Fixed Assets Management application can post to and how.


 
key
string
System-assigned unique key for the posting rule.


 
 Example:  "2"
id
string
Unique ID for the posting rule.


 
 Example:  "ID2"
object
Depreciation method for the asset depreciation rule.


 
key
string
System-assigned unique key for the depreciation method.


 
 Example:  "-1"
id
string
Unique ID for the depreciation method.


 
 Example:  "SL"
depreciationRate
string
Rate used to calculate depreciation amount. For example, a value of 30.00 applies a rate of 30.00%. The value must be between 1.00 and 100.00.


 
 Example:  "30.00"
historicalAccumulatedDepreciationAmount
string <decimal-precision-2> 
User provided historical accumulated depreciation amount for the asset depreciation rule.


 
 Example:  "1000.00"
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "key": "2",
  • "id": "2",
  • "depreciationMethod": {
    • "name": "Straight line",
    • "id": "SL",
    • "key": "-1"
    },
  • "postingRule": {
    • "key": "1",
    • "id": "1"
    },
  • "asset": {
    • "key": "2",
    • "id": "CE_ASSET-1"
    },
  • "usefulLife": 5
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "871",
    • "id": "871",
    • "href": "/objects/fixed-assets/asset-depreciation-rule/871"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get an asset depreciation rule
get/objects/fixed-assets/asset-depreciation-rule/{key}
Returns detailed information for a specified asset depreciation rule.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the asset depreciation rule.


 
 Example:  99
Responses 
200
OK


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "depreciationMethod": {
      • "name": "Straight line",
      • "id": "SL",
      • "key": "-1"
      },
    • "asset": {
      • "name": "Asset Name _~!@#$%^*()_+=-`1682315965",
      • "id": "Asset Id 1682315965",
      • "key": "860"
      },
    • "depreciationSchedule": {
      • "key": "387"
      },
    • "postingRule": {
      • "name": "NAME 1",
      • "id": "ID1",
      • "key": "1"
      },
    • "audit": {
      • "createdBy": "1",
      • "createdDateTime": "2023-04-24T05:59:27Z",
      • "modifiedBy": "1",
      • "modifiedDateTime": "2023-04-24T05:59:27Z",
      • "createdByUser": {
        },
      • "modifiedByUser": {
        }
      },
    • "id": "1009",
    • "key": "1009",
    • "historicalAccumulatedDepreciationAmount": "100.00",
    • "usefulLife": 5
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update an asset depreciation rule
patch/objects/fixed-assets/asset-depreciation-rule/{key}
Updates an existing asset depreciation rule by setting field values. Any fields not provided remain unchanged.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the asset depreciation rule.


 
 Example:  99
Request Body schema: application/json
Responses 
200
OK


400
Bad Request


Request samples 
application/json
{
  • "depreciationMethod": {
    • "id": "DB",
    • "key": "-2"
    }
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "1021",
    • "id": "1021",
    • "href": "/objects/fixed-assets/asset-depreciation-rule/1021"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Delete an asset depreciation rule
delete/objects/fixed-assets/asset-depreciation-rule/{key}
Deletes an asset depreciation rule.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the asset depreciation rule.


 
 Example:  99
Responses 
204
No Content


400
Bad Request


Request samples 
Response samples 
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}