@kreiseck/kasseneck-api 1.13.0 → 1.15.0

package/dist/cjs/models/receipt-output.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECEIPT_OUTPUT_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = exports.RECEIPT_OUTPUT_ENTRIES_MAX = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_LOG_KINDS = exports.RECEIPT_OUTPUT_KINDS = void 0;
+exports.receiptOutputsFromWire = receiptOutputsFromWire;
+exports.isReceiptOutputErrorCode = isReceiptOutputErrorCode;
+exports.receiptOutputErrorCode = receiptOutputErrorCode;
+exports.isReceiptOutputError = isReceiptOutputError;
+exports.receiptOutputFieldErrors = receiptOutputFieldErrors;
+const fehlercodes_js_1 = require("../client/fehlercodes.js");
+/*
+ * Ausgaben eines Belegs: auf welchem Weg ein Beleg den Betrieb verlassen hat
+ * (Erstdruck, Duplikat, E-Mail, Link oder PDF geteilt, vom Kunden geoeffnet).
+ * Registrierkassen-Erlass BMF-AV Nr. 2/2026, Abschnitt 4.2: die Art der
+ * Belegerteilung ist zu dokumentieren. Das Protokoll fuehrt das Backend neben
+ * dem Beleg (nie am Beleg, nie im DEP); die Kasse meldet ihre Drucke und das
+ * Teilen mit `logReceiptOutputs`, `getReceipt` liefert unter `/v3` die
+ * neuesten 20 Eintraege als `outputs`.
+ */
+/**
+ * Die Arten einer Ausgabe (Katalog `AUSGABE_ART`): `print` Erstdruck,
+ * `reprint` Duplikat, `email` Belegmail, `link_shared` Link geteilt,
+ * `pdf_shared` PDF geteilt, `opened` vom Kunden geoeffnet (Abrufe je Stunde).
+ */
+exports.RECEIPT_OUTPUT_KINDS = Object.freeze(['print', 'reprint', 'email', 'link_shared', 'pdf_shared', 'opened']);
+/**
+ * Die Arten, die eine Kasse selbst meldet. `email` und `opened` schreibt das
+ * Backend selbst (beim Versand bzw. beim Abruf des Links); meldet eine Kasse
+ * sie, lehnt der Server genau diesen Eintrag ab (`invalid_output_kind`).
+ */
+exports.RECEIPT_OUTPUT_LOG_KINDS = Object.freeze(['print', 'reprint', 'link_shared', 'pdf_shared']);
+/** Ergebnis einer Ausgabe (Katalog `AUSGABE_ERGEBNIS`); Mail und Abruf sind immer `ok`. */
+exports.RECEIPT_OUTPUT_RESULTS = Object.freeze(['ok', 'failed', 'unclear']);
+/** Hoechstens so viele Eintraege je Aufruf von `logReceiptOutputs`. */
+exports.RECEIPT_OUTPUT_ENTRIES_MAX = 50;
+/**
+ * Liest `data.outputs` nachsichtig: das Protokoll ist eine Auskunft neben dem
+ * Beleg und darf das Lesen, Anzeigen und Nachdrucken des Belegs nie scheitern
+ * lassen. Keine Liste: `undefined` (Antwort ohne Protokoll, etwa `/api` oder
+ * `createReceipt`). Ein Eintrag ohne lesbare Art, Zeit oder Ergebnis faellt
+ * weg; ein Handelnder ohne Kennung gilt als `null`, eine Anzahl, die keine
+ * ganze Zahl ab 0 ist, fehlt. Paketintern.
+ */
+function receiptOutputsFromWire(roh) {
+    if (!Array.isArray(roh))
+        return undefined;
+    const raus = [];
+    for (const e of roh) {
+        if (e === null || typeof e !== 'object' || Array.isArray(e))
+            continue;
+        const { kind, at, result, by, count } = e;
+        if (typeof kind !== 'string' || kind === '' || typeof at !== 'string' || at === '' || typeof result !== 'string' || result === '')
+            continue;
+        const eintrag = { kind, at, result, by: handelnder(by) };
+        if (typeof count === 'number' && Number.isSafeInteger(count) && count >= 0)
+            eintrag.count = count;
+        raus.push(eintrag);
+    }
+    return raus;
+}
+function handelnder(w) {
+    if (w === null || typeof w !== 'object' || Array.isArray(w))
+        return null;
+    const { id, name } = w;
+    if (typeof id !== 'string' || id === '')
+        return null;
+    return { id, name: typeof name === 'string' ? name : null };
+}
+/**
+ * Codes je Eintrag in `rejected[].code` einer Antwort von
+ * `logReceiptOutputs`: der Eintrag ist dauerhaft abgelehnt (aus dem Puffer
+ * nehmen, nicht noch einmal senden). `validation` heisst hier: ein Druck ohne
+ * oder mit unbekanntem Ergebnis.
+ */
+exports.RECEIPT_OUTPUT_ENTRY_ERROR_CODES = Object.freeze([
+    'receipt_not_found', // Beleg gibt es nicht ODER er liegt in einer anderen Kasse
+    'invalid_output_kind', // Art, die die Kasse nicht meldet (email, opened)
+    'output_time_out_of_range', // unlesbare Zeit oder ohne Zone (eine falsch gehende Uhr klemmt der Server)
+    'idempotency_key_required', // Schluessel fehlt oder hat nicht 8-64 Zeichen [A-Za-z0-9_-]
+    'validation', // Druck ohne bzw. mit unbekanntem Ergebnis
+]);
+/**
+ * Fehlercodes von `logReceiptOutputs`, wenn die ganze Anfrage scheitert
+ * (Vokabular `errorCodes.registerHandlersByEndpoint.logReceiptOutputs`),
+ * dahinter die Codes, die Anmeldung und Rand auf diesem Endpunkt erzeugen
+ * koennen (`errorCodes.auth` ohne die sieben des Partner-Zugangs,
+ * `errorCodes.edge`), zuletzt `route_missing` (Code des Pakets). Ein Code
+ * ausserhalb bleibt ueber `KasseneckApiError.code` lesbar.
+ */
+exports.RECEIPT_OUTPUT_ERROR_CODES = Object.freeze([
+    'idempotency_key_required',
+    'invalid_output_kind',
+    'output_time_out_of_range',
+    'receipt_not_found',
+    'server_error',
+    'validation',
+    // Anmeldung und Rand (errorCodes.auth ohne Partner-Zugang, errorCodes.edge)
+    'account_not_found',
+    'action_confirmation_required',
+    'admin_required',
+    'api_not_approved',
+    'app_check_invalid',
+    'app_check_missing',
+    'cashregister_not_assigned',
+    'cashregister_not_found',
+    'cashregister_token_invalid',
+    'cashregister_token_missing',
+    'dialect_mismatch',
+    'internal_translation_error',
+    'live_not_enabled',
+    'method_not_allowed',
+    'mfa_required',
+    'not_found',
+    'password_change_required',
+    'register_user_no_business',
+    'register_user_not_allowed',
+    'register_user_not_found',
+    'response_translation_failed',
+    'second_factor_required',
+    'session_expired',
+    'session_other_cashregister',
+    'unauthorized',
+    'user_disabled',
+    'user_verification_failed',
+    // Code des Pakets (CLIENT_ERROR_CODES)
+    'route_missing',
+]);
+function isReceiptOutputErrorCode(value) {
+    return typeof value === 'string' && exports.RECEIPT_OUTPUT_ERROR_CODES.includes(value);
+}
+const BEKANNT = new Set(exports.RECEIPT_OUTPUT_ERROR_CODES);
+/** Der Code eines geworfenen Fehlers, wenn er in [RECEIPT_OUTPUT_ERROR_CODES] steht; sonst `undefined`. */
+function receiptOutputErrorCode(error) {
+    return (0, fehlercodes_js_1.bekannterCode)(error, BEKANNT);
+}
+/** Ohne `code`: traegt der Fehler ueberhaupt einen Code aus [RECEIPT_OUTPUT_ERROR_CODES]? */
+function isReceiptOutputError(error, code) {
+    const gefunden = receiptOutputErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+function receiptOutputFieldErrors(error) {
+    return (0, fehlercodes_js_1.feldfehlerVon)(error);
+}

package/dist/cjs/models/receipt.d.ts

@@ -155,10 +155,10 @@ export declare function readRegistrationInfo(roh: {
 export declare function receiptValueVoucherSign(receipt: Receipt): 1 | -1;
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
- * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
+ * eingeloeste Aktionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
  * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
- * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * ([receiptValueVoucherSign]), und ein gespiegelter Aktionsgutschein
  * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
  * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
  * nur auf eine positive Topfsumme, die ein Storno nie hat.

package/dist/cjs/models/receipt.js

@@ -150,10 +150,10 @@ function receiptValueVoucherSign(receipt) {
 }
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
- * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
+ * eingeloeste Aktionsgutscheine. Wertgutschein-Einloesungen wirken erst auf
  * [receiptSumCents], nicht hier (siehe Dart-Vorbild `subSumCents`/`sumCents`).
  * Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
- * ([receiptValueVoucherSign]), und ein gespiegelter Promotionsgutschein
+ * ([receiptValueVoucherSign]), und ein gespiegelter Aktionsgutschein
  * mindert nichts: den Rabatt nimmt der Server dort ueber Ausgleichspositionen
  * (`kind: 'discount'`) zurueck, und belegToepfe verteilt einen Promo-Eintrag
  * nur auf eine positive Topfsumme, die ein Storno nie hat.

package/dist/cjs/models/voucher.d.ts

@@ -38,6 +38,28 @@ export interface Voucher {
     exempt?: boolean;
     zeroRateBucket?: boolean;
 }
+/**
+ * Ein ausgestellter Gutschein in der Antwort von `createReceipt` unter `/v3`
+ * (`data.issuedVouchers[]`): der Klartext-Code erscheint hier einmalig fuer das Etikett.
+ */
+export interface IssuedVoucher {
+    id: string;
+    /** Klartext-Code; nie in Logs oder Fehlertexte schreiben. */
+    code: string;
+    type: string;
+    index: number;
+    codeSuffix: string;
+    faceValueCents?: number;
+    quantity?: number;
+    /** Nur bei Leistungsgutscheinen: Name des verkauften Artikels; sonst fehlt das Feld. */
+    articleName?: string;
+    validity?: {
+        pattern: string;
+        redeemableUntil: string | null;
+        refundableUntil: string | null;
+        validUntil: string | null;
+    };
+}
 /** Artikel eines Leistungsgutscheins, wie der Server ihn am Beleg festhaelt. */
 export interface VoucherArticle {
     id: string;
@@ -87,8 +109,8 @@ export declare function voucherServerFields(voucher: Voucher): string[];
 export declare function toVoucherPayload(voucher: Voucher): VoucherPayload;
 /**
  * Ist der Gutschein an das Backend sendbar? Zwilling von `KeckVoucher.isValid`
- * im Flutter-Vorbild: Wert- und Promotionsgutscheine brauchen einen Wert,
- * Promotionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
+ * im Flutter-Vorbild: Wert- und Aktionsgutscheine brauchen einen Wert,
+ * Aktionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
  * gesetzter Wert muss positiv sein.
  */
 export declare function voucherIsValid(voucher: Voucher): boolean;

package/dist/cjs/models/voucher.js

@@ -53,8 +53,8 @@ function toVoucherPayload(voucher) {
 }
 /**
  * Ist der Gutschein an das Backend sendbar? Zwilling von `KeckVoucher.isValid`
- * im Flutter-Vorbild: Wert- und Promotionsgutscheine brauchen einen Wert,
- * Promotionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
+ * im Flutter-Vorbild: Wert- und Aktionsgutscheine brauchen einen Wert,
+ * Aktionsgutscheine duerfen nur eingeloest (nicht verkauft) werden, und ein
  * gesetzter Wert muss positiv sein.
  */
 function voucherIsValid(voucher) {

package/dist/cjs/partner/typen.d.ts

@@ -104,7 +104,7 @@ export interface BusinessAddress {
     city: string;
 }
 export interface BusinessTaxDetails {
-    /** Steuernummer im Format `12-345/6789`; die Pruefziffer wird geprueft. */
+    /** Steuernummer im Format `91-123/4565`; die Pruefziffer wird geprueft. */
     taxNumber: string;
     smallBusiness: boolean;
     /**

package/dist/cjs/pos/index.d.ts

@@ -22,5 +22,6 @@ export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOU
 export { type GetMyDrawerStateOptions, type OpenMyShiftOptions, type RecordMyCashMovementOptions, type DrawerOpeningEntry, type LogMyDrawerOpeningsOptions, type GetMyShiftReportOptions, type TipPayout, type CloseMyShiftOptions, type AfterCountOption, getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, type ShiftTipLine, type ShiftTipLineKey, } from './schicht.js';
 export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
 export { type ShiftReceiptLayoutOptions, shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
+export { RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputKind, type ReceiptOutputResult } from '../models/receipt-output.js';
 export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.js';
-export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, receiptOutputLabel, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/cjs/pos/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.posTipKeptByDefault = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
 exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.posVoucherSettingsFromWire = exports.VOUCHER_SETTINGS_DEFAULTS = exports.reprintVoucherLabel = exports.checkVoucher = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = void 0;
-exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = void 0;
+exports.receiptOutputLabel = exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_KINDS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
@@ -141,6 +141,10 @@ Object.defineProperty(exports, "AFTER_COUNT_TYPES", { enumerable: true, get: fun
 var shift_sheet_js_1 = require("../receipt/shift-sheet.js");
 Object.defineProperty(exports, "shiftReceiptLayout", { enumerable: true, get: function () { return shift_sheet_js_1.shiftReceiptLayout; } });
 Object.defineProperty(exports, "cashMovementLayout", { enumerable: true, get: function () { return shift_sheet_js_1.cashMovementLayout; } });
+// Ausgaben eines Belegs (Belegdetail: Art und Ergebnis -> Beschriftung); dieselben Listen wie an der Wurzel.
+var receipt_output_js_1 = require("../models/receipt-output.js");
+Object.defineProperty(exports, "RECEIPT_OUTPUT_KINDS", { enumerable: true, get: function () { return receipt_output_js_1.RECEIPT_OUTPUT_KINDS; } });
+Object.defineProperty(exports, "RECEIPT_OUTPUT_RESULTS", { enumerable: true, get: function () { return receipt_output_js_1.RECEIPT_OUTPUT_RESULTS; } });
 // Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
 var cancellation_js_1 = require("../models/cancellation.js");
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
@@ -165,3 +169,4 @@ Object.defineProperty(exports, "voucherErrorMessage", { enumerable: true, get: f
 Object.defineProperty(exports, "LABELS", { enumerable: true, get: function () { return texte_js_1.LABELS; } });
 Object.defineProperty(exports, "labelText", { enumerable: true, get: function () { return texte_js_1.labelText; } });
 Object.defineProperty(exports, "RETURN_DISPOSITION_LABELS", { enumerable: true, get: function () { return texte_js_1.RETURN_DISPOSITION_LABELS; } });
+Object.defineProperty(exports, "receiptOutputLabel", { enumerable: true, get: function () { return texte_js_1.receiptOutputLabel; } });

package/dist/cjs/pos/schicht-typen.d.ts

@@ -37,10 +37,10 @@ export declare const CASH_LOCATIONS: readonly ["bank", "safe"];
 export type CashLocation = (typeof CASH_LOCATIONS)[number];
 /**
  * Warum die Lade aufging (Katalog `LADE_OEFFNUNG_GRUND`). `sale`,
- * `cash_movement`, `shift_open` und `shift_close` meldet die Kasse selbst beim
+ * `cash_movement`, `shift_open`, `shift_close` und `voucher_payout` meldet die Kasse selbst beim
  * jeweiligen Vorgang; von Hand waehlt der Kassier aus [MANUAL_OPENING_REASONS].
  */
-export declare const OPENING_REASONS: readonly ["sale", "cash_movement", "shift_open", "shift_close", "change", "check", "misoperation", "other"];
+export declare const OPENING_REASONS: readonly ["sale", "cash_movement", "shift_open", "shift_close", "change", "check", "misoperation", "other", "voucher_payout"];
 export type OpeningReason = (typeof OPENING_REASONS)[number];
 /** Die Gruende des Knopfs „Lade“; `other` braucht einen Text (`note`). */
 export declare const MANUAL_OPENING_REASONS: readonly ["change", "check", "misoperation", "other"];

package/dist/cjs/pos/schicht-typen.js

@@ -41,11 +41,11 @@ exports.MANUAL_MOVEMENT_TYPES = Object.freeze([
 exports.CASH_LOCATIONS = Object.freeze(['bank', 'safe']);
 /**
  * Warum die Lade aufging (Katalog `LADE_OEFFNUNG_GRUND`). `sale`,
- * `cash_movement`, `shift_open` und `shift_close` meldet die Kasse selbst beim
+ * `cash_movement`, `shift_open`, `shift_close` und `voucher_payout` meldet die Kasse selbst beim
  * jeweiligen Vorgang; von Hand waehlt der Kassier aus [MANUAL_OPENING_REASONS].
  */
 exports.OPENING_REASONS = Object.freeze([
-    'sale', 'cash_movement', 'shift_open', 'shift_close', 'change', 'check', 'misoperation', 'other',
+    'sale', 'cash_movement', 'shift_open', 'shift_close', 'change', 'check', 'misoperation', 'other', 'voucher_payout',
 ]);
 /** Die Gruende des Knopfs „Lade“; `other` braucht einen Text (`note`). */
 exports.MANUAL_OPENING_REASONS = Object.freeze(['change', 'check', 'misoperation', 'other']);

package/dist/cjs/pos/settings.d.ts

@@ -199,7 +199,7 @@ export interface PosBusinessSettings {
     tipKeptByDefault?: boolean;
 }
 /** Aktionen der Kasse, die eine Taste bekommen koennen (Schluessel von `device.shortcuts`). */
-export declare const POS_SHORTCUT_ACTIONS: readonly ["checkout", "complete", "cancel", "customAmount", "cash", "card", "exactAmount", "receipts", "undoLast", "settings", "logout", "tip", "fullscreen", "clearTendered", "clearCart", "splitPayment"];
+export declare const POS_SHORTCUT_ACTIONS: readonly ["checkout", "complete", "cancel", "customAmount", "cash", "card", "exactAmount", "receipts", "undoLast", "settings", "logout", "tip", "fullscreen", "clearTendered", "clearCart", "splitPayment", "shiftStatus", "openDrawer", "voucherPayout"];
 export type PosShortcutAction = typeof POS_SHORTCUT_ACTIONS[number];
 /** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
 export type PosShortcutMap = Record<PosShortcutAction, string[]>;

package/dist/cjs/pos/settings.js

@@ -103,6 +103,7 @@ exports.DONE_SCREEN_SECONDS = [0, 3, 5, 10, 15, 30, 60];
 exports.POS_SHORTCUT_ACTIONS = [
     'checkout', 'complete', 'cancel', 'customAmount', 'cash', 'card', 'exactAmount', 'receipts', 'undoLast',
     'settings', 'logout', 'tip', 'fullscreen', 'clearTendered', 'clearCart', 'splitPayment',
+    'shiftStatus', 'openDrawer', 'voucherPayout',
 ];
 exports.POS_SHORTCUT_DEFAULTS = Object.freeze({
     checkout: ['Enter'], complete: ['Enter'], cancel: ['Escape'],
@@ -126,6 +127,10 @@ exports.POS_SHORTCUT_DEFAULTS = Object.freeze({
     // Bewusst ohne Vorgabe: jede freie Mod-Taste ist in irgendeinem Browser
     // belegt oder am Geraet unerprobt. Der Chef vergibt sie, wenn er sie braucht.
     splitPayment: [],
+    // Ebenso ohne Vorgabe: Kassenstand, Kassenlade und Gutschein auszahlen. Der
+    // Server fuehrt sie nicht in seiner Vorgabekarte; fehlen sie in einer
+    // Antwort, heisst das „keine Taste“ (leere Liste), nie eine geratene Taste.
+    shiftStatus: [], openDrawer: [], voucherPayout: [],
 });
 /**
  * Aktionen, die sich eine Taste teilen duerfen (Backend `TASTEN_PAARE`): sie

package/dist/cjs/pos/texte.d.ts

@@ -20,6 +20,7 @@
  * `only`), die Platzhalter und die Arten der Fehlerregeln (Abschnitte
  * `placeholders` und `structure`).
  */
+import type { ReceiptOutput } from '../models/receipt-output.js';
 import { type ErrorOutcome } from '../client/errors.js';
 export type Surface = 'web' | 'app';
 export interface TextEntry {
@@ -1669,6 +1670,9 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'drawer.reason_shift_close': {
         readonly text: "Schichtabschluss";
     };
+    readonly 'drawer.reason_voucher_payout': {
+        readonly text: "Gutschein-Auszahlung";
+    };
     readonly 'shift.resend': {
         readonly text: "Erneut senden";
     };
@@ -1766,6 +1770,79 @@ declare const BESCHRIFTUNGEN_ROH: {
         readonly text: "Gutschein ····-{suffix}";
         readonly placeholders: readonly ["suffix"];
     };
+    readonly 'quantity.at_most': {
+        readonly text: "höchstens {count}";
+        readonly placeholders: readonly ["count"];
+    };
+    readonly 'quantity.at_least': {
+        readonly text: "mindestens {count}";
+        readonly placeholders: readonly ["count"];
+    };
+    readonly 'receipts.number_hint': {
+        readonly text: "Nummer";
+    };
+    readonly 'receipts.clear_number': {
+        readonly text: "Nummer löschen";
+    };
+    readonly 'receipts.open': {
+        readonly text: "Öffnen";
+    };
+    readonly 'receipt.creating': {
+        readonly text: "Beleg wird erstellt …";
+    };
+    readonly 'receipt_done.sale_title': {
+        readonly text: "Verkauf abgeschlossen";
+    };
+    readonly 'receipt_done.paid_by_voucher': {
+        readonly text: "mit Gutschein bezahlt";
+    };
+    readonly 'receipt_done.payout_title': {
+        readonly text: "Auszahlung abgeschlossen";
+    };
+    readonly 'receipt_done.paid_out': {
+        readonly text: "{method} ausgezahlt";
+        readonly placeholders: readonly ["method"];
+    };
+    readonly 'voucher.code_mask': {
+        readonly text: "····-{suffix}";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'cart.close': {
+        readonly text: "Warenkorb schließen";
+    };
+    readonly 'nav.register': {
+        readonly text: "Kasse";
+    };
+    readonly 'nav.receipts': {
+        readonly text: "Belege";
+    };
+    readonly 'nav.vouchers': {
+        readonly text: "Gutscheine";
+    };
+    readonly 'nav.open_drawer': {
+        readonly text: "Kassenlade öffnen";
+    };
+    readonly 'nav.stocktake': {
+        readonly text: "Inventur";
+    };
+    readonly 'nav.settings': {
+        readonly text: "Einstellungen";
+    };
+    readonly 'nav.settings_locked': {
+        readonly text: "nur mit Chef-Anmeldung";
+    };
+    readonly 'nav.logout': {
+        readonly text: "Abmelden";
+    };
+    readonly 'nav.logging_out': {
+        readonly text: "Wird abgemeldet …";
+    };
+    readonly 'nav.fullscreen': {
+        readonly text: "Vollbild";
+    };
+    readonly 'nav.fullscreen_exit': {
+        readonly text: "Vollbild verlassen";
+    };
     readonly 'voucher.covers_items': {
         readonly text: "Deckt: {items}";
         readonly placeholders: readonly ["items"];
@@ -1988,6 +2065,35 @@ declare const BESCHRIFTUNGEN_ROH: {
         readonly text: "{amount} auszahlen";
         readonly placeholders: readonly ["amount"];
     };
+    readonly 'receipt.outputs_title': {
+        readonly text: "Ausgaben";
+    };
+    readonly 'receipt.outputs_count': {
+        readonly text: "{count} Ausgaben";
+        readonly placeholders: readonly ["count"];
+    };
+    readonly 'receipt.output_print': {
+        readonly text: "Erstdruck";
+    };
+    readonly 'receipt.output_reprint': {
+        readonly text: "Duplikat";
+    };
+    readonly 'receipt.output_email': {
+        readonly text: "E-Mail";
+    };
+    readonly 'receipt.output_link_shared': {
+        readonly text: "Link geteilt";
+    };
+    readonly 'receipt.output_pdf_shared': {
+        readonly text: "PDF geteilt";
+    };
+    readonly 'receipt.output_opened': {
+        readonly text: "Link geöffnet ({count}×)";
+        readonly placeholders: readonly ["count"];
+    };
+    readonly 'receipt.output_failed': {
+        readonly text: "fehlgeschlagen";
+    };
 };
 export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
 export declare const LABELS: Record<LabelKey, TextEntry>;
@@ -2002,6 +2108,14 @@ export declare const RETURN_DISPOSITION_LABELS: {
     readonly defective: "stock.return_defective";
     readonly disposed: "stock.return_disposed";
 };
+/**
+ * Die Beschriftung der Art einer Ausgabe (Belegdetail, Zeile „Ausgaben“), nie
+ * eine Ausnahme: `null` bei einer Art, die dieses Paket nicht kennt (neuerer
+ * Server); `opened` ohne gueltige Anzahl (ganze Zahl ab 1) zaehlt als ein
+ * Abruf. Nur die Art: „fehlgeschlagen“ (`receipt.output_failed`) setzt die
+ * Kasse selbst dazu, wenn `result` `failed` ist.
+ */
+export declare function receiptOutputLabel(output: ReceiptOutput): string | null;
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 export declare function labelText(key: LabelKey, values?: Record<string, string | number>): string;
 /** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */

package/dist/cjs/pos/texte.js

@@ -28,6 +28,7 @@ exports.messageOutcome = messageOutcome;
 exports.receiptEmailErrorMessage = receiptEmailErrorMessage;
 exports.cancellationPaymentErrorMessage = cancellationPaymentErrorMessage;
 exports.voucherErrorMessage = voucherErrorMessage;
+exports.receiptOutputLabel = receiptOutputLabel;
 exports.labelText = labelText;
 exports.messageText = messageText;
 exports.messageAppliesTo = messageAppliesTo;
@@ -878,6 +879,7 @@ const BESCHRIFTUNGEN_ROH = {
     'drawer.reason_cash_movement': { text: 'Kassenbewegung' },
     'drawer.reason_shift_open': { text: 'Schichtbeginn' },
     'drawer.reason_shift_close': { text: 'Schichtabschluss' },
+    'drawer.reason_voucher_payout': { text: 'Gutschein-Auszahlung' },
     'shift.resend': { text: 'Erneut senden' },
     'shift.next': { text: 'Weiter' },
     'shift.print_close': { text: 'Schichtabschluss drucken' },
@@ -910,6 +912,30 @@ const BESCHRIFTUNGEN_ROH = {
     'voucher.service': { text: 'Leistungsgutschein' },
     'voucher.promotion': { text: 'Aktionsgutschein' },
     'voucher.payment_line': { text: 'Gutschein ····-{suffix}', placeholders: ['suffix'] },
+    // Kassen-Navigation, Beleg-Fertig-Seite, Mengen (Paket-Nachzug Gutscheine).
+    'quantity.at_most': { text: 'höchstens {count}', placeholders: ['count'] },
+    'quantity.at_least': { text: 'mindestens {count}', placeholders: ['count'] },
+    'receipts.number_hint': { text: 'Nummer' },
+    'receipts.clear_number': { text: 'Nummer löschen' },
+    'receipts.open': { text: 'Öffnen' },
+    'receipt.creating': { text: 'Beleg wird erstellt …' },
+    'receipt_done.sale_title': { text: 'Verkauf abgeschlossen' },
+    'receipt_done.paid_by_voucher': { text: 'mit Gutschein bezahlt' },
+    'receipt_done.payout_title': { text: 'Auszahlung abgeschlossen' },
+    'receipt_done.paid_out': { text: '{method} ausgezahlt', placeholders: ['method'] },
+    'voucher.code_mask': { text: '····-{suffix}', placeholders: ['suffix'] },
+    'cart.close': { text: 'Warenkorb schließen' },
+    'nav.register': { text: 'Kasse' },
+    'nav.receipts': { text: 'Belege' },
+    'nav.vouchers': { text: 'Gutscheine' },
+    'nav.open_drawer': { text: 'Kassenlade öffnen' },
+    'nav.stocktake': { text: 'Inventur' },
+    'nav.settings': { text: 'Einstellungen' },
+    'nav.settings_locked': { text: 'nur mit Chef-Anmeldung' },
+    'nav.logout': { text: 'Abmelden' },
+    'nav.logging_out': { text: 'Wird abgemeldet …' },
+    'nav.fullscreen': { text: 'Vollbild' },
+    'nav.fullscreen_exit': { text: 'Vollbild verlassen' },
     'voucher.covers_items': { text: 'Deckt: {items}', placeholders: ['items'] },
     'voucher.code_shown_once': { text: 'Code nur jetzt sichtbar: {code}', placeholders: ['code'] },
     'voucher.not_in_split': { text: 'Gutscheine gehen beim getrennten Kassieren nicht.' },
@@ -986,6 +1012,18 @@ const BESCHRIFTUNGEN_ROH = {
     'shift.pay_outs': { text: 'Auszahlungen' },
     'cash_movement.pay_in_amount': { text: '{amount} einzahlen', placeholders: ['amount'] },
     'cash_movement.pay_out_amount': { text: '{amount} auszahlen', placeholders: ['amount'] },
+    // Belegdetail: Zeile „Ausgaben“ (eingeklappt mit Anzahl), aufgeklappt je Eintrag die Art
+    // (`receipt.output_<kind>`, Arten wie RECEIPT_OUTPUT_KINDS), dazu „fehlgeschlagen“ bei Ergebnis `failed`.
+    // `{count}` beim Abruf ist die Zahl der Abrufe in dieser Stunde.
+    'receipt.outputs_title': { text: 'Ausgaben' },
+    'receipt.outputs_count': { text: '{count} Ausgaben', placeholders: ['count'] },
+    'receipt.output_print': { text: 'Erstdruck' },
+    'receipt.output_reprint': { text: 'Duplikat' },
+    'receipt.output_email': { text: 'E-Mail' },
+    'receipt.output_link_shared': { text: 'Link geteilt' },
+    'receipt.output_pdf_shared': { text: 'PDF geteilt' },
+    'receipt.output_opened': { text: 'Link geöffnet ({count}×)', placeholders: ['count'] },
+    'receipt.output_failed': { text: 'fehlgeschlagen' },
 };
 exports.LABELS = BESCHRIFTUNGEN_ROH;
 /**
@@ -999,6 +1037,32 @@ exports.RETURN_DISPOSITION_LABELS = {
     defective: 'stock.return_defective',
     disposed: 'stock.return_disposed',
 };
+/** Art einer Ausgabe -> Beschriftung (`receipt.output_<kind>`). */
+const AUSGABE_BESCHRIFTUNG = {
+    print: 'receipt.output_print',
+    reprint: 'receipt.output_reprint',
+    email: 'receipt.output_email',
+    link_shared: 'receipt.output_link_shared',
+    pdf_shared: 'receipt.output_pdf_shared',
+    opened: 'receipt.output_opened',
+};
+/**
+ * Die Beschriftung der Art einer Ausgabe (Belegdetail, Zeile „Ausgaben“), nie
+ * eine Ausnahme: `null` bei einer Art, die dieses Paket nicht kennt (neuerer
+ * Server); `opened` ohne gueltige Anzahl (ganze Zahl ab 1) zaehlt als ein
+ * Abruf. Nur die Art: „fehlgeschlagen“ (`receipt.output_failed`) setzt die
+ * Kasse selbst dazu, wenn `result` `failed` ist.
+ */
+function receiptOutputLabel(output) {
+    const art = output?.kind;
+    if (typeof art !== 'string' || !Object.prototype.hasOwnProperty.call(AUSGABE_BESCHRIFTUNG, art))
+        return null;
+    const key = AUSGABE_BESCHRIFTUNG[art];
+    if (art !== 'opened')
+        return labelText(key);
+    const anzahl = output.count;
+    return labelText(key, { count: typeof anzahl === 'number' && Number.isSafeInteger(anzahl) && anzahl >= 1 ? anzahl : 1 });
+}
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */
 function labelText(key, values = {}) {
     return ersetze(`labelText(${key})`, exports.LABELS[key].text, values);

package/dist/cjs/receipt/due.d.ts

@@ -183,7 +183,8 @@ export interface VoucherRedeemContext {
  * Hoechstbetrag zum Vorbelegen einer Einloesung an der Kasse, in Cent, nie
  * negativ: der groesste Betrag, den der Server fuer diesen Gutschein annimmt.
  *
- * Obergrenze: Saldo, offener Betrag; bei Einzweck die deckbaren Positionen im
+ * Obergrenze: Saldo, offener Betrag ohne Trinkgeld (ein Gutschein deckt nie
+ * das Trinkgeld, Personal wie Inhaber); bei Einzweck die deckbaren Positionen im
  * Topf seines Satzes abzueglich der schon gewaehlten Einloesungen dort. Befreit
  * verkauft bzw. als Kleinunternehmer verteilt der Server anteilig auf alle
  * Saetze (`kuTeile`); dann begrenzt jeder Topf: sein Anteil plus die schon
@@ -195,6 +196,7 @@ export interface VoucherRedeemContext {
  * Bisektion ueber [1, Grenze] und prueft danach 16 Cent aufwaerts: am Rand
  * des groessten Rests ist die Annahme nicht monoton. Leistung (wird ueber
  * Positionen eingeloest), Aktion (Rabatt rechnet der Server) und jeder nicht
- * aktive Gutschein: 0.
+ * aktive Gutschein: 0. Wirft nie [ReceiptDueError]: ist der Beleg ohne den
+ * Gutschein nicht rechenbar (etwa `tip_without_goods`), ist das Ergebnis 0.
  */
 export declare function voucherRedeemMaxCents(items: readonly ReceiptItem[], voucher: VoucherCheck, before?: VoucherRedeemContext): number;