POST
Create a fiscal year (client account)
Client space Accounting module For: Accountant · Permission: fiscal_years.create Conditions
  • The accounting module must be part of the organization’s plan.
  • end_date must be after start_date.
  • The dates must not overlap an existing fiscal year of the book.
  • label, start_date, end_date, currency_code (3 characters) and currency_exponent (0 to 30) are required.
What else happens
  • Creates the periods of the year: one per whole month from the start date, labelled Y-m, the last one absorbing any remainder; all are open.
Part of Fiscal years and periods.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none,
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, owner_type, label, start_date, end_date, currency_code, currency_exponent, is_closed, closed_at, created_at, updated_at.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .

Body

application/json
label
string
required

Name of the fiscal year. Required.

start_date
string<date-time>
required

First day of the year, ISO 8601 date. Required; the year must not overlap an existing one.

end_date
string<date-time>
required

Last day of the year, ISO 8601 date. Required; after start_date. Monthly periods are generated from the two dates.

currency_code
string
required

Three-letter currency code of the year. Required.

Required string length: 3
currency_exponent
integer
required

Number of decimal places of the currency (0 for XOF). An amount in minor units divided by 10 to this power gives the amount in the currency.

Required range: 0 <= x <= 30

Response

Resource (only with response=resource).

id

Identifier of the fiscal year (27-character KSUID).

owner_type

Kind of book that owns the year; set by the server from the selected book.

label

Name of the fiscal year.

start_date

First day of the year, ISO 8601 date.

end_date

Last day of the year, ISO 8601 date.

currency_code

Three-letter currency code in which the year's entries are kept.

currency_exponent
integer

Number of decimal places of the currency (0 for XOF). An amount in minor units divided by 10 to this power gives the amount in the currency.

is_closed
boolean

True once the year is closed by the year-end closing; years start open.

closed_at

When the year was closed, ISO 8601; null while it is open or after it is reopened.

created_at

Date and time the record was created (ISO 8601, UTC).

updated_at

Date and time the record was last changed (ISO 8601, UTC).