FinanceControlAccountsInput Input Object
Chooses the general ledger accounts that hold money owed to someone else. Every id must be an active, undeleted account of type otherCurrentLiability in this workspace; anything else is rejected. The same check runs when a document posts, so an account archived or reclassified after it was chosen stops resolving and the document refuses rather than posting into a dead account.
Each field is independent: omit one to leave the stored choice untouched, or pass null to clear it. Clearing every field is a valid configuration — the workspace has decided it uses none, and finance setup will not propose accounts over that decision. Passing null for the whole object is that same decision in one field: it clears every choice.
An empty string is not a way to clear a choice — it is rejected as an ineligible account.
Fields
#
accountsPayableAccountId
Credited for native vendor obligations without a document-specific payable account.
accountsReceivableAccountId
Debited for what a customer owes when an invoice posts, credited as it is settled. Required before posting native receivables.
customerDepositLiabilityAccountId
Credited when cash arrives before it is applied to an invoice. Unset leaves unapplied cash in accounts receivable.
prebilledCostLiabilityAccountId
Holds the cost of purchase order lines billed to a client before the vendor invoiced them, until that order posts its bill. Required to post an invoice that bills any.
retainerLiabilityAccountId
Debited as a retainer is drawn down, credited when it is funded. Required to fund a retainer.
revenueAccountId
Credited for the revenue an invoice earns, where no item, service or source names a more specific account. Required when no document account assigns the revenue.
salesTaxLiabilityAccountId
Credited for the tax portion of an invoice or credit memo. Required to post any document that charges tax.
FinanceControlAccounts