Skip to main content
PUT
Update amortizable asset
Send the full asset: a field you leave out takes its default. DualEntry rebuilds the amortization schedule from the values you send. Side effects
  • DualEntry generates one amortization for each period of the schedule and replaces the amortizations of a previous save.
  • If the asset is posted, DualEntry posts every amortization dated today or earlier to the general ledger.
  • If an approval workflow holds the asset, DualEntry keeps the amortizations in draft until an approver approves the asset.

Authorizations

X-API-KEY
string
header
required

Headers

Idempotency-Key
string

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Maximum string length: 255

Path Parameters

record_number
integer
required

Body

application/json
company_id
integer
required
name
string
required
Maximum string length: 512
currency_iso_4217_code
enum<string>
required
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
YER,
ZAR,
ZMW,
ZWL
memo
string
required
Maximum string length: 512
amount
required
exchange_rate
required
useful_life
integer
required
amortization_method
enum<string>
required
Available options:
straight_line,
curve
accumulated_beginning_balance
required
accumulated_through
string<date> | null
required
amortization_start_date
string<date>
required
asset_account_id
integer
required
amortization_debit_account_id
integer
required
amortization_credit_account_id
integer
required
status
enum<string>
required
Available options:
active,
inactive,
disposed,
fully_amortized
asset_category
enum<string>
default:prepaid
Available options:
prepaid,
intangible
intangible_class_id
integer | null
acquisition_source
enum<string> | null
Available options:
acquired_separately,
internally_developed,
business_combination
acquisition_date
string<date> | null
reference
string
default:""
Maximum string length: 255
residual_value
default:0.00
Required range: x >= 0
curve
(number | string)[]
vendor_id
integer | null
customer_id
integer | null
attachments
AttachmentSchemaOut · object[]
classifications
RecordClassificationsSchemaOut · object[]
record_status
enum<string> | null
Available options:
draft,
posted,
archived
source_lines
AmortizableAssetSourceIn · object[]
book_ids
integer[] | null

Select accounting Book IDs. Omit this field on update to preserve assignments. Use null or an empty list to select all active Books. For records controlled by the organization setting, disabled selection makes creates use all active Books and rejects changed non-empty updates. Journal Entries are exempt.

Response

OK

created_at
string<date-time>
required

Date and time the record was created

updated_at
string<date-time>
required

Date and time the record was last updated

internal_id
integer
required
number
integer
required
company_id
integer
required
company_name
string
required
name
string
required
currency_iso_4217_code
enum<string>
required
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYU,
UZS,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
YER,
ZAR,
ZMW,
ZWL
memo
string
required
amount
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
exchange_rate
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,16}0*$
useful_life
integer
required
amortization_method
enum<string>
required
Available options:
straight_line,
curve
accumulated_beginning_balance
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$
amortization_start_date
string<date>
required
asset_account_id
integer
required
amortization_debit_account_id
integer
required
amortization_credit_account_id
integer
required
status
enum<string>
required
Available options:
active,
inactive,
disposed,
fully_amortized
record_status
enum<string>
required
Available options:
draft,
posted,
archived
book_ids
integer[]
required
attachments
PublicAttachmentSchemaOut · object[]
approval_status
string | null
next_approvers
ApproverDictSchema · object[] | null
rejected_by
RejectedBySchema · object | null

Schema for rejector information including rejection reason.

code
string | null
accumulated_through
string<date> | null
vendor_id
integer | null
vendor_name
string | null
customer_id
integer | null
customer_name
string | null
pending_terminate_from
string<date> | null
classifications
RecordClassificationsSchemaOut · object[]
source_lines
AmortizableAssetSourceOut · object[]
created_by
AuditActorSchemaOut · object | null

Schema for audit actor information.

updated_by
AuditActorSchemaOut · object | null

Schema for audit actor information.

amortizations
PublicAmortizationListSchemaOut · object[]