@kreiseck/kasseneck-api 1.13.0 → 1.14.0

package/dist/esm/models/voucher.js

@@ -45,8 +45,8 @@ export 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.
  */
 export function voucherIsValid(voucher) {

package/dist/esm/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/esm/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/esm/pos/index.js

@@ -26,7 +26,9 @@ export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOU
 export { getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, } from './schicht.js';
 export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, } from './schicht-typen.js';
 export { shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
+// Ausgaben eines Belegs (Belegdetail: Art und Ergebnis -> Beschriftung); dieselben Listen wie an der Wurzel.
+export { RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS } from '../models/receipt-output.js';
 // Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
 export { RETURN_DISPOSITIONS, isReturnDisposition } from '../models/cancellation.js';
 // Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
-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, } 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, } from './texte.js';

package/dist/esm/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/esm/pos/schicht-typen.js

@@ -38,11 +38,11 @@ export const MANUAL_MOVEMENT_TYPES = Object.freeze([
 export const 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].
  */
 export const 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`). */
 export const MANUAL_OPENING_REASONS = Object.freeze(['change', 'check', 'misoperation', 'other']);

package/dist/esm/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/esm/pos/settings.js

@@ -92,6 +92,7 @@ export const DONE_SCREEN_SECONDS = [0, 3, 5, 10, 15, 30, 60];
 export const POS_SHORTCUT_ACTIONS = [
     'checkout', 'complete', 'cancel', 'customAmount', 'cash', 'card', 'exactAmount', 'receipts', 'undoLast',
     'settings', 'logout', 'tip', 'fullscreen', 'clearTendered', 'clearCart', 'splitPayment',
+    'shiftStatus', 'openDrawer', 'voucherPayout',
 ];
 export const POS_SHORTCUT_DEFAULTS = Object.freeze({
     checkout: ['Enter'], complete: ['Enter'], cancel: ['Escape'],
@@ -115,6 +116,10 @@ export const 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/esm/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/esm/pos/texte.js

@@ -867,6 +867,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' },
@@ -899,6 +900,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.' },
@@ -975,6 +1000,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' },
 };
 export const LABELS = BESCHRIFTUNGEN_ROH;
 /**
@@ -988,6 +1025,32 @@ export const 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.
+ */
+export 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`. */
 export function labelText(key, values = {}) {
     return ersetze(`labelText(${key})`, LABELS[key].text, values);

package/dist/esm/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;

package/dist/esm/receipt/due.js

@@ -1,7 +1,7 @@
 import { ReceiptType, VoucherAction, VoucherType } from '../enums/index.js';
 import { VoucherCode } from '@kreiseck/validator';
 import { toViennaWallClock } from '../vienna-time.js';
-import { centSumme, istDeckbar, kuSaetze, planeGutscheine, topfFuerSatz, } from './gutschein-plan.js';
+import { centSumme, istDeckbar, kuSaetze, planeGutscheine, topfFuerSatz, trinkgeldCents, } from './gutschein-plan.js';
 export { VOUCHER_ZERO_RATE_BUCKET_FROM } from './gutschein-plan.js';
 /**
  * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
@@ -101,6 +101,12 @@ function rechne(items, vouchers, receiptType, options) {
     if (plan.mitPlan && dueCents + plan.auszahlungCents < 0) {
         throw new ReceiptDueError('invalid_voucher', 'die Gutscheine uebersteigen die Summe des Belegs.', 'voucher_exceeds_total');
     }
+    // Ein Gutschein deckt nie das Trinkgeld (Personal wie Inhaber): der Zahlbetrag nach den Gutscheinen
+    // muss die Trinkgeldzeilen tragen. Storno ausgenommen (dort gibt es keinen Plan).
+    const trinkgeld = trinkgeldCents(kunde);
+    if (plan.mitPlan && art !== 'cancellation' && trinkgeld > 0 && dueCents + plan.auszahlungCents < trinkgeld) {
+        throw new ReceiptDueError('invalid_voucher', 'die Gutscheine decken das Trinkgeld.', 'voucher_exceeds_total');
+    }
     return {
         ergebnis: {
             dueCents,
@@ -124,7 +130,8 @@ function rechne(items, vouchers, receiptType, options) {
  * 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
@@ -136,7 +143,8 @@ function rechne(items, vouchers, receiptType, options) {
  * 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 function voucherRedeemMaxCents(items, voucher, before = {}) {
     if (voucher.status !== 'active')
@@ -146,9 +154,18 @@ export function voucherRedeemMaxCents(items, voucher, before = {}) {
     const saldo = Number.isInteger(voucher.balanceCents) ? voucher.balanceCents : 0;
     const options = before.options ?? {};
     const vorher = before.vouchers ?? [];
-    const r = rechne(items, vorher, 'standard', options);
-    // Rundung je Topf: hoechstens ein halber Cent je Topf ueber dem offenen Betrag.
-    let oben = Math.min(saldo, r.ergebnis.dueCents + r.auszahlungCents + 6, HOECHSTBETRAG_CENTS);
+    let r;
+    try {
+        r = rechne(items, vorher, 'standard', options);
+    }
+    catch (fehler) {
+        // Nicht rechenbar (etwa Trinkgeld ohne Ware): nichts vorbelegen, die Kasse meldet es beim Zahlbetrag.
+        if (fehler instanceof ReceiptDueError)
+            return 0;
+        throw fehler;
+    }
+    // Rundung je Topf: hoechstens ein halber Cent je Topf ueber dem offenen Betrag. Das Trinkgeld deckt nie ein Gutschein.
+    let oben = Math.min(saldo, r.ergebnis.dueCents + r.auszahlungCents - trinkgeldCents(r.kunde) + 6, HOECHSTBETRAG_CENTS);
     if (voucher.type === 'single_purpose') {
         const deckbar = r.kunde.filter(istDeckbar);
         const topfBasis = (topf) => centSumme(deckbar.filter((it) => topfFuerSatz(it.vat) === topf));

package/dist/esm/receipt/duplikat.d.ts

@@ -0,0 +1,35 @@
+import type { ReceiptLayout } from './layout.js';
+/**
+ * Kennzeichnet einen Nachdruck als **Belegduplikat**. Registrierkassen-Erlass
+ * BMF-AV Nr. 2/2026, Abschnitt 4.5.6: „Ein Belegduplikat ist als solches zu
+ * bezeichnen, nicht nochmals zu signieren, nicht neuerlich im
+ * Datenerfassungsprotokoll aufzunehmen und darf zu keiner Veränderung des
+ * Umsatzzählers führen.“ Signatur, DEP und Zähler bleiben ohnehin unberührt,
+ * weil ein Nachdruck den gespeicherten Beleg druckt; diese Funktion liefert
+ * die Bezeichnung.
+ *
+ * Die Kasse ruft sie bei **jedem** Nachdruck und bei „Kopie drucken“ mit dem
+ * Zeitpunkt des Drucks auf, nie beim Erstdruck und nie fuer Mail, Link oder
+ * PDF, und gibt das Ergebnis an denselben Druckweg (`escPosLayoutBytes`,
+ * `eposPrintXml`, `receiptSheet`, React-Ansicht).
+ *
+ * Neu ist genau eine Zeile im Kennungsblock, direkt unter `Beleg-ID:`, in
+ * der Spaltenform von `Datum:` (nicht fett, Wert rechtsbuendig):
+ *
+ * ```
+ * Beleg-ID:          AT0-KASSE1-42
+ * Duplikat am: 24.10.2026 14:10:05
+ * ```
+ *
+ * `printedAt` ist ein Zeitpunkt; gedruckt wird er in Wiener Zeit
+ * (Sommerzeit nach EU-Regel), nie in der Zeitzone des Rechners. Ohne
+ * Spaltenzeile `Beleg-ID:` (Schicht-Bons) steht die Zeile ganz oben. Alles
+ * andere bleibt Zeile fuer Zeile wie beim Erstdruck.
+ *
+ * Reine Funktion: die Eingabe bleibt unangetastet, das Ergebnis ist eine
+ * eigene Kopie. Traegt das Layout schon eine Zeile `Duplikat am:`, bekommt
+ * nur sie die neue Zeit (der letzte Nachdruck gilt); es bleibt bei einer
+ * Zeile. Ein unbrauchbarer Zeitpunkt wirft `KasseneckValidationError`
+ * (`scope: 'request'`).
+ */
+export declare function markAsDuplicate(layout: ReceiptLayout, printedAt: Date): ReceiptLayout;

package/dist/esm/receipt/duplikat.js

@@ -0,0 +1,73 @@
+import { KasseneckValidationError } from '../client/errors.js';
+import { toViennaWallClock } from '../vienna-time.js';
+/** Beschriftung der Duplikat-Zeile; derselbe Text im Dart-Zwilling. */
+const DUPLIKAT_AM = 'Duplikat am:';
+/**
+ * Spaltenbreiten in Zwoelfteln. 5:7 setzt Beschriftung (12 Zeichen) und Zeit
+ * (19 Zeichen) auf 32 und 48 Zeichen ohne Umbruch in eine Zeile, den Wert am
+ * rechten Rand wie bei `Datum:`: 13 + 19 bzw. 20 + 28 Zeichen. Die Breiten
+ * von `Beleg-ID:` (6:6) und `Datum:` (4:8) reichen auf 32 Zeichen nicht.
+ */
+const LINKS = 5;
+const RECHTS = 7;
+/** Eigene Kopie einer Zeile: wer am Duplikat dreht, dreht nie am Erstdruck. */
+function kopie(zeile) {
+    return zeile.kind === 'columns' ? { ...zeile, columns: zeile.columns.map((c) => ({ ...c })) } : { ...zeile };
+}
+const istZeile = (z, beschriftung) => z.kind === 'columns' && z.columns[0]?.text === beschriftung;
+/** Zeitpunkt als `TT.MM.JJJJ HH:MM:SS` in Wiener Zeit; Bruchteile fallen weg. */
+function wienerZeit(zeitpunkt) {
+    const t = toViennaWallClock(zeitpunkt);
+    const zwei = (n) => String(n).padStart(2, '0');
+    return `${zwei(t.day)}.${zwei(t.month)}.${t.year} ${zwei(t.hour)}:${zwei(t.minute)}:${zwei(t.second)}`;
+}
+/**
+ * Kennzeichnet einen Nachdruck als **Belegduplikat**. Registrierkassen-Erlass
+ * BMF-AV Nr. 2/2026, Abschnitt 4.5.6: „Ein Belegduplikat ist als solches zu
+ * bezeichnen, nicht nochmals zu signieren, nicht neuerlich im
+ * Datenerfassungsprotokoll aufzunehmen und darf zu keiner Veränderung des
+ * Umsatzzählers führen.“ Signatur, DEP und Zähler bleiben ohnehin unberührt,
+ * weil ein Nachdruck den gespeicherten Beleg druckt; diese Funktion liefert
+ * die Bezeichnung.
+ *
+ * Die Kasse ruft sie bei **jedem** Nachdruck und bei „Kopie drucken“ mit dem
+ * Zeitpunkt des Drucks auf, nie beim Erstdruck und nie fuer Mail, Link oder
+ * PDF, und gibt das Ergebnis an denselben Druckweg (`escPosLayoutBytes`,
+ * `eposPrintXml`, `receiptSheet`, React-Ansicht).
+ *
+ * Neu ist genau eine Zeile im Kennungsblock, direkt unter `Beleg-ID:`, in
+ * der Spaltenform von `Datum:` (nicht fett, Wert rechtsbuendig):
+ *
+ * ```
+ * Beleg-ID:          AT0-KASSE1-42
+ * Duplikat am: 24.10.2026 14:10:05
+ * ```
+ *
+ * `printedAt` ist ein Zeitpunkt; gedruckt wird er in Wiener Zeit
+ * (Sommerzeit nach EU-Regel), nie in der Zeitzone des Rechners. Ohne
+ * Spaltenzeile `Beleg-ID:` (Schicht-Bons) steht die Zeile ganz oben. Alles
+ * andere bleibt Zeile fuer Zeile wie beim Erstdruck.
+ *
+ * Reine Funktion: die Eingabe bleibt unangetastet, das Ergebnis ist eine
+ * eigene Kopie. Traegt das Layout schon eine Zeile `Duplikat am:`, bekommt
+ * nur sie die neue Zeit (der letzte Nachdruck gilt); es bleibt bei einer
+ * Zeile. Ein unbrauchbarer Zeitpunkt wirft `KasseneckValidationError`
+ * (`scope: 'request'`).
+ */
+export function markAsDuplicate(layout, printedAt) {
+    if (!(printedAt instanceof Date) || Number.isNaN(printedAt.getTime())) {
+        throw new KasseneckValidationError('markAsDuplicate', 'printedAt: kein gueltiger Zeitpunkt (Date)', 'request');
+    }
+    const neu = {
+        kind: 'columns',
+        columns: [
+            { text: DUPLIKAT_AM, width: LINKS, align: 'left' },
+            { text: wienerZeit(printedAt), width: RECHTS, align: 'right' },
+        ],
+    };
+    const vorhanden = layout.lines.findIndex((z) => istZeile(z, DUPLIKAT_AM));
+    const lines = layout.lines.filter((z) => !istZeile(z, DUPLIKAT_AM)).map(kopie);
+    const stelle = vorhanden >= 0 ? vorhanden : lines.findIndex((z) => istZeile(z, 'Beleg-ID:')) + 1;
+    lines.splice(stelle, 0, neu);
+    return { ...layout, lines };
+}

package/dist/esm/receipt/gutschein-plan.d.ts

@@ -89,6 +89,8 @@ type TopfName = 'amountRateStandard' | 'amountRateReduced1' | 'amountRateReduced
 export declare function topfFuerSatz(vat: number): TopfName;
 /** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
 export declare function istDeckbar(p: Innen): boolean;
+/** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
+export declare function trinkgeldCents(kunde: readonly Innen[]): number;
 /** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
 export declare function centSumme(liste: readonly Innen[]): number;
 /** Die Saetze, auf die `kuTeile` verteilt: je Satz `centSumme` der deckbaren Positionen, nur positive. */

package/dist/esm/receipt/gutschein-plan.js

@@ -29,6 +29,10 @@ function istGutscheinZeile(p) {
 export function istDeckbar(p) {
     return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
 }
+/** Summe der Trinkgeldzeilen (Personal und Inhaber) in Cent, wie `centSumme(kunde.filter(istTip))` im Backend. */
+export function trinkgeldCents(kunde) {
+    return centSumme(kunde.filter((p) => p.tip != null || p.kind === 'tip'));
+}
 /** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
 export function centSumme(liste) {
     return Math.round(liste.reduce((s, it) => s + it.priceOne * it.amount, 0) * 100);

package/dist/esm/receipt/index.d.ts

@@ -1,4 +1,5 @@
 export { type LayoutAlign, type LayoutColumn, type LayoutTextLine, type LayoutColumnsLine, type LayoutRuleLine, type LayoutSpaceLine, type LayoutQrLine, type LayoutLine, type ReceiptLayout, type BuildReceiptLayoutOptions, buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, CURRENT_LAYOUT_RULESET, type LayoutBannerLine, type LayoutBannerTone, type LayoutRuleset, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
+export { markAsDuplicate } from './duplikat.js';
 export { type EscPosLayoutOptions, type EscPosLayoutResult, type QrPrintMode, type PrintLogo, assertLogoRaster, escPosLayoutBytes, escPosLayoutResult, } from './layout-escpos.js';
 export { type GridLine, type GridLineKind, type ReceiptGrid, type RenderReceiptGridOptions, renderReceiptGrid, gridColumnWidths, gridToText, CHARS_PER_PAPER_SIZE, } from './grid.js';
 export { type EposPrintXmlOptions, type EposPrintResult, type EposDirectOptions, type EposResponse, EposConnectionError, eposPrintXml, eposPrintXmlResult, eposXmlEscape, eposImageXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';

package/dist/esm/receipt/index.js

@@ -1,4 +1,5 @@
 export { buildReceiptLayout, receiptSignatureFailed, receiptSignatureIsTest, receiptIsZero, receiptAmountsAreZero, receiptIsSmallBusinessConsistent, receiptZdaText, CURRENT_LAYOUT_RULESET, SMALL_BUSINESS_NOTICE, formatCents, } from './layout.js';
+export { markAsDuplicate } from './duplikat.js';
 export { assertLogoRaster, escPosLayoutBytes, escPosLayoutResult, } from './layout-escpos.js';
 export { renderReceiptGrid, gridColumnWidths, gridToText, CHARS_PER_PAPER_SIZE, } from './grid.js';
 export { EposConnectionError, eposPrintXml, eposPrintXmlResult, eposXmlEscape, eposImageXml, eposServiceUrl, eposSoapEnvelope, eposParseResponse, eposDirectPrint, eposDirectStatus } from './epos.js';