Fiscal Years

Fiscal years define the 12‑month periods Naqood uses for reporting, opening entries, and period locking. Naqood automatically creates new fiscal years when you post journal entries dated outside existing periods, so you rarely need to provision them manually. This guide covers read-only access to the fiscal year list; closing or creating periods requires fiscal year management permissions in the UI or mutations.

Prerequisites

• A Naqood API secret or OAuth-issued secret scoped to the organization
• The organization slug on every request
• Access to the organization (read-only is sufficient for listing fiscal years)

FiscalYear fields

Field	Type	Notes
id	ID!	Stable identifier for the fiscal year
fromDate	Date!	First day of the fiscal period (inclusive)
toDate	Date!	Last day of the fiscal period (inclusive)
closed	Boolean!	true when the period is locked and new journal entries are blocked

Pagination metadata is returned alongside the entries:

Field	Type	Notes
count	Int	Total fiscal years for the organization
offset	Int	Offset requested in the query
limit	Int	Page size (maximum 50)

List fiscal years

Fetch fiscal years for an organization with optional pagination, ordering, and filtering. Results default to toDate descending.

query FiscalYears(
  $slug: Slug!
  $limit: Int
  $offset: Int
  $filter: JSONObject
) {
  organization(slug: $slug) {
    fiscalYears(
      limit: $limit
      offset: $offset
      orderBy: { field: "toDate", order: DESC }
      filter: $filter
    ) {
      count
      offset
      limit
      entries {
        id
        fromDate
        toDate
        closed
      }
    }
  }
}

Example variables to list open periods first:

{
  "slug": "acme-co",
  "limit": 25,
  "filter": { "closed": { "equalTo": false } }
}

Fiscal years are created automatically as you post entries in new date ranges. Use the closed flag to decide whether a period is locked before attempting journal entry imports or adjustments.