@kreiseck/kasseneck-api 1.11.1 → 1.13.0

package/dist/cjs/receipt/layout.js

@@ -573,6 +573,152 @@ function gutscheinText(voucher) {
     }
     return text;
 }
+/*
+ * Gutscheine der neuen Form (Spec 2026-10-14, „Bon und Beleg“). Der Dart-
+ * Zwilling uebernimmt Texte und Spaltenbreiten (Zwoelftel) genau so:
+ *
+ *   Verkauf Einzweck/Leistung  Positionszeile 7:5 „1  x <Name> <Code>“ | „50,00 A“
+ *   Verkauf Mehrzweck          dieselbe Zeile (Position im 0-%-Topf oder, vor dem
+ *                              Stichtag, aus dem Eintrag) + Text „  USt bei Einlösung“
+ *   Einloesung Einzweck/       8:4 „Gutschein ····-9DWT“ | „-30,50 A“, nach der letzten
+ *   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.
+ *                              „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)
+ *
+ * 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
+ * Positionen wie jede andere Position. Ein Betrag zaehlt immer genau einmal:
+ * Positionen in der Steuertabelle, Eintraege mit `zeroRateBucket` nie.
+ */
+/** Steht der Betrag des Eintrags als Position am Beleg (Einzweck, Leistung, 0-%-Topf)? */
+function gutscheinStehtAlsPosition(voucher) {
+    return voucher.type === index_js_1.VoucherType.single_purpose || voucher.type === index_js_1.VoucherType.service || voucher.zeroRateBucket === true;
+}
+/** Mehrzweckgutschein mit Code (Altart `value`, vom Server als `multi_purpose` gekennzeichnet). */
+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.
+ */
+function gutscheinCodeZusatz(voucher) {
+    return typeof voucher.code === 'string' && voucher.code !== '' && voucher.code !== 'no-code' ? ` ${voucher.code}` : '';
+}
+/** Die vier letzten Zeichen des Codes (`codeSuffix`, sonst aus der Maske), oder null. */
+function gutscheinEndung(voucher) {
+    if (typeof voucher.codeSuffix === 'string' && voucher.codeSuffix !== '')
+        return voucher.codeSuffix;
+    return typeof voucher.code === 'string' && voucher.code.length >= 4 && voucher.code !== 'no-code' ? voucher.code.slice(-4) : null;
+}
+const MEHRZWECK_UST_TEXT = '  USt bei Einlösung';
+/**
+ * Welche Gutscheinposition (`voucher`/`voucher_float`) gehoert zu welchem
+ * 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
+ * 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
+ * eine Leistung ueber mehrere Saetze hat je Satz eine Position; zwei
+ * Gutscheine mit derselben Endung teilen sich so nie eine Position). Ohne
+ * Betrag am Eintrag genau eine Position.
+ */
+function gutscheinPositionen(receipt) {
+    const zuordnung = new Map();
+    const istGutscheinzeile = (it) => it.kind === 'voucher' || it.kind === 'voucher_float';
+    for (const voucher of receipt.vouchers) {
+        if (!gutscheinStehtAlsPosition(voucher))
+            continue;
+        if (voucher.action === index_js_1.VoucherAction.sell) {
+            const art = voucher.zeroRateBucket === true ? 'voucher_float' : 'voucher';
+            const cents = Number.isInteger(voucher.amountCents) ? Math.abs(voucher.amountCents) : Math.abs(voucher.valueCents ?? 0);
+            const i = receipt.items.findIndex((it, k) => !zuordnung.has(k) && it.kind === art
+                && Math.abs((0, index_js_2.receiptItemTotalCents)(it)) === cents && !it.name.includes('····'));
+            if (i >= 0)
+                zuordnung.set(i, { voucher, letzte: true });
+            continue;
+        }
+        const endung = gutscheinEndung(voucher);
+        if (endung == null || (voucher.action !== index_js_1.VoucherAction.redeem && voucher.action !== index_js_1.VoucherAction.payout))
+            continue;
+        const name = `${voucher.action === index_js_1.VoucherAction.payout ? 'Auszahlung ' : ''}Gutschein ····-${endung}`;
+        const ziel = Number.isInteger(voucher.amountCents) ? Math.abs(voucher.amountCents) : Math.abs(voucher.valueCents ?? 0);
+        const genommen = [];
+        let summe = 0;
+        receipt.items.forEach((it, k) => {
+            if (zuordnung.has(k) || !istGutscheinzeile(it) || it.name !== name)
+                return;
+            if (genommen.length > 0 && (ziel <= 0 || summe >= ziel))
+                return;
+            genommen.push(k);
+            summe += Math.abs((0, index_js_2.receiptItemTotalCents)(it));
+        });
+        genommen.forEach((k, n) => zuordnung.set(k, { voucher, letzte: n === genommen.length - 1 }));
+    }
+    return zuordnung;
+}
+/**
+ * Zeilen einer Gutscheinposition mit ihrem Eintrag. Verkauf als gewoehnliche
+ * Positionszeile mit dem Code des Eintrags; Einloesung und Auszahlung ohne
+ * Menge in der Breite der Rabattzeilen (8:4), damit „Gutschein ····-9DWT“ auch
+ * auf 58 mm in einer Zeile steht.
+ */
+function gutscheinPositionsZeilen(item, satz, zu) {
+    const v = zu.voucher;
+    if (v.action === index_js_1.VoucherAction.sell) {
+        const zeilen = [positionsZeile({ ...item, name: `${item.name}${gutscheinCodeZusatz(v)}` }, satz)];
+        if (v.type === index_js_1.VoucherType.value)
+            zeilen.push(textZeile(MEHRZWECK_UST_TEXT));
+        return zeilen;
+    }
+    const zeilen = [{
+            kind: 'columns',
+            columns: [
+                { text: item.name, width: 8, align: 'left' },
+                { text: `${formatCents((0, index_js_2.receiptItemTotalCents)(item))} ${satz.category}`, width: 4, align: 'right' },
+            ],
+        }];
+    if (!zu.letzte)
+        return zeilen;
+    if (v.action === index_js_1.VoucherAction.payout) {
+        const grund = typeof v.reason === 'string' ? v.reason.trim() : '';
+        if (grund !== '')
+            zeilen.push(textZeile(`  Grund: ${grund}`));
+        return zeilen;
+    }
+    const art = v.type === index_js_1.VoucherType.service ? 'Leistung' : 'Einzweck';
+    if (typeof v.taxedWith === 'string' && v.taxedWith !== '') {
+        zeilen.push(textZeile(`  ${art}, versteuert mit Beleg ${v.taxedWith}`));
+    }
+    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.
+    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));
+    }
+    return zeilen;
+}
 // ----------------------------------------------------------------- Bauteile
 function textZeile(text, align = 'left', bold = false) {
     return { kind: 'text', text, align, bold };
@@ -917,13 +1063,15 @@ function buildReceiptLayout(receipt, company, options = {}) {
         .filter((it) => !(0, index_js_2.isTipItem)(it) && !(0, index_js_2.isDiscountItem)(it))
         .reduce((summe, it) => summe + (0, index_js_2.receiptItemTotalCents)(it), 0);
     let zwischensummeGezeigt = false;
+    const gutscheinZuordnung = gutscheinPositionen(receipt);
     let i = 0;
     while (i < receipt.items.length) {
         const item = receipt.items[i];
         if (!(0, index_js_2.isTipItem)(item) && !(0, index_js_2.isDiscountItem)(item)) {
             const satz = steuersatz(item.vat);
             gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
-            lines.push(positionsZeile(item, satz));
+            const gutschein = gutscheinZuordnung.get(i);
+            lines.push(...(gutschein ? gutscheinPositionsZeilen(item, satz, gutschein) : [positionsZeile(item, satz)]));
             i += 1;
             continue;
         }
@@ -960,22 +1108,31 @@ function buildReceiptLayout(receipt, company, options = {}) {
     //     Promotionsgutscheine 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).
     const wgVz = (0, index_js_2.receiptValueVoucherSign)(receipt);
     let promoCents = 0;
     for (const voucher of receipt.vouchers) {
+        // Betrag steht als Position (Einzweck, Leistung, 0-%-Topf): weder Zeile noch 0-%-Zeile aus dem Eintrag.
+        if (gutscheinStehtAlsPosition(voucher))
+            continue;
         const wert = voucher.valueCents ?? 0;
         const vz = voucher.type === index_js_1.VoucherType.value ? wgVz : 1;
         if ((0, index_js_2.voucherIsValid)(voucher) && voucher.action === index_js_1.VoucherAction.sell) {
             gruppeVon(steuersatz(index_js_1.VatRate.vat0)).bruttoCents += vz * wert;
         }
         if (voucher.action === index_js_1.VoucherAction.sell && voucher.type === index_js_1.VoucherType.value) {
+            // Mehrzweck mit Code (vor dem Stichtag nur als Eintrag): wie die Position im 0-%-Topf.
+            const mehrzweck = istMehrzweckMitCode(voucher);
+            const code = gutscheinCodeZusatz(voucher);
             lines.push({
                 kind: 'columns',
                 columns: [
-                    { text: `1  x ${gutscheinText(voucher)}`, width: 7, align: 'left' },
+                    { text: `1  x ${mehrzweck ? `Mehrzweckgutschein${code}` : gutscheinText(voucher)}`, width: 7, align: 'left' },
                     { text: `${formatCents(vz * wert)} ${index_js_1.VatRate.vat0.category}`, width: 5, align: 'right' },
                 ],
             });
+            if (mehrzweck)
+                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
@@ -1034,12 +1191,22 @@ function buildReceiptLayout(receipt, company, options = {}) {
     if (summeCents !== zwischensummeCents) {
         lines.push(paarZeile('Zwischensumme', `${formatCents(zwischensummeCents)} €`));
         for (const voucher of receipt.vouchers) {
-            if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.VoucherType.value) {
-                // Breite 8:4 — "Wertgutschein GS-1" (Label + Code) passt so auf 58 mm
-                // in die Zeile, statt den Code in eine Folgezeile fliessen zu lassen.
-                // Am Storno-Beleg geht der Wert auf den Gutschein zurueck: ohne Minus.
-                const wert = voucher.valueCents ?? 0;
-                lines.push(paarZeile(gutscheinText(voucher), wgVz === 1 ? `-${formatCents(wert)} €` : `${formatCents(wert)} €`, 8, 4));
+            if (voucher.type !== index_js_1.VoucherType.value || voucher.zeroRateBucket === true)
+                continue;
+            if (voucher.action !== index_js_1.VoucherAction.redeem && voucher.action !== index_js_1.VoucherAction.payout)
+                continue;
+            // Breite 8:4 — "Wertgutschein GS-1" (Label + Code) passt so auf 58 mm
+            // in die Zeile, statt den Code in eine Folgezeile fliessen zu lassen.
+            // Am Storno-Beleg geht der Wert auf den Gutschein zurueck: ohne Minus.
+            // Mehrzweck mit Code: „Gutschein ····-9DWT“ und darunter der Rest
+            // (Zahlungszeile laut Spec); eine Auszahlung ohne `zeroRateBucket`
+            // (schreibt der Server nicht) zaehlt wie in receiptSumCents.
+            const wert = voucher.valueCents ?? 0;
+            const endung = istMehrzweckMitCode(voucher) ? gutscheinEndung(voucher) : null;
+            const text = endung != null ? `Gutschein ····-${endung}` : gutscheinText(voucher);
+            lines.push(paarZeile(voucher.action === index_js_1.VoucherAction.payout ? `Auszahlung ${text}` : text, wgVz === 1 ? `-${formatCents(wert)} €` : `${formatCents(wert)} €`, 8, 4));
+            if (endung != null && wgVz === 1 && Number.isInteger(voucher.balanceAfterCents)) {
+                lines.push(paarZeile('  Rest am Gutschein', `${formatCents(voucher.balanceAfterCents)} €`, 8, 4));
             }
         }
         lines.push({ kind: 'rule', char: '-' });

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

@@ -199,6 +199,12 @@ export interface RegisterUserPerms {
     stocktakeClose?: boolean;
     /** Standort der Kasse waehlen (setMyCashregisterStockLocation). */
     stockLocation?: boolean;
+    /** Gutschein verkaufen (fehlt bei altem Server: gilt wie beim Kassier, siehe [voucherPermsOf]). */
+    voucherSell?: boolean;
+    /** Gutschein einloesen (fehlt bei altem Server: gilt wie beim Kassier). */
+    voucherRedeem?: boolean;
+    /** Gutscheine verwalten, z. B. Etikett nachdrucken (fehlt: verweigert). */
+    voucherManage?: boolean;
     [weiteresRecht: string]: boolean | RegisterScope | undefined;
 }
 /**
@@ -209,7 +215,7 @@ export interface RegisterUserPerms {
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
  * Die Gegenrichtung schliesst [_RechteVollstaendig] direkt darunter.
  */
-export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation"];
+export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation", "voucherSell", "voucherRedeem", "voucherManage"];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
 export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
@@ -219,6 +225,20 @@ export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefi
  * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
  */
 export declare function stockViewOf(perms: RegisterUserPerms | null | undefined): boolean;
+/** Die drei Gutschein-Rechte, aufgeloest (kein Schluessel fehlt mehr). */
+export interface VoucherPerms {
+    voucherSell: boolean;
+    voucherRedeem: boolean;
+    voucherManage: boolean;
+}
+/**
+ * Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein
+ * alter Server (und `/api`-Antworten) kennt sie nicht. Dann gilt je fehlendem
+ * Schluessel die Vorgabe des Kassiers: verkaufen und einloesen ja, verwalten
+ * nein. Ein ausdrueckliches `false` sperrt; was kein Wahrheitswert ist,
+ * erteilt nichts.
+ */
+export declare function voucherPermsOf(perms: Partial<RegisterUserPerms> | null | undefined): VoucherPerms;
 /** Der angemeldete Kassen-Benutzer. */
 export interface RegisterUser {
     id: string;

package/dist/cjs/register/pairing.js

@@ -4,6 +4,7 @@ exports.REGISTER_PERMS = void 0;
 exports.cancelScopeOf = cancelScopeOf;
 exports.receiptsScopeOf = receiptsScopeOf;
 exports.stockViewOf = stockViewOf;
+exports.voucherPermsOf = voucherPermsOf;
 exports.pairRegisterDevice = pairRegisterDevice;
 exports.unpairRegisterDevice = unpairRegisterDevice;
 exports.listRegisterSessionsForDevice = listRegisterSessionsForDevice;
@@ -62,6 +63,7 @@ exports.REGISTER_PERMS = [
     'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
     'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
     'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
+    'voucherSell', 'voucherRedeem', 'voucherManage',
 ];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 function cancelScopeOf(perms) {
@@ -88,6 +90,21 @@ function stockViewOf(perms) {
         return false;
     return perms.stockView === undefined ? true : perms.stockView === true;
 }
+/**
+ * Gutschein-Rechte lesen. Das Backend loest sie bei der Anmeldung auf; ein
+ * alter Server (und `/api`-Antworten) kennt sie nicht. Dann gilt je fehlendem
+ * Schluessel die Vorgabe des Kassiers: verkaufen und einloesen ja, verwalten
+ * nein. Ein ausdrueckliches `false` sperrt; was kein Wahrheitswert ist,
+ * erteilt nichts.
+ */
+function voucherPermsOf(perms) {
+    const lies = (wert, vorgabe) => (wert === undefined ? vorgabe : wert === true);
+    return {
+        voucherSell: lies(perms?.voucherSell, true),
+        voucherRedeem: lies(perms?.voucherRedeem, true),
+        voucherManage: lies(perms?.voucherManage, false),
+    };
+}
 /**
  * Geraet koppeln: der Kopplungs-Code wird gegen den dauerhaften Ausweis dieses
  * Geraets getauscht. **Ohne Anmeldung** — der Code ist der Nachweis.

package/dist/cjs/stored/bon-layout.d.ts

@@ -0,0 +1,8 @@
+import type { ReceiptWithCompany } from '../client/receipts.js';
+import { type ReceiptLayout } from '../receipt/layout.js';
+/**
+ * Layout wie `beleg-layout.layoutFuerBeleg`: 80 mm, Regelwerk mindestens das
+ * aktuelle. Kann der Server es nicht bauen, liefert er `null` (dann baut
+ * [receiptLayoutFromResult] selbst); ebenso hier.
+ */
+export declare function layoutWieServer(b: ReceiptWithCompany, regelwerk: unknown): ReceiptLayout | null;

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

@@ -0,0 +1,23 @@
+"use strict";
+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
+ * [receiptLayoutFromResult] selbst); ebenso hier.
+ */
+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, {
+            paperSize: 'mm80', ruleset, testCashregister: b.testCashregister, testSignature: b.testSignature, registrationInfo: b.registrationInfo,
+        });
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -1,4 +1,4 @@
-import { type SchemaEintrag, type SchemaObjekt } from './vokabular.js';
+import { type SchemaEintrag, type SchemaObjekt, type Wertverweis } from './vokabular.js';
 export type Objekt = Record<string, unknown>;
 export declare const hat: (o: object, k: string) => boolean;
 export declare const istObjekt: (w: unknown) => w is Objekt;
@@ -10,6 +10,8 @@ export declare function regel(eintrag: SchemaEintrag): {
 };
 /** Innere Namen einer Schema-Ebene (was der Server innen an dieser Stelle kennt). */
 export declare function innereNamen(schema: SchemaObjekt): Map<string, string>;
+/** Zuordnung eines Wertverweises: benannter Katalog oder eingebettet. */
+export declare function katalogVon(verweis: Wertverweis): Readonly<Record<string, string>> | undefined;
 /** Rueckgabe-Wahl innen -> aussen (Katalog RUECKGABE; stored.test.ts vergleicht mit dem Vertrag). */
 export declare const _RUECKGABE_NACH_AUSSEN: Readonly<Record<string, string>>;
 /**

package/dist/cjs/stored/draht.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._RUECKGABE_NACH_AUSSEN = exports.istObjekt = exports.hat = void 0;
 exports.regel = regel;
 exports.innereNamen = innereNamen;
+exports.katalogVon = katalogVon;
 exports._storedReceiptInner = _storedReceiptInner;
 exports.pruefangabenDerHuelle = pruefangabenDerHuelle;
 exports._receiptEnvelopeToWire = _receiptEnvelopeToWire;
@@ -79,16 +80,21 @@ function anPfad(obj, teile, fn) {
  */
 function werteNachAussen(obj, werte) {
     let raus = obj;
-    for (const [pfad, { $catalog }] of Object.entries(werte)) {
-        const katalog = vokabular_js_1.KATALOGE[$catalog];
+    for (const [pfad, verweis] of Object.entries(werte)) {
+        const katalog = katalogVon(verweis);
         if (!katalog)
-            throw new Error(`stored: Katalog ${$catalog} fehlt im Vokabular`);
+            throw new Error(`stored: Katalog ${verweis.$catalog} fehlt im Vokabular`);
         raus = anPfad(raus, pfad.split('.'), (v) => (typeof v === 'string' && (0, exports.hat)(katalog, v) ? katalog[v] : v));
     }
     return raus;
 }
+/** Zuordnung eines Wertverweises: benannter Katalog oder eingebettet. */
+function katalogVon(verweis) {
+    const name = verweis.$catalog;
+    return typeof name === 'string' ? vokabular_js_1.KATALOGE[name] : verweis;
+}
 /** Englische Werte eines Katalogs (was an dieser Stelle hinaus darf). */
-const aeussereWerte = (name) => new Set(Object.values(vokabular_js_1.KATALOGE[name] ?? {}));
+const aeussereWerte = (verweis) => new Set(Object.values(katalogVon(verweis) ?? {}));
 // ---- Belege -----------------------------------------------------------------
 /**
  * Interne Marke der Storno-Reservierung: `stornoMarke` am Storno-Beleg,
@@ -143,6 +149,47 @@ function belegRueckgabeNachAussen(beleg) {
     }
     return raus;
 }
+// ---- Gutschein-Eintraege am Beleg ---------------------------------------------
+/** Zwilling von `BELEG_GUTSCHEIN` (api-vokabular-v3): aussen -> innen. */
+const BELEG_GUTSCHEIN = {
+    voucherType: 'art', voucherId: 'gutscheinId', codeSuffix: 'codeEnde', amountCents: 'betragCents', vatRateBp: 'satzBp',
+    article: 'artikel', articleId: 'artikelId', quantity: 'stueck', positions: 'positionen',
+    balanceAfterCents: 'saldoNachCents', remainingQuantityAfter: 'stueckOffenNach', taxedWith: 'versteuertMit', exempt: 'befreit',
+    reason: 'grund', zeroRateBucket: 'imNullTopf',
+};
+const BELEG_GUTSCHEIN_AUSSEN = Object.fromEntries(Object.entries(BELEG_GUTSCHEIN).map(([aussen, innen]) => [innen, aussen]));
+const GUTSCHEIN_ARTIKEL_AUSSEN = { satzBp: 'vatRateBp', preisCents: 'priceCents' };
+function umbenannt(o, namen) {
+    return Object.fromEntries(Object.entries(o).map(([k, w]) => [(0, exports.hat)(namen, k) ? namen[k] : k, w]));
+}
+/** Zwilling von `gutscheinEintragNachAussen`: ohne deutschen Schluessel/Wert dasselbe Objekt (Altbeleg). */
+function gutscheinEintragNachAussen(v) {
+    if (!(0, exports.istObjekt)(v))
+        return v;
+    const art = vokabular_js_1.KATALOGE.GUTSCHEIN_ART ?? {};
+    const typNeu = typeof v.type === 'string' && (0, exports.hat)(art, v.type);
+    if (!typNeu && !Object.keys(v).some((k) => (0, exports.hat)(BELEG_GUTSCHEIN_AUSSEN, k)))
+        return v;
+    const raus = {};
+    for (const [k, w] of Object.entries(v)) {
+        if (k === 'type')
+            raus.type = typNeu ? art[w] : w;
+        else if (k === 'art')
+            raus.voucherType = typeof w === 'string' && (0, exports.hat)(art, w) ? art[w] : w;
+        else if (k === 'artikel')
+            raus.article = (0, exports.istObjekt)(w) ? umbenannt(w, GUTSCHEIN_ARTIKEL_AUSSEN) : w;
+        else
+            raus[(0, exports.hat)(BELEG_GUTSCHEIN_AUSSEN, k) ? BELEG_GUTSCHEIN_AUSSEN[k] : k] = w;
+    }
+    return raus;
+}
+/** Zwilling von `belegGutscheineNachAussen`: `vouchers[]` eines Belegs an Ort und Stelle nach aussen. */
+function belegGutscheineNachAussen(beleg) {
+    if (!Array.isArray(beleg.vouchers))
+        return beleg;
+    const neu = beleg.vouchers.map(gutscheinEintragNachAussen);
+    return neu.every((v, i) => v === beleg.vouchers[i]) ? beleg : { ...beleg, vouchers: neu };
+}
 /**
  * Zwilling von `beleg-pruefangaben.alsIso`: leer (auch 0, '') -> null;
  * Firestore-Zeitstempel, Zahl oder Zeichenkette -> ISO-Zeitpunkt in UTC;
@@ -194,7 +241,7 @@ function pruefangabenDerHuelle(p) {
 function _receiptEnvelopeToWire(huelle) {
     const schema = vokabular_js_1.SCHEMAS.getReceipt;
     const draht = werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
-    return (0, exports.istObjekt)(draht.receipt) ? { ...draht, receipt: belegRueckgabeNachAussen(draht.receipt) } : draht;
+    return (0, exports.istObjekt)(draht.receipt) ? { ...draht, receipt: belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt)) } : draht;
 }
 /**
  * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
@@ -250,7 +297,7 @@ function _storedArticleToWire(id, doc, functionName = 'fromStoredArticle') {
     const schema = vokabular_js_1.SCHEMAS.listMyArticles;
     const huelle = werteNachAussen(schluesselNachAussen({ articles: [handler] }, schema.data), schema.werte);
     const artikel = huelle.articles[0];
-    const katalog = (pfad) => aeussereWerte(schema.werte[pfad].$catalog);
+    const katalog = (pfad) => aeussereWerte(schema.werte[pfad]);
     const raus = nurBekannte(artikel, new Set(vokabular_js_1.ARTIKEL_FELDER), {
         quantityRule: katalog('articles[].quantityRule'), e1aGroup: katalog('articles[].e1aGroup'),
     });

package/dist/cjs/stored/einstellungen.js

@@ -4,6 +4,7 @@ exports._PRUEFER_FELDER = void 0;
 exports._storedPosSettingsToWire = _storedPosSettingsToWire;
 const settings_js_1 = require("../pos/settings.js");
 const draht_js_1 = require("./draht.js");
+const draht_js_2 = require("./draht.js");
 const vokabular_js_1 = require("./vokabular.js");
 const bool = (v) => typeof v === 'boolean';
 const hex = (v) => typeof v === 'string' && /^#[0-9a-fA-F]{6}$/.test(v);
@@ -75,7 +76,7 @@ function teilSchema(teil) {
 }
 function katalogFuer(teil, aussen) {
     const verweis = vokabular_js_1.SCHEMAS.getKasseSettings.werte[`${teil}.${aussen}`];
-    return verweis ? vokabular_js_1.KATALOGE[verweis.$catalog] ?? null : null;
+    return verweis ? (0, draht_js_2.katalogVon)(verweis) ?? null : null;
 }
 /** Tasten: aeussere und innere Aktionsnamen, Vorgabe und Paare in innerer Form. */
 const TASTEN_SCHEMA = (0, draht_js_1.regel)(teilSchema('device').shortcuts).unter;

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

@@ -0,0 +1,3 @@
+import type { Receipt } from '../models/receipt.js';
+export declare function gutscheineFuerPaket(receipt: Receipt): Receipt;
+export declare function wieVendortesPaket(receipt: Receipt): Receipt;

package/dist/cjs/stored/gutscheine.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gutscheineFuerPaket = gutscheineFuerPaket;
+exports.wieVendortesPaket = wieVendortesPaket;
+/*
+ * Zwilling von `gutscheineFuerPaket` (functions/beleg-layout.js): der Bon
+ * kennt Gutscheine mit Code nur als Positionen. Eintraege, deren Betrag schon
+ * als Position am Beleg steht (Einzweck, Leistung, Mehrzweck im 0-%-Topf),
+ * fallen fuer das Zeilenmodell weg, sonst zaehlte es sie ein zweites Mal; die
+ * maskierte Code-Endung wandert an die passende Position. Nur Darstellung,
+ * der Beleg selbst bleibt unberuehrt.
+ */
+const POSITIONS_ARTEN = ['single_purpose', 'service'];
+const centsDerPosition = (it) => Math.round(Math.abs(it.priceCents * it.quantity));
+const centsDesEintrags = (v) => Number.isInteger(v.amountCents) ? Math.abs(v.amountCents) : Math.abs(v.valueCents ?? 0);
+function gutscheineFuerPaket(receipt) {
+    const positionen = receipt.items.map((it) => ({ ...it }));
+    const vergeben = new Set();
+    const codeAnPosition = (v, kinds) => {
+        const cents = centsDesEintrags(v);
+        const i = positionen.findIndex((it, k) => !vergeben.has(k) && it.kind != null && kinds.includes(it.kind)
+            && centsDerPosition(it) === cents && !String(it.name || '').includes('····'));
+        if (i < 0)
+            return;
+        vergeben.add(i);
+        if (typeof v.code === 'string' && v.code)
+            positionen[i].name = `${positionen[i].name} ${v.code}`;
+    };
+    const bleiben = [];
+    for (const v of receipt.vouchers) {
+        if (POSITIONS_ARTEN.includes(v.type)) {
+            if (v.action === 'sell')
+                codeAnPosition(v, ['voucher']);
+            continue;
+        }
+        if (v.zeroRateBucket === true) {
+            codeAnPosition(v, ['voucher_float']);
+            continue;
+        }
+        bleiben.push(v);
+    }
+    return { ...receipt, items: positionen, vouchers: bleiben };
+}
+/*
+ * Das Backend setzt den Bon noch mit dem vendorten Paket 0.33 (functions/
+ * package.json). Es liest an einem Gutschein nur name, code, action, type und
+ * den Wert; die Kennzeichen der neuen Form (`voucherType`, `codeSuffix`,
+ * `balanceAfterCents` ...) sieht es nicht. Was nach `gutscheineFuerPaket`
+ * bleibt (Mehrzweck, Aktion), zeigt es darum wie einen Altbeleg
+ * („Wertgutschein ····-····-5KNZ - Gutschein“). Dieses Paket zeigt solche
+ * Eintraege selbst in der Form der Spec („Gutschein ····-5KNZ“ + Rest); fuer
+ * das Layout wie der Server fallen die Kennzeichen hier weg. Entfaellt, sobald
+ * der Server ein Paket mit der neuen Form vendort und nicht mehr aufbereitet.
+ */
+function wieVendortesPaket(receipt) {
+    const vouchers = receipt.vouchers.map((v) => ({
+        name: v.name, code: v.code, action: v.action, type: v.type, valueCents: v.valueCents,
+    }));
+    return { ...receipt, vouchers };
+}

package/dist/cjs/stored/index.js

@@ -29,6 +29,7 @@ const settings_js_1 = require("../pos/settings.js");
 const artikel_js_1 = require("../pos/artikel.js");
 const errors_js_1 = require("../client/errors.js");
 const draht_js_1 = require("./draht.js");
+const bon_layout_js_1 = require("./bon-layout.js");
 const einstellungen_js_1 = require("./einstellungen.js");
 const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
 // ---- Belege -----------------------------------------------------------------
@@ -87,7 +88,7 @@ function fromStoredReceiptWithCompany(doc, options) {
     const draht = (0, draht_js_1._receiptEnvelopeToWire)(huelle);
     draht.receipt = zeilenAlsText(draht.receipt);
     const raus = (0, receipts_js_1.belegMitFirmaAusHuelle)(draht, name);
-    raus.layout = layoutWieServer(raus, beleg.layoutRegeln);
+    raus.layout = (0, bon_layout_js_1.layoutWieServer)(raus, beleg.layoutRegeln);
     return raus;
 }
 /**
@@ -102,22 +103,6 @@ function pruefangabenFuer(beleg, angabe) {
         return (0, draht_js_1.pruefangabenDerHuelle)(beleg.pruefangaben);
     return { karteRegistriertAm: angabe?.cardRegisteredAt ?? null, kasseRegistriertAm: angabe?.cashregisterRegisteredAt ?? null };
 }
-/**
- * Layout wie `beleg-layout.layoutFuerBeleg`: 80 mm, Regelwerk mindestens das
- * aktuelle. Kann der Server es nicht bauen, liefert er `null` (dann baut
- * [receiptLayoutFromResult] selbst); ebenso hier.
- */
-function layoutWieServer(b, regelwerk) {
-    const ruleset = Math.max(Number(regelwerk) || 1, layout_js_1.CURRENT_LAYOUT_RULESET);
-    try {
-        return (0, layout_js_1.buildReceiptLayout)(b.receipt, b.company, {
-            paperSize: 'mm80', ruleset, testCashregister: b.testCashregister, testSignature: b.testSignature, registrationInfo: b.registrationInfo,
-        });
-    }
-    catch {
-        return null;
-    }
-}
 // ---- Firma ------------------------------------------------------------------
 const KOPF_FELDER = ['companyName', 'street', 'zip', 'city', 'phone', 'uid', 'taxnr', 'isSmallBusiness',
     'footer1', 'footer2', 'footer3', 'footer4', 'thanksMessage', 'showKreiseckLogo', 'logoUrl'];

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

@@ -1,16 +1,18 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "e061453f62c8f4af21528eb51a677d6f947553f5b78621d64497f45833dd8b09";
+export declare const VOKABULAR_QUELLE = "733e4385baf4b2aa50605e2ebe5903948ce77b3346aa3bb65c5fd0d450a6898f";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {
     readonly [aussen: string]: SchemaEintrag;
 }
+/** Wertverweis: Name eines Katalogs oder eine eingebettete Zuordnung innen -> aussen. */
+export type Wertverweis = {
+    readonly $catalog: string;
+} | Readonly<Record<string, string>>;
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export declare const SCHEMAS: Readonly<Record<'getReceipt' | 'getKasseSettings' | 'listMyArticles', {
     readonly data: SchemaObjekt;
-    readonly werte: Readonly<Record<string, {
-        readonly $catalog: string;
-    }>>;
+    readonly werte: Readonly<Record<string, Wertverweis>>;
 }>>;
 /** Die Felder eines Artikels in der Antwort (`listMyArticles`), aussen. */
 export declare const ARTIKEL_FELDER: readonly string[];