CONTRACTEW: Early Warning
The CONTRACTEW entity stores early warnings. An NEC early warning notice identifying a risk that could affect cost, time, or quality. Tracks risk reduction meetings and agreed actions.
Default definition. This article describes the default
CONTRACTEW 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 CONTRACTEW.Entity properties
| Property | Value |
|---|---|
| Entity code | CONTRACTEW |
| Display name | Early Warning |
| Plural | Early Warnings |
| Level | 71020 |
Use cases
Child entity of CONTRACT via SUB|CONTRACT comboKey. NEC clause 15 requires both parties to notify early warnings.
Fields
Early Warning Details
| Field | Type | Required | Notes |
|---|---|---|---|
ewRef | text | Yes | EW reference. Example: e.g. EW-001 |
status | enum | Yes | Status. Valid ids: open (Open), rrm_scheduled (RRM Scheduled), actioned (Actioned), closed (Closed). |
name | text (multi-line) | Yes | Description |
raisedBy | enum | Raised by. Valid ids: pm (Project Manager), contractor (Contractor), supervisor (Supervisor). | |
dateRaised | date | Date raised | |
assigned_to | reference → user | Owner |
Risk Reduction Meeting
| Field | Type | Required | Notes |
|---|---|---|---|
rrmScheduledDate | date | RRM scheduled date | |
rrmHeldDate | date | RRM held date | |
rrmAttendees | array of references → user | Attendees |
Actions & Outcome
| Field | Type | Required | Notes |
|---|---|---|---|
actionsAgreed | text (multi-line) | Actions agreed | |
riskMitigation | text (multi-line) | Risk mitigation outcome | |
becameCE | boolean | Became a compensation event |
Relationships
- No declared relationships in the default definition.
Creating a Early Warning via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "CONTRACTEW",
"level": 71020,
"comboKey": "SUB:<your-sub-id>|ENT:",
"ewRef": "Example value",
"status": "open",
"name": "Example value"
}Listing Early Warnings
GET /v1/entities/CONTRACTEW/SUB