Chart of Accounts

Add an account to the chart of accounts

Adds a custom account to the profile's Kontenplan, e.g. a liability account the default chart lacks (2270 Geschuldete Sozialversicherungen). The 4-digit code must match the type per Swiss Kontenrahmen KMU: 1xxx ASSET, 2000-2799 LIABILITY, 2800-2999 EQUITY, 3xxx REVENUE, 4xxx-7xxx EXPENSE. Codes are unique per profile. Permission bookkeeping.create; needs a read-write key.

post/chart-accounts

Request

  • Base URL: https://api.lumabill.ch/v1
  • URL: https://api.lumabill.ch/v1/chart-accounts
  • Auth: HTTP bearer

Request body

codestring required

4-digit account code; the range must match type

namestring required
type'ASSET' | 'LIABILITY' | 'EQUITY' | 'REVENUE' | 'EXPENSE' required
parentCodestring nullable

Parent account code for grouping

currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF'

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

Example request

{
  "code": "2270",
  "name": "Geschuldete Sozialversicherungen",
  "parentCode": "2200",
  "currency": "CHF"
}

Response

Account created

idstring uuid required
codestring required

Swiss chart of accounts (Kontenplan KMU) account number

namestring required
type'ASSET' | 'LIABILITY' | 'EQUITY' | 'REVENUE' | 'EXPENSE' required
parentCodestring nullable
isSystemboolean
isActiveboolean
currency'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF'

ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.

createdAtstring date-time
balancenumber double nullable

Only present when includeBalances=true (CHF)

fwBalancenumber double nullable

FW accounts with includeBalances=true only: the saldo in the account currency, over the requested fiscalYearId, else as of today over the fiscal year covering today (null when no year covers today).

carryForwardMissingboolean

FW accounts with includeBalances=true only: true when the previous fiscal year is still open, so the year holds no Saldovortrag and balance / fwBalance show only this year's movements.

Example response

{
  "code": "6940",
  "name": "Bankspesen",
  "currency": "CHF"
}

Changes

No recorded changes to this operation across all 1 revision of this API.