AUDIT: Audit
An internal or external audit record covering scope, schedule, team, and overall conclusion with linked findings and corrective actions.
AUDIT 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 AUDIT.Entity properties
| Property | Value |
|---|---|
| Entity code | AUDIT |
| Display name | Audit |
| Plural | Audits |
| Level | 90000 |
Use cases
AUDIT is the parent entity for the audit programme required by ISO 9001 clause 9.2 and ISO 27001 clause 9.2. Each audit has a type (Internal, External, Certification, Surveillance), scope, criteria, and team. The schedule fields (plannedDate, actualDate) support audit programme planning. Status tracks the audit lifecycle from Planned through to Closed. The Findings panel shows child AUDITFINDING records via comboKey SUB|AUDIT. The Actions panel shows AUDITACTION records raised from this audit. The conclusion and summary fields capture the overall audit outcome.
Fields
General: Audit Details
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Audit Title. Placeholder: e.g. ISO 9001 Internal Audit Q2 2026. |
auditType | enum | Yes | Audit Type. Valid ids: internal (Internal), external (External), certification (Certification), surveillance (Surveillance), supplier (Supplier Audit). |
standard | multiselect | Standard(s). | |
status | enum | Yes | Status. Valid ids: planned (Planned), inProgress (In Progress), awaitingReview (Awaiting Review), completed (Completed), closed (Closed). |
General: Schedule
| Field | Type | Required | Notes |
|---|---|---|---|
plannedDate | date | Planned Start Date. | |
plannedEndDate | date | Planned End Date. | |
actualDate | date | Actual Start Date. | |
actualEndDate | date | Actual End Date. |
General: Scope & Criteria
| Field | Type | Required | Notes |
|---|---|---|---|
scope | text (multi-line) | Yes | Processes, departments, or areas to be audited |
criteria | text (multi-line) | Standard clauses, policies, or procedures being audited against |
General: Audit Team
| Field | Type | Required | Notes |
|---|---|---|---|
leadAuditor | reference → user | Yes | Lead Auditor. |
auditTeam | array of references → user | Audit Team. | |
auditee | text | Auditee / Department. | |
auditeeContact | reference → user | Auditee Contact. |
General: Certification Body
| Field | Type | Required | Notes |
|---|---|---|---|
certBody | reference → VEN | External certification body (for external/certification audits) | |
externalAuditorName | text | External Auditor Name. |
Conclusion: Audit Outcome
| Field | Type | Required | Notes |
|---|---|---|---|
conclusion | enum | Overall Conclusion. Valid ids: conforming (Conforming), minorNC (Minor Non-conformities), majorNC (Major Non-conformities), notApplicable (Not Applicable). | |
summary | text (multi-line) | Executive Summary. |
Conclusion: Statistics
| Field | Type | Required | Notes |
|---|---|---|---|
totalFindings | number | Total Findings. | |
majorNCs | number | Major NCs. | |
minorNCs | number | Minor NCs. | |
observations | number | Observations. | |
opportunities | number | Opportunities for Improvement. | |
positiveFindings | number | Positive Findings. |
Conclusion: Recommendations
| Field | Type | Required | Notes |
|---|---|---|---|
recommendations | text (multi-line) | Recommendations. |
Attachments
| Field | Panel | Allowed types | Max files |
|---|---|---|---|
(unnamed) | Documents | any | multiple |
Relationships
- Lookups:
certBodypoints at aVENrecord. - Related lists:
AUDITFINDING(formatSUB|AUDIT),AUDITACTION(formatSUB|AUDIT). - Activity: activity timeline panel attached.
Creating a Audit via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "AUDIT",
"level": 90000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Audit Title",
"auditType": "internal",
"status": "planned",
"scope": "Audit Scope"
}Listing Audits records
GET /v1/entities/AUDIT/SUB