@kreiseck/kasseneck-api 1.11.0 → 1.12.0

package/dist/esm/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/esm/register/pairing.js

@@ -50,6 +50,7 @@ export const 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). */
 export function cancelScopeOf(perms) {
@@ -76,6 +77,21 @@ export 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.
+ */
+export 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/esm/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/esm/stored/bon-layout.js

@@ -0,0 +1,20 @@
+import { buildReceiptLayout, CURRENT_LAYOUT_RULESET } from '../receipt/layout.js';
+import { gutscheineFuerPaket, wieVendortesPaket } from './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.
+ */
+export function layoutWieServer(b, regelwerk) {
+    const ruleset = Math.max(Number(regelwerk) || 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 buildReceiptLayout(wieVendortesPaket(gutscheineFuerPaket(b.receipt)), b.company, {
+            paperSize: 'mm80', ruleset, testCashregister: b.testCashregister, testSignature: b.testSignature, registrationInfo: b.registrationInfo,
+        });
+    }
+    catch {
+        return null;
+    }
+}

package/dist/esm/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/esm/stored/draht.js

@@ -67,16 +67,21 @@ function anPfad(obj, teile, fn) {
  */
 function werteNachAussen(obj, werte) {
     let raus = obj;
-    for (const [pfad, { $catalog }] of Object.entries(werte)) {
-        const katalog = 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' && hat(katalog, v) ? katalog[v] : v));
     }
     return raus;
 }
+/** Zuordnung eines Wertverweises: benannter Katalog oder eingebettet. */
+export function katalogVon(verweis) {
+    const name = verweis.$catalog;
+    return typeof name === 'string' ? KATALOGE[name] : verweis;
+}
 /** Englische Werte eines Katalogs (was an dieser Stelle hinaus darf). */
-const aeussereWerte = (name) => new Set(Object.values(KATALOGE[name] ?? {}));
+const aeussereWerte = (verweis) => new Set(Object.values(katalogVon(verweis) ?? {}));
 // ---- Belege -----------------------------------------------------------------
 /**
  * Interne Marke der Storno-Reservierung: `stornoMarke` am Storno-Beleg,
@@ -131,6 +136,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]) => [hat(namen, k) ? namen[k] : k, w]));
+}
+/** Zwilling von `gutscheinEintragNachAussen`: ohne deutschen Schluessel/Wert dasselbe Objekt (Altbeleg). */
+function gutscheinEintragNachAussen(v) {
+    if (!istObjekt(v))
+        return v;
+    const art = KATALOGE.GUTSCHEIN_ART ?? {};
+    const typNeu = typeof v.type === 'string' && hat(art, v.type);
+    if (!typNeu && !Object.keys(v).some((k) => 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' && hat(art, w) ? art[w] : w;
+        else if (k === 'artikel')
+            raus.article = istObjekt(w) ? umbenannt(w, GUTSCHEIN_ARTIKEL_AUSSEN) : w;
+        else
+            raus[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;
@@ -182,7 +228,7 @@ export function pruefangabenDerHuelle(p) {
 export function _receiptEnvelopeToWire(huelle) {
     const schema = SCHEMAS.getReceipt;
     const draht = werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
-    return istObjekt(draht.receipt) ? { ...draht, receipt: belegRueckgabeNachAussen(draht.receipt) } : draht;
+    return istObjekt(draht.receipt) ? { ...draht, receipt: belegGutscheineNachAussen(belegRueckgabeNachAussen(draht.receipt)) } : draht;
 }
 /**
  * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
@@ -238,7 +284,7 @@ export function _storedArticleToWire(id, doc, functionName = 'fromStoredArticle'
     const schema = 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(ARTIKEL_FELDER), {
         quantityRule: katalog('articles[].quantityRule'), e1aGroup: katalog('articles[].e1aGroup'),
     });

package/dist/esm/stored/einstellungen.js

@@ -1,6 +1,7 @@
 import { POS_BUSINESS_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_DEVICE_VALUES, POS_SHORTCUT_DEFAULTS, POS_SHORTCUT_SHARED_PAIRS, POS_BUSINESS_OPTIONAL_FIELDS, _optionalerWert, } from '../pos/settings.js';
 import { hat, innereNamen, istObjekt, regel } from './draht.js';
-import { KATALOGE, SCHEMAS } from './vokabular.js';
+import { katalogVon } from './draht.js';
+import { SCHEMAS } from './vokabular.js';
 const bool = (v) => typeof v === 'boolean';
 const hex = (v) => typeof v === 'string' && /^#[0-9a-fA-F]{6}$/.test(v);
 const kuerzel = (v) => typeof v === 'string' && /^[A-Za-z0-9]{1,3}$/.test(v);
@@ -71,7 +72,7 @@ function teilSchema(teil) {
 }
 function katalogFuer(teil, aussen) {
     const verweis = SCHEMAS.getKasseSettings.werte[`${teil}.${aussen}`];
-    return verweis ? KATALOGE[verweis.$catalog] ?? null : null;
+    return verweis ? katalogVon(verweis) ?? null : null;
 }
 /** Tasten: aeussere und innere Aktionsnamen, Vorgabe und Paare in innerer Form. */
 const TASTEN_SCHEMA = regel(teilSchema('device').shortcuts).unter;

package/dist/esm/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/esm/stored/gutscheine.js

@@ -0,0 +1,56 @@
+/*
+ * 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);
+export 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.
+ */
+export 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/esm/stored/index.js

@@ -15,11 +15,12 @@
  */
 import { belegAusHuelle, belegMitFirmaAusHuelle } from '../client/receipts.js';
 import { fromReceiptCompanyPayload } from '../models/receipt-company.js';
-import { buildReceiptLayout, CURRENT_LAYOUT_RULESET, receiptSignatureIsTest } from '../receipt/layout.js';
+import { receiptSignatureIsTest } from '../receipt/layout.js';
 import { sanitizePosSettings } from '../pos/settings.js';
 import { fromPosArticlePayload } from '../pos/artikel.js';
 import { KasseneckValidationError } from '../client/errors.js';
 import { _receiptEnvelopeToWire, _storedArticleToWire, _storedReceiptInner, _storedReceiptToWire, pruefangabenDerHuelle, } from './draht.js';
+import { layoutWieServer } from './bon-layout.js';
 import { _storedPosSettingsToWire } from './einstellungen.js';
 const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
 // ---- Belege -----------------------------------------------------------------
@@ -93,22 +94,6 @@ function pruefangabenFuer(beleg, angabe) {
         return 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, CURRENT_LAYOUT_RULESET);
-    try {
-        return 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/esm/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[];

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
 // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export const VOKABULAR_QUELLE = "e061453f62c8f4af21528eb51a677d6f947553f5b78621d64497f45833dd8b09";
+export const VOKABULAR_QUELLE = "733e4385baf4b2aa50605e2ebe5903948ce77b3346aa3bb65c5fd0d450a6898f";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -43,7 +43,22 @@ export const SCHEMAS = {
                         "tone": "ton"
                     }
                 ]
-            }
+            },
+            "issuedVouchers": [
+                {
+                    "__": "gutscheine",
+                    "codeSuffix": "codeEnde",
+                    "faceValueCents": "nennwertCents",
+                    "quantity": "stueck",
+                    "validity": {
+                        "__": "gueltigkeit",
+                        "pattern": "muster",
+                        "redeemableUntil": "einloesbarBis",
+                        "refundableUntil": "rueckzahlbarBis",
+                        "validUntil": "gueltigBis"
+                    }
+                }
+            ]
         },
         "werte": {
             "receipt.cancellationReason": {
@@ -51,6 +66,12 @@ export const SCHEMAS = {
             },
             "layout.lines[].tone": {
                 "$catalog": "LAYOUT_TON"
+            },
+            "issuedVouchers[].type": {
+                "$catalog": "GUTSCHEIN_ART"
+            },
+            "issuedVouchers[].validity.pattern": {
+                "$catalog": "GUTSCHEIN_MUSTER"
             }
         }
     },
@@ -157,6 +178,12 @@ export const SCHEMAS = {
                 "terminalVia": "terminalVia",
                 "terminalType": "terminalArt",
                 "shortcutHints": "tastenMarken"
+            },
+            "vouchers": {
+                "__": "gutscheine",
+                "sale": "verkauf",
+                "valueVoucherType": "wertArt",
+                "vatRateBp": "satzBp"
             }
         },
         "werte": {
@@ -207,6 +234,10 @@ export const SCHEMAS = {
             },
             "device.terminalType": {
                 "$catalog": "KASSE_GERAET_WERTE.terminalType"
+            },
+            "vouchers.valueVoucherType": {
+                "mehrzweck": "multi_purpose",
+                "einzweck": "single_purpose"
             }
         }
     },
@@ -301,6 +332,7 @@ export const KATALOGE = {
         "afa_gebaeude": "building_depreciation",
         "anlagenabgang": "asset_disposal_book_value",
         "instandhaltung_gebaeude": "building_maintenance",
+        "bauarbeiten": "construction_work",
         "reise": "travel_expenses",
         "fahrkarten": "travel_tickets",
         "naechtigung_beleg": "lodging_invoice",
@@ -335,6 +367,8 @@ export const KATALOGE = {
         "geschenke_geschaeftsfreunde": "business_gifts",
         "bewirtung": "hospitality",
         "bewirtung_werbung": "hospitality_advertising",
+        "kundschaft_aufmerksamkeit": "customer_courtesy",
+        "lebensmittel": "groceries",
         "bewirtung_voll": "hospitality_full",
         "bewirtung_repraesentation": "hospitality_representation",
         "sponsoring": "sponsorship",
@@ -365,6 +399,7 @@ export const KATALOGE = {
         "arbeitslosen_optin": "voluntary_unemployment_insurance",
         "uebrige_ausgaben": "other_expenses",
         "telefon_internet": "phone_internet",
+        "energie": "energy_utilities",
         "buero": "office_supplies",
         "software": "software_subscriptions",
         "fachliteratur": "professional_literature",
@@ -396,6 +431,17 @@ export const KATALOGE = {
         "ball_kultur": "non_deductible_events",
         "durchlaufend_ausgabe": "pass_through_payment"
     },
+    "GUTSCHEIN_ART": {
+        "mehrzweck": "multi_purpose",
+        "einzweck": "single_purpose",
+        "leistung": "service",
+        "aktion": "promotion"
+    },
+    "GUTSCHEIN_MUSTER": {
+        "unbefristet": "unlimited",
+        "1+3": "1+3",
+        "frei": "custom"
+    },
     "KASSE_BETRIEB_WERTE.cardProvider": {
         "keiner": "none",
         "extern": "external",

package/dist/esm/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.11.0";
+export declare const PACKAGE_VERSION = "1.12.0";

package/dist/esm/version.js

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

package/fixtures/expected/voucher-cancellation.grid32.txt

@@ -0,0 +1,30 @@
+       Melisse Nails e.U.       
+         Melissenweg 7          
+           1070 Wien            
+          ATU12345675           
+         +43 1 2345678          
+                                
+================================
+          STORNOBELEG           
+================================
+     Stornobuchung zu Beleg     
+         AT0-KASSE1-70          
+   vom 19.10.2026, 10:15 Uhr    
+   Grund: Kunde hat storniert   
+                                
+Datum:       19.10.2026 10:15:30
+Kassen-ID:                KASSE1
+Beleg-ID:          AT0-KASSE1-77
+                                
+1  x Maniküre           -35,00 A
+Gutschein ····-9DWT      30,50 A
+                                
+MwSt%   MwSt      Netto   Brutto
+A 20%   -0,75     -3,75    -4,50
+--------------------------------
+Gesamt:                  -4,50 €
+Zahlungsart:          Barzahlung
+                                
+           [QR-Code]            
+                                
+     Danke für Ihren Besuch     

package/fixtures/expected/voucher-cancellation.grid48.txt

@@ -0,0 +1,29 @@
+               Melisse Nails e.U.               
+                 Melissenweg 7                  
+                   1070 Wien                    
+                  ATU12345675                   
+                 +43 1 2345678                  
+                                                
+================================================
+                  STORNOBELEG                   
+================================================
+      Stornobuchung zu Beleg AT0-KASSE1-70      
+           vom 19.10.2026, 10:15 Uhr            
+           Grund: Kunde hat storniert           
+                                                
+Datum:                       19.10.2026 10:15:30
+Kassen-ID:                                KASSE1
+Beleg-ID:                          AT0-KASSE1-77
+                                                
+1  x Maniküre                           -35,00 A
+Gutschein ····-9DWT                      30,50 A
+                                                
+MwSt%       MwSt            Netto         Brutto
+A 20%       -0,75           -3,75          -4,50
+------------------------------------------------
+Gesamt:                                  -4,50 €
+Zahlungsart:                          Barzahlung
+                                                
+                   [QR-Code]                    
+                                                
+             Danke für Ihren Besuch