---
title: Audit lifecycle status transitions
summary: Premium-audit workflow detail.
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy.Audit.Premium
reference_type: package
operation_id: OP-010
trigger: Callers cancel, revise, complete, or derive audit status
---

# Audit lifecycle status transitions

Premium-audit workflow detail.

| Field | Value |
| --- | --- |
| **Operation ID** | OP-010 |
| **Trigger** | Callers cancel, revise, complete, or derive audit status |
| **Inputs** | Audit state, result payloads, cancel reasons, and prior-audit context |
| **Outputs** | Updated status, result state, and duplicate-audit checks |
| **Primary components** | `clsAudit.CancelAudit`, `DeriveStatusCode`, `NewRevisedAudit`, `DuplicateAuditExists` |
| **Entry point** | `Business\SAIF.Business.Policy.Audit.Premium\clsAudit.vb` |

## Steps

1. Use the public lifecycle helpers on `clsAudit` to cancel audits, derive status, seed revised audits, and manage result payloads.
2. Call the duplicate-audit query before creating or revising audits that could overlap an existing period and type.
3. Drive status changes from the current audit dates, completion state, review state, and cancellation inputs.
4. Traceability summary. Primary rules: [BR-020](../business-rules.md#br-020-ineligible-policy-types-cannot-be-audited), [BR-021](../business-rules.md#br-021-duplicate-audits-are-blocked), [BR-032](../business-rules.md#br-032-rows-affected-must-equal-one), [BR-035](../business-rules.md#br-035-nonzerodecimalrequired-auditseqnum), [BR-036](../business-rules.md#br-036-nonzerodecimalrequired-policynumber), [BR-037](../business-rules.md#br-037-textrequired), [BR-057](../business-rules.md#br-057-validupdatableaudit), [BR-058](../business-rules.md#br-058-validtestaudittype-validtestauditdifference-validtestauditresult), [BR-067](../business-rules.md#br-067-audit-event-code-must-be-valid). SQL and Oracle calls: [SQL-001](../sql/SQL-001-saif-business-policy-audit-premium.md), [SQL-002](../sql/SQL-002-saif-business-policy-audit-premium.md), [SQL-004](../sql/SQL-004-saif-business-policy-audit-premium.md), [SQL-006](../sql/SQL-006-saif-business-policy-audit-premium.md), [SQL-007](../sql/SQL-007-saif-business-policy-audit-premium.md), [SQL-018](../sql/SQL-018-saif-business-policy-audit-premium.md), [SQL-019](../sql/SQL-019-saif-business-policy-audit-premium.md), [SQL-020](../sql/SQL-020-saif-business-policy-audit-premium.md), [SQL-021](../sql/SQL-021-saif-business-policy-audit-premium.md), [SQL-022](../sql/SQL-022-saif-business-policy-audit-premium.md), [SQL-023](../sql/SQL-023-saif-business-policy-audit-premium.md), [SQL-024](../sql/SQL-024-saif-business-policy-audit-premium.md), [SQL-030](../sql/SQL-030-saif-business-policy-audit-premium.md), [SQL-031](../sql/SQL-031-saif-business-policy-audit-premium.md), [SQL-070](../sql/SQL-070-saif-business-policy-audit-premium.md), [SQL-071](../sql/SQL-071-saif-business-policy-audit-premium.md), [SQL-072](../sql/SQL-072-saif-business-policy-audit-premium.md), [SQL-076](../sql/SQL-076-saif-business-policy-audit-premium.md), [SQL-078](../sql/SQL-078-saif-business-policy-audit-premium.md), [SQL-088](../sql/SQL-088-saif-business-policy-audit-premium.md), [SQL-089](../sql/SQL-089-saif-business-policy-audit-premium.md).

## Process flow

The following diagram visualizes this operation's control flow.

```mermaid
flowchart TD
 Start([Trigger]) --> S1[Load context]
 S1 --> S2[Run core logic]
 S2 --> EndOk([Outcome])
```

## Failure and edge-case behavior

- Review the linked rule and SQL documents for operation-specific validation failures and persistence behavior.
- Remote-wrapper SQL and not-found Oracle references are documented in the linked SQL and procedure pages where applicable.

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Business rules](../business-rules.md)
- [SQL catalog](../sql/index.md)
- [Database tables](../database-tables.md)



> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- `Business\SAIF.Business.Policy.Audit.Premium\clsAudit.vb`