platform-types 1.10.731 → 1.10.733

package/dist/audit.d.ts

@@ -161,7 +161,10 @@ declare global {
      * A seña leg was recorded (`POST /orders { mode: 'deposit' }`; an absorbed
      * replay writes none). `after`: `tenderIds`, net `amount`, the order's
      * `currency`, `freezesPrice`, the applied factura's `invoiceId` when it
-     * freezes, and `financialStatus`.
+     * freezes, and `financialStatus`. A freezing seña's `invoiceId` is absent
+     * only when the freeze was taken while the store's
+     * `config.modules.fiscalInvoicing` was `false` over an order carrying no
+     * live voucher — that freeze records no factura.
      */
      | 'deposit_recorded'
     /**

package/dist/cash.d.ts

@@ -511,12 +511,16 @@ declare global {
  * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
  *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
+ * - `STORE_MODULE_DISABLED` · 403 — `POST /shifts` (open) while the store has
+ *   `modules.cash` off; `data.module` is `'cash'` (`StoreModuleDisabledData`)
+ *   and nothing is written. Close, movements, reconcile and reads of a shift
+ *   already open stay reachable.
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
  * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
  * elevation.
  */
-export declare const SHIFT_ERROR_CODES: readonly ["INVALID_SHIFT_ID", "SHIFT_NOT_FOUND", "SHIFT_ALREADY_OPEN", "SHIFT_NOT_OPEN", "SHIFT_NOT_CLOSED", "SHIFT_OWNER_MISMATCH", "CURRENCY_MISMATCH", "BUCKET_COUNTS_INVALID", "BUCKET_REVIEW_INVALID", "BUCKET_COUNT_MISSING", "SHIFT_CHANGED", "SHIFT_EVENTS_TRUNCATED", "CASH_DRAWER_BUSY", "SELF_APPROVAL_FORBIDDEN", "INVALID_DENOMINATION", "INVALID_CURSOR", "WAREHOUSE_NOT_FOUND", "ROLE_FORBIDDEN", "VALIDATION_FAILED"];
+export declare const SHIFT_ERROR_CODES: readonly ["INVALID_SHIFT_ID", "SHIFT_NOT_FOUND", "SHIFT_ALREADY_OPEN", "SHIFT_NOT_OPEN", "SHIFT_NOT_CLOSED", "SHIFT_OWNER_MISMATCH", "CURRENCY_MISMATCH", "BUCKET_COUNTS_INVALID", "BUCKET_REVIEW_INVALID", "BUCKET_COUNT_MISSING", "SHIFT_CHANGED", "SHIFT_EVENTS_TRUNCATED", "CASH_DRAWER_BUSY", "SELF_APPROVAL_FORBIDDEN", "INVALID_DENOMINATION", "INVALID_CURSOR", "WAREHOUSE_NOT_FOUND", "ROLE_FORBIDDEN", "VALIDATION_FAILED", "STORE_MODULE_DISABLED"];
 export type ShiftErrorCode = (typeof SHIFT_ERROR_CODES)[number];
 /**
  * Where a {@link ShiftMethodTotal}'s `label` came from.

package/dist/cash.js

@@ -37,6 +37,10 @@
  * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
  *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
+ * - `STORE_MODULE_DISABLED` · 403 — `POST /shifts` (open) while the store has
+ *   `modules.cash` off; `data.module` is `'cash'` (`StoreModuleDisabledData`)
+ *   and nothing is written. Close, movements, reconcile and reads of a shift
+ *   already open stay reachable.
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
  * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
@@ -62,6 +66,9 @@ export const SHIFT_ERROR_CODES = [
     'WAREHOUSE_NOT_FOUND',
     'ROLE_FORBIDDEN',
     'VALIDATION_FAILED',
+    // Opening a shift while the store has `modules.cash` off; its `data` is
+    // `StoreModuleDisabledData` (`StoreModuleRefusalBody` types the whole body).
+    'STORE_MODULE_DISABLED',
 ];
 /**
  * Where a {@link ShiftMethodTotal}'s `label` came from.

package/dist/cjs/cash.js

@@ -40,6 +40,10 @@ exports.METHOD_LABEL_SOURCES = exports.SHIFT_ERROR_CODES = void 0;
  * - `WAREHOUSE_NOT_FOUND` · 404 — `GET /shifts?warehouseId=` naming a depósito
  *   the store does not have (`resolveReportWarehouseFilter`).
  * - `ROLE_FORBIDDEN` · 403 · `VALIDATION_FAILED` · 400
+ * - `STORE_MODULE_DISABLED` · 403 — `POST /shifts` (open) while the store has
+ *   `modules.cash` off; `data.module` is `'cash'` (`StoreModuleDisabledData`)
+ *   and nothing is written. Close, movements, reconcile and reads of a shift
+ *   already open stay reachable.
  *
  * ⚠️ Cross-cutting refusals are NOT repeated here — check `GATING_ERROR_CODES`
  * as well, and `TERMINAL_ELEVATION_ERROR_CODES` for a money-out movement's PIN
@@ -65,6 +69,9 @@ exports.SHIFT_ERROR_CODES = [
     'WAREHOUSE_NOT_FOUND',
     'ROLE_FORBIDDEN',
     'VALIDATION_FAILED',
+    // Opening a shift while the store has `modules.cash` off; its `data` is
+    // `StoreModuleDisabledData` (`StoreModuleRefusalBody` types the whole body).
+    'STORE_MODULE_DISABLED',
 ];
 /**
  * Where a {@link ShiftMethodTotal}'s `label` came from.

package/dist/cjs/order.js

@@ -229,12 +229,23 @@ exports.orderFulfilmentProgress = orderFulfilmentProgress;
  *   `DEPOSIT_EXCEEDS_TOTAL` · 409 · `DEPOSIT_FREEZE_REQUIRES_INVOICE` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_PENDING` · 409 · `DEPOSIT_INVOICED_ORDER_MUST_FREEZE`
- *   · 409 · `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
+ *   · 409 · `DEPOSIT_FROZEN_ORDER_MUST_FREEZE` · 409 ·
+ *   `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
  *   `DEPOSIT_REFERENCE_IS_LINKED_PAYMENT` · 409 · `DEPOSIT_DUPLICATE_REFERENCE` ·
  *   409 — `mode: 'deposit'`, see `OrderDepositRequest`. `DEPOSIT_EXCEEDS_TOTAL`
  *   is also `mode: 'edit'`'s and the update leg's answer to a re-price that
  *   would leave the order's net señas above its new charged total. Nothing was
  *   written on any of them.
+ * - `ORDER_PRICE_FROZEN` · 409 — `mode: 'edit'`, or a `discount` change on the
+ *   update leg, whose new charged total differs from the stored one on an order
+ *   still holding an unrefunded seña that froze the price with NO factura (taken
+ *   while `config.modules.fiscalInvoicing` was `false`). `data: { orderId }`.
+ *   An edit that leaves the charged total unchanged still lands; giving that
+ *   seña back (`mode: 'deposit-refund'`) lifts it. It is a refusal, not an
+ *   `OrderLockReason`: the lock matrix is unchanged. A freeze applied to a
+ *   factura answers that factura's own refusals instead (`ORDER_LOCKED`
+ *   `invoiced` on an edit, `ORDER_DISCOUNT_AFTER_INVOICE` on the update leg).
+ *   Nothing was written.
  * - `TILL_TENDER_REQUIRES_DEPOSIT` · 400 — `mode: 'tender'` adding till money
  *   (any leg whose `source` is not `account`) to an order that is NOT yet
  *   delivered and holds no seña: money taken before delivery is a seña and
@@ -557,6 +568,8 @@ exports.ORDER_ERROR_CODES = [
     'DEPOSIT_CHARACTERIZATION_CONFLICT',
     'DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING',
     'DEPOSIT_INVOICED_ORDER_MUST_FREEZE',
+    // A non-freezing seña on an order already holding a seña frozen with no factura.
+    'DEPOSIT_FROZEN_ORDER_MUST_FREEZE',
     'DEPOSIT_REFERENCE_IS_LINKED_PAYMENT',
     'DEPOSIT_DUPLICATE_REFERENCE',
     // Till money on an undelivered order with no seña — `mode: 'deposit'` takes it.
@@ -565,6 +578,8 @@ exports.ORDER_ERROR_CODES = [
     'PAYMENT_REFERENCED_BY_DEPOSIT',
     // Customer cancellation of an order still holding a seña.
     'ORDER_HAS_UNREFUNDED_DEPOSIT',
+    // A re-price moving the charged total of an order a seña froze with no factura.
+    'ORDER_PRICE_FROZEN',
     // `POST /orders { mode: 'deposit-refund' }` — see `OrderDepositRefundRequest`.
     'DEPOSIT_NOT_FOUND',
     'DEPOSIT_ALREADY_REFUNDED',

package/dist/cjs/store.js

@@ -71,10 +71,14 @@ exports.isStoreModuleOn = isStoreModuleOn;
  * - `STORE_MODULE_BALANCE_CHECK_INCOMPLETE` (409) — the bounded balance read
  *   stopped before it could prove every balance is zero. Retrying is harmless but
  *   walks the same rows, so a very large customer book keeps answering it.
+ * - `STORE_MODULE_SHIFTS_OPEN` (409) — `cash` off while any cash shift of the
+ *   store is still open (the default drawer is not a shift anyone closes, so it
+ *   never counts); `data.openShifts` carries the count, `data.truncated: true`
+ *   marks it as a floor (see {@link StoreModuleShiftsOpenData}).
  * - `STORE_MODULE_DISABLED` (403) — a server-enforced module is off (storefront
- *   self-booking, storefront survey); `data.module` names it. `POST /warehouses`
- *   answers it too when a create, or returning a depósito to service, would add
- *   a second active depósito while `multiWarehouse` is off
+ *   self-booking, storefront survey, opening a cash shift); `data.module` names
+ *   it. `POST /warehouses` answers it too when a create, or returning a depósito
+ *   to service, would add a second active depósito while `multiWarehouse` is off
  *   (`data.module: 'multiWarehouse'`). Always 403, and never an Action Denied row.
  */
 exports.STORE_MODULE_ERROR_CODES = [
@@ -84,5 +88,6 @@ exports.STORE_MODULE_ERROR_CODES = [
     'STORE_MODULE_TRANSFER_IN_FLIGHT',
     'STORE_MODULE_CUSTOMER_BALANCES',
     'STORE_MODULE_BALANCE_CHECK_INCOMPLETE',
+    'STORE_MODULE_SHIFTS_OPEN',
     'STORE_MODULE_DISABLED',
 ];

package/dist/cjs/terminal.js

@@ -66,7 +66,8 @@ exports.TERMINAL_ENROLMENT_ERROR_CODES = [
  *
  * - `TERMINAL_NOT_PAIRED` · 401 — the request carried no `sf_terminal` cookie,
  *   or one naming an unknown, expired or revoked terminal. Re-pair the till.
- * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift.
+ * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift,
+ *   while the store's `cash` module is on (with it off no shift is asked for).
  * - `TERMINAL_ACTIVATION_SESSION_INVALID` · 401 — the presented USER refresh
  *   credential cannot identify a signed modern family; clear delivery and sign in again.
  * - `TERMINAL_ACTIVATION_SESSION_MISMATCH` · 409 — its signed employee or store

package/dist/order.d.ts

@@ -57,6 +57,11 @@ declare global {
          * freezing SALES seña was applied to WHEN IT WAS TAKEN. On a carried
          * service receipt this copies `appliedToInvoiceId` only when recorded;
          * its absence is preserved, never inferred from `freezesPrice`.
+         * ⚠️ ABSENT on a freezing SALES seña too when it was taken while the
+         * store's `config.modules.fiscalInvoicing` was `false` over an order
+         * carrying no live voucher: that freeze records no factura. A reader
+         * prints or reasons about the freeze from `freezesPrice`, and about a
+         * factura only when this is present.
          * The factura is issued for the order's full lines and is never
          * reduced by the seña. A historical stamp: nothing re-points it
          * if a credit note later credits that factura.
@@ -1917,7 +1922,11 @@ declare global {
      * which), `409 DEPOSIT_CURRENCY_MISMATCH` (a cash seña whose drawer did not
      * declare the order's currency; the body carries `declaredCurrencies`), `409 DEPOSIT_EXCEEDS_TOTAL` (more than the order still
      * owes), `409 DEPOSIT_FREEZE_REQUIRES_INVOICE` (`freezesPrice: true` on an
-     * order carrying no live voucher at all — invoice it first), `409
+     * order carrying no live voucher at all — invoice it first; NEVER answered
+     * while the store's `config.modules.fiscalInvoicing` is `false`, where that
+     * freeze is accepted with no `invoiceId` instead — absent or unreadable
+     * modules count as on — except at commit, when fiscal invoicing was switched
+     * back on between the read and the write; nothing is booked then), `409
      * DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING` (`freezesPrice: true` where the
      * order's vouchers exist but none qualifies — a factura a credit note counts
      * as credited, a credit note still pending; invoicing again is NOT the
@@ -1925,7 +1934,10 @@ declare global {
      * `pending_cae`, for either characterization), `409
      * DEPOSIT_INVOICED_ORDER_MUST_FREEZE` (`freezesPrice: false` on an order
      * already carrying an uncredited authorized factura — the price is already
-     * fixed by it), `409 DEPOSIT_REFERENCE_IS_LINKED_PAYMENT` (the `reference` is
+     * fixed by it), `409 DEPOSIT_FROZEN_ORDER_MUST_FREEZE` (`freezesPrice: false`
+     * on an order still holding an unrefunded seña that froze the price with no
+     * factura — the price is already frozen by it), `409
+     * DEPOSIT_REFERENCE_IS_LINKED_PAYMENT` (the `reference` is
      * a payment already linked to the order) and `409
      * DEPOSIT_CHARACTERIZATION_CONFLICT` (a replay of an existing leg — a seña of
      * the other characterization, or an ordinary tender — on money, method,
@@ -1956,7 +1968,11 @@ declare global {
         reference?: string;
         /** Cash handed back — a `source: 'cash'` seña only. */
         change?: number;
-        /** Required, never defaulted. `true` needs an authorized factura on the order first. */
+        /**
+         * Required, never defaulted. `true` needs an authorized factura on the order
+         * first — except with `modules.fiscalInvoicing` off and no live voucher on
+         * the order, where it freezes with no factura.
+         */
         freezesPrice: boolean;
         /** Same semantics as {@link OrderTenderRequest.shiftId}. */
         shiftId?: string;
@@ -2500,12 +2516,23 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  *   `DEPOSIT_EXCEEDS_TOTAL` · 409 · `DEPOSIT_FREEZE_REQUIRES_INVOICE` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_PENDING` · 409 · `DEPOSIT_INVOICED_ORDER_MUST_FREEZE`
- *   · 409 · `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
+ *   · 409 · `DEPOSIT_FROZEN_ORDER_MUST_FREEZE` · 409 ·
+ *   `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
  *   `DEPOSIT_REFERENCE_IS_LINKED_PAYMENT` · 409 · `DEPOSIT_DUPLICATE_REFERENCE` ·
  *   409 — `mode: 'deposit'`, see `OrderDepositRequest`. `DEPOSIT_EXCEEDS_TOTAL`
  *   is also `mode: 'edit'`'s and the update leg's answer to a re-price that
  *   would leave the order's net señas above its new charged total. Nothing was
  *   written on any of them.
+ * - `ORDER_PRICE_FROZEN` · 409 — `mode: 'edit'`, or a `discount` change on the
+ *   update leg, whose new charged total differs from the stored one on an order
+ *   still holding an unrefunded seña that froze the price with NO factura (taken
+ *   while `config.modules.fiscalInvoicing` was `false`). `data: { orderId }`.
+ *   An edit that leaves the charged total unchanged still lands; giving that
+ *   seña back (`mode: 'deposit-refund'`) lifts it. It is a refusal, not an
+ *   `OrderLockReason`: the lock matrix is unchanged. A freeze applied to a
+ *   factura answers that factura's own refusals instead (`ORDER_LOCKED`
+ *   `invoiced` on an edit, `ORDER_DISCOUNT_AFTER_INVOICE` on the update leg).
+ *   Nothing was written.
  * - `TILL_TENDER_REQUIRES_DEPOSIT` · 400 — `mode: 'tender'` adding till money
  *   (any leg whose `source` is not `account`) to an order that is NOT yet
  *   delivered and holds no seña: money taken before delivery is a seña and
@@ -2772,6 +2799,6 @@ export declare const orderFulfilmentProgress: (order: OrderFulfilmentProgressInp
  * `SUBSCRIPTION_READONLY`) sit on the order CREATE leg only: an edit is not a new
  * order, so `bareOrderPostHandler` routes past `requireMetered` entirely.
  */
-export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "DELIVERY_METHOD_NOT_FOUND", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
+export declare const ORDER_ERROR_CODES: readonly ["ORDER_COST_DENOMINATION_UNKNOWN", "SERVICE_ORDER_DELIVERY_MANAGED", "ORDER_NOT_FOUND", "ORDER_LOCKED", "ORDER_NOT_READY", "ORDER_DELIVERED_ANOTHER_DAY", "ORDER_DELIVERY_STATE_UNCHANGED", "ORDER_ILLEGAL_TRANSITION", "ORDER_VERSION_CONFLICT", "CUSTOMER_NOT_FOUND", "CUSTOMER_MERGED", "ORDER_HAS_NO_CUSTOMER", "CUSTOMER_ANONYMIZED", "FX_CONVERSION_UNAVAILABLE", "ROLE_FORBIDDEN", "ORDER_CANCELLED", "PAYMENT_SETTLED_ON_ANOTHER_ORDER", "ORDER_HAS_SHIPMENTS", "ORDER_HAS_RETURNS", "SHIPMENT_QUANTITY_EXCEEDED", "SHIPMENT_LINE_MISMATCH", "SHIPMENT_NOT_FOUND", "SHIPMENT_LIMIT_REACHED", "SHIPMENT_TOO_LARGE", "ORDER_FULFILMENT_EXTERNAL", "SHIPMENT_FAILED", "ADMIN_REQUIRED", "IDEMPOTENCY_KEY_REQUIRED", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_IN_PROGRESS", "IDEMPOTENCY_LOCK_CONTENTION", "IDEMPOTENCY_KEY_FAILED", "IDEMPOTENT_RESPONSE_NOT_CACHED", "ORDER_CANCELLATION_NOT_PROTECTED", "ORDER_CANCELLATION_COMMITTED", "ORDER_CANCELLATION_LOCKED", "ORDER_CANCELLATION_TOO_LARGE", "ORDER_CANCELLATION_FAILED", "SALE_LEDGER_RETRACTION_REFUSED", "SALE_LEDGER_ROW_NOT_OWNED", "PRODUCT_NOT_FOUND", "PRODUCT_SALE_LIMIT_EXCEEDED", "PRODUCT_SALE_LIMIT_INVALID", "DEPOSIT_SOURCE_NOT_ALLOWED", "DEPOSIT_CURRENCY_MISMATCH", "DEPOSIT_EXCEEDS_TOTAL", "DEPOSIT_FREEZE_REQUIRES_INVOICE", "DEPOSIT_FREEZE_INVOICE_PENDING", "DEPOSIT_CHARACTERIZATION_CONFLICT", "DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING", "DEPOSIT_INVOICED_ORDER_MUST_FREEZE", "DEPOSIT_FROZEN_ORDER_MUST_FREEZE", "DEPOSIT_REFERENCE_IS_LINKED_PAYMENT", "DEPOSIT_DUPLICATE_REFERENCE", "TILL_TENDER_REQUIRES_DEPOSIT", "PAYMENT_REFERENCED_BY_DEPOSIT", "ORDER_HAS_UNREFUNDED_DEPOSIT", "ORDER_PRICE_FROZEN", "DEPOSIT_NOT_FOUND", "DEPOSIT_ALREADY_REFUNDED", "UNIT_QUANTITY_NOT_WHOLE", "UNIT_REVISION_STALE", "UNIT_QUANTITY_UNREPRESENTABLE", "KIT_RECIPE_CHANGED", "CART_PROMOTION_UNAVAILABLE", "ORDER_HAS_KIT_LINES", "ORDER_TARGET_REQUIRED", "ORDER_SOURCE_CONFLICT", "ORDER_CUSTOMER_REQUIRED", "BASKET_EMPTY", "BASKET_CHANGED_DURING_CHECKOUT", "CART_VERSION_CREATE_ONLY", "CART_VERSION_REQUIRES_CART_ID", "CART_REVISION_STALE", "CART_CUSTOMER_MISMATCH", "COUNTER_SALE_CREATE_ONLY", "SOLD_AT_CREATE_ONLY", "SOLD_AT_IN_FUTURE", "ORDER_TENDER_CREATE_ONLY", "CREDIT_OVERRIDE_CREATE_ONLY", "ON_ACCOUNT_CREATE_ONLY", "ON_ACCOUNT_WITH_TENDERS", "TENDERS_REQUIRE_COUNTER_SALE", "LINES_REQUIRE_COUNTER_SALE", "PRODUCT_COST_UNKNOWN", "PRICE_CHANGE_DISABLED", "LINE_DISCOUNT_EXCEEDS_MAX", "CUSTOMER_DISABLED", "SHIFT_NOT_AVAILABLE", "SOLD_AT_OUTSIDE_SHIFT", "ORDER_CURRENCY_NOT_SUBSCRIBED", "PAYMENT_METHODS_NOT_CONFIGURED", "PAYMENT_METHOD_NOT_FOUND", "DELIVERY_METHOD_NOT_FOUND", "ORDER_BELOW_MINIMUM_PURCHASE", "ORDER_INVALID_CART", "EMAIL_VERIFICATION_REQUIRED", "ACCOUNT_DISABLED", "CURRENCY_MISMATCH", "SHIFT_NOT_OPEN", "ORDER_DISCOUNT_AFTER_INVOICE", "ORDER_DISCOUNT_ON_SERVICE_ORDER", "ORDER_DISCOUNT_ON_MARKETPLACE_ORDER", "ORDER_INVOICE_METHOD_OUTSTANDING_FACTURA", "ORDER_SERVICE_PERIOD_AFTER_INVOICE", "ORDER_ATTEMPT_COMMITTED", "ORDER_ATTEMPT_ABANDONED", "ORDER_ATTEMPT_KEY_EXPIRED", "ORDER_ATTEMPT_KEY_SCOPE_MISMATCH", "ORDER_COMPLETION_ATTEMPT_COMMITTED", "ORDER_COMPLETION_ATTEMPT_ABANDONED"];
 export type OrderErrorCode = (typeof ORDER_ERROR_CODES)[number];
 export {};

package/dist/order.js

@@ -222,12 +222,23 @@ export const orderFulfilmentProgress = (order) => {
  *   `DEPOSIT_EXCEEDS_TOTAL` · 409 · `DEPOSIT_FREEZE_REQUIRES_INVOICE` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING` · 409 ·
  *   `DEPOSIT_FREEZE_INVOICE_PENDING` · 409 · `DEPOSIT_INVOICED_ORDER_MUST_FREEZE`
- *   · 409 · `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
+ *   · 409 · `DEPOSIT_FROZEN_ORDER_MUST_FREEZE` · 409 ·
+ *   `DEPOSIT_CHARACTERIZATION_CONFLICT` · 409 ·
  *   `DEPOSIT_REFERENCE_IS_LINKED_PAYMENT` · 409 · `DEPOSIT_DUPLICATE_REFERENCE` ·
  *   409 — `mode: 'deposit'`, see `OrderDepositRequest`. `DEPOSIT_EXCEEDS_TOTAL`
  *   is also `mode: 'edit'`'s and the update leg's answer to a re-price that
  *   would leave the order's net señas above its new charged total. Nothing was
  *   written on any of them.
+ * - `ORDER_PRICE_FROZEN` · 409 — `mode: 'edit'`, or a `discount` change on the
+ *   update leg, whose new charged total differs from the stored one on an order
+ *   still holding an unrefunded seña that froze the price with NO factura (taken
+ *   while `config.modules.fiscalInvoicing` was `false`). `data: { orderId }`.
+ *   An edit that leaves the charged total unchanged still lands; giving that
+ *   seña back (`mode: 'deposit-refund'`) lifts it. It is a refusal, not an
+ *   `OrderLockReason`: the lock matrix is unchanged. A freeze applied to a
+ *   factura answers that factura's own refusals instead (`ORDER_LOCKED`
+ *   `invoiced` on an edit, `ORDER_DISCOUNT_AFTER_INVOICE` on the update leg).
+ *   Nothing was written.
  * - `TILL_TENDER_REQUIRES_DEPOSIT` · 400 — `mode: 'tender'` adding till money
  *   (any leg whose `source` is not `account`) to an order that is NOT yet
  *   delivered and holds no seña: money taken before delivery is a seña and
@@ -550,6 +561,8 @@ export const ORDER_ERROR_CODES = [
     'DEPOSIT_CHARACTERIZATION_CONFLICT',
     'DEPOSIT_FREEZE_INVOICE_NOT_QUALIFYING',
     'DEPOSIT_INVOICED_ORDER_MUST_FREEZE',
+    // A non-freezing seña on an order already holding a seña frozen with no factura.
+    'DEPOSIT_FROZEN_ORDER_MUST_FREEZE',
     'DEPOSIT_REFERENCE_IS_LINKED_PAYMENT',
     'DEPOSIT_DUPLICATE_REFERENCE',
     // Till money on an undelivered order with no seña — `mode: 'deposit'` takes it.
@@ -558,6 +571,8 @@ export const ORDER_ERROR_CODES = [
     'PAYMENT_REFERENCED_BY_DEPOSIT',
     // Customer cancellation of an order still holding a seña.
     'ORDER_HAS_UNREFUNDED_DEPOSIT',
+    // A re-price moving the charged total of an order a seña froze with no factura.
+    'ORDER_PRICE_FROZEN',
     // `POST /orders { mode: 'deposit-refund' }` — see `OrderDepositRefundRequest`.
     'DEPOSIT_NOT_FOUND',
     'DEPOSIT_ALREADY_REFUNDED',

package/dist/store.d.ts

@@ -915,9 +915,10 @@ declare global {
              * `customerAccounts` while any customer carries a non-zero balance
              * (`409 STORE_MODULE_CUSTOMER_BALANCES`, or
              * `409 STORE_MODULE_BALANCE_CHECK_INCOMPLETE` when the bounded read could
-             * not finish).
+             * not finish); `cash` while any cash shift is still open
+             * (`409 STORE_MODULE_SHIFTS_OPEN` — `StoreModuleShiftsOpenData`).
              *
-             * Enforced on the server for six modules only:
+             * Enforced on the server for seven modules only:
              * - `promotions` — applying one is refused `PROMOTION_NOT_ACTIVE` (the
              *   existing promotion refusal, not `STORE_MODULE_DISABLED`), a grant already
              *   frozen on a cart stays on the row but derives no money (its
@@ -942,6 +943,10 @@ declare global {
              *   operator's `POST /loyalty/earn` and every read stay reachable.
              * - `marketing` — automation and campaign sends go out to nobody: each is
              *   settled `'skipped'` with reason `MODULE_OFF` at its send worker.
+             * - `cash` — a POS terminal activates WITHOUT a shift (no `shiftId`,
+             *   living until its own expiry), and opening a shift (`POST /shifts`) is
+             *   refused `403 STORE_MODULE_DISABLED`; every other `/shifts` endpoint
+             *   (close, movements, reconcile, reads) stays reachable.
              * Every other module is hide-only: its endpoints stay reachable. Public
              * reads carry only `appointments`, `surveys`, `promotions` and
              * `customerAccounts`. `PUT /platform/stores/{storeId}` refuses the leaf.
@@ -2046,13 +2051,17 @@ export declare const isStoreModuleOn: (modules: StoreModules | null | undefined,
  * - `STORE_MODULE_BALANCE_CHECK_INCOMPLETE` (409) — the bounded balance read
  *   stopped before it could prove every balance is zero. Retrying is harmless but
  *   walks the same rows, so a very large customer book keeps answering it.
+ * - `STORE_MODULE_SHIFTS_OPEN` (409) — `cash` off while any cash shift of the
+ *   store is still open (the default drawer is not a shift anyone closes, so it
+ *   never counts); `data.openShifts` carries the count, `data.truncated: true`
+ *   marks it as a floor (see {@link StoreModuleShiftsOpenData}).
  * - `STORE_MODULE_DISABLED` (403) — a server-enforced module is off (storefront
- *   self-booking, storefront survey); `data.module` names it. `POST /warehouses`
- *   answers it too when a create, or returning a depósito to service, would add
- *   a second active depósito while `multiWarehouse` is off
+ *   self-booking, storefront survey, opening a cash shift); `data.module` names
+ *   it. `POST /warehouses` answers it too when a create, or returning a depósito
+ *   to service, would add a second active depósito while `multiWarehouse` is off
  *   (`data.module: 'multiWarehouse'`). Always 403, and never an Action Denied row.
  */
-export declare const STORE_MODULE_ERROR_CODES: readonly ["STORE_MODULE_UNKNOWN", "STORE_MODULE_NOT_BOOLEAN", "STORE_MODULE_WAREHOUSES_ACTIVE", "STORE_MODULE_TRANSFER_IN_FLIGHT", "STORE_MODULE_CUSTOMER_BALANCES", "STORE_MODULE_BALANCE_CHECK_INCOMPLETE", "STORE_MODULE_DISABLED"];
+export declare const STORE_MODULE_ERROR_CODES: readonly ["STORE_MODULE_UNKNOWN", "STORE_MODULE_NOT_BOOLEAN", "STORE_MODULE_WAREHOUSES_ACTIVE", "STORE_MODULE_TRANSFER_IN_FLIGHT", "STORE_MODULE_CUSTOMER_BALANCES", "STORE_MODULE_BALANCE_CHECK_INCOMPLETE", "STORE_MODULE_SHIFTS_OPEN", "STORE_MODULE_DISABLED"];
 export type StoreModuleErrorCode = (typeof STORE_MODULE_ERROR_CODES)[number];
 /** `data` of `400 STORE_MODULE_UNKNOWN` — the unknown key, cut to its first 64 UTF-16 code units. */
 export interface StoreModuleUnknownData {
@@ -2092,7 +2101,20 @@ export interface StoreModuleCustomerBalancesData {
 export interface StoreModuleBalanceCheckIncompleteData {
     module: 'customerAccounts';
 }
-/** `data` of `STORE_MODULE_DISABLED` (403) — the switched-off module the request needed. */
+/**
+ * `data` of `409 STORE_MODULE_SHIFTS_OPEN`.
+ *
+ * `openShifts` is the number of open cash shifts the read SAW — the store
+ * default drawer excluded. `truncated: true` marks the read as stopped early,
+ * so that number is a FLOOR (possibly `0`: "could not finish counting");
+ * absent, the count is exact and at least one.
+ */
+export interface StoreModuleShiftsOpenData {
+    module: 'cash';
+    openShifts: number;
+    truncated?: true;
+}
+/** `data` of `403 STORE_MODULE_DISABLED` — the switched-off module the request needed. */
 export interface StoreModuleDisabledData {
     module: StoreModuleKey;
 }
@@ -2109,6 +2131,7 @@ export interface StoreModuleRefusalDataByCode {
     STORE_MODULE_TRANSFER_IN_FLIGHT: StoreModuleTransferInFlightData;
     STORE_MODULE_CUSTOMER_BALANCES: StoreModuleCustomerBalancesData;
     STORE_MODULE_BALANCE_CHECK_INCOMPLETE: StoreModuleBalanceCheckIncompleteData;
+    STORE_MODULE_SHIFTS_OPEN: StoreModuleShiftsOpenData;
     STORE_MODULE_DISABLED: StoreModuleDisabledData;
 }
 /**

package/dist/store.js

@@ -66,10 +66,14 @@ export const isStoreModuleOn = (modules, module) => modules?.[module] !== false;
  * - `STORE_MODULE_BALANCE_CHECK_INCOMPLETE` (409) — the bounded balance read
  *   stopped before it could prove every balance is zero. Retrying is harmless but
  *   walks the same rows, so a very large customer book keeps answering it.
+ * - `STORE_MODULE_SHIFTS_OPEN` (409) — `cash` off while any cash shift of the
+ *   store is still open (the default drawer is not a shift anyone closes, so it
+ *   never counts); `data.openShifts` carries the count, `data.truncated: true`
+ *   marks it as a floor (see {@link StoreModuleShiftsOpenData}).
  * - `STORE_MODULE_DISABLED` (403) — a server-enforced module is off (storefront
- *   self-booking, storefront survey); `data.module` names it. `POST /warehouses`
- *   answers it too when a create, or returning a depósito to service, would add
- *   a second active depósito while `multiWarehouse` is off
+ *   self-booking, storefront survey, opening a cash shift); `data.module` names
+ *   it. `POST /warehouses` answers it too when a create, or returning a depósito
+ *   to service, would add a second active depósito while `multiWarehouse` is off
  *   (`data.module: 'multiWarehouse'`). Always 403, and never an Action Denied row.
  */
 export const STORE_MODULE_ERROR_CODES = [
@@ -79,5 +83,6 @@ export const STORE_MODULE_ERROR_CODES = [
     'STORE_MODULE_TRANSFER_IN_FLIGHT',
     'STORE_MODULE_CUSTOMER_BALANCES',
     'STORE_MODULE_BALANCE_CHECK_INCOMPLETE',
+    'STORE_MODULE_SHIFTS_OPEN',
     'STORE_MODULE_DISABLED',
 ];

package/dist/terminal.d.ts

@@ -293,11 +293,18 @@ declare global {
         activatedByName: string;
         /**
          * The activating employee's OPEN shift. The activation ends the moment
-         * this shift closes; activating with no open shift is `409 SHIFT_NOT_OPEN`.
+         * this shift closes; activating with no open shift is `409 SHIFT_NOT_OPEN`
+         * while the store's `cash` module is on (absent counts as on).
+         *
+         * ABSENT on a SHIFT-LESS activation — one made while
+         * `config.modules.cash === false`, when no shift is asked for. That
+         * activation lives until `expiresAt` alone, whatever the switch reads
+         * later; cash sales on its till attribute to the store's default drawer
+         * whenever the operator holds no open shift of their own.
          */
-        shiftId: string;
+        shiftId?: string;
         activatedAt: number;
-        /** The 12-hour hard cap, unix ms. The shift closing ends it sooner. */
+        /** The 12-hour hard cap, unix ms. A shift-bound activation's shift closing ends it sooner. */
         expiresAt: number;
     }
     /** A PIN ladder refusal from operator login or elevation; whole seconds until that gate unlocks. */
@@ -563,7 +570,8 @@ export type TerminalEnrolmentErrorCode = (typeof TERMINAL_ENROLMENT_ERROR_CODES)
  *
  * - `TERMINAL_NOT_PAIRED` · 401 — the request carried no `sf_terminal` cookie,
  *   or one naming an unknown, expired or revoked terminal. Re-pair the till.
- * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift.
+ * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift,
+ *   while the store's `cash` module is on (with it off no shift is asked for).
  * - `TERMINAL_ACTIVATION_SESSION_INVALID` · 401 — the presented USER refresh
  *   credential cannot identify a signed modern family; clear delivery and sign in again.
  * - `TERMINAL_ACTIVATION_SESSION_MISMATCH` · 409 — its signed employee or store

package/dist/terminal.js

@@ -63,7 +63,8 @@ export const TERMINAL_ENROLMENT_ERROR_CODES = [
  *
  * - `TERMINAL_NOT_PAIRED` · 401 — the request carried no `sf_terminal` cookie,
  *   or one naming an unknown, expired or revoked terminal. Re-pair the till.
- * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift.
+ * - `SHIFT_NOT_OPEN` · 409 — activation by an employee who holds no open shift,
+ *   while the store's `cash` module is on (with it off no shift is asked for).
  * - `TERMINAL_ACTIVATION_SESSION_INVALID` · 401 — the presented USER refresh
  *   credential cannot identify a signed modern family; clear delivery and sign in again.
  * - `TERMINAL_ACTIVATION_SESSION_MISMATCH` · 409 — its signed employee or store

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.731",
+	"version": "1.10.733",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",