platform-types 1.10.732 → 1.10.734

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/invoice.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICE_DOCUMENT_REFUSAL_CODES = exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = exports.INVOICE_ISSUANCE_REFUSAL_CODES = exports.INVOICE_POST_VOUCHER_ERROR_CODES = void 0;
+exports.INVOICE_NOT_AUTHORIZED_RECOVERIES = exports.INVOICE_DOCUMENT_REFUSAL_CODES = exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = exports.INVOICE_ISSUANCE_REFUSAL_CODES = exports.INVOICE_POST_VOUCHER_ERROR_CODES = void 0;
 /**
  * The codes `POST /invoices` answers AFTER a voucher number was spent — ARCA
  * was asked, or a CAEA number was claimed — as a runtime value the app maps.
@@ -87,13 +87,33 @@ exports.INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  *   store. Answered before any store read, render, print stamp, broadcast,
  *   staged PDF, print job or email.
  * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
- *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) ride beside `error`. A
  *   print refused here wrote nothing to the invoice and dispatched nothing.
- *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
- *   factura or full credit note with no client action (an FCE or partial
- *   credit note waits for support). `rejected` is final — ARCA refused the
- *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
- *   before the field existed) is treated as authorized, whether or not it
- *   carries a CAE.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all reads `fiscalStatus` only: a row with none (issued before the field
+ *   existed) is treated as authorized, whether or not it carries a CAE.
  */
 exports.INVOICE_DOCUMENT_REFUSAL_CODES = ['INVOICE_NOT_FOUND', 'INVOICE_NOT_AUTHORIZED'];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+exports.INVOICE_NOT_AUTHORIZED_RECOVERIES = ['retry', 'support', 'final'];

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/invoice.d.ts

@@ -354,6 +354,26 @@ declare global {
          * Forward-only; nothing reads it as anything but a deadline.
          */
         drainClaimUntil?: number;
+        /**
+         * `true` while a REJECTED row's order still shows it unsettled — the
+         * rejection committed, but the order's `invoices[]` entry could not be set to
+         * `rejected` in the same write. Written in that same rejection write, only
+         * then; REMOVEd by the repair that sets the entry — tried at once, then by the
+         * `order-copy-repair` queue's consumer, and by a pending-invoice drain pass
+         * that reaches the store's page (AFIP not known down, its AFIP client up).
+         * ABSENT on every other row, and forward-only.
+         */
+        orderCopyStale?: true;
+        /**
+         * The rejecting caller's ORDER-trail origin, written beside `orderCopyStale`
+         * in the same write and REMOVEd with it, so whichever repairer reaches the
+         * row records the caller's settle rather than its own. Forward-only.
+         */
+        orderCopyStaleOrigin?: Extract<OrderAuditOrigin, 'platform' | 'operator' | 'worker'>;
+        /** The rejecting caller's settle reason — ids only, code-authored. Beside `orderCopyStale`, REMOVEd with it. */
+        orderCopyStaleReason?: string;
+        /** The rejecting caller's actor `userId` (`''` = the system actor). Beside `orderCopyStale`, REMOVEd with it. */
+        orderCopyStaleActorId?: string;
         invoicePrinted?: boolean;
         /**
          * Server-derived ms epoch, stamped by the WSS `ack` handler on an
@@ -1006,15 +1026,36 @@ export declare const INVOICE_ISSUANCE_REFUSAL_RECOVERY: {
  *   store. Answered before any store read, render, print stamp, broadcast,
  *   staged PDF, print job or email.
  * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
- *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) ride beside `error`. A
  *   print refused here wrote nothing to the invoice and dispatched nothing.
- *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
- *   factura or full credit note with no client action (an FCE or partial
- *   credit note waits for support). `rejected` is final — ARCA refused the
- *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
- *   before the field existed) is treated as authorized, whether or not it
- *   carries a CAE.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all reads `fiscalStatus` only: a row with none (issued before the field
+ *   existed) is treated as authorized, whether or not it carries a CAE.
  */
 export declare const INVOICE_DOCUMENT_REFUSAL_CODES: readonly ["INVOICE_NOT_FOUND", "INVOICE_NOT_AUTHORIZED"];
 export type InvoiceDocumentRefusalCode = (typeof INVOICE_DOCUMENT_REFUSAL_CODES)[number];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+export declare const INVOICE_NOT_AUTHORIZED_RECOVERIES: readonly ["retry", "support", "final"];
+export type InvoiceNotAuthorizedRecovery = (typeof INVOICE_NOT_AUTHORIZED_RECOVERIES)[number];
 export {};

package/dist/invoice.js

@@ -84,13 +84,33 @@ export const INVOICE_ISSUANCE_REFUSAL_RECOVERY = {
  *   store. Answered before any store read, render, print stamp, broadcast,
  *   staged PDF, print job or email.
  * - `INVOICE_NOT_AUTHORIZED` · 409 — the row's `fiscalStatus` is `pending_cae`
- *   or `rejected`. `invoiceId` and that `fiscalStatus` ride beside `error`. A
+ *   or `rejected`. `invoiceId`, that `fiscalStatus` and a `recovery`
+ *   (`INVOICE_NOT_AUTHORIZED_RECOVERIES`) ride beside `error`. A
  *   print refused here wrote nothing to the invoice and dispatched nothing.
- *   `pending_cae` is wait-and-retry: the pending-invoice drain authorizes a
- *   factura or full credit note with no client action (an FCE or partial
- *   credit note waits for support). `rejected` is final — ARCA refused the
- *   voucher and nothing retries it. The decision reads `fiscalStatus` only: a row with none (issued
- *   before the field existed) is treated as authorized, whether or not it
- *   carries a CAE.
+ *   What the client tells the operator is `recovery`'s to say, never
+ *   re-derived here: a `pending_cae` row answers `retry` or `support` (an FCE
+ *   voucher, a partial credit note, or a submit whose recorded voucher triple
+ *   is incomplete), and a `rejected` row answers `final`. Whether to refuse at
+ *   all reads `fiscalStatus` only: a row with none (issued before the field
+ *   existed) is treated as authorized, whether or not it carries a CAE.
  */
 export const INVOICE_DOCUMENT_REFUSAL_CODES = ['INVOICE_NOT_FOUND', 'INVOICE_NOT_AUTHORIZED'];
+/**
+ * What a client should tell the operator about a voucher the document routes
+ * refused with `INVOICE_NOT_AUTHORIZED` — the `recovery` beside `error` in that
+ * 409 body, decided server-side from the INVOICE row so a client never re-derives
+ * the drain's rules:
+ *
+ * - `retry` — `pending_cae`, and nothing on the row says the pending-invoice
+ *   drain will hold it: try again later. The drain may still hold such a row
+ *   when its order changed underneath it — that is decided against the order,
+ *   not the row, and is not answered here.
+ * - `support` — `pending_cae`, and the row itself shows the drain will hold it
+ *   rather than settle it: an FCE voucher (skipped), a PARTIAL credit note (its
+ *   row carries `partialItems`, and the drain's full-order rebuild never
+ *   reproduces it), or a submit whose recorded voucher triple is incomplete.
+ *   Contact support. A return's own partial credit note can still be settled by
+ *   that return's credit-note retry.
+ * - `final` — `rejected`. ARCA refused the voucher and nothing retries it.
+ */
+export const INVOICE_NOT_AUTHORIZED_RECOVERIES = ['retry', 'support', 'final'];

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.732",
+	"version": "1.10.734",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",