Sign in

v1

latestOpenAPI 3.1.02026-07-22733584.5 KB
Company

Update company accounting settings (admin/approver only)

Changes the fiscal year start month and/or VAT period length. Requires an interactive admin/approver session — NOT available to API keys (even write-scoped ones), which receive 403. vat_period_valid_from must be a period-aligned YYYY-MM-DD date.

post/company/settings

Request body

customer_idstring

Target company. Optional for single-company sessions.

fiscal_year_start_monthinteger

Month the fiscal year starts (1-12).

vat_period_monthsinteger

VAT reporting period length in months (e.g. 1, 3, 12).

vat_period_valid_fromstring

Period-aligned effective date, YYYY-MM-DD.

Response

Updated company profile.

customer_idstring
legal_namestring
business_idstring

Finnish business ID (Y-tunnus).

vat_numberstring
country_codestring
currencystring
fiscal_year_start_monthinteger

Month the fiscal year starts (1-12).

vat_period_monthsinteger

VAT reporting period length in months.

vat_period_source'dated' | 'column' | 'default'

Where the VAT period setting comes from.

company_formstring
statement_formatstring
editableboolean

Whether the caller may change settings (false for API keys).