Xero: adds a fixed asset type

← Assets operations · Get started

Operation xero.assets_createassettype

Provider route: POST /assets.xro/1.0/AssetTypes. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/xero with npm, or alter-sdk-xero with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { XeroIntegration } from "@alter-ai/xero";

async function execute(input: Parameters<XeroIntegration["assets"]["createAssetType"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new XeroIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.assets.createAssetType(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_xero import XeroIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = XeroIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.assets.create_asset_type(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
headers	object	Required within parent	Additional keys: not allowed
headers.xero-tenant-id	string	Required within parent
headers.Idempotency-Key	string	Optional
body	Model	Required within parent	Expand adds a fixed asset type — request body — body

Referenced models: adds a fixed asset type — request body — body

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand adds a fixed asset type — response body

Referenced models: adds a fixed asset type — response body

Schemas

adds a fixed asset type — request body — body

Field	Type	Presence	Description and constraints
$	object	Root
accumulatedDepreciationAccountId	string	Optional	The account for accumulated depreciation of fixed assets of this type Format: uuid
assetTypeId	string	Optional	Xero generated unique identifier for asset types Format: uuid
assetTypeName	string	Required within parent	The name of the asset type
bookDepreciationSetting	Model	Required within parent	Expand adds a fixed asset — request body — body book Depreciation Setting
depreciationExpenseAccountId	string	Optional	The expense account for the depreciation of fixed assets of this type Format: uuid
fixedAssetAccountId	string	Optional	The asset account for fixed assets of this type Format: uuid
locks	integer	Optional	All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed.

Referenced models: adds a fixed asset — request body — body book Depreciation Setting

adds a fixed asset type — response body

Field	Type	Presence	Description and constraints
$	object	Root
accumulatedDepreciationAccountId	string	Optional	The account for accumulated depreciation of fixed assets of this type Format: uuid
assetTypeId	string	Optional	Xero generated unique identifier for asset types Format: uuid
assetTypeName	string	Required within parent	The name of the asset type
bookDepreciationSetting	Model	Required within parent	Expand adds a fixed asset — response body — book Depreciation Setting
depreciationExpenseAccountId	string	Optional	The expense account for the depreciation of fixed assets of this type Format: uuid
fixedAssetAccountId	string	Optional	The asset account for fixed assets of this type Format: uuid
locks	JSON	Optional
locks (anyOf 1)	integer	Alternative	All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed.
locks (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: adds a fixed asset — response body — book Depreciation Setting

adds a fixed asset — request body — body book Depreciation Setting

Field	Type	Presence	Description and constraints
$	JSON	Root
averagingMethod	string	Optional	The method of averaging applied to this asset. See Averaging Methods One of: FullMonth, ActualDays
bookEffectiveDateOfChangeId	string	Optional	Unique Xero identifier for the effective date change Format: uuid
depreciableObjectId	string	Optional	Unique Xero identifier for the depreciable object Format: uuid
depreciableObjectType	string	Optional	The type of asset object
depreciationCalculationMethod	string	Optional	See Depreciation Calculation Methods One of: Rate, Life, None
depreciationMethod	string	Optional	The method of depreciation applied to this asset. See Depreciation Methods One of: NoDepreciation, StraightLine, DiminishingValue100, DiminishingValue150, DiminishingValue200, FullDepreciation
depreciationRate	number	Optional	The rate of depreciation (e.g. 0.05) Format: double
effectiveLifeYears	integer	Optional	Effective life of the asset in years (e.g. 5)

adds a fixed asset — response body — book Depreciation Setting

Field	Type	Presence	Description and constraints
$	JSON	Root
averagingMethod	string	Optional	The method of averaging applied to this asset. See Averaging Methods Known values: FullMonth, ActualDays
bookEffectiveDateOfChangeId	string	Optional	Unique Xero identifier for the effective date change Format: uuid
depreciableObjectId	string	Optional	Unique Xero identifier for the depreciable object Format: uuid
depreciableObjectType	string	Optional	The type of asset object
depreciationCalculationMethod	string	Optional	See Depreciation Calculation Methods Known values: Rate, Life, None
depreciationMethod	string	Optional	The method of depreciation applied to this asset. See Depreciation Methods Known values: NoDepreciation, StraightLine, DiminishingValue100, DiminishingValue150, DiminishingValue200, FullDepreciation
depreciationRate	JSON	Optional
depreciationRate (anyOf 1)	number	Alternative	The rate of depreciation (e.g. 0.05) Format: double
depreciationRate (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
effectiveLifeYears	JSON	Optional
effectiveLifeYears (anyOf 1)	integer	Alternative	Effective life of the asset in years (e.g. 5)
effectiveLifeYears (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Policy, approvals and errors

SDK function policy ID: xero.assets_createassettype. Catalog operation: assets.createAssetType. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Official provider source