Skip to content
OpenCOOS
Open in explorer
Financial Managementsince 0.1.0-draftspec v0.1.0-draft

Budget

Proposed

The annual budget for a fiscal year, including planned contributions to the operating fund and the contingency reserve fund.

JSON Schema Example file

Fields

FieldTypeDescription
id
required
Identifier

Stable identifier of this Budget record.

strataCorporationId
required
Identifier

The strata corporation this record belongs to.

References StrataCorporation

fiscalYearStart
required
Date

First day of the fiscal year.

fiscalYearEnd
required
Date

Last day of the fiscal year.

status
required
enum

Approval status.

draftproposedapprovedsuperseded

approvedByResolutionId
optional
Identifier

Resolution approving the budget.

References Resolution

lineItems
optional
array<object>

Budgeted income and expense lines.

↳ category
required
string

Category label used by the corporation (for example "Insurance"). A shared category vocabulary is an open proposal.

max length 120

↳ kind
optional
enum

Whether the line is income or expense.

incomeexpense

↳ fundId
optional
Identifier

Fund the line belongs to.

References Fund

↳ amount
required
Money

Budgeted amount for the year.

extensions
optional
Extensions

Implementation-specific data, namespaced by reverse domain.

Controlled vocabularies

status

draft
Being prepared.
proposed
Presented to owners for approval.
approved
Approved by the owners.
superseded
Replaced by an amended budget.

lineItems[].kind

income
Income.
expense
Expense.

Relationships

Referenced by

Budget

References

Validation rules

Cross-field rules beyond what JSON Schema expresses. Documented in the draft; not yet enforced by tooling.

  • fiscalYearEnd must be after fiscalYearStart.
  • approvedByResolutionId should be present when status is approved.

Example payload

Illustrative only, with fictional data. Validated against the draft schema at build time.

{
  "id": "budget-2026",
  "strataCorporationId": "sc-0001",
  "fiscalYearStart": "2026-01-01",
  "fiscalYearEnd": "2026-12-31",
  "status": "approved",
  "approvedByResolutionId": "res-2026-03",
  "lineItems": [
    {
      "category": "Insurance",
      "kind": "expense",
      "fundId": "fund-operating",
      "amount": {
        "amount": "96000.00",
        "currency": "CAD"
      }
    },
    {
      "category": "Contribution to CRF",
      "kind": "expense",
      "fundId": "fund-operating",
      "amount": {
        "amount": "60000.00",
        "currency": "CAD"
      }
    },
    {
      "category": "Strata fees",
      "kind": "income",
      "fundId": "fund-operating",
      "amount": {
        "amount": "288000.00",
        "currency": "CAD"
      }
    }
  ]
}