Logo

V3docs

Balances

Balances represent amounts on Balance Sheet accounts carried over from previous reporting periods. Consequently there can only be Balance Sheet account balances. Balances provide a way of decoupling reports between different reporting periods from each other.

Attributes

  • entity: The Entity associated with the balance. Defaults to the entity of the logged in user.
  • exchangeRate: The Exchange Rate of the Transaction object that originated the balance amount. Defaults to associated entity’s default exchange rate.
  • currency: The Currency of the Transaction object that originated the balance amount. Defaults to the entity’s reporting currency.
  • account: The Account associated with the balance.
  • reportingPeriod: The Reporting Period the balance pertains to.
  • transaction_no: The transaction number from the Transaction object that originated the balance amount.
  • transaction_date: The date of the Transaction object that originated the balance amount.
  • transaction_type: The type of the Transaction object that originated the balance amount. Defaults to Transaction::JN.
  • reference: More information about the Transaction object that originated the balance amount.
  • balance_type: The side of the double entry the balance should be posted. Defaults to Balance::DEBIT.
  • amount: The balance amount. This may or may not be the amount of the originating Transaction depending on its clearance in its reporting period.
  • isPosted: A boolean to mirror the Transaction model isPosted attribute because like some Transactions Balances are Clearable.
  • isCredited: A boolean to mirror the Transaction model isCredited attribute because like some Transactions Balances are Clearable.
  • clearedType: The string representation of the Balance model because like some Transactions Balances are Clearable.

Constants

  • Balance::DEBIT: The debit side of the double entry in the sense of the balance of an asset.
  • Balance::CREDIT: The credit side of the double entry in the sense of the balance of an liability.

Methods

  • Balance::getType($type): The human readable type name of the given balance type.
  • Balance::getTypes($types): The human readable type names of the balance types in the given array.
  • $balance->attributes(): Presents the balance’s attributes as an object. Useful for debugging.
  • $balance->toString():The string representation of the Balance object instance.

Constraints

  • NegativeAmount: Balance amounts cannot be negative.
  • InvalidBalanceTransaction: Transaction type must be one of Transaction::IN, Transaction::BL or Transaction::JN. See Transactions for details of Transaction Types.
  • InvalidBalance: Balance type must be one of Balance::DEBIT or Balance::CREDIT.
  • InvalidAccountClassBalance: Income Statement accounts cannot have opening balances.