@kreiseck/kasseneck-api 1.12.0 → 1.14.0

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 {
@@ -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/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;
@@ -206,6 +207,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
@@ -863,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' },
@@ -895,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.' },
@@ -902,6 +943,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'] },
@@ -962,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;
 /**
@@ -975,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;

package/dist/cjs/receipt/due.js

@@ -110,6 +110,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 = (0, gutschein_plan_js_1.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,
@@ -133,7 +139,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
@@ -145,7 +152,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.
  */
 function voucherRedeemMaxCents(items, voucher, before = {}) {
     if (voucher.status !== 'active')
@@ -155,9 +163,18 @@ 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 - (0, gutschein_plan_js_1.trinkgeldCents)(r.kunde) + 6, HOECHSTBETRAG_CENTS);
     if (voucher.type === 'single_purpose') {
         const deckbar = r.kunde.filter(gutschein_plan_js_1.istDeckbar);
         const topfBasis = (topf) => (0, gutschein_plan_js_1.centSumme)(deckbar.filter((it) => (0, gutschein_plan_js_1.topfFuerSatz)(it.vat) === topf));

package/dist/cjs/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/cjs/receipt/duplikat.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markAsDuplicate = markAsDuplicate;
+const errors_js_1 = require("../client/errors.js");
+const vienna_time_js_1 = require("../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 = (0, vienna_time_js_1.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'`).
+ */
+function markAsDuplicate(layout, printedAt) {
+    if (!(printedAt instanceof Date) || Number.isNaN(printedAt.getTime())) {
+        throw new errors_js_1.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/cjs/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/cjs/receipt/gutschein-plan.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VOUCHER_ZERO_RATE_BUCKET_FROM = void 0;
 exports.topfFuerSatz = topfFuerSatz;
 exports.istDeckbar = istDeckbar;
+exports.trinkgeldCents = trinkgeldCents;
 exports.centSumme = centSumme;
 exports.kuSaetze = kuSaetze;
 exports.planeGutscheine = planeGutscheine;
@@ -37,6 +38,10 @@ function istGutscheinZeile(p) {
 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. */
+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. */
 function centSumme(liste) {
     return Math.round(liste.reduce((s, it) => s + it.priceOne * it.amount, 0) * 100);

package/dist/cjs/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/cjs/receipt/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
-exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = void 0;
+exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.markAsDuplicate = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = exports.isReceiptDueError = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -13,6 +13,8 @@ Object.defineProperty(exports, "receiptZdaText", { enumerable: true, get: functi
 Object.defineProperty(exports, "CURRENT_LAYOUT_RULESET", { enumerable: true, get: function () { return layout_js_1.CURRENT_LAYOUT_RULESET; } });
 Object.defineProperty(exports, "SMALL_BUSINESS_NOTICE", { enumerable: true, get: function () { return layout_js_1.SMALL_BUSINESS_NOTICE; } });
 Object.defineProperty(exports, "formatCents", { enumerable: true, get: function () { return layout_js_1.formatCents; } });
+var duplikat_js_1 = require("./duplikat.js");
+Object.defineProperty(exports, "markAsDuplicate", { enumerable: true, get: function () { return duplikat_js_1.markAsDuplicate; } });
 var layout_escpos_js_1 = require("./layout-escpos.js");
 Object.defineProperty(exports, "assertLogoRaster", { enumerable: true, get: function () { return layout_escpos_js_1.assertLogoRaster; } });
 Object.defineProperty(exports, "escPosLayoutBytes", { enumerable: true, get: function () { return layout_escpos_js_1.escPosLayoutBytes; } });