Skip to main content
Version: 1.0.0-beta

Field Reference — Annual Planning

AnnualPlan​

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
org_idIntegerAutoFrom session—Organization
titleString✅—Max 255 charsPlan name
yearInteger✅—2020–2099Fiscal year
descriptionTextNo—Max 5,000 charsPlan overview
statusEnumAutoDraftDraft, Under Review, Approved, In Progress, Completed, RevisedCurrent status
owner_idIntegerAutoCurrent user—Plan owner (typically CAE)
versionIntegerAuto1—Plan version number
approved_byIntegerNonull—Approving user
approved_atTimestampNonull—Approval timestamp
total_hoursIntegerAuto0—Sum of all plan item hours
completion_pctFloatAuto0.00.0–100.0Overall completion percentage
created_atTimestampAutoCurrent time—Creation timestamp
updated_atTimestampAutoCurrent time—Last modification

PlanItem​

FieldTypeRequiredDefaultValidationDescription
idIntegerAutoAuto-increment—Unique identifier
plan_idInteger✅—Must reference existing planParent plan
titleString✅—Max 255 charsEngagement name
universe_item_idInteger✅—Must reference existing universe itemLinked entity
typeEnum✅—Compliance, Operational, Financial, IT, SpecialEngagement type
priority_scoreFloatAutoCalculated0.0–100.0Risk-based priority
planned_quarterEnum✅—Q1, Q2, Q3, Q4Target quarter
estimated_hoursIntegerNo00–10,000Budgeted hours
lead_auditor_idIntegerNonull—Assigned lead
statusEnumAutoPlannedPlanned, In Progress, Completed, Deferred, CancelledItem status
engagement_idIntegerNonull—Created engagement (when executed)