Occurrences

Occurrences are the records that turn a financial plan into a real history. Where a Budget sets the target, occurrences capture what actually happened — or what you expect to happen.

GreenVee has two active occurrence types. Each answers a different financial question:

Type	Question it answers
Cost Occurrence	How much did this project spend (or expect to spend)?
Earning Occurrence	How much revenue has the project’s Order generated?

There is also a Benefit Occurrence record in the data model, but it isn’t connected to projects today — see below.

Caution

The underlying database uses the spelling “occurance” (a typo). All documentation and user-facing labels use the correct English spelling: Occurrence. They refer to the same data.

---

Cost Occurrence

A Cost Occurrence records a single cost event — either something that has already been spent or something expected in the future. It is always linked to both a Cost Item and a Project.

Field	What it means
Description	A note explaining what this cost is for
Cost Value	The monetary amount
Occurred Date	The day the cost happened or is expected to happen (a calendar date, not a timestamp)
Expected / Actual	Flag: is this a plan entry or a confirmed actual?
Cost Item	The budget line this cost is charged against
Project	The project this cost belongs to

The Expected / Actual flag is the key to plan vs. actual reporting. Mark entries as Expected while planning. Switch them to Actual once spending is confirmed. Reports can then compare the two.

---

Benefit Occurrence

GreenVee’s data model reserves a Benefit Occurrence record for capturing financial value year by year (Description, Value, Year), but this record isn’t wired into any project today — it has no working link to a Project, Program, or Portfolio.

Instead, the economic benefit a project delivers is tracked as a single Benefit value stored directly on the Project. It shows up alongside earnings and costs in the project’s Business Case view — see Benefits and the Business Case for how it’s used in profit and ROI calculations.

---

Earning Occurrence

An Earning Occurrence records a revenue payment received against an Order. It is the sales counterpart to a Cost Occurrence.

Field	What it means
Description	What this payment is for (e.g. “Milestone 2 invoice”)
Value	The payment amount
Currency	The currency of the payment
Occurred Date	The day the payment was received (a calendar date, not a timestamp)
Order	The Order this payment belongs to
Project	The associated project

Earning Occurrences accumulate on an Order over time. Together they show how much of the contracted order volume has been received. See Orders for more on the Order record.

---

Side-by-side comparison

	Cost Occurrence	Earning Occurrence
What it tracks	Spending	Revenue received
Linked to	Cost Item + Project	Order + Project
Date field	Occurred date	Occurred date
Has currency	Inherits from Budget	Yes (own field)
Expected / Actual flag	Yes	No

For Project Managers

Occurrences are how plan vs. actual becomes visible in GreenVee. Start by entering Expected Cost Occurrences when you set up the project budget. As work progresses, add Actual entries for confirmed spending. The gap between the two is your variance. The project’s Benefit value and its Earning Occurrences round out the picture — see Benefits and the Business Case.