Module xero.assets
ballerinax/xero.assets Ballerina library
1.1.1
Overview
This is a generated connector for Xero Assets API v2.9.4 OpenAPI specification.
The Assets API exposes fixed asset related functions of the Xero Accounting application and can be used for a variety of purposes such as creating assets, retrieving asset valuations etc.
Clients
xero.assets: Client
Isolated
This is a generated connector for Xero Assets API v2.9.4 OpenAPI specification. The Assets API exposes fixed asset related functions of the Xero Accounting application and can be used for a variety of purposes such as creating assets, retrieving asset valuations etc.
Constructor
Gets invoked to initialize the connector.
The connector initialization requires setting the API credentials.
Create a Xero account and obtain tokens following this guide.
init (ClientConfig clientConfig, string serviceUrl)- clientConfig ClientConfig - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.xero.com/assets.xro/1.0" - URL of the target service
getAssetTypes
Isolated FunctionRemote Function
searches fixed asset types
Parameters
- xeroTenantId string - Xero identifier for Tenant
createAssetType
Isolated FunctionRemote Function
adds a fixed asset type
getAssets
Isolated FunctionRemote Function
function getAssets(string xeroTenantId, AssetStatusQueryParam status, int? page, int? pageSize, string? orderBy, string? sortDirection, string? filterBy) returns Assets|errorsearches fixed asset
Parameters
- xeroTenantId string - Xero identifier for Tenant
- status AssetStatusQueryParam - Required when retrieving a collection of assets. See Asset Status Codes
- page int? (default ()) - Results are paged. This specifies which page of the results to return. The default page is 1.
- pageSize int? (default ()) - The number of records returned per page. By default the number of records returned is 10.
- orderBy string? (default ()) - 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? (default ()) - ASC or DESC
- filterBy string? (default ()) - 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.
createAsset
Isolated FunctionRemote Function
adds a fixed asset
Parameters
- xeroTenantId string - Xero identifier for Tenant
- payload Asset - Fixed asset you are creating
getAssetById
Isolated FunctionRemote Function
Retrieves fixed asset by id
Parameters
- xeroTenantId string - Xero identifier for Tenant
- id string - fixed asset id for single object
getAssetSettings
Isolated FunctionRemote Function
searches fixed asset settings
Parameters
- xeroTenantId string - Xero identifier for Tenant
Records
xero.assets: Asset
Fields
- accountingBookValue float? - The accounting value of the asset
- assetId string? - The Xero-generated Id for the asset
- assetName string - The name of the asset
- assetNumber string? - Must be unique.
- assetStatus AssetStatus? - See Asset Status Codes.
- assetTypeId string? - The Xero-generated Id for the asset type
- bookDepreciationDetail BookDepreciationDetail? -
- bookDepreciationSetting BookDepreciationSetting? -
- canRollback boolean? - Boolean to indicate whether depreciation can be rolled back for this asset individually. This is true if it doesn't have 'legacy' journal entries and if there is no lock period that would prevent this asset from rolling back.
- disposalDate string? - The date the asset was disposed
- disposalPrice float? - The price the asset was disposed at
- isDeleteEnabledForDate boolean? - Boolean to indicate whether delete is enabled
- purchaseDate string? - The date the asset was purchased YYYY-MM-DD
- purchasePrice float? - The purchase price of the asset
- serialNumber string? - The asset's serial number
- warrantyExpiryDate string? - The date the asset’s warranty expires (if needed) YYYY-MM-DD
xero.assets: Assets
Fields
- items Asset[]? -
- pagination Pagination? -
xero.assets: AssetType
Fields
- accumulatedDepreciationAccountId string? - The account for accumulated depreciation of fixed assets of this type
- assetTypeId string? - Xero generated unique identifier for asset types
- assetTypeName string - The name of the asset type
- bookDepreciationSetting BookDepreciationSetting -
- depreciationExpenseAccountId string? - The expense account for the depreciation of fixed assets of this type
- fixedAssetAccountId string? - The asset account for fixed assets of this type
- locks int? - All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed.
xero.assets: BookDepreciationDetail
Fields
- costLimit float? - The value of the asset you want to depreciate, if this is less than the cost of the asset.
- currentAccumDepreciationAmount float? - All depreciation occurring in the current financial year.
- currentCapitalGain float? - When an asset is disposed, this will be the sell price minus the purchase price if a profit was made.
- currentGainLoss float? - When an asset is disposed, this will be the lowest one of sell price or purchase price, minus the current book value.
- depreciationStartDate string? - YYYY-MM-DD
- priorAccumDepreciationAmount float? - All depreciation prior to the current financial year.
- residualValue float? - The value of the asset remaining when you've fully depreciated it.
xero.assets: BookDepreciationSetting
Fields
- averagingMethod string? - The method of averaging applied to this asset. See Averaging Methods
- bookEffectiveDateOfChangeId string? - Unique Xero identifier for the effective date change
- depreciableObjectId string? - Unique Xero identifier for the depreciable object
- depreciableObjectType string? - The type of asset object
- depreciationCalculationMethod string? - See Depreciation Calculation Methods
- depreciationMethod string? - The method of depreciation applied to this asset. See Depreciation Methods
- depreciationRate float? - The rate of depreciation (e.g. 0.05)
- effectiveLifeYears int? - Effective life of the asset in years (e.g. 5)
xero.assets: ClientConfig
Closed record
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- auth BearerTokenConfig|OAuth2RefreshTokenGrantConfig - Configurations related to client authentication
- httpVersion string(default "1.1") - The HTTP version understood by the client
- http1Settings ClientHttp1Settings(default {}) - Configurations related to HTTP/1.x protocol
- http2Settings ClientHttp2Settings(default {}) - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded/x-forwardedheader
- followRedirects FollowRedirects?(default ()) - Configurations associated with Redirection
- poolConfig PoolConfiguration?(default ()) - Configurations associated with request pooling
- cache CacheConfig(default {}) - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding) header
- circuitBreaker CircuitBreakerConfig?(default ()) - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig RetryConfig?(default ()) - Configurations associated with retrying
- responseLimits ResponseLimitConfigs(default {}) - Configurations associated with inbound response size limits
- secureSocket ClientSecureSocket?(default ()) - SSL/TLS-related options
xero.assets: Error
Fields
- detail string? - Detail of the error
- fieldValidationErrors FieldValidationErrorsElement[]? - Array of elements of field validation errors
- resourceValidationErrors ResourceValidationErrorsElement[]? - Array of elements of resource validation errors
- title string? - Title of the error
- 'type string? - The internal type of error, not accessible externally
xero.assets: FieldValidationErrorsElement
Fields
- detail string? - Detail of the field validation error
- fieldName string? - The field name of the erroneous field
- localisedMessage string? - Explanation of the field validation error
- title string? - Title of the field validation error
- 'type string? - Internal type of the field validation error message
- valueProvided string? - The provided value
xero.assets: Pagination
Fields
- itemCount int? -
- page int? -
- pageCount int? -
- pageSize int? -
xero.assets: ResourceValidationErrorsElement
Fields
- detail string? - Detail of the resource validation error
- localisedMessage string? - Explanation of the resource validation error
- resourceName string? - The field name of the erroneous field
- title string? - Title of the resource validation error
- 'type string? - Internal type of the resource error message
xero.assets: Setting
Fields
- assetNumberPrefix string? - The prefix used for fixed asset numbers (“FA-” by default)
- assetNumberSequence string? - The next available sequence number
- assetStartDate string? - The date depreciation calculations started on registered fixed assets in Xero
- defaultCapitalGainOnDisposalAccountId string? - Default account that capital gains are posted to
- defaultGainOnDisposalAccountId string? - Default account that gains are posted to
- defaultLossOnDisposalAccountId string? - Default account that losses are posted to
- lastDepreciationDate string? - The last depreciation date
- optInForTax boolean? - opt in for tax calculation