POST
Create a fiscal period (client account)
Client space Accounting module For: Accountant · Permission: fiscal_periods.create Conditions
  • The accounting module must be part of the organization’s plan.
  • The label must be unique within the fiscal year.
  • The start and end dates must stay inside the fiscal year and must not overlap another period of that year.
  • end_date must be on or after start_date.
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, fiscal_year_id, label, start_date, end_date, 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
fiscal_year_id
string
required

Identifier of the fiscal year that will contain the period. Required.

label
string
required

Name of the period. Required; must be unique within the fiscal year.

start_date
string<date-time>
required

First day of the period, ISO 8601 date. Required; must not be before the start of the fiscal year and must not overlap another period of that year.

end_date
string<date-time>
required

Last day of the period, ISO 8601 date. Required; on or after start_date and not after the end of the fiscal year.

Response

Resource (only with response=resource).

id

Identifier of the period (27-character KSUID).

owner_type

Kind of book that owns the period (organization book or client book); set by the server from the selected book.

fiscal_year_id

Identifier of the fiscal year the period belongs to.

label

Name of the period; unique within its fiscal year. Periods generated with a year are labelled Y-m.

start_date

First day of the period, ISO 8601 date.

end_date

Last day of the period, ISO 8601 date.

is_closed
boolean

True once the period is closed and accepts no more entries. Periods start open.

closed_at

When the period was closed, ISO 8601; null while it is open.

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).