Create a draft fixed asset

Creates a DRAFT asset; nothing posts until fixedAsset.register. Use acquisition_type: opening_balance for an asset owned before the books start (registration posts Dr asset / Cr Opening Balance Equity; give opening_balance_date and opening_accumulated_depreciation on fixedAsset.registerPreview to bring it in at its book value when the books start), or other with acquisition_credit_account_id for a gift, contribution or transfer. Give the useful life one way: useful_life_years (whole years), useful_life_months (12 to 1200, e.g. 400 for 33 years 4 months) or rate_percent (a yearly straight-line rate that comes to whole months, e.g. 3 = 400 months); more than one, or a rate that is not whole months, is refused with invalid_useful_life. A purchase booked on a bill to the type's asset account already creates a draft: complete it with fixedAsset.update. Cost is in the base currency. Idempotency-Key is required. Requires the fixed-assets:write OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Fields accepted to create a draft fixed asset. The schema identifies required and optional values.

Create a DRAFT fixed asset. Nothing posts until fixedAsset.register.

opening_balance is an asset owned before the books start (registration
posts Dr asset / Cr Opening Balance Equity, and catch-up depreciation to
today against Opening Balance Equity); other is a gift, contribution or
transfer credited to acquisition_credit_account_id. A purchase booked on a
bill already creates a draft automatically (coded to the type's asset
account): complete that draft with fixedAsset.update instead.

uuid
required
string
required
length ≤ 255
string | null

Notes.

string | null

Serial number, VIN or registration plate.

string
enum
required
Allowed:
integer | null
≥ 1

Required for acquisition_type other: the account credited on registration.

date
required
date | null

Defaults to the purchase date.

number
required
0.01 to 999999999999

Cost in the base currency.

string | null

Must be the base currency when sent.

number | null
0 to 999999999999
integer | null
1 to 100

Straight-line useful life in whole years; defaults to the type's default. Ignored for a non-depreciable type. Send one of useful_life_years, useful_life_months and rate_percent.

integer | null
12 to 1200

A useful life that is not a whole number of years, in months (12 to 1200; 400 months = 33 years 4 months = 3% a year). Send one of useful_life_years, useful_life_months and rate_percent.

number | null

The useful life as a yearly straight-line rate, in percent of the cost less the residual value (3 = 400 months). It must come to a whole number of months: 7 would be 171.43 months, so send useful_life_months 171 instead. Stored as useful_life_months.

string
enum

Only straight_line is supported.

Allowed:
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*