Xero Assets API

Asset

createAsset

adds a fixed asset

Adds an asset to the system


/Assets

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';
        String idempotencyKey = 'KEY_VALUE';
        
        Asset asset = new Asset();
        asset.setassetName("Other Computer");
        asset.setassetNumber("FA-00210");
        asset.setStatus(com.xero.models.assets.AssetStatus.DRAFT);

        try {
            Asset result = apiInstance.createAsset(accessToken, xeroTenantId, asset, idempotencyKey);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#createAsset");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets

Parameters

Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required
Idempotency-Key
String
This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
Body parameters
Name Description
asset *
Asset
Fixed asset you are creating
Required

createAssetType

adds a fixed asset type

Adds an fixed asset type to the system


/AssetTypes

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';
        String idempotencyKey = 'KEY_VALUE';
        
        BookDepreciationSetting bookDepreciationSetting = new BookDepreciationSetting();
        bookDepreciationSetting.setDepreciationMethod("DiminishingValue100");
        bookDepreciationSetting.setAveragingMethod("ActualDays");
        bookDepreciationSetting.setDepreciationRate(40);
        bookDepreciationSetting.setDepreciationCalculationMethod("None");
        
        AssetType assetType = new AssetType();
        assetType.setAssetTypeName("Computer Equipment");
        assetType.setFixedAssetAccountId(UUID.fromString("00000000-0000-0000-0000-000000000000"));
        assetType.setDepreciationExpenseAccountId(UUID.fromString("00000000-0000-0000-0000-000000000000"));
        assetType.setAccumulatedDepreciationAccountId(UUID.fromString("00000000-0000-0000-0000-000000000000"));
        assetType.setBookDepreciationSetting(bookDepreciationSetting);

        try {
            AssetType result = apiInstance.createAssetType(accessToken, xeroTenantId, assetType, idempotencyKey);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#createAssetType");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets

Parameters

Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required
Idempotency-Key
String
This allows you to safely retry requests without the risk of duplicate processing. 128 character max.
Body parameters
Name Description
assetType *
AssetType
Asset type to add
Required

getAssetById

Retrieves fixed asset by id

By passing in the appropriate asset id, you can search for a specific fixed asset in the system


/Assets/{id}

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';
        UUID id = UUID.fromString("00000000-0000-0000-0000-000000000000");
        UUID id = '00000000-0000-0000-0000-000000000000';

        try {
            Asset result = apiInstance.getAssetById(accessToken, xeroTenantId, id);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#getAssetById");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets
assets.read Grant read-only access to fixed assets

Parameters

Path parameters
Name Description
id*
UUID (uuid)
fixed asset id for single object
Required
Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required

getAssetSettings

searches fixed asset settings

By passing in the appropriate options, you can search for available fixed asset types in the system


/Settings

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';

        try {
            Setting result = apiInstance.getAssetSettings(accessToken, xeroTenantId);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#getAssetSettings");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets
assets.read Grant read-only access to fixed assets

Parameters

Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required

getAssetTypes

searches fixed asset types

By passing in the appropriate options, you can search for available fixed asset types in the system


/AssetTypes

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';

        try {
            array[AssetType] result = apiInstance.getAssetTypes(accessToken, xeroTenantId);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#getAssetTypes");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets
assets.read Grant read-only access to fixed assets

Parameters

Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required

getAssets

searches fixed asset

By passing in the appropriate options, you can search for available fixed asset in the system


/Assets

Usage and SDK Samples

import org.openapitools.client.api.*;
import org.openapitools.client.api.client.AssetApi;
import org.openapitools.client.models.asset.*;

import java.io.File;
import java.util.*;

public class AssetApiExample {
    private AssetApi apiInstance;
    
    public static void main(String[] args) {
        String accessToken = "YOUR_ACCESS_TOKEN";
        ApiClient defaultClient = new ApiClient();

        apiInstance = AccountingApi.getInstance(defaultClient);
        String xeroTenantId = 'YOUR_XERO_TENANT_ID';
        AssetStatusQueryParam status = ;
        Integer page = 1;
        Integer pageSize = 5;
        String orderBy = 'AssetName';
        String sortDirection = 'ASC';
        String filterBy = 'Company Car';

        try {
            Assets result = apiInstance.getAssets(accessToken, xeroTenantId, status, page, pageSize, orderBy, sortDirection, filterBy);
            System.out.println(result);
        } catch (XeroException e) {
            System.err.println("Exception when calling AssetApi#getAssets");
            e.printStackTrace();
        }
    }
}

Scopes

assets Grant read-write access to fixed assets
assets.read Grant read-only access to fixed assets

Parameters

Header parameters
Name Description
xero-tenant-id*
String
Xero identifier for Tenant
Required
Query parameters
Name Description
status*
AssetStatusQueryParam
Required when retrieving a collection of assets. See Asset Status Codes
Required
page
Integer
Results are paged. This specifies which page of the results to return. The default page is 1.
pageSize
Integer
The number of records returned per page. By default the number of records returned is 10.
orderBy
String
Requests can be ordered by AssetType, AssetName, AssetNumber, PurchaseDate and PurchasePrice. If the asset status is DISPOSED it also allows DisposalDate and DisposalPrice.
sortDirection
String
ASC or DESC
filterBy
String
A string that can be used to filter the list to only return assets containing the text. Checks it against the AssetName, AssetNumber, Description and AssetTypeName fields.