MTPPLAN: MTP Plan
A medium-term plan covering a configurable horizon of years. Holds the set of projects being considered, their prioritisation scoring snapshot, and the cost model lines that justify the budget. On approval, generates ROADLINEs for the selected projects' next fiscal year.
Default definition. This article describes the default
MTPPLAN definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches MTPPLAN.Entity properties
| Property | Value |
|---|---|
| Entity code | MTPPLAN |
| Display name | MTP Plan |
| Plural | MTP Plans |
| Level | 460 |
Use cases
MTP is the top-level planning container. Projects are attached via MTPPJ (project-in-plan join) and cost lines via MTPLINE. Prioritisation, cost-model, and approve actions are driven by toolbar functions (not native relatedlists) because they need custom popouts.
Fields
Plan
| Field | Type | Required | Notes |
|---|---|---|---|
ref | text | Ref. Read only. | |
name | text | Yes | Name |
startYear | number | Yes | First fiscal year covered by this plan |
horizonYears | number | Yes | Number of years covered by this plan |
status | enum | Status Valid ids: draft (Draft), review (In Review), approved (Approved), superseded (Superseded). |
Approval
| Field | Type | Required | Notes |
|---|---|---|---|
approvedForYear | number | The fiscal year whose ROADLINEs were generated when this plan was approved Read only. | |
approvedAt | timestamp | Approved At Read only. | |
approvedBy | reference → user | Approved By Read only. | |
created | timestamp | Created Read only. | |
updated | timestamp | Updated Read only. |
Scoring Weights
| Field | Type | Required | Notes |
|---|---|---|---|
weightIni | number | All weights must sum to 100 | |
weightNwplat | number | NWPLAT weight | |
weightBenefit | number | Benefit weight | |
weightProb | number | Probability weight | |
weightImpact | number | Impact weight |
Funnel
| Field | Type | Required | Notes |
|---|---|---|---|
targetYear | number | The fiscal year the funnel ranks projects for. Typically the next plan year awaiting approval. | |
budgetCaps | text (multi-line) | Per-year funding caps, e.g. { "2026": 5000000, "2027": 7500000 } |
Activity. Activity timeline panel attached.
Relationships
- Related lists:
MTPPJ(formatSUB|MTPPLAN|ENT).
Creating a MTP Plan via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "MTPPLAN",
"level": 460,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example",
"startYear": 1,
"horizonYears": 1
}Listing MTP Plans records
# All mtp plans in your tenant
GET /v1/entities/MTPPLAN/SUB