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

FinancialTransaction

Experimental

A single receipt, disbursement, transfer or adjustment affecting a fund.

Fields

FieldTypeDescription
id
required
Identifier

Stable identifier of this FinancialTransaction record.

strataCorporationId
required
Identifier

The strata corporation this record belongs to.

References StrataCorporation

fundId
required
Identifier

Fund affected.

References Fund

transactionDate
required
Date

Date of the transaction.

transactionType
required
enum

Kind of transaction.

receiptdisbursementtransferadjustment

amount
required
Money

Amount. Positive values increase the fund; negative values decrease it.

category
optional
string

Category label (for example "Insurance").

max length 120

description
optional
string

Description or memo.

max length 1000

strataLotId
optional
Identifier

Strata lot the transaction relates to, if any.

References StrataLot

counterpartyOrganizationId
optional
Identifier

Organization paid or paying, if any.

References Organization

levyId
optional
Identifier

Levy the transaction relates to, if any.

References Levy

documentIds
optional
array<Identifier>

Supporting documents such as invoices.

References Document

unique items

extensions
optional
Extensions

Implementation-specific data, namespaced by reverse domain.

Controlled vocabularies

transactionType

receipt
Money received.
disbursement
Money paid out.
transfer
Transfer between funds.
adjustment
Accounting adjustment.

Relationships

Referenced by

None

FinancialTransaction

References

Validation rules

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

  • Disbursements should have a negative amount and receipts a positive amount.

Example payload

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

{
  "id": "txn-2026-000123",
  "strataCorporationId": "sc-0001",
  "fundId": "fund-operating",
  "transactionDate": "2026-04-30",
  "transactionType": "disbursement",
  "amount": {
    "amount": "-1850.00",
    "currency": "CAD"
  },
  "category": "Landscaping",
  "description": "April landscaping service",
  "counterpartyOrganizationId": "org-0002",
  "documentIds": [
    "doc-0201"
  ]
}