DemandFlow Support Centre

MTPLINE: MTP Cost Line

A single justifiable cost entry on a project within an MTP plan. Source can be a free entry, a resource template, a BOM (exploded into multiple lines sharing sourceParentId), a NWPLAT hardware requirement, a component, or a contract. On plan approval, lines for the approved fiscal year are aggregated into ROADLINEs.

Default definition. This article describes the default MTPLINE 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 MTPLINE.

Entity properties

Property	Value
Entity code	`MTPLINE`
Display name	MTP Cost Line
Plural	MTP Cost Lines
Level	462

Use cases

sourceParentId groups lines that came from a single BOM/template explosion so they can be deleted or re-expanded together. justification optionally references an INI or NWPLATHWREQ to make the 'why' traceable. month is optional.

Fields

Line

Field	Type	Required	Notes
`year`	number	Yes	Year
`month`	number		1-12. Leave blank to spread evenly across the year.
`source`	enum	Yes	Source Valid ids: `free` (Free entry), `rest` (Resource Template), `bom` (BOM), `nwplathwreq` (NWPLAT Requirement), `comp` (Component), `pcon` (Contract).
`sourceRefId`	text		ID of the REST / BOM / NWPLATHWREQ / COMP / PCON this line came from Read only.
`sourceParentId`	text		Shared UUID for lines exploded from the same BOM or template Read only.
`description`	text		Description

Cost

Field	Type	Notes
`spendType`	reference → `SPEND`	Spend Type
`vendor`	reference → `VEN`	Vendor
`qty`	number	Qty
`unitPrice`	number	Unit Price
`amount`	number	Calculated: qty × unitPrice Read only.

Justification

Field	Type	Notes
`justification`	text (multi-line)	Justification
`justifyIniId`	reference → `INI`	Linked Initiative
`justifyNwplatHwReqId`	reference → `NWPLATHWREQ`	Linked HW Requirement

Relationships

Lookups: spendType points at a SPEND record. vendor points at a VEN record. justifyIniId points at a INI record. justifyNwplatHwReqId points at a NWPLATHWREQ record.

Creating a MTP Cost Line via the API

POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json

{
  "entity":   "MTPLINE",
  "level":    462,
  "comboKey": "SUB:<your-sub-id>|ENT:",
  "year": 1,
  "source": "free",
  "month": 1,
  "sourceRefId": "Example"
}

Listing MTP Cost Lines records

# All mtp cost lines in your tenant
GET /v1/entities/MTPLINE/SUB

DemandFlow Support Centre

MTPLINE: MTP Cost Line

MTPLINE: MTP Cost Line

Entity properties

Use cases

Fields

Relationships

Creating a MTP Cost Line via the API

Listing MTP Cost Lines records

See also

Was this article helpful?