@kreiseck/kasseneck-api 1.13.0 → 1.15.0

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';

package/dist/esm/receipt/layout.js

@@ -441,19 +441,31 @@ function barZeilen(zahlung) {
  */
 function zahlungsZeilen(receipt) {
     const zahlungen = receipt.payments;
+    // Trägt der Beleg eine Gutschein-Zahlungszeile, entfällt, was 0 Cent kostet
+    // (§ 132a Abs. 3 BAO: die Zahlungsart ist kein Pflichtinhalt, der Betrag bleibt).
+    const mitGutschein = receipt.vouchers.some((v) => v.action === VoucherAction.redeem && v.type !== VoucherType.promo);
     if (zahlungen == null || zahlungen.length === 0) {
+        if (mitGutschein && receiptSumCents(receipt) === 0)
+            return [];
         return [paarZeile('Zahlungsart:', zahlungsartText(receipt.paymentMethod))];
     }
     if (zahlungen.length === 1) {
         const zahlung = zahlungen[0];
+        if (mitGutschein && zahlung.amountCents === 0)
+            return [];
         return [paarZeile('Zahlungsart:', zahlungsartText(zahlung.method)), ...zahlungTrinkgeldZeilen(zahlung), ...barZeilen(zahlung)];
     }
+    // Mehrere Zahlungen: mit Gutschein entfallen die mit 0 Cent (Nummer bleibt die des Kartenblocks).
+    const alle = zahlungen.map((zahlung, i) => ({ zahlung, i }));
+    const liste = mitGutschein ? alle.filter(({ zahlung }) => zahlung.amountCents !== 0) : alle;
+    if (liste.length === 0)
+        return [];
     const zeilen = [textZeile('Zahlungsarten:')];
-    zahlungen.forEach((zahlung, i) => {
+    for (const { zahlung, i } of liste) {
         zeilen.push(paarZeile(zahlungNummerText(zahlung, i), `${formatCents(zahlung.amountCents)} €`, 8, 4));
         zeilen.push(...zahlungTrinkgeldZeilen(zahlung));
         zeilen.push(...barZeilen(zahlung));
-    });
+    }
     return zeilen;
 }
 // -------------------------------------------------------- Kleinunternehmer
@@ -542,10 +554,12 @@ function gutscheinText(voucher) {
         text += 'Wertgutschein';
     }
     else if (voucher.type === VoucherType.promo) {
-        text += 'Promotionsgutschein';
+        text += 'Aktionsgutschein';
     }
     const name = voucher.name;
-    if (name != null && name.toLowerCase().includes(text.toLowerCase())) {
+    // Alte Belege nennen den Aktionsgutschein noch „Promotionsgutschein": auch dieser Name steht allein.
+    if (name != null && (name.toLowerCase().includes(text.toLowerCase())
+        || (voucher.type === VoucherType.promo && name.toLowerCase().includes('promotionsgutschein')))) {
         return name;
     }
     // Der Betrag steht in derselben Zeile rechts in der Betragsspalte — ihn
@@ -554,7 +568,7 @@ function gutscheinText(voucher) {
     // identifiziert den Gutschein (Mehrzweck: der Kunde will wissen, WELCHER
     // eingeloest wurde).
     if (voucher.code != null && voucher.code !== '') {
-        text += ` ${voucher.code}`;
+        text += ` ${codeKurz(voucher)}`;
     }
     if (name != null && name.length > 0) {
         text += ` - ${name}`;
@@ -572,21 +586,20 @@ function gutscheinText(voucher) {
  *   Leistung                   Zeile dieses Gutscheins Text „  Einzweck, versteuert mit
  *                              Beleg K1-ID-4711“ (bzw. „Leistung, …“, „…, befreit
  *                              verkauft (Kleinunternehmer)“, 47 Zeichen: passt auf
- *                              80 mm) und 8:4 „  Rest am Gutschein“ | „19,50  “ bzw.
+ *                              80 mm) und 8:4 „  Rest am Gutschein“ | „19,50 €“ bzw.
  *                              „2 Stück“
  *   Einloesung Mehrzweck       nach „Zwischensumme“ 8:4 „Gutschein ····-9DWT“ |
  *                              „-17,50 €“ und „  Rest am Gutschein“ | „32,50 €“
  *   Auszahlung                 8:4 „Auszahlung Gutschein ····-9DWT“ | „-12,00 D“,
  *                              Text „  Grund: <Grund>“
- *   Aktion                     Rabattzeile wie bisher (Promotionsgutschein)
+ *   Aktion                     Rabattzeile wie bisher (Aktionsgutschein)
  *
  * Vermerke sind Textzeilen mit zwei fuehrenden Leerzeichen; das Raster bricht
  * sie mit demselben Einzug um (grid.ts, haengender Einzug), auf 58 mm etwa
  * „  Einzweck, versteuert mit“ / „  Beleg K1-ID-4711“.
  *
- * Die Zusatzzeilen kommen nur aus dem Eintrag: ein Beleg, den der Server fuer
- * ein aelteres Paket aufbereitet hat (Eintraege mit Position entfernt, Code an
- * der Position, functions/beleg-layout.js `gutscheineFuerPaket`), zeigt seine
+ * Die Zusatzzeilen kommen nur aus dem Eintrag: ein Beleg ohne Eintrag (aeltere
+ * Belege, bei denen der Code schon an der Position steht) zeigt seine
  * Positionen wie jede andere Position. Ein Betrag zaehlt immer genau einmal:
  * Positionen in der Steuertabelle, Eintraege mit `zeroRateBucket` nie.
  */
@@ -599,12 +612,22 @@ function istMehrzweckMitCode(voucher) {
     return voucher.type === VoucherType.value && voucher.voucherType === VoucherType.multi_purpose;
 }
 /**
- * Code fuer die Belegzeile: die Maske des Eintrags, ohne den Platzhalter
- * `no-code`, den der Server Alt-Eintraegen ohne Code setzt (index.js
- * checkVouchersIsValid). Leer, wenn es keinen gibt.
+ * Code fuer die Belegzeile: immer die kurze Maske `····-XXXX` aus dem Code-Ende
+ * (auch wenn ein alter Beleg die lange `····-····-XXXX` im Eintrag traegt),
+ * ohne den Platzhalter `no-code`, den der Server Alt-Eintraegen ohne Code
+ * setzt (index.js checkVouchersIsValid). Leer, wenn es keinen gibt.
  */
 function gutscheinCodeZusatz(voucher) {
-    return typeof voucher.code === 'string' && voucher.code !== '' && voucher.code !== 'no-code' ? ` ${voucher.code}` : '';
+    return typeof voucher.code === 'string' && voucher.code !== '' && voucher.code !== 'no-code' ? ` ${codeKurz(voucher)}` : '';
+}
+/**
+ * Maskierte Codes (`····-····-XXXX` alt, `····-XXXX` neu) drucken immer kurz;
+ * ein Alt-Code ohne Maske (z. B. `GS-1`) bleibt, wie er ist.
+ */
+function codeKurz(voucher) {
+    const code = voucher.code ?? '';
+    const endung = gutscheinEndung(voucher);
+    return code.includes('····') && endung != null ? `····-${endung}` : code;
 }
 /** Die vier letzten Zeichen des Codes (`codeSuffix`, sonst aus der Maske), oder null. */
 function gutscheinEndung(voucher) {
@@ -618,7 +641,7 @@ const MEHRZWECK_UST_TEXT = '  USt bei Einlösung';
  * Eintrag? Jede Position hoechstens einem Eintrag, Eintraege in ihrer
  * Reihenfolge (der Server haengt die Positionen in derselben Reihenfolge an).
  * Verkauf: erste freie Position der Art mit demselben Betrag und ohne Code im
- * Namen (wie `gutscheineFuerPaket` des Servers). Einloesung: freie Positionen
+ * Namen (wie die Zuordnung des Servers). Einloesung: freie Positionen
  * mit genau dem Namen `Gutschein ····-<Endung>`, Auszahlung: `Auszahlung
  * Gutschein ····-<Endung>` (gutschein-beleg.plane) -- der Reihe nach, bis
  * ihr Betrag den des Eintrags erreicht (ein Kleinunternehmer-Einzweck oder
@@ -696,14 +719,14 @@ function gutscheinPositionsZeilen(item, satz, zu) {
     else if (v.exempt === true) {
         zeilen.push(textZeile(`  ${art}, befreit verkauft (Kleinunternehmer)`));
     }
-    // Rest: Betrag fluchtet mit den Positionsbetraegen (zwei Zeichen statt
-    // „ A“), Stueck rechtsbuendig. Die Gesamtzahl kennt der Beleg nicht.
+    // Rest: Betrag mit „€“ wie beim Mehrzweckgutschein, Stueck rechtsbuendig.
+    // Die Gesamtzahl kennt der Beleg nicht.
     if (v.type === VoucherType.service) {
         if (Number.isInteger(v.remainingQuantityAfter))
             zeilen.push(paarZeile('  Rest am Gutschein', `${v.remainingQuantityAfter} Stück`, 8, 4));
     }
     else if (Number.isInteger(v.balanceAfterCents)) {
-        zeilen.push(paarZeile('  Rest am Gutschein', `${formatCents(v.balanceAfterCents)}  `, 8, 4));
+        zeilen.push(paarZeile('  Rest am Gutschein', `${formatCents(v.balanceAfterCents)} €`, 8, 4));
     }
     return zeilen;
 }
@@ -1093,7 +1116,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push(...(art === 'discount' ? rabattZeilen(item.name, teile) : trinkgeldZeilen(item.name, teile)));
     }
     // --- Gutscheine: verkaufte Wertgutscheine sind Umsatz zu 0 %, eingeloeste
-    //     Promotionsgutscheine mindern die Steuergruppen anteilig.
+    //     Aktionsgutscheine mindern die Steuergruppen anteilig.
     //     Am Storno-Beleg zaehlen Wertgutscheine mit umgekehrtem Vorzeichen
     //     (receiptValueVoucherSign): der verkaufte wird zurueckgezahlt.
     //     Eintraege mit `zeroRateBucket` stehen schon als Position (0-%-Topf).
@@ -1123,7 +1146,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
                 lines.push(textZeile(MEHRZWECK_UST_TEXT));
         }
         if (voucher.action === VoucherAction.redeem && voucher.type === VoucherType.promo) {
-            // Am Storno-Beleg steht der Promotionsgutschein nur als Bezug: den Rabatt
+            // Am Storno-Beleg steht der Aktionsgutschein nur als Bezug: den Rabatt
             // nimmt dort die Position „Gutschein-Ausgleich“ zurueck (receiptSubSumCents).
             if (wgVz === 1)
                 promoCents += wert;
@@ -1243,7 +1266,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
     return { lines, paperSize, ruleset };
 }
 /**
- * Verteilt einen eingeloesten Promotionsgutschein anteilig auf die
+ * Verteilt einen eingeloesten Aktionsgutschein anteilig auf die
  * Steuergruppen — Zwilling von `print_paper.dart` (Zeilen 296-325).
  *
  * Der Gutschein mindert keinen einzelnen Artikel, sondern den Umsatz: jede

package/dist/esm/register/pairing.d.ts

@@ -120,8 +120,12 @@ export type RegisterLoginMode = 'select_user' | 'pin';
 export interface RegisterDeviceUsers {
     /** Im Modus `pin` bewusst leer — Namen haben am nur-PIN-Geraet nichts verloren. */
     users: RegisterUserSummary[];
-    /** Kassen-Einstellungen (betriebsweit + Geraet), gemischt mit den Standardwerten. */
-    settings: PosSettings;
+    /**
+     * Kassen-Einstellungen (betriebsweit + Geraet), gemischt mit den Standardwerten.
+     * Ohne `vouchers`: die Antwort des Servers fuehrt den Block nicht, er kommt
+     * mit `getPosSettings`; ein Vorgabe-Block waere erfunden.
+     */
+    settings: Omit<PosSettings, 'vouchers'>;
     /** Belegkopf-Daten des Betriebs (Name, Anschrift, UID, Fusszeilen), ohne Geheimnisse. */
     receiptHeader: ReceiptCompany | null;
     /**