From 7f358fc624f0370f11fccc64c1bd1ab150c9bfdb Mon Sep 17 00:00:00 2001
From: "tom.droza2" <tom.droza2@nhs.net>
Date: Tue, 3 Feb 2026 13:50:35 +0000
Subject: [PATCH] CCM-13295: Add `reasonCode` and `reasonText` to
 PrintLetterTransitioned event

---
 ...-letters-print-letter-transitioned-data.schema.yaml |  4 ++++
 .../2025-10-draft/defs/print.schema.yaml               | 10 ++++++++++
 2 files changed, 14 insertions(+)

diff --git a/src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-transitioned-data.schema.yaml b/src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-transitioned-data.schema.yaml
index b4dbfebb4..994c3cbcc 100644
--- a/src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-transitioned-data.schema.yaml
+++ b/src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-transitioned-data.schema.yaml
@@ -12,6 +12,10 @@ properties:
     $ref: ../defs/print.schema.yaml#/properties/specificationId
   status:
     $ref: ../defs/print.schema.yaml#/properties/status
+  reasonCode:
+    $ref: ../defs/print.schema.yaml#/properties/reasonCode
+  reasonText:
+    $ref: ../defs/print.schema.yaml#/properties/reasonText
   supplierId:
     $ref: ../defs/print.schema.yaml#/properties/supplierId
   time:
diff --git a/src/cloudevents/domains/digital-letters/2025-10-draft/defs/print.schema.yaml b/src/cloudevents/domains/digital-letters/2025-10-draft/defs/print.schema.yaml
index c5fb2160e..2ced7c8f7 100644
--- a/src/cloudevents/domains/digital-letters/2025-10-draft/defs/print.schema.yaml
+++ b/src/cloudevents/domains/digital-letters/2025-10-draft/defs/print.schema.yaml
@@ -59,3 +59,13 @@ properties:
     ]
     type: "string"
     pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
+  reasonCode:
+    type: string
+    description: A codified reason for the status of the message
+    examples:
+      - "FAILURE001"
+  reasonText:
+    type: string
+    description: Human-readable explanation for the reasonCode
+    examples:
+      - "Letter has too many pages"