@tallyui/pos 3.5.2 → 3.6.0

package/dist/index.d.ts

@@ -534,6 +534,28 @@ declare function useParkedSales(drafts: RxCollection | undefined): {
     discard: (id: string) => Promise<void>;
 };
 
+/** WCPOS receipt data schema version these blocks follow (wiki: fiscal groundwork, receipt identity and QR §2). */
+declare const RECEIPT_SCHEMA_VERSION = "1.4.0";
+/** 1.4 `software`: which software produced the receipt. */
+interface ReceiptSoftware {
+    name: string;
+    plugin_version: string;
+    app_version: string;
+    app_build: string;
+    platform: string;
+}
+/** 1.4 `register`: `{ id: '', name: '' }` when there is none. */
+interface ReceiptRegister {
+    id: string;
+    name: string;
+}
+/** 1.4 `fiscal` identity fields a till can know. Sale time, zone and counter come with the per-register sale counter (#475). */
+interface ReceiptFiscal {
+    document_type: 'sale' | 'refund' | 'void' | 'cancellation' | 'closure' | 'x_report';
+    is_reprint: boolean;
+    reprint_count: number;
+    qr_payload: string;
+}
 interface ReceiptLineItem {
     name: string;
     sku: string;
@@ -549,6 +571,10 @@ interface ReceiptLineItem {
     }[];
 }
 interface ReceiptData {
+    schemaVersion: string;
+    software: ReceiptSoftware;
+    register: ReceiptRegister;
+    fiscal: ReceiptFiscal;
     header: {
         storeName: string;
         storeAddress?: string;
@@ -602,6 +628,9 @@ interface ReceiptConfig {
     storeAddress?: string;
     cashier?: string;
     register?: string;
+    registerName?: string;
+    software?: Partial<ReceiptSoftware>;
+    fiscal?: Partial<ReceiptFiscal>;
     taxLabels?: Record<number, string>;
 }
 
@@ -921,6 +950,7 @@ declare function getDeviceId(storage: {
  * session closed (`lateSessionId`) or with local warnings (whatever the sync status), or pending with a `commandId` in
  * `stuckCommandIds` (the outbox's `OutboxState.stuck`: the store keeps failing it), newest first.
  * A warning code this till version doesn't know is not shown here (`knownWarnings`). Never changes `orders`.
+ * `register_session_unknown` is not shown, because the store counts the order once its session arrives (ADR-078).
  */
 declare function needsAttention(orders: PosOrder[], options?: {
     stuckCommandIds?: readonly string[];
@@ -2496,4 +2526,43 @@ declare function planLegs(plan: TenderPlan, rowsSinceFrom: {
     };
 };
 
-export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type CatalogueGridColumns, type CatalogueView, type CatalogueViewAction, type CatalogueViewState, type ChargeInput, type ChargeLine, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DEFAULT_CATALOGUE_VIEW_STATE, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FeeLine, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OrderTransportContext, type OutboxState, PRODUCT_SORT_FIELDS, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type ProductSort, type ProductSortValue, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type ShippingLine, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, catalogueViewReducer, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, inCategory, initTenderState, initialTenderState, isServerDecimal, labelKeys, listCategories, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, normalizeCatalogueViewState, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, productCategories, productSortValue, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveGridColumns, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, sortProducts, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };
+/**
+ * One record per voided tender leg: its v2 ledger row plus the provenance a v2 `void`
+ * fiscal record carries (TallyUI#479). Write-once: insert only, never update or delete;
+ * a replay of a known `paymentId` is a no-op for the caller to handle.
+ * Local only, never replicated. No device-side number or checksum:
+ * v2 numbers records on the server.
+ */
+
+interface TenderVoid {
+    /** The voided leg's client-minted id (the `clientPaymentId` order.create would send). Primary key, write-once. */
+    paymentId: string;
+    /** The sale's id (`PosOrder.saleId`). */
+    saleId: string;
+    type: 'void';
+    method: PaymentMethodKind;
+    amountMinor: number;
+    /** Cash only: what the customer handed over. */
+    tenderedMinor?: number;
+    /** An external terminal's reference. */
+    reference?: string;
+    /** ISO 4217 code. */
+    currency: string;
+    /** `removed`: the cashier removed this one leg. `cancelled`: the cashier backed out of tendering. */
+    reason: 'removed' | 'cancelled';
+    /** Device clock at the void, ISO 8601. */
+    deviceTime: string;
+    /** The device's IANA time zone. */
+    deviceTz: string;
+    /** The bound register's id, `''` when no register is bound. */
+    registerId: string;
+    sessionId?: string;
+    /** The cashier, as the backend's user id string. */
+    cashierRef: string;
+}
+declare const tenderVoidSchema: RxJsonSchema<TenderVoid>;
+declare function tenderVoidCollection(): {
+    readonly schema: RxJsonSchema<TenderVoid>;
+};
+
+export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type CatalogueGridColumns, type CatalogueView, type CatalogueViewAction, type CatalogueViewState, type ChargeInput, type ChargeLine, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DEFAULT_CATALOGUE_VIEW_STATE, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FeeLine, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OrderTransportContext, type OutboxState, PRODUCT_SORT_FIELDS, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type ProductSort, type ProductSortValue, RECEIPT_SCHEMA_VERSION, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptFiscal, type ReceiptLineItem, type ReceiptRegister, type ReceiptSoftware, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type ShippingLine, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TenderVoid, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, catalogueViewReducer, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, inCategory, initTenderState, initialTenderState, isServerDecimal, labelKeys, listCategories, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, normalizeCatalogueViewState, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, productCategories, productSortValue, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveGridColumns, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, sortProducts, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, tenderVoidCollection, tenderVoidSchema, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };

package/dist/index.js

@@ -1364,6 +1364,9 @@ function useParkedSales(drafts) {
   return { parked, discard };
 }
 
+// src/receipt/types.ts
+var RECEIPT_SCHEMA_VERSION = "1.4.0";
+
 // src/receipt/build-receipt-data.ts
 function buildReceiptData(order, config) {
   const taxedLines = [...order.lineItems.map((line) => order.taxRounding?.granularity === "woocommerce" && line.netMicros !== void 0 ? { ...line, taxInclusive: order.pricesIncludeTax } : line), ...[...order.fees ?? [], ...order.shipping ?? []].map((charge) => ({
@@ -1387,6 +1390,23 @@ function buildReceiptData(order, config) {
   const label = (d) => d.label ?? d.couponCode ?? `${d.type} discount`;
   const customer = order.customer?.name || order.customer?.email;
   return {
+    schemaVersion: RECEIPT_SCHEMA_VERSION,
+    software: {
+      name: "WCPOS",
+      plugin_version: "",
+      app_version: "",
+      app_build: "",
+      platform: "",
+      ...config.software
+    },
+    register: { id: config.register ?? "", name: config.registerName ?? "" },
+    fiscal: {
+      document_type: "sale",
+      is_reprint: false,
+      reprint_count: 0,
+      qr_payload: "",
+      ...config.fiscal
+    },
     header: {
       storeName: config.storeName,
       storeAddress: config.storeAddress,
@@ -2282,7 +2302,7 @@ function getDeviceId(storage, key) {
 // src/pos-order/needs-attention.ts
 import { knownWarnings } from "@tallyui/core";
 function needsAttention(orders, options = {}) {
-  return orders.filter((order) => order.syncStatus === "rejected" || (order.localWarnings?.length ?? 0) > 0 || order.syncStatus === "applied" && knownWarnings(order.warnings).length > 0 || order.lateSessionId !== void 0 || order.syncStatus === "pending" && options.stuckCommandIds?.includes(order.commandId) === true).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+  return orders.filter((order) => order.syncStatus === "rejected" || (order.localWarnings?.length ?? 0) > 0 || order.syncStatus === "applied" && knownWarnings(order.warnings).some((warning) => warning.code !== "register_session_unknown") || order.lateSessionId !== void 0 || order.syncStatus === "pending" && options.stuckCommandIds?.includes(order.commandId) === true).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
 }
 
 // src/pos-order/same-sale.ts
@@ -5086,6 +5106,7 @@ function createOrderOutbox(options) {
 
 // src/outbox/register-outbox.ts
 import { BehaviorSubject as BehaviorSubject5 } from "rxjs";
+var NON_BLOCKING_REJECTIONS = /* @__PURE__ */ new Set(["register_session_superseded", "register_session_abandoned"]);
 function plainCommand({
   key,
   registerId,
@@ -5165,8 +5186,9 @@ function createRegisterOutbox(options) {
       selector: { syncStatus: { $in: ["pending", "rejected"] } },
       sort: [{ seq: "asc" }, { key: "asc" }]
     })) {
-      if (command.syncStatus === "rejected") blocked.add(command.registerId);
-      else if (!blocked.has(command.registerId)) sendable2.add(command.commandId);
+      if (command.syncStatus === "rejected") {
+        if (!NON_BLOCKING_REJECTIONS.has(command.error?.code ?? "")) blocked.add(command.registerId);
+      } else if (!blocked.has(command.registerId)) sendable2.add(command.commandId);
     }
     for (const id2 of clocks.keys()) if (!sendable2.has(id2)) clocks.delete(id2);
     state$.next({ ...state$.value, ...patch, pending, stuck: stuckState() });
@@ -5202,9 +5224,10 @@ function createRegisterOutbox(options) {
         });
         const commands = [];
         for (const command of ledger) {
+          if (command.syncStatus === "rejected" && NON_BLOCKING_REJECTIONS.has(command.error?.code ?? "")) continue;
           if (command.syncStatus === "rejected") break;
           commands.push(command);
-          if (commands.length >= batchSize) break;
+          if (command.type === "register.session.open" || commands.length >= batchSize) break;
         }
         if (stopped) {
           stoppedDuringRun = true;
@@ -5707,6 +5730,49 @@ function planLegs(plan, rowsSinceFrom, balanceMinor) {
   const title = plan.kind === "fixed" && taken === 0 ? plan.title : null;
   return { legs, thisPaymentMinor: each, label: { n: taken + 1, ways, rest, title } };
 }
+
+// src/tender/tender-void.ts
+var tenderVoidSchema = {
+  title: "Tender voids",
+  version: 0,
+  primaryKey: "paymentId",
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    paymentId: { type: "string", maxLength: 64 },
+    saleId: { type: "string", maxLength: 64 },
+    type: { type: "string", enum: ["void"], maxLength: 4 },
+    // Not an enum: PaymentMethodKind grows, and a stored enum would need a schema migration per new kind.
+    method: { type: "string", maxLength: 32 },
+    amountMinor: { type: "integer" },
+    tenderedMinor: { type: "integer" },
+    reference: { type: "string" },
+    currency: { type: "string", maxLength: 3 },
+    reason: { type: "string", enum: ["removed", "cancelled"] },
+    deviceTime: { type: "string", maxLength: 40 },
+    deviceTz: { type: "string" },
+    registerId: { type: "string" },
+    sessionId: { type: "string" },
+    cashierRef: { type: "string" }
+  },
+  required: [
+    "paymentId",
+    "saleId",
+    "type",
+    "method",
+    "amountMinor",
+    "currency",
+    "reason",
+    "deviceTime",
+    "deviceTz",
+    "registerId",
+    "cashierRef"
+  ],
+  indexes: [["saleId"], ["deviceTime"]]
+};
+function tenderVoidCollection() {
+  return { schema: tenderVoidSchema };
+}
 export {
   CartError,
   CurrencyProvider,
@@ -5717,6 +5783,7 @@ export {
   OrderContentMismatchError,
   PRODUCT_SORT_FIELDS,
   PosOrderOpenClosedError,
+  RECEIPT_SCHEMA_VERSION,
   RegisterApprovalRequiredError,
   RegisterCloseIncompleteError,
   RegisterIdInvalidError,
@@ -5842,6 +5909,8 @@ export {
   taxMicros,
   taxProviderProps,
   tenderReducer,
+  tenderVoidCollection,
+  tenderVoidSchema,
   toOrderCreateEnvelope,
   unbindRegister,
   useCurrencyCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -27,20 +27,20 @@
     "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.5.2",
+    "@tallyui/core": "^3.6.0",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.5.2",
+    "@tallyui/core": "3.6.0",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "rxdb": "17.5.0",
     "rxjs": "7.8.2",
-    "@tallyui/connector-medusa": "3.5.2",
-    "@tallyui/connector-woocommerce": "3.5.2",
-    "@tallyui/database": "3.5.2"
+    "@tallyui/connector-medusa": "3.6.0",
+    "@tallyui/connector-woocommerce": "3.6.0",
+    "@tallyui/database": "3.6.0"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -51,8 +51,8 @@ export type {
 } from './order';
 
 // Receipt
-export { buildReceiptData } from './receipt';
-export type { ReceiptData, ReceiptLineItem, ReceiptConfig } from './receipt';
+export { buildReceiptData, RECEIPT_SCHEMA_VERSION } from './receipt';
+export type { ReceiptData, ReceiptLineItem, ReceiptConfig, ReceiptSoftware, ReceiptRegister, ReceiptFiscal } from './receipt';
 
 // Product
 export { searchProducts, sortProducts, productSortValue, PRODUCT_SORT_FIELDS, type ProductSort, type ProductSortValue, catalogueViewReducer, normalizeCatalogueViewState, resolveGridColumns, DEFAULT_CATALOGUE_VIEW_STATE, type CatalogueView, type CatalogueGridColumns, type CatalogueViewState, type CatalogueViewAction, withStockOverlay, getProductStock, stockOverlay$, stockOverlayAsOf$, productCategories, listCategories, inCategory } from './product';
@@ -69,8 +69,8 @@ export type { RegisterOutboxOptions, RegisterOutbox, UseRegisterOutboxOptions, U
 export { createBackendNotFound } from './outbox/backend-not-found';
 export type { BackendNotFound } from './outbox/backend-not-found';
 export type { HttpTransportOptions, OrderOutboxOptions, OrderOutbox, TransportOutcome, CommandTransport, OrderTransportContext, OutboxState, UseOrderOutboxOptions, UseOrderOutboxResult } from './outbox';
-export { tenderReducer, initTenderState, initialTenderState, appliedMinor, changeMinor, quickTenderedAmounts, evenSplitShareMinor, activePlan, planLegs, MAX_TENDER_MINOR } from './tender';
-export type { PaymentTransport, TenderView, TenderLineId, TenderPlan, SplitTab, TenderState, TenderKey, TenderAction, PlanLeg } from './tender';
+export { tenderReducer, initTenderState, initialTenderState, appliedMinor, changeMinor, quickTenderedAmounts, evenSplitShareMinor, activePlan, planLegs, MAX_TENDER_MINOR, tenderVoidSchema, tenderVoidCollection } from './tender';
+export type { PaymentTransport, TenderView, TenderLineId, TenderPlan, SplitTab, TenderState, TenderKey, TenderAction, PlanLeg, TenderVoid } from './tender';
 
 // Register
 export { normalizeAmount, isServerDecimal, movementFieldError, deriveExpected, parseMinor, validAmount, countVariance, overThreshold, closeNeedsApproval, denominationTotal, varianceText, denominations } from './register';

package/src/outbox/register-outbox.ts

@@ -7,6 +7,9 @@ import { createBackendNotFound, type BackendNotFound } from './backend-not-found
 import { STUCK_AFTER_MS } from './order-outbox';
 import type { CommandTransport, OutboxState } from './types';
 
+/** Final rejections that do not stop their register's ledger (ADR-078): the commands behind them are still sent. */
+export const NON_BLOCKING_REJECTIONS: ReadonlySet<string> = new Set(['register_session_superseded', 'register_session_abandoned']);
+
 export interface RegisterOutboxOptions {
   collection: RxCollection<RegisterCommand>;
   transport: CommandTransport<RegisterCommandEnvelope>;
@@ -68,7 +71,7 @@ export function createRegisterOutbox(options: RegisterOutboxOptions): RegisterOu
   // like a 503, or `no_progress`); a running clock keeps its `since` and takes the latest reason. A `network` failure
   // pauses every clock (`pausedAt`), and the next answer of any kind resumes them, moving `since` on by the offline
   // gap, so `since` is now minus the answered time. A clock clears when its command is no longer pending under its
-  // commandId (applied or rejected), or when a rejected command comes ahead of it in its ledger (it is not being
+  // commandId (applied or rejected), or when a blocking rejected command comes ahead of it in its ledger (it is not being
   // sent: Front desk, 2026-09-30); commands never sent have none. Nothing is isolated: a stuck command at the head
   // of a register's ledger holds up the commands behind it, by design, since register facts apply in `seq` order.
   // In memory only: a restart starts with no clocks, and the first answered failure after it starts them afresh
@@ -96,8 +99,9 @@ export function createRegisterOutbox(options: RegisterOutboxOptions): RegisterOu
     const blocked = new Set<string>();
     if (clocks.size) for (const command of await readFresh(collection, { selector: { syncStatus: { $in: ['pending', 'rejected'] } },
       sort: [{ seq: 'asc' }, { key: 'asc' }] })) {
-      if (command.syncStatus === 'rejected') blocked.add(command.registerId);
-      else if (!blocked.has(command.registerId)) sendable.add(command.commandId);
+      if (command.syncStatus === 'rejected') {
+        if (!NON_BLOCKING_REJECTIONS.has(command.error?.code ?? '')) blocked.add(command.registerId);
+      } else if (!blocked.has(command.registerId)) sendable.add(command.commandId);
     }
     for (const id of clocks.keys()) if (!sendable.has(id)) clocks.delete(id);
     state$.next({ ...state$.value, ...patch, pending, stuck: stuckState() });
@@ -127,9 +131,10 @@ export function createRegisterOutbox(options: RegisterOutboxOptions): RegisterOu
         });
         const commands: RegisterCommand[] = [];
         for (const command of ledger) {
+          if (command.syncStatus === 'rejected' && NON_BLOCKING_REJECTIONS.has(command.error?.code ?? '')) continue;
           if (command.syncStatus === 'rejected') break;
           commands.push(command);
-          if (commands.length >= batchSize) break;
+          if (command.type === 'register.session.open' || commands.length >= batchSize) break;
         }
         if (stopped) { stoppedDuringRun = true; return; }
         if (!commands.length) continue;

package/src/pos-order/needs-attention.ts

@@ -6,11 +6,12 @@ import type { PosOrder } from './types';
  * session closed (`lateSessionId`) or with local warnings (whatever the sync status), or pending with a `commandId` in
  * `stuckCommandIds` (the outbox's `OutboxState.stuck`: the store keeps failing it), newest first.
  * A warning code this till version doesn't know is not shown here (`knownWarnings`). Never changes `orders`.
+ * `register_session_unknown` is not shown, because the store counts the order once its session arrives (ADR-078).
  */
 export function needsAttention(orders: PosOrder[], options: { stuckCommandIds?: readonly string[] } = {}): PosOrder[] {
   return orders.filter((order) => order.syncStatus === 'rejected'
     || (order.localWarnings?.length ?? 0) > 0
-    || (order.syncStatus === 'applied' && knownWarnings(order.warnings).length > 0) || order.lateSessionId !== undefined
+    || (order.syncStatus === 'applied' && knownWarnings(order.warnings).some((warning) => warning.code !== 'register_session_unknown')) || order.lateSessionId !== undefined
     || (order.syncStatus === 'pending' && options.stuckCommandIds?.includes(order.commandId) === true))
     .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
 }

package/src/receipt/build-receipt-data.ts

@@ -1,6 +1,7 @@
 import type { Discount, SentOrder } from '../order/types';
 import { roundMicrosToMinor, taxLinesByRate } from '../tax/exact';
 import type { ReceiptConfig, ReceiptData } from './types';
+import { RECEIPT_SCHEMA_VERSION } from './types';
 
 export function buildReceiptData(order: SentOrder, config: ReceiptConfig): ReceiptData {
   // Drops the shared helper's `netMinor` (the Z report's own use): the receipt's tax summary
@@ -29,6 +30,14 @@ export function buildReceiptData(order: SentOrder, config: ReceiptConfig): Recei
   const customer = order.customer?.name || order.customer?.email;
 
   return {
+    schemaVersion: RECEIPT_SCHEMA_VERSION,
+    software: {
+      name: 'WCPOS', plugin_version: '', app_version: '', app_build: '', platform: '', ...config.software,
+    },
+    register: { id: config.register ?? '', name: config.registerName ?? '' },
+    fiscal: {
+      document_type: 'sale', is_reprint: false, reprint_count: 0, qr_payload: '', ...config.fiscal,
+    },
     header: {
       storeName: config.storeName,
       storeAddress: config.storeAddress,

package/src/receipt/index.ts

@@ -1,2 +1,3 @@
 export { buildReceiptData } from './build-receipt-data';
-export type { ReceiptData, ReceiptLineItem, ReceiptConfig } from './types';
+export { RECEIPT_SCHEMA_VERSION } from './types';
+export type { ReceiptData, ReceiptLineItem, ReceiptConfig, ReceiptSoftware, ReceiptRegister, ReceiptFiscal } from './types';

package/src/receipt/types.ts

@@ -1,3 +1,18 @@
+/** WCPOS receipt data schema version these blocks follow (wiki: fiscal groundwork, receipt identity and QR §2). */
+export const RECEIPT_SCHEMA_VERSION = '1.4.0';
+
+/** 1.4 `software`: which software produced the receipt. */
+export interface ReceiptSoftware { name: string; plugin_version: string; app_version: string; app_build: string; platform: string }
+/** 1.4 `register`: `{ id: '', name: '' }` when there is none. */
+export interface ReceiptRegister { id: string; name: string }
+/** 1.4 `fiscal` identity fields a till can know. Sale time, zone and counter come with the per-register sale counter (#475). */
+export interface ReceiptFiscal {
+  document_type: 'sale' | 'refund' | 'void' | 'cancellation' | 'closure' | 'x_report';
+  is_reprint: boolean;
+  reprint_count: number;
+  qr_payload: string;
+}
+
 export interface ReceiptLineItem {
   name: string;
   sku: string;
@@ -11,6 +26,10 @@ export interface ReceiptLineItem {
 }
 
 export interface ReceiptData {
+  schemaVersion: string;
+  software: ReceiptSoftware;
+  register: ReceiptRegister;
+  fiscal: ReceiptFiscal;
   header: {
     storeName: string;
     storeAddress?: string;
@@ -47,5 +66,8 @@ export interface ReceiptConfig {
   storeAddress?: string;
   cashier?: string;
   register?: string;
+  registerName?: string;
+  software?: Partial<ReceiptSoftware>;
+  fiscal?: Partial<ReceiptFiscal>;
   taxLabels?: Record<number, string>;
 }

package/src/tender/index.ts

@@ -1,2 +1,4 @@
 export { tenderReducer, initTenderState, initialTenderState, appliedMinor, changeMinor, quickTenderedAmounts, evenSplitShareMinor, activePlan, planLegs, MAX_TENDER_MINOR } from './tender-state';
 export type { PaymentTransport, TenderView, TenderLineId, TenderPlan, SplitTab, TenderState, TenderKey, TenderAction, PlanLeg } from './tender-state';
+export { tenderVoidSchema, tenderVoidCollection } from './tender-void';
+export type { TenderVoid } from './tender-void';

package/src/tender/tender-void.ts

@@ -0,0 +1,66 @@
+/**
+ * One record per voided tender leg: its v2 ledger row plus the provenance a v2 `void`
+ * fiscal record carries (TallyUI#479). Write-once: insert only, never update or delete;
+ * a replay of a known `paymentId` is a no-op for the caller to handle.
+ * Local only, never replicated. No device-side number or checksum:
+ * v2 numbers records on the server.
+ */
+import type { PaymentMethodKind } from '@tallyui/core';
+import type { RxJsonSchema } from 'rxdb';
+
+export interface TenderVoid {
+  /** The voided leg's client-minted id (the `clientPaymentId` order.create would send). Primary key, write-once. */
+  paymentId: string;
+  /** The sale's id (`PosOrder.saleId`). */
+  saleId: string;
+  type: 'void';
+  method: PaymentMethodKind;
+  amountMinor: number;
+  /** Cash only: what the customer handed over. */
+  tenderedMinor?: number;
+  /** An external terminal's reference. */
+  reference?: string;
+  /** ISO 4217 code. */
+  currency: string;
+  /** `removed`: the cashier removed this one leg. `cancelled`: the cashier backed out of tendering. */
+  reason: 'removed' | 'cancelled';
+  /** Device clock at the void, ISO 8601. */
+  deviceTime: string;
+  /** The device's IANA time zone. */
+  deviceTz: string;
+  /** The bound register's id, `''` when no register is bound. */
+  registerId: string;
+  sessionId?: string;
+  /** The cashier, as the backend's user id string. */
+  cashierRef: string;
+}
+
+export const tenderVoidSchema: RxJsonSchema<TenderVoid> = {
+  title: 'Tender voids', version: 0, primaryKey: 'paymentId', type: 'object', additionalProperties: false,
+  properties: {
+    paymentId: { type: 'string', maxLength: 64 },
+    saleId: { type: 'string', maxLength: 64 },
+    type: { type: 'string', enum: ['void'], maxLength: 4 },
+    // Not an enum: PaymentMethodKind grows, and a stored enum would need a schema migration per new kind.
+    method: { type: 'string', maxLength: 32 },
+    amountMinor: { type: 'integer' },
+    tenderedMinor: { type: 'integer' },
+    reference: { type: 'string' },
+    currency: { type: 'string', maxLength: 3 },
+    reason: { type: 'string', enum: ['removed', 'cancelled'] },
+    deviceTime: { type: 'string', maxLength: 40 },
+    deviceTz: { type: 'string' },
+    registerId: { type: 'string' },
+    sessionId: { type: 'string' },
+    cashierRef: { type: 'string' },
+  },
+  required: [
+    'paymentId', 'saleId', 'type', 'method', 'amountMinor', 'currency', 'reason',
+    'deviceTime', 'deviceTz', 'registerId', 'cashierRef',
+  ],
+  indexes: [['saleId'], ['deviceTime']],
+};
+
+export function tenderVoidCollection(): { readonly schema: RxJsonSchema<TenderVoid> } {
+  return { schema: tenderVoidSchema } as const;
+}