Last modified: Jun 6, 2025

Correspondence Life Cycle

Altinn 3 Correspondence status life cycle and states overview.

Overview

A correspondence in Altinn 3 goes through several status states during its life cycle. The flow is divided into two main phases:

Two Main Phases

1. Pre-Published Life Cycle

The journey from correspondence creation to publication, including:

  • Initialization and validation
  • Attachment processing and virus scanning
  • Publishing process and error handling
  • Status states: Initialized, Reserved, ReadyForPublish, Published, Failed

2. Post-Published Life Cycle

Recipient interactions after publication, including:

  • Fetching correspondence details
  • Reading and confirmation processes
  • Attachment downloads
  • Purging and archival
  • Status states: Fetched, Read, AttachmentsDownloaded, Confirmed, PurgedByRecipient, PurgedByAltinn

Complete Status Flow Summary

Initialization → Validation → [Attachment Processing] → Publishing → Recipient Interactions → Purging

Key Points

  • System-Managed Phase: Pre-published flow handles validation, security, and delivery
  • Recipient-Managed Phase: Post-published flow tracks recipient interactions and actions
  • Error Handling: Comprehensive error handling at each phase with appropriate HTTP status codes
  • Audit Trail: Complete tracking of all status changes and timestamps
  • API Flexibility: Different APIs support different functionality (main API vs. legacy API)

Each phase has its own detailed documentation with diagrams, status explanations, and API specifications.