@kreiseck/kasseneck-api 1.13.0 → 1.15.0

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; } });

package/dist/cjs/receipt/layout.js

@@ -453,19 +453,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 === index_js_1.VoucherAction.redeem && v.type !== index_js_1.VoucherType.promo);
     if (zahlungen == null || zahlungen.length === 0) {
+        if (mitGutschein && (0, index_js_2.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
@@ -554,10 +566,12 @@ function gutscheinText(voucher) {
         text += 'Wertgutschein';
     }
     else if (voucher.type === index_js_1.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 === index_js_1.VoucherType.promo && name.toLowerCase().includes('promotionsgutschein')))) {
         return name;
     }
     // Der Betrag steht in derselben Zeile rechts in der Betragsspalte — ihn
@@ -566,7 +580,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}`;
@@ -584,21 +598,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.
  */
@@ -611,12 +624,22 @@ function istMehrzweckMitCode(voucher) {
     return voucher.type === index_js_1.VoucherType.value && voucher.voucherType === index_js_1.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) {
@@ -630,7 +653,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
@@ -708,14 +731,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 === index_js_1.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;
 }
@@ -1105,7 +1128,7 @@ 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).
@@ -1135,7 +1158,7 @@ function buildReceiptLayout(receipt, company, options = {}) {
                 lines.push(textZeile(MEHRZWECK_UST_TEXT));
         }
         if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.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;
@@ -1255,7 +1278,7 @@ 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/cjs/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;
     /**

package/dist/cjs/register/pairing.js

@@ -215,7 +215,7 @@ async function listRegisterUsersForDevice(options) {
         };
     });
     const settingsRoh = daten?.settings;
-    const settings = (0, client_js_1.posSettingsFromWire)(settingsRoh !== null && typeof settingsRoh === 'object' ? settingsRoh : null);
+    const { vouchers: _keinBlock, ...settings } = (0, client_js_1.posSettingsFromWire)(settingsRoh !== null && typeof settingsRoh === 'object' ? settingsRoh : null);
     const kopf = daten?.receiptHeader;
     const receiptHeader = kopf && typeof kopf === 'object' ? (0, receipt_company_js_1.fromReceiptCompanyPayload)(kopf) : null;
     return {

package/dist/cjs/stored/bon-layout.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.layoutWieServer = layoutWieServer;
 const layout_js_1 = require("../receipt/layout.js");
-const gutscheine_js_1 = require("./gutscheine.js");
 /**
  * Layout wie `beleg-layout.layoutFuerBeleg`: 80 mm, Regelwerk mindestens das
  * aktuelle. Kann der Server es nicht bauen, liefert er `null` (dann baut
@@ -11,9 +10,9 @@ const gutscheine_js_1 = require("./gutscheine.js");
 function layoutWieServer(b, regelwerk) {
     const ruleset = Math.max(Number(regelwerk) || 1, layout_js_1.CURRENT_LAYOUT_RULESET);
     try {
-        // Wie layoutFuerBeleg: Gutscheine mit Code stehen am Bon als Positionen,
-        // die uebrigen Eintraege so, wie das vendorte Paket des Servers sie liest.
-        return (0, layout_js_1.buildReceiptLayout)((0, gutscheine_js_1.wieVendortesPaket)((0, gutscheine_js_1.gutscheineFuerPaket)(b.receipt)), b.company, {
+        // Wie layoutFuerBeleg seit dem Paket 0.34.0 des Servers: der Beleg geht
+        // unveraendert ans Paket (keine Aufbereitung der Gutscheine mehr).
+        return (0, layout_js_1.buildReceiptLayout)(b.receipt, b.company, {
             paperSize: 'mm80', ruleset, testCashregister: b.testCashregister, testSignature: b.testSignature, registrationInfo: b.registrationInfo,
         });
     }

package/dist/cjs/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "733e4385baf4b2aa50605e2ebe5903948ce77b3346aa3bb65c5fd0d450a6898f";
+export declare const VOKABULAR_QUELLE = "c64430e6ec3c3dad8674ad684b353bf52c57df54da8afbaa6ba7d8f717511eb7";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/cjs/stored/vokabular.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KATALOGE = exports.ARTIKEL_FELDER = exports.SCHEMAS = exports.VOKABULAR_QUELLE = void 0;
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-exports.VOKABULAR_QUELLE = "733e4385baf4b2aa50605e2ebe5903948ce77b3346aa3bb65c5fd0d450a6898f";
+exports.VOKABULAR_QUELLE = "c64430e6ec3c3dad8674ad684b353bf52c57df54da8afbaa6ba7d8f717511eb7";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 exports.SCHEMAS = {
     "getReceipt": {
@@ -53,6 +53,7 @@ exports.SCHEMAS = {
                     "codeSuffix": "codeEnde",
                     "faceValueCents": "nennwertCents",
                     "quantity": "stueck",
+                    "articleName": "artikelName",
                     "validity": {
                         "__": "gueltigkeit",
                         "pattern": "muster",
@@ -61,6 +62,15 @@ exports.SCHEMAS = {
                         "validUntil": "gueltigBis"
                     }
                 }
+            ],
+            "outputs": [
+                {
+                    "__": "ausgaben",
+                    "kind": "art",
+                    "result": "ergebnis",
+                    "by": "durch",
+                    "count": "anzahl"
+                }
             ]
         },
         "werte": {
@@ -75,6 +85,12 @@ exports.SCHEMAS = {
             },
             "issuedVouchers[].validity.pattern": {
                 "$catalog": "GUTSCHEIN_MUSTER"
+            },
+            "outputs[].kind": {
+                "$catalog": "AUSGABE_ART"
+            },
+            "outputs[].result": {
+                "$catalog": "AUSGABE_ERGEBNIS"
             }
         }
     },
@@ -157,7 +173,10 @@ exports.SCHEMAS = {
                     "fullscreen": "vollbild",
                     "clearTendered": "gegebenLeeren",
                     "clearCart": "korbLeeren",
-                    "splitPayment": "getrennt"
+                    "splitPayment": "getrennt",
+                    "shiftStatus": "kassenstand",
+                    "openDrawer": "ladeOeffnen",
+                    "voucherPayout": "gutscheinAuszahlen"
                 },
                 "printerEnabled": "druckerAn",
                 "printerType": "druckerArt",
@@ -186,7 +205,19 @@ exports.SCHEMAS = {
                 "__": "gutscheine",
                 "sale": "verkauf",
                 "valueVoucherType": "wertArt",
-                "vatRateBp": "satzBp"
+                "vatRateBp": "satzBp",
+                "label": {
+                    "__": "etikett",
+                    "size": "groesse",
+                    "fields": {
+                        "__": "felder",
+                        "business": "betrieb",
+                        "value": "wert",
+                        "validity": "gueltigkeit",
+                        "checkPage": "pruefseite"
+                    },
+                    "freeText": "freitext"
+                }
             }
         },
         "werte": {
@@ -301,6 +332,19 @@ exports.ARTIKEL_FELDER = [
 ];
 /** Wertkataloge innen (deutsch) -> aussen (englisch). */
 exports.KATALOGE = {
+    "AUSGABE_ART": {
+        "erstdruck": "print",
+        "duplikat": "reprint",
+        "mail": "email",
+        "link_geteilt": "link_shared",
+        "pdf_geteilt": "pdf_shared",
+        "abruf": "opened"
+    },
+    "AUSGABE_ERGEBNIS": {
+        "ok": "ok",
+        "fehler": "failed",
+        "unklar": "unclear"
+    },
     "E1A_GRUPPE": {
         "erloese": "revenue",
         "erloese_waren": "revenue_goods",

package/dist/cjs/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.13.0";
+export declare const PACKAGE_VERSION = "1.15.0";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.13.0';
+exports.PACKAGE_VERSION = '1.15.0';

package/dist/esm/client/api.d.ts

@@ -4,7 +4,8 @@ import { type HobexPayOptions, type HobexRefundOptions } from '../payments/hobex
 import { type TransportOptions } from './transport.js';
 import { type CashregisterReportPeriod, type ReportV2, type ReportV2Options } from './reports.js';
 import { type CashboxStatus, type SignatureStatus } from './status.js';
-import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './receipts.js';
+import { type ListedReceipt, type ListReceiptsOptions, type ListReceiptsPage, type ListReceiptsView } from './list-receipts.js';
+import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './receipts.js';
 /**
  * Schlichte Factory ueber den Endpunkt-Funktionen: bindet einen Transport
  * einmal und liefert die Aufrufe ohne den wiederkehrenden ersten Parameter.
@@ -48,12 +49,18 @@ export interface KasseneckApi {
     getFirstReceiptDate(): Promise<ReportMonth>;
     /** Beleg als Link auf die oeffentliche Belegseite per E-Mail schicken. */
     sendReceiptEmail(options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
+    /** Drucke und Teilen eines Belegs an das Protokoll „Ausgaben“ melden (nur Kassenweg). */
+    logReceiptOutputs(options: LogReceiptOutputsOptions): Promise<LogReceiptOutputsResult>;
     /** Belegliste einer Kasse samt Kennzahlen (nur mit ID-Token, siehe receipts.ts). */
     listMyReceipts(options: ListMyReceiptsOptions): Promise<ReceiptList>;
     /** Kassen des angemeldeten Benutzers (nur mit ID-Token, siehe cashregisters.ts). */
     listMyCashregisters(): Promise<Cashregister[]>;
     /** Rohdaten eines Zeitraums: Belege und Firmendaten (`getReportV2`). */
     getReportV2(options: ReportV2Options): Promise<ReportV2>;
+    /** Eine Seite Belege eines Tages oder Zeitraums (`listReceipts`, hoechstens 31 Tage, blaetterbar). */
+    listReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
+    /** Alle Belege eines Tages oder Zeitraums, Seite fuer Seite geholt (hoechstens 100 Seiten). */
+    listAllReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;
     /** Kassenbericht als PDF (v2): abgeschlossener Monat, Tag oder Zeitraum (Endpunkt `getCashregisterReport`). */
     getCashregisterReport(options: CashregisterReportPeriod): Promise<Uint8Array>;
     /** @deprecated Since 1.10.0: use getCashregisterReport. Tagesbericht als PDF (Kalendertag nach Wiener Zeit). */

package/dist/esm/client/api.js

@@ -3,7 +3,8 @@ import { hobexPay, hobexRefund } from '../payments/hobex.js';
 import { createTransport, createBinaryTransport } from './transport.js';
 import { downloadDailyReport, downloadMonthlyReport, getCashregisterReport, getReportV2 } from './reports.js';
 import { getCashboxStatus, getSignatureStatus } from './status.js';
-import { sellReceipt, sellReceiptWithCompany, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, } from './receipts.js';
+import { listAllReceipts, listReceipts } from './list-receipts.js';
+import { sellReceipt, sellReceiptWithCompany, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, logReceiptOutputs, } from './receipts.js';
 import { listMyCashregisters } from './cashregisters.js';
 import { renewRegisterSession, endRegisterSession } from '../register/session.js';
 export function createKasseneckApi(options) {
@@ -22,8 +23,11 @@ export function createKasseneckApi(options) {
         getFirstReceiptDate: () => getFirstReceiptDate(rufen),
         listMyReceipts: (o) => listMyReceipts(rufen, o),
         sendReceiptEmail: (o) => sendReceiptEmail(rufen, o),
+        logReceiptOutputs: (o) => logReceiptOutputs(rufen, o),
         listMyCashregisters: () => listMyCashregisters(rufen),
         getReportV2: (o) => getReportV2(rufen, o),
+        listReceipts: (o) => listReceipts(rufen, o),
+        listAllReceipts: (o) => listAllReceipts(rufen, o),
         getCashregisterReport: (options) => getCashregisterReport(rufenBinaer, options),
         downloadDailyReport: (date) => downloadDailyReport(rufenBinaer, date),
         downloadMonthlyReport: (reportMonth) => downloadMonthlyReport(rufenBinaer, reportMonth),