@kreiseck/kasseneck-api 1.12.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 {
@@ -370,6 +371,52 @@ declare const MELDUNGEN_ROH: {
     readonly 'voucher_error.sale_off': {
         readonly text: "Gutscheine verkaufen geht hier noch nicht.";
     };
+    readonly 'voucher.reentry_needed': {
+        readonly text: "Die Karte ist belastet, der Beleg fehlt noch: zu jedem Gutschein den Code erneut eingeben, dann den Beleg abschließen.";
+    };
+    readonly 'voucher.reentry_mismatch': {
+        readonly text: "Mit diesen Gutscheinen ergibt der Beleg nicht mehr den belasteten Betrag – die Karte zurückbuchen.";
+    };
+    readonly 'voucher.not_this_voucher': {
+        readonly text: "Das ist nicht der Gutschein ····-{suffix}.";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'voucher.reentry_no_permission': {
+        readonly text: "Die Karte ist belastet, der Beleg fehlt noch: den Gutschein-Code kann nur jemand mit dem Recht zum Einlösen nachtragen – sonst die Karte zurückbuchen.";
+    };
+    readonly 'voucher.already_covered': {
+        readonly text: "Diese Positionen deckt schon ein anderer Gutschein.";
+    };
+    readonly 'voucher.payout_reason_too_long': {
+        readonly text: "Der Grund hat höchstens 200 Zeichen.";
+    };
+    readonly 'voucher.payout_reason_missing': {
+        readonly text: "Für die Auszahlung fehlt der Grund.";
+    };
+    readonly 'voucher.payout_check_first': {
+        readonly text: "Die letzte Auszahlung ging unklar aus und kann schon gebucht sein. Erst unter „Belege“ die Liste neu laden und nachsehen, dann ist eine neue möglich.";
+    };
+    readonly 'voucher.sale_max_amount': {
+        readonly text: "Höchstens {amount} je Gutschein.";
+        readonly placeholders: readonly ["amount"];
+    };
+    readonly 'voucher.sale_not_at_terminal': {
+        readonly text: "Gutscheine mit Karte am Terminal zu verkaufen geht an dieser Kasse noch nicht – bar kassieren.";
+    };
+    readonly 'voucher.no_redeem_with_sale': {
+        readonly text: "Auf einem Beleg, der Gutscheine verkauft, lässt sich kein Gutschein einlösen.";
+    };
+    readonly 'voucher.code_not_on_receipt': {
+        readonly text: "Der Code steht nicht auf dem Bon – jetzt auf den Gutschein schreiben.";
+    };
+    readonly 'cancellation.voucher_sale_cancelled': {
+        readonly text: "Der Gutschein ····-{suffix} wird mitstorniert und gilt danach nicht mehr.";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'cancellation.promo_valid_again': {
+        readonly text: "Der Aktionsgutschein ····-{suffix} gilt danach wieder.";
+        readonly placeholders: readonly ["suffix"];
+    };
     readonly 'split.setting_hint': {
         readonly text: "Ein Tisch zahlt in Teilen: jede Zahlung bar oder mit Karte, mit eigenem Trinkgeld – am Ende ein Beleg für alles.";
     };
@@ -1623,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";
     };
@@ -1720,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"];
@@ -1746,6 +1869,33 @@ declare const BESCHRIFTUNGEN_ROH: {
         readonly text: "{amount} geht zurück auf den Gutschein";
         readonly placeholders: readonly ["amount"];
     };
+    readonly 'voucher.apply': {
+        readonly text: "Übernehmen";
+    };
+    readonly 'voucher.redeemable_until': {
+        readonly text: "einlösbar bis {date}";
+        readonly placeholders: readonly ["date"];
+    };
+    readonly 'voucher.remove_line': {
+        readonly text: "{line} entfernen";
+        readonly placeholders: readonly ["line"];
+    };
+    readonly 'voucher.reenter_code': {
+        readonly text: "Code erneut eingeben";
+    };
+    readonly 'voucher.refundable_until': {
+        readonly text: "rückzahlbar bis {date}";
+        readonly placeholders: readonly ["date"];
+    };
+    readonly 'voucher.code_done': {
+        readonly text: "Fertig";
+    };
+    readonly 'voucher.article': {
+        readonly text: "Artikel";
+    };
+    readonly 'voucher.add': {
+        readonly text: "Hinzufügen";
+    };
     readonly 'shift.all_payments': {
         readonly text: "Alle Zahlungen dieser Schicht (bar + unbar)";
     };
@@ -1915,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>;
@@ -1929,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

@@ -195,6 +195,21 @@ const MELDUNGEN_ROH = {
     'voucher_error.settings_missing': { text: 'Die Gutschein-Einstellungen fehlen. Bitte die Kasse neu laden.' },
     'voucher_error.too_many_checks': { text: 'Zu viele Versuche. Bitte in einer Stunde wieder.' },
     'voucher_error.sale_off': { text: 'Gutscheine verkaufen geht hier noch nicht.' },
+    // Gutscheine an der Kasse, Stufe 3 (1.13.0): Sätze der Kasse selbst (nicht des Servers).
+    'voucher.reentry_needed': { text: 'Die Karte ist belastet, der Beleg fehlt noch: zu jedem Gutschein den Code erneut eingeben, dann den Beleg abschließen.' },
+    'voucher.reentry_mismatch': { text: 'Mit diesen Gutscheinen ergibt der Beleg nicht mehr den belasteten Betrag – die Karte zurückbuchen.' },
+    'voucher.not_this_voucher': { text: 'Das ist nicht der Gutschein ····-{suffix}.', placeholders: ['suffix'] },
+    'voucher.reentry_no_permission': { text: 'Die Karte ist belastet, der Beleg fehlt noch: den Gutschein-Code kann nur jemand mit dem Recht zum Einlösen nachtragen – sonst die Karte zurückbuchen.' },
+    'voucher.already_covered': { text: 'Diese Positionen deckt schon ein anderer Gutschein.' },
+    'voucher.payout_reason_too_long': { text: 'Der Grund hat höchstens 200 Zeichen.' },
+    'voucher.payout_reason_missing': { text: 'Für die Auszahlung fehlt der Grund.' },
+    'voucher.payout_check_first': { text: 'Die letzte Auszahlung ging unklar aus und kann schon gebucht sein. Erst unter „Belege“ die Liste neu laden und nachsehen, dann ist eine neue möglich.' },
+    'voucher.sale_max_amount': { text: 'Höchstens {amount} je Gutschein.', placeholders: ['amount'] },
+    'voucher.sale_not_at_terminal': { text: 'Gutscheine mit Karte am Terminal zu verkaufen geht an dieser Kasse noch nicht – bar kassieren.' },
+    'voucher.no_redeem_with_sale': { text: 'Auf einem Beleg, der Gutscheine verkauft, lässt sich kein Gutschein einlösen.' },
+    'voucher.code_not_on_receipt': { text: 'Der Code steht nicht auf dem Bon – jetzt auf den Gutschein schreiben.' },
+    'cancellation.voucher_sale_cancelled': { text: 'Der Gutschein ····-{suffix} wird mitstorniert und gilt danach nicht mehr.', placeholders: ['suffix'] },
+    'cancellation.promo_valid_again': { text: 'Der Aktionsgutschein ····-{suffix} gilt danach wieder.', placeholders: ['suffix'] },
     // --- Getrennt zahlen -----------------------------------------------------
     // Ein Tisch zahlt in Teilen, ein Beleg fuer alles. Das Teure ist eine schon
     // belastete Karte: jeder Satz, der sie betrifft, nennt den Betrag, und keiner
@@ -852,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' },
@@ -884,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.' },
@@ -891,6 +931,15 @@ const BESCHRIFTUNGEN_ROH = {
     'voucher.add_article': { text: '{article} hinzufügen', placeholders: ['article'] },
     'voucher.payout_confirm': { text: '{amount} bar auszahlen?', placeholders: ['amount'] },
     'cancellation.voucher_back': { text: '{amount} geht zurück auf den Gutschein', placeholders: ['amount'] },
+    // Gutscheine an der Kasse, Stufe 3 (1.13.0)
+    'voucher.apply': { text: 'Übernehmen' },
+    'voucher.redeemable_until': { text: 'einlösbar bis {date}', placeholders: ['date'] },
+    'voucher.remove_line': { text: '{line} entfernen', placeholders: ['line'] },
+    'voucher.reenter_code': { text: 'Code erneut eingeben' },
+    'voucher.refundable_until': { text: 'rückzahlbar bis {date}', placeholders: ['date'] },
+    'voucher.code_done': { text: 'Fertig' },
+    'voucher.article': { text: 'Artikel' },
+    'voucher.add': { text: 'Hinzufügen' },
     'shift.all_payments': { text: 'Alle Zahlungen dieser Schicht (bar + unbar)' },
     'shift.receipt_count_one': { text: '1 Beleg' },
     'shift.receipt_count_other': { text: '{count} Belege', placeholders: ['count'] },
@@ -951,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;
 /**
@@ -964,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;