Accounting

Fiscal years, the chart of accounts, and imported bank and tax account transactions.

Scope: accounting:read.

Fiscal years

GET /user-companies/{company_id}/fiscal-years

Lists the fiscal years configured for the company. Fiscal years are integers (1, 2, 3, …) and are required to scope the account and verification endpoints.

Chart of accounts

GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/accounts

The chart of accounts belongs to a fiscal year, so the same company can have a different chart in different years.

Response fields:

Field	Description
`chart_id`	Identifier of the chart.
`chart_name`	Name of the chart.
`fiscal_year`	The fiscal year the chart belongs to.
`accounts`	Array of account objects.
`total`	Number of accounts.

Each account object:

Field	Description
`account_number`	Account number, four digits in the Swedish BAS standard.
`account_name`	Account name.
`account_type`	See below.
`vat_code`	VAT code associated with the account.
`sru_codes`	SRU codes used for tax reporting.
`balance_time`	Balance timing for the account.

Account types, derived from the Swedish BAS standard:

asset, liability_equity, revenue, cost_of_goods, expense, personnel, financial, other.

Single account

GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/accounts/{account_number}

Returns chart_id, chart_name, fiscal_year and a single account object.

Bank accounts

Imported bank statement data, scoped to a fiscal year.

GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/bank-accounts
GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/bank-accounts/{account}
GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/bank-accounts/{account}/items

The items endpoint lists imported transactions and accepts:

Parameter	Description
`start-date`	`YYYY-MM-DD`. Note the hyphen.
`end-date`	`YYYY-MM-DD`. Note the hyphen.
`limit`	Maximum number of items.
`offset`	Offset into the result set.

Tax accounts

Imported Skatteverket tax account data, with the same shape as bank accounts.

GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/tax-accounts
GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/tax-accounts/{account}
GET /user-companies/{company_id}/fiscal-years/{fiscal_year}/tax-accounts/{account}/items

The items endpoint takes the same start-date, end-date, limit and offset parameters.

Note

These endpoints return what has been imported into Economydesk. They are not a live connection to the bank or to Skatteverket. If a statement has not been imported, its transactions are not here.