NQD financial sources and cash Transactions
Distinguish Invoice, Income, Expense, Payout, and Asset sources from the cash Transactions recorded against them.
NQD separates financial sources from the cash Transactions recorded against them. A source describes what the money or wealth represents. A Transaction records an actual cash movement. Sources can be unpaid or partially paid.
Sources
- Invoice: Incoming service source. Use Client and Project for the service context, and Entries for the priced units. Post one or more Transactions as customers pay.
- Income: Other incoming cash source that does not require a service-work relationship. Use it for capital, inheritance, product receipts, or another standalone receipt. A buyer Client is optional.
- Expense: Outgoing payment source for a Vendor’s service. A Vendor can be an individual or a company. Client and Project are optional. A null Client means the current Workspace.
- Payout: Outgoing payment source for an individual Contact’s service. Client, Project, and a customer Invoice are optional. A null Client means the current Workspace. If one person is both a Vendor and a Contact, the selected payee role decides whether the source is an Expense or Payout.
- Asset: Non-cash holding. Its acquisition may have a separate cash Transaction. The holding and the acquisition event stay distinct.
Do not create a placeholder Client for the Workspace. Leave clientId null and resolve Workspace ownership at runtime.
Entries and Modifiers
Entries are reusable priced units for products, services, plans, or other calculable lines. An Entry amount is quantity multiplied by its net unit price; Entry prices exclude VAT. An applied Entry keeps its saved values even when its catalog definition changes.
Modifiers change one Entry or the whole source. NQD supports signed fixed amounts and percentages, including increases and decreases. Applied modifiers preserve their ordered target and value snapshots. It does not support arbitrary multiplication or division modifiers. A modifier with an entryIndex belongs to that Entry. A null entryIndex applies to the source.
Bank statement classification
Use the statement to find cash Transactions and match them to existing sources before creating anything. Ask for the purpose of a movement when its description is ambiguous. A debit is not automatically an Expense. A transfer, withdrawal, refund, loan, investment, or personal movement needs its own classification.
When a payment settles an existing Invoice, Expense, or Payout, record a Transaction against that source instead of creating a duplicate source. Keep the statement’s payment date and amount as the cash event details.