@kreiseck/kasseneck-api 1.11.0 → 1.12.0

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[];

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 = "e061453f62c8f4af21528eb51a677d6f947553f5b78621d64497f45833dd8b09";
+exports.VOKABULAR_QUELLE = "733e4385baf4b2aa50605e2ebe5903948ce77b3346aa3bb65c5fd0d450a6898f";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 exports.SCHEMAS = {
     "getReceipt": {
@@ -46,7 +46,22 @@ exports.SCHEMAS = {
                         "tone": "ton"
                     }
                 ]
-            }
+            },
+            "issuedVouchers": [
+                {
+                    "__": "gutscheine",
+                    "codeSuffix": "codeEnde",
+                    "faceValueCents": "nennwertCents",
+                    "quantity": "stueck",
+                    "validity": {
+                        "__": "gueltigkeit",
+                        "pattern": "muster",
+                        "redeemableUntil": "einloesbarBis",
+                        "refundableUntil": "rueckzahlbarBis",
+                        "validUntil": "gueltigBis"
+                    }
+                }
+            ]
         },
         "werte": {
             "receipt.cancellationReason": {
@@ -54,6 +69,12 @@ exports.SCHEMAS = {
             },
             "layout.lines[].tone": {
                 "$catalog": "LAYOUT_TON"
+            },
+            "issuedVouchers[].type": {
+                "$catalog": "GUTSCHEIN_ART"
+            },
+            "issuedVouchers[].validity.pattern": {
+                "$catalog": "GUTSCHEIN_MUSTER"
             }
         }
     },
@@ -160,6 +181,12 @@ exports.SCHEMAS = {
                 "terminalVia": "terminalVia",
                 "terminalType": "terminalArt",
                 "shortcutHints": "tastenMarken"
+            },
+            "vouchers": {
+                "__": "gutscheine",
+                "sale": "verkauf",
+                "valueVoucherType": "wertArt",
+                "vatRateBp": "satzBp"
             }
         },
         "werte": {
@@ -210,6 +237,10 @@ exports.SCHEMAS = {
             },
             "device.terminalType": {
                 "$catalog": "KASSE_GERAET_WERTE.terminalType"
+            },
+            "vouchers.valueVoucherType": {
+                "mehrzweck": "multi_purpose",
+                "einzweck": "single_purpose"
             }
         }
     },
@@ -304,6 +335,7 @@ exports.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",
@@ -338,6 +370,8 @@ exports.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",
@@ -368,6 +402,7 @@ exports.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",
@@ -399,6 +434,17 @@ exports.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/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.11.0";
+export declare const PACKAGE_VERSION = "1.12.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.11.0';
+exports.PACKAGE_VERSION = '1.12.0';

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

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
-export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
+export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
 export type ApiCall = typeof ALL_CALLS[number];
 /**
  * Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
@@ -21,14 +21,14 @@ export type ApiCall = typeof ALL_CALLS[number];
  * (`fixtures/v3/v3-vokabular.json`, `endpoints.public`, umbenannt nach
  * `names`). Ein Test haelt beide Listen deckungsgleich.
  */
-export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf"];
+export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder"];
 /**
  * Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
  * Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
  * `endpoints.register`. Sechs davon sind zugleich oeffentlich; die Kasse ruft
  * sie trotzdem ueber diesen Weg (ein Dialekt je Client, Nachtrag §5.2).
  */
-export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
+export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift"];
 export type PublicCall = typeof PUBLIC_CALLS[number];
 export type PosCall = typeof POS_CALLS[number];
 /**
@@ -49,7 +49,7 @@ export type PosCall = typeof POS_CALLS[number];
  * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
  * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
  */
-export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "openMyShift", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
+export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "addVariant", "cancelInvoice", "cancelReceipt", "cancelStocktake", "changeStockCondition", "closeMyShift", "closeStocktake", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createStocktake", "createVariantGroup", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "logMyDrawerOpenings", "openMyShift", "orderSignatureCard", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordMyCashMovement", "recordMyStocktakeCount", "recordStockLoss", "recordStocktakeCount", "recountStocktake", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "reviewStocktake", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateVariantGroup", "updateWebhook", "voidMyStocktakeCount", "voidStocktakeCount", "withdrawInvoiceItem"];
 /** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
 export type CallWithoutEffectReason = 'read' | 'repeatable';
 /**