@ingenx-io/valets-schema-mcp-server 0.1.4 → 0.1.6

package/data/docs/models/order.md

@@ -1,7 +1,7 @@
 ---
 title: "Order"
 sidebar_label: "Order"
-sidebar_position: 17
+sidebar_position: 20
 ---
 
 # Order
@@ -14,6 +14,7 @@ sidebar_position: 17
   "id": "bk_abc123def456",
   "uid": "user_u8x92kqm",
   "companyId": "comp_xyz789",
+  "siteId": null,
   "orderNumber": "ORD-2026-0042",
   "status": "status",
   "paymentStatus": "paymentStatus",
@@ -67,115 +68,116 @@ sidebar_position: 17
 - [1. Property `id`](#id)
 - [2. Property `uid`](#uid)
 - [3. Property `companyId`](#companyId)
-- [4. Property `orderNumber`](#orderNumber)
-- [5. Property `status`](#status)
-- [6. Property `paymentStatus`](#paymentStatus)
-  - [6.1. Property `payment-status`](#paymentStatus_anyOf_i0)
-  - [6.2. Property `item 1`](#paymentStatus_anyOf_i1)
-- [7. Property `fulfillmentStatus`](#fulfillmentStatus)
-  - [7.1. Property `fulfillment-status`](#fulfillmentStatus_anyOf_i0)
-  - [7.2. Property `item 1`](#fulfillmentStatus_anyOf_i1)
-- [8. Property `returnStatus`](#returnStatus)
-  - [8.1. Property `return-status`](#returnStatus_anyOf_i0)
-  - [8.2. Property `item 1`](#returnStatus_anyOf_i1)
-- [9. Property `deliveryType`](#deliveryType)
-  - [9.1. Property `delivery-type`](#deliveryType_anyOf_i0)
-  - [9.2. Property `item 1`](#deliveryType_anyOf_i1)
-- [10. Property `paymentMethod`](#paymentMethod)
-  - [10.1. Property `payment-method`](#paymentMethod_anyOf_i0)
-  - [10.2. Property `item 1`](#paymentMethod_anyOf_i1)
-- [11. Property `invoiceId`](#invoiceId)
-- [12. Property `customerId`](#customerId)
-- [13. Property `customerName`](#customerName)
-- [14. Property `customerEmail`](#customerEmail)
-- [15. Property `customerPhone`](#customerPhone)
-- [16. Property `clientEmail`](#clientEmail)
-- [17. Property `clientPhoneNumber`](#clientPhoneNumber)
-- [18. Property `items`](#items)
-  - [18.1. order-item](#items_items)
-    - [18.1.1. Property `name`](#items_items_name)
-    - [18.1.2. Property `quantity`](#items_items_quantity)
-    - [18.1.3. Property `price`](#items_items_price)
-    - [18.1.4. Property `productId`](#items_items_productId)
-    - [18.1.5. Property `increment`](#items_items_increment)
-    - [18.1.6. Property `variantId`](#items_items_variantId)
-    - [18.1.7. Property `supplierId`](#items_items_supplierId)
-    - [18.1.8. Property `supplierName`](#items_items_supplierName)
-    - [18.1.9. Property `sentAt`](#items_items_sentAt)
-      - [18.1.9.1. Property `_seconds`](#items_items_sentAt__seconds)
-      - [18.1.9.2. Property `_nanoseconds`](#items_items_sentAt__nanoseconds)
-    - [18.1.10. Property `startedCookingAt`](#items_items_startedCookingAt)
-      - [18.1.10.1. Property `_seconds`](#items_items_startedCookingAt__seconds)
-      - [18.1.10.2. Property `_nanoseconds`](#items_items_startedCookingAt__nanoseconds)
-    - [18.1.11. Property `readyAt`](#items_items_readyAt)
-      - [18.1.11.1. Property `_seconds`](#items_items_readyAt__seconds)
-      - [18.1.11.2. Property `_nanoseconds`](#items_items_readyAt__nanoseconds)
-    - [18.1.12. Property `servedAt`](#items_items_servedAt)
-      - [18.1.12.1. Property `_seconds`](#items_items_servedAt__seconds)
-      - [18.1.12.2. Property `_nanoseconds`](#items_items_servedAt__nanoseconds)
-- [19. Property `amount`](#amount)
-- [20. Property `amountPaid`](#amountPaid)
-- [21. Property `total`](#total)
-- [22. Property `createdAt`](#createdAt)
-  - [22.1. Property `_seconds`](#createdAt__seconds)
-  - [22.2. Property `_nanoseconds`](#createdAt__nanoseconds)
-- [23. Property `orderDate`](#orderDate)
-- [24. Property `PROCESSING_ON`](#PROCESSING_ON)
-  - [24.1. Property `firestore-timestamp`](#PROCESSING_ON_anyOf_i0)
-  - [24.2. Property `item 1`](#PROCESSING_ON_anyOf_i1)
-- [25. Property `COMPLETED_ON`](#COMPLETED_ON)
-  - [25.1. Property `firestore-timestamp`](#COMPLETED_ON_anyOf_i0)
-  - [25.2. Property `item 1`](#COMPLETED_ON_anyOf_i1)
-- [26. Property `CANCELLED_ON`](#CANCELLED_ON)
-  - [26.1. Property `firestore-timestamp`](#CANCELLED_ON_anyOf_i0)
-  - [26.2. Property `item 1`](#CANCELLED_ON_anyOf_i1)
-- [27. Property `cancellationReason`](#cancellationReason)
-- [28. Property `shippingCarrier`](#shippingCarrier)
-- [29. Property `trackingNumber`](#trackingNumber)
-- [30. Property `estimatedDeliveryDate`](#estimatedDeliveryDate)
-  - [30.1. Property `firestore-timestamp`](#estimatedDeliveryDate_anyOf_i0)
-  - [30.2. Property `item 1`](#estimatedDeliveryDate_anyOf_i1)
-- [31. Property `shippingCost`](#shippingCost)
-- [32. Property `paymentProofUrl`](#paymentProofUrl)
-- [33. Property `paymentProofStatus`](#paymentProofStatus)
-  - [33.1. Property `payment-proof-status`](#paymentProofStatus_anyOf_i0)
-  - [33.2. Property `item 1`](#paymentProofStatus_anyOf_i1)
-- [34. Property `paymentProofAddedAt`](#paymentProofAddedAt)
-  - [34.1. Property `firestore-timestamp`](#paymentProofAddedAt_anyOf_i0)
-  - [34.2. Property `item 1`](#paymentProofAddedAt_anyOf_i1)
-- [35. Property `paymentProofAddedBy`](#paymentProofAddedBy)
-- [36. Property `paymentProofReviewedAt`](#paymentProofReviewedAt)
-  - [36.1. Property `firestore-timestamp`](#paymentProofReviewedAt_anyOf_i0)
-  - [36.2. Property `item 1`](#paymentProofReviewedAt_anyOf_i1)
-- [37. Property `paymentProofReviewedBy`](#paymentProofReviewedBy)
-- [38. Property `paymentProofRejectionReason`](#paymentProofRejectionReason)
-- [39. Property `paymentStatusChangeReason`](#paymentStatusChangeReason)
-- [40. Property `paymentStatusChangedBy`](#paymentStatusChangedBy)
-- [41. Property `paymentStatusChangedAt`](#paymentStatusChangedAt)
-  - [41.1. Property `firestore-timestamp`](#paymentStatusChangedAt_anyOf_i0)
-  - [41.2. Property `item 1`](#paymentStatusChangedAt_anyOf_i1)
-- [42. Property `payments`](#payments)
-  - [42.1. payments items](#payments_items)
-    - [42.1.1. Property `paymentId`](#payments_items_paymentId)
-    - [42.1.2. Property `amount`](#payments_items_amount)
-    - [42.1.3. Property `currency`](#payments_items_currency)
-    - [42.1.4. Property `paymentMethod`](#payments_items_paymentMethod)
-    - [42.1.5. Property `paymentDate`](#payments_items_paymentDate)
-    - [42.1.6. Property `referenceNumber`](#payments_items_referenceNumber)
-    - [42.1.7. Property `status`](#payments_items_status)
-- [43. Property `totalOverridden`](#totalOverridden)
-- [44. Property `notes`](#notes)
-  - [44.1. notes items](#notes_items)
-    - [44.1.1. Property `id`](#notes_items_id)
-    - [44.1.2. Property `text`](#notes_items_text)
-    - [44.1.3. Property `createdAt`](#notes_items_createdAt)
-      - [44.1.3.1. Property `_seconds`](#createdAt__seconds)
-      - [44.1.3.2. Property `_nanoseconds`](#createdAt__nanoseconds)
-    - [44.1.4. Property `createdBy`](#notes_items_createdBy)
-    - [44.1.5. Property `createdByName`](#notes_items_createdByName)
-- [45. Property `additionalInfo`](#additionalInfo)
-- [46. Property `appliedDiscountCode`](#appliedDiscountCode)
-- [47. Property `purchaseId`](#purchaseId)
+- [4. Property `siteId`](#siteId)
+- [5. Property `orderNumber`](#orderNumber)
+- [6. Property `status`](#status)
+- [7. Property `paymentStatus`](#paymentStatus)
+  - [7.1. Property `payment-status`](#paymentStatus_anyOf_i0)
+  - [7.2. Property `item 1`](#paymentStatus_anyOf_i1)
+- [8. Property `fulfillmentStatus`](#fulfillmentStatus)
+  - [8.1. Property `fulfillment-status`](#fulfillmentStatus_anyOf_i0)
+  - [8.2. Property `item 1`](#fulfillmentStatus_anyOf_i1)
+- [9. Property `returnStatus`](#returnStatus)
+  - [9.1. Property `return-status`](#returnStatus_anyOf_i0)
+  - [9.2. Property `item 1`](#returnStatus_anyOf_i1)
+- [10. Property `deliveryType`](#deliveryType)
+  - [10.1. Property `delivery-type`](#deliveryType_anyOf_i0)
+  - [10.2. Property `item 1`](#deliveryType_anyOf_i1)
+- [11. Property `paymentMethod`](#paymentMethod)
+  - [11.1. Property `payment-method`](#paymentMethod_anyOf_i0)
+  - [11.2. Property `item 1`](#paymentMethod_anyOf_i1)
+- [12. Property `invoiceId`](#invoiceId)
+- [13. Property `customerId`](#customerId)
+- [14. Property `customerName`](#customerName)
+- [15. Property `customerEmail`](#customerEmail)
+- [16. Property `customerPhone`](#customerPhone)
+- [17. Property `clientEmail`](#clientEmail)
+- [18. Property `clientPhoneNumber`](#clientPhoneNumber)
+- [19. Property `items`](#items)
+  - [19.1. order-item](#items_items)
+    - [19.1.1. Property `name`](#items_items_name)
+    - [19.1.2. Property `quantity`](#items_items_quantity)
+    - [19.1.3. Property `price`](#items_items_price)
+    - [19.1.4. Property `productId`](#items_items_productId)
+    - [19.1.5. Property `increment`](#items_items_increment)
+    - [19.1.6. Property `variantId`](#items_items_variantId)
+    - [19.1.7. Property `supplierId`](#items_items_supplierId)
+    - [19.1.8. Property `supplierName`](#items_items_supplierName)
+    - [19.1.9. Property `sentAt`](#items_items_sentAt)
+      - [19.1.9.1. Property `_seconds`](#items_items_sentAt__seconds)
+      - [19.1.9.2. Property `_nanoseconds`](#items_items_sentAt__nanoseconds)
+    - [19.1.10. Property `startedCookingAt`](#items_items_startedCookingAt)
+      - [19.1.10.1. Property `_seconds`](#items_items_startedCookingAt__seconds)
+      - [19.1.10.2. Property `_nanoseconds`](#items_items_startedCookingAt__nanoseconds)
+    - [19.1.11. Property `readyAt`](#items_items_readyAt)
+      - [19.1.11.1. Property `_seconds`](#items_items_readyAt__seconds)
+      - [19.1.11.2. Property `_nanoseconds`](#items_items_readyAt__nanoseconds)
+    - [19.1.12. Property `servedAt`](#items_items_servedAt)
+      - [19.1.12.1. Property `_seconds`](#items_items_servedAt__seconds)
+      - [19.1.12.2. Property `_nanoseconds`](#items_items_servedAt__nanoseconds)
+- [20. Property `amount`](#amount)
+- [21. Property `amountPaid`](#amountPaid)
+- [22. Property `total`](#total)
+- [23. Property `createdAt`](#createdAt)
+  - [23.1. Property `_seconds`](#createdAt__seconds)
+  - [23.2. Property `_nanoseconds`](#createdAt__nanoseconds)
+- [24. Property `orderDate`](#orderDate)
+- [25. Property `PROCESSING_ON`](#PROCESSING_ON)
+  - [25.1. Property `firestore-timestamp`](#PROCESSING_ON_anyOf_i0)
+  - [25.2. Property `item 1`](#PROCESSING_ON_anyOf_i1)
+- [26. Property `COMPLETED_ON`](#COMPLETED_ON)
+  - [26.1. Property `firestore-timestamp`](#COMPLETED_ON_anyOf_i0)
+  - [26.2. Property `item 1`](#COMPLETED_ON_anyOf_i1)
+- [27. Property `CANCELLED_ON`](#CANCELLED_ON)
+  - [27.1. Property `firestore-timestamp`](#CANCELLED_ON_anyOf_i0)
+  - [27.2. Property `item 1`](#CANCELLED_ON_anyOf_i1)
+- [28. Property `cancellationReason`](#cancellationReason)
+- [29. Property `shippingCarrier`](#shippingCarrier)
+- [30. Property `trackingNumber`](#trackingNumber)
+- [31. Property `estimatedDeliveryDate`](#estimatedDeliveryDate)
+  - [31.1. Property `firestore-timestamp`](#estimatedDeliveryDate_anyOf_i0)
+  - [31.2. Property `item 1`](#estimatedDeliveryDate_anyOf_i1)
+- [32. Property `shippingCost`](#shippingCost)
+- [33. Property `paymentProofUrl`](#paymentProofUrl)
+- [34. Property `paymentProofStatus`](#paymentProofStatus)
+  - [34.1. Property `payment-proof-status`](#paymentProofStatus_anyOf_i0)
+  - [34.2. Property `item 1`](#paymentProofStatus_anyOf_i1)
+- [35. Property `paymentProofAddedAt`](#paymentProofAddedAt)
+  - [35.1. Property `firestore-timestamp`](#paymentProofAddedAt_anyOf_i0)
+  - [35.2. Property `item 1`](#paymentProofAddedAt_anyOf_i1)
+- [36. Property `paymentProofAddedBy`](#paymentProofAddedBy)
+- [37. Property `paymentProofReviewedAt`](#paymentProofReviewedAt)
+  - [37.1. Property `firestore-timestamp`](#paymentProofReviewedAt_anyOf_i0)
+  - [37.2. Property `item 1`](#paymentProofReviewedAt_anyOf_i1)
+- [38. Property `paymentProofReviewedBy`](#paymentProofReviewedBy)
+- [39. Property `paymentProofRejectionReason`](#paymentProofRejectionReason)
+- [40. Property `paymentStatusChangeReason`](#paymentStatusChangeReason)
+- [41. Property `paymentStatusChangedBy`](#paymentStatusChangedBy)
+- [42. Property `paymentStatusChangedAt`](#paymentStatusChangedAt)
+  - [42.1. Property `firestore-timestamp`](#paymentStatusChangedAt_anyOf_i0)
+  - [42.2. Property `item 1`](#paymentStatusChangedAt_anyOf_i1)
+- [43. Property `payments`](#payments)
+  - [43.1. payments items](#payments_items)
+    - [43.1.1. Property `paymentId`](#payments_items_paymentId)
+    - [43.1.2. Property `amount`](#payments_items_amount)
+    - [43.1.3. Property `currency`](#payments_items_currency)
+    - [43.1.4. Property `paymentMethod`](#payments_items_paymentMethod)
+    - [43.1.5. Property `paymentDate`](#payments_items_paymentDate)
+    - [43.1.6. Property `referenceNumber`](#payments_items_referenceNumber)
+    - [43.1.7. Property `status`](#payments_items_status)
+- [44. Property `totalOverridden`](#totalOverridden)
+- [45. Property `notes`](#notes)
+  - [45.1. notes items](#notes_items)
+    - [45.1.1. Property `id`](#notes_items_id)
+    - [45.1.2. Property `text`](#notes_items_text)
+    - [45.1.3. Property `createdAt`](#notes_items_createdAt)
+      - [45.1.3.1. Property `_seconds`](#createdAt__seconds)
+      - [45.1.3.2. Property `_nanoseconds`](#createdAt__nanoseconds)
+    - [45.1.4. Property `createdBy`](#notes_items_createdBy)
+    - [45.1.5. Property `createdByName`](#notes_items_createdByName)
+- [46. Property `additionalInfo`](#additionalInfo)
+- [47. Property `appliedDiscountCode`](#appliedDiscountCode)
+- [48. Property `purchaseId`](#purchaseId)
 
 |                           |                     |
 | ------------------------- | ------------------- |
@@ -191,6 +193,7 @@ sidebar_position: 17
 | + [id](#id )                                                   | No      | string                  | No         | -                                    | (Read-only) Firestore document ID. Note: some models also have uid; see ID conventions.                                  |
 | + [uid](#uid )                                                 | No      | string                  | No         | -                                    | (Read-only) Entity UID. Often mirrors id.                                                                                |
 | + [companyId](#companyId )                                     | No      | string                  | No         | -                                    | (Immutable) FK → Company document ID. Scopes all queries.                                                                |
+| - [siteId](#siteId )                                           | No      | string or null          | No         | -                                    | (Immutable, Optional) FK → Site document ID (D43 / ADR-003). null = company-wide.                                        |
 | + [orderNumber](#orderNumber )                                 | No      | string                  | No         | -                                    | (Read-only) Server-generated order number.                                                                               |
 | + [status](#status )                                           | No      | enum (of string)        | No         | In #/definitions/order-status        | Core lifecycle status (D34, MIG-11). See OrderStatus enum for the legacy value migration mapping.                        |
 | - [paymentStatus](#paymentStatus )                             | No      | Combination             | No         | -                                    | Payment lifecycle (D34). Null until payment is initiated.                                                                |
@@ -275,7 +278,32 @@ Do not include in write requests. This field is set exclusively by the server (F
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
 :::
 
-## <a name="orderNumber"></a>4. Property `orderNumber`
+## <a name="siteId"></a>4. Property `siteId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable, Optional) FK → Site document ID (D43 / ADR-003). null = company-wide.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+:::note
+D43 / ADR-003: optional site attribution. Absent/null means company-wide (legacy). When set, the order is attributed to a specific site for analytics and site-scoped dashboards. No migration — existing orders keep null. Flat path; Order continues to live at `companies/\{companyId\}/orders/\{orderId\}`.
+:::
+
+:::tip When to set
+Set at order creation when the client knows which site the order originated from (e.g. SR Single, Lifesense). Leave null for legacy/company-wide orders. Composite index: (companyId, siteId, createdAt).
+:::
+
+:::info See also
+**Decisions:** `D43`
+:::
+
+## <a name="orderNumber"></a>5. Property `orderNumber`
 
 |              |          |
 | ------------ | -------- |
@@ -288,7 +316,7 @@ Set at creation only. This field cannot be modified after the document is create
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="status"></a>5. Property `status`
+## <a name="status"></a>6. Property `status`
 
 |                |                            |
 | -------------- | -------------------------- |
@@ -307,7 +335,7 @@ Must be one of:
 * "CANCELLED"
 * "EXPIRED"
 
-## <a name="paymentStatus"></a>6. Property `paymentStatus`
+## <a name="paymentStatus"></a>7. Property `paymentStatus`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -322,7 +350,7 @@ Must be one of:
 | [payment-status](#paymentStatus_anyOf_i0) |
 | [item 1](#paymentStatus_anyOf_i1)         |
 
-### <a name="paymentStatus_anyOf_i0"></a>6.1. Property `payment-status`
+### <a name="paymentStatus_anyOf_i0"></a>7.1. Property `payment-status`
 
 |                |                              |
 | -------------- | ---------------------------- |
@@ -341,14 +369,14 @@ Must be one of:
 * "REFUNDED"
 * "PARTIALLY_REFUNDED"
 
-### <a name="paymentStatus_anyOf_i1"></a>6.2. Property `item 1`
+### <a name="paymentStatus_anyOf_i1"></a>7.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
 | **Type**     | `null` |
 | **Required** | No     |
 
-## <a name="fulfillmentStatus"></a>7. Property `fulfillmentStatus`
+## <a name="fulfillmentStatus"></a>8. Property `fulfillmentStatus`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -363,7 +391,7 @@ Must be one of:
 | [fulfillment-status](#fulfillmentStatus_anyOf_i0) |
 | [item 1](#fulfillmentStatus_anyOf_i1)             |
 
-### <a name="fulfillmentStatus_anyOf_i0"></a>7.1. Property `fulfillment-status`
+### <a name="fulfillmentStatus_anyOf_i0"></a>8.1. Property `fulfillment-status`
 
 |                |                                  |
 | -------------- | -------------------------------- |
@@ -381,7 +409,7 @@ Must be one of:
 * "DELIVERED"
 * "PICKED_UP"
 
-### <a name="fulfillmentStatus_anyOf_i1"></a>7.2. Property `item 1`
+### <a name="fulfillmentStatus_anyOf_i1"></a>8.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -396,7 +424,7 @@ Null for ON_SITE and PICK_UP orders. Set when deliveryType is DELIVERY and a phy
 **Decisions:** `D34`
 :::
 
-## <a name="returnStatus"></a>8. Property `returnStatus`
+## <a name="returnStatus"></a>9. Property `returnStatus`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -411,7 +439,7 @@ Null for ON_SITE and PICK_UP orders. Set when deliveryType is DELIVERY and a phy
 | [return-status](#returnStatus_anyOf_i0) |
 | [item 1](#returnStatus_anyOf_i1)        |
 
-### <a name="returnStatus_anyOf_i0"></a>8.1. Property `return-status`
+### <a name="returnStatus_anyOf_i0"></a>9.1. Property `return-status`
 
 |                |                             |
 | -------------- | --------------------------- |
@@ -429,14 +457,14 @@ Must be one of:
 * "EXCHANGE_PROCESSING"
 * "EXCHANGE_COMPLETED"
 
-### <a name="returnStatus_anyOf_i1"></a>8.2. Property `item 1`
+### <a name="returnStatus_anyOf_i1"></a>9.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
 | **Type**     | `null` |
 | **Required** | No     |
 
-## <a name="deliveryType"></a>9. Property `deliveryType`
+## <a name="deliveryType"></a>10. Property `deliveryType`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -451,7 +479,7 @@ Must be one of:
 | [delivery-type](#deliveryType_anyOf_i0) |
 | [item 1](#deliveryType_anyOf_i1)        |
 
-### <a name="deliveryType_anyOf_i0"></a>9.1. Property `delivery-type`
+### <a name="deliveryType_anyOf_i0"></a>10.1. Property `delivery-type`
 
 |                |                             |
 | -------------- | --------------------------- |
@@ -466,7 +494,7 @@ Must be one of:
 * "PICK_UP"
 * "DELIVERY"
 
-### <a name="deliveryType_anyOf_i1"></a>9.2. Property `item 1`
+### <a name="deliveryType_anyOf_i1"></a>10.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -477,7 +505,7 @@ Must be one of:
 Drives whether fulfillmentStatus is relevant. ON_SITE and PICK_UP orders typically have no fulfillmentStatus.
 :::
 
-## <a name="paymentMethod"></a>10. Property `paymentMethod`
+## <a name="paymentMethod"></a>11. Property `paymentMethod`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -492,7 +520,7 @@ Drives whether fulfillmentStatus is relevant. ON_SITE and PICK_UP orders typical
 | [payment-method](#paymentMethod_anyOf_i0) |
 | [item 1](#paymentMethod_anyOf_i1)         |
 
-### <a name="paymentMethod_anyOf_i0"></a>10.1. Property `payment-method`
+### <a name="paymentMethod_anyOf_i0"></a>11.1. Property `payment-method`
 
 |                |                              |
 | -------------- | ---------------------------- |
@@ -514,14 +542,14 @@ Must be one of:
 * "STRIPE"
 * "OTHER"
 
-### <a name="paymentMethod_anyOf_i1"></a>10.2. Property `item 1`
+### <a name="paymentMethod_anyOf_i1"></a>11.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
 | **Type**     | `null` |
 | **Required** | No     |
 
-## <a name="invoiceId"></a>11. Property `invoiceId`
+## <a name="invoiceId"></a>12. Property `invoiceId`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -530,7 +558,7 @@ Must be one of:
 
 **Description:** FK → Invoice document ID.
 
-## <a name="customerId"></a>12. Property `customerId`
+## <a name="customerId"></a>13. Property `customerId`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -539,7 +567,7 @@ Must be one of:
 
 **Description:** FK → Customer.id (Firestore doc ID). Used to resolve customer details.
 
-## <a name="customerName"></a>13. Property `customerName`
+## <a name="customerName"></a>14. Property `customerName`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -548,7 +576,7 @@ Must be one of:
 
 **Description:** (Denormalized) From Customer.name at write time.
 
-## <a name="customerEmail"></a>14. Property `customerEmail`
+## <a name="customerEmail"></a>15. Property `customerEmail`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -557,7 +585,7 @@ Must be one of:
 
 **Description:** (Denormalized) From Customer.email at write time. Canonical field per D24.
 
-## <a name="customerPhone"></a>15. Property `customerPhone`
+## <a name="customerPhone"></a>16. Property `customerPhone`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -566,7 +594,7 @@ Must be one of:
 
 **Description:** (Denormalized) From Customer.phone at write time. Canonical field per D24.
 
-## <a name="clientEmail"></a>16. Property `clientEmail`
+## <a name="clientEmail"></a>17. Property `clientEmail`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -583,7 +611,7 @@ This field is deprecated. Do not write it in new code.
 Use `customerEmail` instead.
 :::
 
-## <a name="clientPhoneNumber"></a>17. Property `clientPhoneNumber`
+## <a name="clientPhoneNumber"></a>18. Property `clientPhoneNumber`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -600,7 +628,7 @@ This field is deprecated. Do not write it in new code.
 Use `customerPhone` instead.
 :::
 
-## <a name="items"></a>18. Property `items`
+## <a name="items"></a>19. Property `items`
 
 |              |                 |
 | ------------ | --------------- |
@@ -619,7 +647,7 @@ Use `customerPhone` instead.
 | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [order-item](#items_items)      | Line item within an Order or Sale/Purchase. Canonical fields: name, quantity, price, productId. Optional commerce fields (increment, variantId, supplierId, supplierName) and kitchen tracking fields (sentAt, startedCookingAt, readyAt, servedAt) are TBD/WIP pending cross-platform alignment. |
 
-### <a name="items_items"></a>18.1. order-item
+### <a name="items_items"></a>19.1. order-item
 
 |                           |                          |
 | ------------------------- | ------------------------ |
@@ -645,7 +673,7 @@ Use `customerPhone` instead.
 | - [readyAt](#items_items_readyAt )                   | No      | object | No         | -          | (Read-only) Timestamp when the item was ready for pickup or service. TBD/WIP — archived CBL flow. |
 | - [servedAt](#items_items_servedAt )                 | No      | object | No         | -          | (Read-only) Timestamp when the item was served to the customer. TBD/WIP — archived CBL flow.      |
 
-#### <a name="items_items_name"></a>18.1.1. Property `name`
+#### <a name="items_items_name"></a>19.1.1. Property `name`
 
 |              |          |
 | ------------ | -------- |
@@ -654,7 +682,7 @@ Use `customerPhone` instead.
 
 **Description:** Display name of the product or service.
 
-#### <a name="items_items_quantity"></a>18.1.2. Property `quantity`
+#### <a name="items_items_quantity"></a>19.1.2. Property `quantity`
 
 |              |          |
 | ------------ | -------- |
@@ -663,7 +691,7 @@ Use `customerPhone` instead.
 
 **Description:** Number of units ordered.
 
-#### <a name="items_items_price"></a>18.1.3. Property `price`
+#### <a name="items_items_price"></a>19.1.3. Property `price`
 
 |              |          |
 | ------------ | -------- |
@@ -672,7 +700,7 @@ Use `customerPhone` instead.
 
 **Description:** Unit price. Canonical name per D11.
 
-#### <a name="items_items_productId"></a>18.1.4. Property `productId`
+#### <a name="items_items_productId"></a>19.1.4. Property `productId`
 
 |              |          |
 | ------------ | -------- |
@@ -681,7 +709,7 @@ Use `customerPhone` instead.
 
 **Description:** FK → Product document ID.
 
-#### <a name="items_items_increment"></a>18.1.5. Property `increment`
+#### <a name="items_items_increment"></a>19.1.5. Property `increment`
 
 |              |          |
 | ------------ | -------- |
@@ -690,7 +718,7 @@ Use `customerPhone` instead.
 
 **Description:** Quantity step for bundle/bulk items (e.g. 5 for a 5-pack). Dashboard/Firebase only.
 
-#### <a name="items_items_variantId"></a>18.1.6. Property `variantId`
+#### <a name="items_items_variantId"></a>19.1.6. Property `variantId`
 
 |              |          |
 | ------------ | -------- |
@@ -699,7 +727,7 @@ Use `customerPhone` instead.
 
 **Description:** FK → ProductVariant ID within the product. Dashboard/Firebase only.
 
-#### <a name="items_items_supplierId"></a>18.1.7. Property `supplierId`
+#### <a name="items_items_supplierId"></a>19.1.7. Property `supplierId`
 
 |              |          |
 | ------------ | -------- |
@@ -708,7 +736,7 @@ Use `customerPhone` instead.
 
 **Description:** FK → Supplier document ID. B2B orders only.
 
-#### <a name="items_items_supplierName"></a>18.1.8. Property `supplierName`
+#### <a name="items_items_supplierName"></a>19.1.8. Property `supplierName`
 
 |              |          |
 | ------------ | -------- |
@@ -717,7 +745,7 @@ Use `customerPhone` instead.
 
 **Description:** (Denormalized) From Supplier.name at write time. B2B orders only.
 
-#### <a name="items_items_sentAt"></a>18.1.9. Property `sentAt`
+#### <a name="items_items_sentAt"></a>19.1.9. Property `sentAt`
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -732,7 +760,7 @@ Use `customerPhone` instead.
 | + [_seconds](#items_items_sentAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#items_items_sentAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-##### <a name="items_items_sentAt__seconds"></a>18.1.9.1. Property `_seconds`
+##### <a name="items_items_sentAt__seconds"></a>19.1.9.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -744,7 +772,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-##### <a name="items_items_sentAt__nanoseconds"></a>18.1.9.2. Property `_nanoseconds`
+##### <a name="items_items_sentAt__nanoseconds"></a>19.1.9.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -756,7 +784,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-#### <a name="items_items_startedCookingAt"></a>18.1.10. Property `startedCookingAt`
+#### <a name="items_items_startedCookingAt"></a>19.1.10. Property `startedCookingAt`
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -771,7 +799,7 @@ Use `customerPhone` instead.
 | + [_seconds](#items_items_startedCookingAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#items_items_startedCookingAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-##### <a name="items_items_startedCookingAt__seconds"></a>18.1.10.1. Property `_seconds`
+##### <a name="items_items_startedCookingAt__seconds"></a>19.1.10.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -783,7 +811,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-##### <a name="items_items_startedCookingAt__nanoseconds"></a>18.1.10.2. Property `_nanoseconds`
+##### <a name="items_items_startedCookingAt__nanoseconds"></a>19.1.10.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -795,7 +823,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-#### <a name="items_items_readyAt"></a>18.1.11. Property `readyAt`
+#### <a name="items_items_readyAt"></a>19.1.11. Property `readyAt`
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -810,7 +838,7 @@ Use `customerPhone` instead.
 | + [_seconds](#items_items_readyAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#items_items_readyAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-##### <a name="items_items_readyAt__seconds"></a>18.1.11.1. Property `_seconds`
+##### <a name="items_items_readyAt__seconds"></a>19.1.11.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -822,7 +850,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-##### <a name="items_items_readyAt__nanoseconds"></a>18.1.11.2. Property `_nanoseconds`
+##### <a name="items_items_readyAt__nanoseconds"></a>19.1.11.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -834,7 +862,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-#### <a name="items_items_servedAt"></a>18.1.12. Property `servedAt`
+#### <a name="items_items_servedAt"></a>19.1.12. Property `servedAt`
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -849,7 +877,7 @@ Use `customerPhone` instead.
 | + [_seconds](#items_items_servedAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#items_items_servedAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-##### <a name="items_items_servedAt__seconds"></a>18.1.12.1. Property `_seconds`
+##### <a name="items_items_servedAt__seconds"></a>19.1.12.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -861,7 +889,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-##### <a name="items_items_servedAt__nanoseconds"></a>18.1.12.2. Property `_nanoseconds`
+##### <a name="items_items_servedAt__nanoseconds"></a>19.1.12.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -873,7 +901,7 @@ Use `customerPhone` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-## <a name="amount"></a>19. Property `amount`
+## <a name="amount"></a>20. Property `amount`
 
 |              |          |
 | ------------ | -------- |
@@ -882,7 +910,7 @@ Use `customerPhone` instead.
 
 **Description:** Total order amount. Canonical field for the order total.
 
-## <a name="amountPaid"></a>20. Property `amountPaid`
+## <a name="amountPaid"></a>21. Property `amountPaid`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -891,7 +919,7 @@ Use `customerPhone` instead.
 
 **Description:** Amount of `amount` paid to date. Derived from payment allocations.
 
-## <a name="total"></a>21. Property `total`
+## <a name="total"></a>22. Property `total`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -912,7 +940,7 @@ Sent by Mobile only. Mirrors `amount`. Use `amount` for all new writes. Pending
 Use `amount` instead.
 :::
 
-## <a name="createdAt"></a>22. Property `createdAt`
+## <a name="createdAt"></a>23. Property `createdAt`
 
 |                           |                                   |
 | ------------------------- | --------------------------------- |
@@ -928,7 +956,7 @@ Use `amount` instead.
 | + [_seconds](#createdAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#createdAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-### <a name="createdAt__seconds"></a>22.1. Property `_seconds`
+### <a name="createdAt__seconds"></a>23.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -940,7 +968,7 @@ Use `amount` instead.
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-### <a name="createdAt__nanoseconds"></a>22.2. Property `_nanoseconds`
+### <a name="createdAt__nanoseconds"></a>23.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -956,7 +984,7 @@ Use `amount` instead.
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="orderDate"></a>23. Property `orderDate`
+## <a name="orderDate"></a>24. Property `orderDate`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -967,7 +995,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-## <a name="PROCESSING_ON"></a>24. Property `PROCESSING_ON`
+## <a name="PROCESSING_ON"></a>25. Property `PROCESSING_ON`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -982,7 +1010,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#PROCESSING_ON_anyOf_i0) |
 | [item 1](#PROCESSING_ON_anyOf_i1)              |
 
-### <a name="PROCESSING_ON_anyOf_i0"></a>24.1. Property `firestore-timestamp`
+### <a name="PROCESSING_ON_anyOf_i0"></a>25.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -993,7 +1021,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="PROCESSING_ON_anyOf_i1"></a>24.2. Property `item 1`
+### <a name="PROCESSING_ON_anyOf_i1"></a>25.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1013,7 +1041,7 @@ Never write this field directly. The server sets it automatically on status tran
 **Migrations:** `MIG-01`
 :::
 
-## <a name="COMPLETED_ON"></a>25. Property `COMPLETED_ON`
+## <a name="COMPLETED_ON"></a>26. Property `COMPLETED_ON`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1028,7 +1056,7 @@ Never write this field directly. The server sets it automatically on status tran
 | [firestore-timestamp](#COMPLETED_ON_anyOf_i0) |
 | [item 1](#COMPLETED_ON_anyOf_i1)              |
 
-### <a name="COMPLETED_ON_anyOf_i0"></a>25.1. Property `firestore-timestamp`
+### <a name="COMPLETED_ON_anyOf_i0"></a>26.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1039,7 +1067,7 @@ Never write this field directly. The server sets it automatically on status tran
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="COMPLETED_ON_anyOf_i1"></a>25.2. Property `item 1`
+### <a name="COMPLETED_ON_anyOf_i1"></a>26.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1050,7 +1078,7 @@ Never write this field directly. The server sets it automatically on status tran
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="CANCELLED_ON"></a>26. Property `CANCELLED_ON`
+## <a name="CANCELLED_ON"></a>27. Property `CANCELLED_ON`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1065,7 +1093,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#CANCELLED_ON_anyOf_i0) |
 | [item 1](#CANCELLED_ON_anyOf_i1)              |
 
-### <a name="CANCELLED_ON_anyOf_i0"></a>26.1. Property `firestore-timestamp`
+### <a name="CANCELLED_ON_anyOf_i0"></a>27.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1076,7 +1104,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="CANCELLED_ON_anyOf_i1"></a>26.2. Property `item 1`
+### <a name="CANCELLED_ON_anyOf_i1"></a>27.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1087,28 +1115,28 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="cancellationReason"></a>27. Property `cancellationReason`
+## <a name="cancellationReason"></a>28. Property `cancellationReason`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="shippingCarrier"></a>28. Property `shippingCarrier`
+## <a name="shippingCarrier"></a>29. Property `shippingCarrier`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="trackingNumber"></a>29. Property `trackingNumber`
+## <a name="trackingNumber"></a>30. Property `trackingNumber`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="estimatedDeliveryDate"></a>30. Property `estimatedDeliveryDate`
+## <a name="estimatedDeliveryDate"></a>31. Property `estimatedDeliveryDate`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1123,7 +1151,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#estimatedDeliveryDate_anyOf_i0) |
 | [item 1](#estimatedDeliveryDate_anyOf_i1)              |
 
-### <a name="estimatedDeliveryDate_anyOf_i0"></a>30.1. Property `firestore-timestamp`
+### <a name="estimatedDeliveryDate_anyOf_i0"></a>31.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1134,21 +1162,21 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="estimatedDeliveryDate_anyOf_i1"></a>30.2. Property `item 1`
+### <a name="estimatedDeliveryDate_anyOf_i1"></a>31.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
 | **Type**     | `null` |
 | **Required** | No     |
 
-## <a name="shippingCost"></a>31. Property `shippingCost`
+## <a name="shippingCost"></a>32. Property `shippingCost`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `number or null` |
 | **Required** | No               |
 
-## <a name="paymentProofUrl"></a>32. Property `paymentProofUrl`
+## <a name="paymentProofUrl"></a>33. Property `paymentProofUrl`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -1157,7 +1185,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** URL to uploaded payment proof image/document.
 
-## <a name="paymentProofStatus"></a>33. Property `paymentProofStatus`
+## <a name="paymentProofStatus"></a>34. Property `paymentProofStatus`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1172,7 +1200,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [payment-proof-status](#paymentProofStatus_anyOf_i0) |
 | [item 1](#paymentProofStatus_anyOf_i1)               |
 
-### <a name="paymentProofStatus_anyOf_i0"></a>33.1. Property `payment-proof-status`
+### <a name="paymentProofStatus_anyOf_i0"></a>34.1. Property `payment-proof-status`
 
 |                |                                    |
 | -------------- | ---------------------------------- |
@@ -1187,14 +1215,14 @@ Must be one of:
 * "APPROVED"
 * "REJECTED"
 
-### <a name="paymentProofStatus_anyOf_i1"></a>33.2. Property `item 1`
+### <a name="paymentProofStatus_anyOf_i1"></a>34.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
 | **Type**     | `null` |
 | **Required** | No     |
 
-## <a name="paymentProofAddedAt"></a>34. Property `paymentProofAddedAt`
+## <a name="paymentProofAddedAt"></a>35. Property `paymentProofAddedAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1209,7 +1237,7 @@ Must be one of:
 | [firestore-timestamp](#paymentProofAddedAt_anyOf_i0) |
 | [item 1](#paymentProofAddedAt_anyOf_i1)              |
 
-### <a name="paymentProofAddedAt_anyOf_i0"></a>34.1. Property `firestore-timestamp`
+### <a name="paymentProofAddedAt_anyOf_i0"></a>35.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1220,7 +1248,7 @@ Must be one of:
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="paymentProofAddedAt_anyOf_i1"></a>34.2. Property `item 1`
+### <a name="paymentProofAddedAt_anyOf_i1"></a>35.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1231,7 +1259,7 @@ Must be one of:
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="paymentProofAddedBy"></a>35. Property `paymentProofAddedBy`
+## <a name="paymentProofAddedBy"></a>36. Property `paymentProofAddedBy`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -1240,7 +1268,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** FK → User/staff UID who uploaded the payment proof.
 
-## <a name="paymentProofReviewedAt"></a>36. Property `paymentProofReviewedAt`
+## <a name="paymentProofReviewedAt"></a>37. Property `paymentProofReviewedAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1255,7 +1283,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#paymentProofReviewedAt_anyOf_i0) |
 | [item 1](#paymentProofReviewedAt_anyOf_i1)              |
 
-### <a name="paymentProofReviewedAt_anyOf_i0"></a>36.1. Property `firestore-timestamp`
+### <a name="paymentProofReviewedAt_anyOf_i0"></a>37.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1266,7 +1294,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="paymentProofReviewedAt_anyOf_i1"></a>36.2. Property `item 1`
+### <a name="paymentProofReviewedAt_anyOf_i1"></a>37.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1277,7 +1305,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="paymentProofReviewedBy"></a>37. Property `paymentProofReviewedBy`
+## <a name="paymentProofReviewedBy"></a>38. Property `paymentProofReviewedBy`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -1286,21 +1314,21 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** FK → User/staff UID who reviewed the payment proof.
 
-## <a name="paymentProofRejectionReason"></a>38. Property `paymentProofRejectionReason`
+## <a name="paymentProofRejectionReason"></a>39. Property `paymentProofRejectionReason`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="paymentStatusChangeReason"></a>39. Property `paymentStatusChangeReason`
+## <a name="paymentStatusChangeReason"></a>40. Property `paymentStatusChangeReason`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="paymentStatusChangedBy"></a>40. Property `paymentStatusChangedBy`
+## <a name="paymentStatusChangedBy"></a>41. Property `paymentStatusChangedBy`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -1309,7 +1337,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** FK → User/staff UID who changed payment status.
 
-## <a name="paymentStatusChangedAt"></a>41. Property `paymentStatusChangedAt`
+## <a name="paymentStatusChangedAt"></a>42. Property `paymentStatusChangedAt`
 
 |                           |                  |
 | ------------------------- | ---------------- |
@@ -1324,7 +1352,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | [firestore-timestamp](#paymentStatusChangedAt_anyOf_i0) |
 | [item 1](#paymentStatusChangedAt_anyOf_i1)              |
 
-### <a name="paymentStatusChangedAt_anyOf_i0"></a>41.1. Property `firestore-timestamp`
+### <a name="paymentStatusChangedAt_anyOf_i0"></a>42.1. Property `firestore-timestamp`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1335,7 +1363,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Firestore Timestamp serialized representation
 
-### <a name="paymentStatusChangedAt_anyOf_i1"></a>41.2. Property `item 1`
+### <a name="paymentStatusChangedAt_anyOf_i1"></a>42.2. Property `item 1`
 
 |              |        |
 | ------------ | ------ |
@@ -1346,7 +1374,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
 :::
 
-## <a name="payments"></a>42. Property `payments`
+## <a name="payments"></a>43. Property `payments`
 
 |              |                           |
 | ------------ | ------------------------- |
@@ -1367,7 +1395,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | [payments items](#payments_items) | [TBD/WIP — IG-4] Denormalized payment snapshot. Subset of CustomerPayment (D22), written when a payment is allocated to this order. Sync rules pending IG-4 resolution. |
 
-### <a name="payments_items"></a>42.1. payments items
+### <a name="payments_items"></a>43.1. payments items
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -1387,7 +1415,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | - [referenceNumber](#payments_items_referenceNumber ) | No      | string           | No         | -                                                          | Payment reference (receipt number, transaction ID, etc.).                           |
 | + [status](#payments_items_status )                   | No      | enum (of string) | No         | In #/definitions/customer-payment-status                   | Payment status at time of snapshot. May lag CustomerPayment.status until re-synced. |
 
-#### <a name="payments_items_paymentId"></a>42.1.1. Property `paymentId`
+#### <a name="payments_items_paymentId"></a>43.1.1. Property `paymentId`
 
 |              |          |
 | ------------ | -------- |
@@ -1396,7 +1424,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** (Immutable) FK → CustomerPayment.id. Source document for this snapshot.
 
-#### <a name="payments_items_amount"></a>42.1.2. Property `amount`
+#### <a name="payments_items_amount"></a>43.1.2. Property `amount`
 
 |              |          |
 | ------------ | -------- |
@@ -1405,7 +1433,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 **Description:** Total payment amount.
 
-#### <a name="payments_items_currency"></a>42.1.3. Property `currency`
+#### <a name="payments_items_currency"></a>43.1.3. Property `currency`
 
 |              |         |
 | ------------ | ------- |
@@ -1416,7 +1444,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 
 Specific value: `"XOF"`
 
-#### <a name="payments_items_paymentMethod"></a>42.1.4. Property `paymentMethod`
+#### <a name="payments_items_paymentMethod"></a>43.1.4. Property `paymentMethod`
 
 |                        |                                                   |
 | ---------------------- | ------------------------------------------------- |
@@ -1426,7 +1454,7 @@ Specific value: `"XOF"`
 
 **Description:** Payment method used (D02).
 
-#### <a name="payments_items_paymentDate"></a>42.1.5. Property `paymentDate`
+#### <a name="payments_items_paymentDate"></a>43.1.5. Property `paymentDate`
 
 |                           |                         |
 | ------------------------- | ----------------------- |
@@ -1437,7 +1465,7 @@ Specific value: `"XOF"`
 
 **Description:** Firestore Timestamp serialized representation
 
-#### <a name="payments_items_referenceNumber"></a>42.1.6. Property `referenceNumber`
+#### <a name="payments_items_referenceNumber"></a>43.1.6. Property `referenceNumber`
 
 |              |          |
 | ------------ | -------- |
@@ -1446,7 +1474,7 @@ Specific value: `"XOF"`
 
 **Description:** Payment reference (receipt number, transaction ID, etc.).
 
-#### <a name="payments_items_status"></a>42.1.7. Property `status`
+#### <a name="payments_items_status"></a>43.1.7. Property `status`
 
 |                |                                       |
 | -------------- | ------------------------------------- |
@@ -1472,7 +1500,7 @@ Shape and sync rules are TBD pending IG-4 resolution. Do not build production lo
 **Issues:** `IG-4`
 :::
 
-## <a name="totalOverridden"></a>43. Property `totalOverridden`
+## <a name="totalOverridden"></a>44. Property `totalOverridden`
 
 |              |                   |
 | ------------ | ----------------- |
@@ -1489,7 +1517,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 **Decisions:** `D14`
 :::
 
-## <a name="notes"></a>44. Property `notes`
+## <a name="notes"></a>45. Property `notes`
 
 |              |                           |
 | ------------ | ------------------------- |
@@ -1508,7 +1536,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 | ------------------------------- | -------------------------------------- |
 | [notes items](#notes_items)     | Timestamped note attached to an Order. |
 
-### <a name="notes_items"></a>44.1. notes items
+### <a name="notes_items"></a>45.1. notes items
 
 |                           |             |
 | ------------------------- | ----------- |
@@ -1526,7 +1554,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 | - [createdBy](#notes_items_createdBy )         | No      | string | No         | -                                    | (Immutable) FK → User/staff UID who created this note.     |
 | - [createdByName](#notes_items_createdByName ) | No      | string | No         | -                                    | (Denormalized) From User display name at write time.       |
 
-#### <a name="notes_items_id"></a>44.1.1. Property `id`
+#### <a name="notes_items_id"></a>45.1.1. Property `id`
 
 |              |          |
 | ------------ | -------- |
@@ -1535,14 +1563,14 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 
 **Description:** (Read-only) Note ID. Server-generated.
 
-#### <a name="notes_items_text"></a>44.1.2. Property `text`
+#### <a name="notes_items_text"></a>45.1.2. Property `text`
 
 |              |          |
 | ------------ | -------- |
 | **Type**     | `string` |
 | **Required** | Yes      |
 
-#### <a name="notes_items_createdAt"></a>44.1.3. Property `createdAt`
+#### <a name="notes_items_createdAt"></a>45.1.3. Property `createdAt`
 
 |                           |                                   |
 | ------------------------- | --------------------------------- |
@@ -1558,7 +1586,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 | + [_seconds](#createdAt__seconds )         | No      | integer | No         | -          | -                 |
 | + [_nanoseconds](#createdAt__nanoseconds ) | No      | integer | No         | -          | -                 |
 
-##### <a name="createdAt__seconds"></a>44.1.3.1. Property `_seconds`
+##### <a name="createdAt__seconds"></a>45.1.3.1. Property `_seconds`
 
 |              |           |
 | ------------ | --------- |
@@ -1570,7 +1598,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-##### <a name="createdAt__nanoseconds"></a>44.1.3.2. Property `_nanoseconds`
+##### <a name="createdAt__nanoseconds"></a>45.1.3.2. Property `_nanoseconds`
 
 |              |           |
 | ------------ | --------- |
@@ -1582,7 +1610,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 | **Minimum**  | &ge; -9007199254740991 |
 | **Maximum**  | &le; 9007199254740991  |
 
-#### <a name="notes_items_createdBy"></a>44.1.4. Property `createdBy`
+#### <a name="notes_items_createdBy"></a>45.1.4. Property `createdBy`
 
 |              |          |
 | ------------ | -------- |
@@ -1591,7 +1619,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 
 **Description:** (Immutable) FK → User/staff UID who created this note.
 
-#### <a name="notes_items_createdByName"></a>44.1.5. Property `createdByName`
+#### <a name="notes_items_createdByName"></a>45.1.5. Property `createdByName`
 
 |              |          |
 | ------------ | -------- |
@@ -1600,21 +1628,21 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 
 **Description:** (Denormalized) From User display name at write time.
 
-## <a name="additionalInfo"></a>45. Property `additionalInfo`
+## <a name="additionalInfo"></a>46. Property `additionalInfo`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="appliedDiscountCode"></a>46. Property `appliedDiscountCode`
+## <a name="appliedDiscountCode"></a>47. Property `appliedDiscountCode`
 
 |              |                  |
 | ------------ | ---------------- |
 | **Type**     | `string or null` |
 | **Required** | No               |
 
-## <a name="purchaseId"></a>47. Property `purchaseId`
+## <a name="purchaseId"></a>48. Property `purchaseId`
 
 |              |                  |
 | ------------ | ---------------- |
@@ -1624,7 +1652,7 @@ Set only by the mobile app when the user manually edits the order total. Dashboa
 **Description:** FK → Sale.id. Link to associated Sale document.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-18 at 21:21:09 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-05 at 12:09:28 +0000
 
 ## Related Decisions