Classification depreciation rules

Depreciation rules contain information about the depreciation method, convention, and useful life for an asset. Depreciation rules in a classification serve as a standard default for how assets in that classification are treated. However, you can override the depreciation rules at the asset level.

List classification depreciation rules

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

Returns a collection with a key, ID, and link for each classification 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": [
    • {
      • "key": "81",
      • "id": "81",
      • "href": "objects/fixed-assets/classification-depreciation-rule/81"
      },
    • {
      • "key": "82",
      • "id": "82",
      • "href": "objects/fixed-assets/classification-depreciation-rule/82"
      },
    • {
      • "key": "83",
      • "id": "83",
      • "href": "objects/fixed-assets/classification-depreciation-rule/83"
      }
    ],
  • "ia::meta": {
    • "totalCount": 3,
    • "totalSuccess": 3,
    • "totalError": 0
    }
}
Create a classification depreciation rule
post/objects/fixed-assets/classification-depreciation-rule
Creates a new classification depreciation rule.


SecurityOAuth2 
Request 
Request Body schema: application/json
required
Creates a classification depreciation rule


key
string
System-assigned unique key for the classification depreciation rule.


 
 Example:  "6"
usefulLife
integer
Specify a value for the useful life, which is either in months or years as established by the usefulLifeUnits field in the posting rule. The value must not exceed 500 if usefulLifeUnits is set to months, and must not exceed 100 if usefulLifeUnits is set to years.


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


 
key
string
System-assigned key for the posting rule.


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


 
 Example:  "ID2"
object
Asset classification associated with this depreciation rule.


 
key
string
Classification key


 
 Example:  "3"
id
string
Unique ID for the classification.


 
 Example:  "CE-1"
object
Depreciation method.


 
key
string
System-assigned key for the depreciation method.


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


 
 Example:  "SL01"
name
string
Depreciation method name


 
 Example:  "Straight line"
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"
Responses 
201
Created


400
Bad Request


Request samples 
application/json
{
  • "id": "818",
  • "journal": {
    • "key": "45"
    },
  • "depreciationMethod": {
    • "key": "-1"
    },
  • "classification": {
    • "key": "100"
    },
  • "usefulLife": 60
}
Response samples 
application/json
{
  • "ia::result": {
    • "key": "818",
    • "id": "818",
    • "href": "/objects/fixed-assets/classification-depreciation-rule/818"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Get a classification depreciation rule
get/objects/fixed-assets/classification-depreciation-rule/{key}
Returns detailed information for a specified classification depreciation rule.


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the classification 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"
      },
    • "journal": {
      • "id": "GAAP",
      • "title": "GAAP Accrual Book",
      • "key": "45"
      },
    • "classification": {
      • "id": "Classification Id 100",
      • "key": "100"
      },
    • "id": "818",
    • "key": "818",
    • "usefulLife": 60
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}
Update a classification depreciation rule
patch/objects/fixed-assets/classification-depreciation-rule/{key}
Updates an existing classification depreciation rule by setting field values. Any fields not provided remain unchanged.


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


 
 Example:  99
Request Body schema: application/json
usefulLife
integer
Specify a value for the useful life, which is either in months or years as established by the usefulLifeUnits field in the posting rule. The value must not exceed 500 if usefulLifeUnits is set to months, and must not exceed 100 if usefulLifeUnits is set to years.


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


 
key
string
System-assigned key for the posting rule.


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


 
 Example:  "ID2"
object
Asset classification associated with this depreciation rule.


 
key
string
Classification key


 
 Example:  "3"
id
string
Unique ID for the classification.


 
 Example:  "CE-1"
object
Depreciation method.


 
key
string
System-assigned key for the depreciation method.


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


 
 Example:  "SL01"
name
string
Depreciation method name


 
 Example:  "Straight line"
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"
Responses 
200
OK


400
Bad Request


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


SecurityOAuth2 
Request 
path Parameters
key
required
string
System-assigned key for the classification 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
    }
}