@kreiseck/kasseneck-api 1.16.0 → 1.17.1

package/dist/esm/pos/gutschein.d.ts

@@ -15,10 +15,27 @@ export declare const VOUCHER_STATUSES: readonly VoucherStatus[];
 /** Gueltigkeit eines Gutscheins; Daten als `YYYY-MM-DD` (Wiener Tag). Was der Server nicht nennt, fehlt. */
 export interface VoucherValidity {
     pattern: 'unlimited' | '1+3' | 'custom';
+    /**
+     * Gutschein einer Sorte „N Jahre einloesbar, danach 3 Jahre Rueckzahlung“:
+     * die Zahl N (1 bis 30); `pattern` ist dann `1+3` fuer jedes N. Fehlt bei
+     * Gutscheinen ohne Sorte und bei unbefristeten. Die Daten stehen trotzdem in
+     * `redeemableUntil` (+N) und `refundableUntil` (+N+3) und gelten.
+     */
+    redeemableYears?: number;
     redeemableUntil?: string;
     refundableUntil?: string;
     validUntil?: string;
 }
+/** Auszahlung eines Gutscheins bzw. einer Sorte: erlaubt oder nie (nur bei unbefristeter Gueltigkeit). */
+export type VoucherPayout = 'allowed' | 'never';
+/** Art einer Gutschein-Sorte: nur Wertgutscheine (Leistung und Aktion sind keine Sorte). */
+export type VoucherTypeKind = 'multi_purpose' | 'single_purpose';
+export declare const VOUCHER_PAYOUTS: readonly VoucherPayout[];
+export declare const VOUCHER_TYPE_KINDS: readonly VoucherTypeKind[];
+/** Betrag einer Sorte: frei an der Kasse eingegeben oder fest. */
+export declare const VOUCHER_AMOUNT_MODES: readonly ('free' | 'fixed')[];
+/** Gueltigkeit einer Sorte: unbefristet oder N Jahre (das Muster der Sorte, nicht das eines Gutscheins). */
+export declare const VOUCHER_TYPE_VALIDITY_PATTERNS: readonly ('unlimited' | 'years')[];
 /** Der Artikel eines Dienstleistungsgutscheins. */
 export interface VoucherArticle {
     id: string;
@@ -50,12 +67,92 @@ export interface VoucherCheck {
      * inzwischen steuerpflichtigen Konto. Fehlt bei aelteren Servern.
      */
     exempt?: boolean;
+    /** Name der Sorte, mit der der Gutschein verkauft wurde (beim Verkauf eingefroren); fehlt ohne Sorte. */
+    typeName?: string;
+    /**
+     * Auszahlung dieses Gutscheins (beim Verkauf eingefroren); fehlt ohne
+     * Sorte. Bei `never` lehnt der Server jede Auszahlung ab
+     * (`voucher_payout_not_allowed`); Einloesen geht unveraendert.
+     */
+    payout?: VoucherPayout;
+}
+/**
+ * Etikett-Vorlage in der `/v3`-Form (Groesse, Layout, Drehung, Felder,
+ * Freitext). Das Paket zeichnet keine Etiketten: es reicht die Vorlage als
+ * Kopie durch, gezeichnet wird in der Kasse (druck-kit, Kassen-App). Weitere
+ * Schluessel eines neueren Servers bleiben erhalten.
+ */
+export interface VoucherLabelTemplate {
+    /** Etikettgroesse `BxH` in mm, z. B. `40x30`. */
+    size: string;
+    layout: string;
+    /** 0 oder 90 (Grad); fehlt = 0. */
+    rotation?: number;
+    fields?: Record<string, boolean>;
+    freeText?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Gutschein-Sorte (Gutscheine Stufe 4b): eine Kachel im Reiter „Gutscheine“.
+ * Die Kasse bekommt nur verkaufbare Sorten (aktiv und gueltig), in
+ * Kachelfolge. Verkauft wird ein Wertgutschein nur ueber eine Sorte:
+ * `{ action: 'sell', type: kind, typeId: id, amountCents }` (bei `fixed` genau
+ * `amount.cents`); Art, Satz, Gueltigkeit und Auszahlung nimmt der Server aus
+ * der Sorte und friert sie am Gutschein ein.
+ */
+export interface PosVoucherType {
+    id: string;
+    name: string;
+    kind: VoucherTypeKind;
+    /** Satz in Basispunkten, nur bei Einzweck (> 0); Mehrzweck `null`. */
+    vatRateBp: number | null;
+    /** Betrag: frei (Zahlenfeld) oder fest (sofort in den Korb), Cent ganzzahlig. */
+    amount: {
+        mode: 'free';
+    } | {
+        mode: 'fixed';
+        cents: number;
+    };
+    /** Unbefristet oder N Jahre einloesbar, danach 3 Jahre Rueckzahlung (N 1 bis 30). */
+    validity: {
+        pattern: 'unlimited';
+    } | {
+        pattern: 'years';
+        years: number;
+    };
+    payout: VoucherPayout;
+    /** Wirksame Vorlage der Sorte (eigene, sonst die Standardvorlage); `null`, wenn die Antwort keine brauchbare traegt. */
+    label: VoucherLabelTemplate | null;
+    order: number;
+    active: boolean;
+    /** Verkaufte Gutscheine dieser Sorte (nur zur Anzeige). */
+    soldCount: number;
 }
-/** Gutschein-Einstellungen der Kasse (Block `vouchers` aus `getKasseSettings`). */
+/**
+ * Gutschein-Einstellungen der Kasse (Block `vouchers` aus `getKasseSettings`).
+ *
+ * Seit Gutscheine Stufe 4b verkauft eine Kasse ueber Sorten: Reiter und
+ * Kacheln zeigt sie mit `typeSale` (und dem Recht `voucherSell`), je Sorte aus
+ * `types` und die feste Kachel „Leistungsgutschein“ mit `serviceArticles`.
+ * `sale`, `valueVoucherType` und `vatRateBp` gelten nur Kassen vor 1.17; der
+ * Server schickt `sale` immer als `false`.
+ *
+ * Die vier neuen Felder sind optional, damit bestehende Literale von
+ * Verbrauchern weiter uebersetzen; der Leser ([posVoucherSettingsFromWire])
+ * setzt sie immer.
+ */
 export interface PosVoucherSettings {
     sale: boolean;
     valueVoucherType: 'multi_purpose' | 'single_purpose' | null;
     vatRateBp: number | null;
+    /** Gutscheine verkaufen (Reiter „Gutscheine“): Schalter des Servers und mindestens eine Sorte oder ein Leistungsartikel. */
+    typeSale?: boolean;
+    /** Verkaufbare Sorten in Kachelfolge. */
+    types?: PosVoucherType[];
+    /** Es gibt aktive Artikel, die als Leistungsgutschein freigegeben sind (`PosArticle.serviceVoucher`). */
+    serviceArticles?: boolean;
+    /** Standardvorlage des Etiketts (Leistungsgutschein, Notausgang); `null` ohne brauchbare Vorlage. */
+    labelDefault?: VoucherLabelTemplate | null;
 }
 /** Ohne Block `vouchers` (alter Server, Konto ohne Schalter): Verkaufen ist aus. */
 export declare const VOUCHER_SETTINGS_DEFAULTS: Readonly<PosVoucherSettings>;
@@ -67,7 +164,15 @@ export declare const VOUCHER_SETTINGS_DEFAULTS: Readonly<PosVoucherSettings>;
  * `multi_purpose`/`single_purpose`/`null`, der Satz eine ganze Zahl >= 0 oder
  * `null`; Mehrzweck traegt keinen Satz, Einzweck braucht einen, und ein
  * eingeschalteter Verkauf braucht eine Art. Ein ausgeschalteter Verkauf darf
- * eine Art behalten.
+ * eine Art behalten. `typeSale` und `serviceArticles` sind Wahrheitswerte,
+ * `types` eine Liste (fehlen sie, antwortet ein aelterer Server: aus, leer).
+ *
+ * Sorten (Gutscheine Stufe 4b) liest der Leser einzeln: eine unstimmige Sorte
+ * faellt weg ([sorteVomDraht]), die anderen bleiben; ist danach weder eine
+ * Sorte noch ein Leistungsartikel da, ist `typeSale` aus (kein leerer Reiter).
+ * Eine unbrauchbare Etikett-Vorlage schliesst nichts: sie wird `null`, die
+ * Kasse druckt dann ihren Standard (ein Verkauf scheitert nie an der Vorlage).
+ * Das alte Feld `label` (Kassen vor 1.17, Ruling R3) liest das Paket nicht.
  */
 export declare function posVoucherSettingsFromWire(block: unknown): PosVoucherSettings;
 /**

package/dist/esm/pos/gutschein.js

@@ -2,10 +2,21 @@ import { VoucherCode } from '@kreiseck/validator';
 import { KasseneckApiError, KasseneckValidationError } from '../client/errors.js';
 export const VOUCHER_KINDS = Object.freeze(['multi_purpose', 'single_purpose', 'service', 'promotion']);
 export const VOUCHER_STATUSES = Object.freeze(['active', 'used_up', 'expired', 'paid_out', 'cancelled', 'blocked']);
+// Nur die Muster, die der Server an Gutscheinen nach aussen gibt: eine Sorte mit
+// „N Jahre“ geht fuer jedes N als `1+3` mit den Daten und `redeemableYears` = N hinaus
+// (Nachtrag E1), damit Kassen bis 1.16 beim Einloesen nicht an einem neuen Muster
+// scheitern und „einloesbar bis <Datum>“ drucken.
 const VOUCHER_VALIDITY_PATTERNS = ['unlimited', '1+3', 'custom'];
+export const VOUCHER_PAYOUTS = Object.freeze(['allowed', 'never']);
+export const VOUCHER_TYPE_KINDS = Object.freeze(['multi_purpose', 'single_purpose']);
+/** Betrag einer Sorte: frei an der Kasse eingegeben oder fest. */
+export const VOUCHER_AMOUNT_MODES = Object.freeze(['free', 'fixed']);
+/** Gueltigkeit einer Sorte: unbefristet oder N Jahre (das Muster der Sorte, nicht das eines Gutscheins). */
+export const VOUCHER_TYPE_VALIDITY_PATTERNS = Object.freeze(['unlimited', 'years']);
 /** Ohne Block `vouchers` (alter Server, Konto ohne Schalter): Verkaufen ist aus. */
 export const VOUCHER_SETTINGS_DEFAULTS = Object.freeze({
     sale: false, valueVoucherType: null, vatRateBp: null,
+    typeSale: false, types: Object.freeze([]), serviceArticles: false, labelDefault: null,
 });
 /**
  * Block `vouchers` einer Einstellungs-Antwort, geschlossen im Zweifel: ist
@@ -15,10 +26,18 @@ export const VOUCHER_SETTINGS_DEFAULTS = Object.freeze({
  * `multi_purpose`/`single_purpose`/`null`, der Satz eine ganze Zahl >= 0 oder
  * `null`; Mehrzweck traegt keinen Satz, Einzweck braucht einen, und ein
  * eingeschalteter Verkauf braucht eine Art. Ein ausgeschalteter Verkauf darf
- * eine Art behalten.
+ * eine Art behalten. `typeSale` und `serviceArticles` sind Wahrheitswerte,
+ * `types` eine Liste (fehlen sie, antwortet ein aelterer Server: aus, leer).
+ *
+ * Sorten (Gutscheine Stufe 4b) liest der Leser einzeln: eine unstimmige Sorte
+ * faellt weg ([sorteVomDraht]), die anderen bleiben; ist danach weder eine
+ * Sorte noch ein Leistungsartikel da, ist `typeSale` aus (kein leerer Reiter).
+ * Eine unbrauchbare Etikett-Vorlage schliesst nichts: sie wird `null`, die
+ * Kasse druckt dann ihren Standard (ein Verkauf scheitert nie an der Vorlage).
+ * Das alte Feld `label` (Kassen vor 1.17, Ruling R3) liest das Paket nicht.
  */
 export function posVoucherSettingsFromWire(block) {
-    const zu = () => ({ ...VOUCHER_SETTINGS_DEFAULTS });
+    const zu = () => ({ ...VOUCHER_SETTINGS_DEFAULTS, types: [] });
     if (block === null || typeof block !== 'object' || Array.isArray(block))
         return zu();
     const b = block;
@@ -37,7 +56,92 @@ export function posVoucherSettingsFromWire(block) {
         return zu();
     if (art === 'multi_purpose' && satz !== null)
         return zu();
-    return { sale, valueVoucherType: art, vatRateBp: satz };
+    const sortenVerkauf = b['typeSale'] ?? false;
+    const rohSorten = b['types'] ?? [];
+    const leistung = b['serviceArticles'] ?? false;
+    if (typeof sortenVerkauf !== 'boolean' || typeof leistung !== 'boolean' || !Array.isArray(rohSorten))
+        return zu();
+    const types = [];
+    const gesehen = new Set();
+    for (const roh of rohSorten) {
+        const t = sorteVomDraht(roh);
+        if (t === null || gesehen.has(t.id))
+            continue;
+        gesehen.add(t.id);
+        types.push(t);
+    }
+    return {
+        sale, valueVoucherType: art, vatRateBp: satz,
+        typeSale: sortenVerkauf && (types.length > 0 || leistung),
+        types,
+        serviceArticles: leistung,
+        labelDefault: vorlageVomDraht(b['labelDefault']),
+    };
+}
+/** Kennung wie am Server (gutschein-core.ID_MUSTER): reservierte `__…__` gibt es nie als Sorte. */
+const SORTE_ID = /^(?!__.*__$)[A-Za-z0-9_-]{1,128}$/;
+/** Grenzen des Servers (gutschein-core.pruefeSorte): Fixbetrag 1,00 bis 10.000,00 €, Gueltigkeit 1 bis 30 Jahre. */
+const MIN_FIX_CENTS = 100;
+const MAX_BETRAG_CENTS = 1_000_000;
+const MAX_JAHRE = 30;
+const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
+const ganzeZahl = (w, min, max = Number.MAX_SAFE_INTEGER) => typeof w === 'number' && Number.isSafeInteger(w) && w >= min && w <= max;
+/** Etikett-Vorlage als Kopie, wenn sie Groesse und Layout als Text traegt; sonst `null`. */
+function vorlageVomDraht(w) {
+    if (!istObjekt(w) || typeof w['size'] !== 'string' || typeof w['layout'] !== 'string')
+        return null;
+    return JSON.parse(JSON.stringify(w));
+}
+/**
+ * Eine Sorte aus `vouchers.types[]`, oder `null`, wenn sie nicht so ist, wie
+ * der Server eine verkaufbare Sorte liefert (dann bietet die Kasse sie nicht
+ * an): Kennung, Name, Art mit passendem Satz, Betrag, Gueltigkeit, Auszahlung
+ * (`never` nur unbefristet) und aktiv. Fehlende Reihenfolge oder Verkaufszahl
+ * gelten als 0; eine unbrauchbare Vorlage wird `null`.
+ */
+function sorteVomDraht(w) {
+    if (!istObjekt(w))
+        return null;
+    const { id, name, kind, amount, validity, payout } = w;
+    const satz = w['vatRateBp'] ?? null;
+    const reihenfolge = w['order'] ?? 0;
+    const verkauft = w['soldCount'] ?? 0;
+    if (typeof id !== 'string' || !SORTE_ID.test(id))
+        return null;
+    if (typeof name !== 'string' || name.trim() === '')
+        return null;
+    if (kind !== 'multi_purpose' && kind !== 'single_purpose')
+        return null;
+    if (kind === 'single_purpose' ? !ganzeZahl(satz, 1) : satz !== null)
+        return null;
+    if (!istObjekt(amount) || !istObjekt(validity))
+        return null;
+    let betrag;
+    if (amount['mode'] === 'free')
+        betrag = { mode: 'free' };
+    else if (amount['mode'] === 'fixed' && ganzeZahl(amount['cents'], MIN_FIX_CENTS, MAX_BETRAG_CENTS))
+        betrag = { mode: 'fixed', cents: amount['cents'] };
+    else
+        return null;
+    let gueltig;
+    if (validity['pattern'] === 'unlimited')
+        gueltig = { pattern: 'unlimited' };
+    else if (validity['pattern'] === 'years' && ganzeZahl(validity['years'], 1, MAX_JAHRE))
+        gueltig = { pattern: 'years', years: validity['years'] };
+    else
+        return null;
+    if (payout !== 'allowed' && payout !== 'never')
+        return null;
+    if (payout === 'never' && gueltig.pattern !== 'unlimited')
+        return null;
+    if (!ganzeZahl(reihenfolge, Number.MIN_SAFE_INTEGER) || !ganzeZahl(verkauft, 0))
+        return null;
+    if (w['active'] !== true)
+        return null;
+    return {
+        id, name, kind, vatRateBp: satz, amount: betrag, validity: gueltig, payout,
+        label: vorlageVomDraht(w['label']), order: reihenfolge, active: true, soldCount: verkauft,
+    };
 }
 function fehler(name, grund) {
     return new KasseneckValidationError(name, `Antwort: ${grund}`, 'response');
@@ -71,6 +175,12 @@ function wahl(name, pfad, o, feld, erlaubt) {
 function gueltigkeit(name, w) {
     const o = objekt(name, 'validity', w);
     const raus = { pattern: wahl(name, 'validity', o, 'pattern', VOUCHER_VALIDITY_PATTERNS) };
+    if (!fehlt(o.redeemableYears)) {
+        const jahre = o.redeemableYears;
+        if (typeof jahre !== 'number' || !Number.isSafeInteger(jahre) || jahre < 1)
+            throw fehler(name, 'validity.redeemableYears ist keine Zahl von Jahren');
+        raus.redeemableYears = jahre;
+    }
     for (const feld of ['redeemableUntil', 'refundableUntil', 'validUntil']) {
         const t = o[feld];
         if (fehlt(t))
@@ -111,6 +221,16 @@ function leseCheck(name, w) {
             throw fehler(name, 'data.exempt ist kein Wahrheitswert');
         raus.exempt = o.exempt;
     }
+    if (!fehlt(o.typeName)) {
+        if (typeof o.typeName !== 'string' || o.typeName === '')
+            throw fehler(name, 'data.typeName ist kein Text');
+        raus.typeName = o.typeName;
+    }
+    // Geschlossen im Zweifel, ohne Wurf: ein unbekannter Wert (neuerer Server)
+    // gilt als `never`. Einloesen haengt nicht daran und darf nicht an einem
+    // neuen Wert scheitern (die Lehre aus dem Gueltigkeitsmuster, Nachtrag E1).
+    if (!fehlt(o.payout))
+        raus.payout = o.payout === 'allowed' ? 'allowed' : 'never';
     return raus;
 }
 /**

package/dist/esm/pos/index.d.ts

@@ -18,7 +18,7 @@ export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type
 export { type ListMyStocktakesOptions, type ListMyStocktakeItemsOptions, type ListMyStocktakeCountsOptions, type RecordMyStocktakeCountOptions, type VoidMyStocktakeCountOptions, listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
 export type { Stocktake, StocktakeItem, StocktakeCount, StocktakeCountResult, StocktakeItemPage, StocktakeCountPage, StocktakeActor, StocktakeProgress, StocktakeReview, StocktakeRecount, StocktakeScope, } from '../inventory/typen.js';
 export type { StocktakeStatus } from '../inventory/vertrag.js';
-export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, type VoucherKind, type VoucherStatus, type VoucherValidity, type VoucherArticle, type VoucherCheck, type PosVoucherSettings, } from './gutschein.js';
+export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, type VoucherKind, type VoucherStatus, type VoucherValidity, type VoucherArticle, type VoucherCheck, type PosVoucherSettings, type VoucherPayout, type VoucherTypeKind, type PosVoucherType, type VoucherLabelTemplate, } from './gutschein.js';
 export { type GetMyDrawerStateOptions, type OpenMyShiftOptions, type RecordMyCashMovementOptions, type DrawerOpeningEntry, type LogMyDrawerOpeningsOptions, type GetMyShiftReportOptions, type TipPayout, type CloseMyShiftOptions, type AfterCountOption, getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, type ShiftTipLine, type ShiftTipLineKey, } from './schicht.js';
 export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
 export { type ShiftReceiptLayoutOptions, shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';

package/dist/esm/pos/index.js

@@ -20,8 +20,8 @@ export { PRINT_JOB_STATUSES, PRINT_JOB_SOURCES, isPrintJobFinished, listMyPrinte
 export { listMyTipRecipients } from './trinkgeld.js';
 export { STOCK_LOCATION_TYPES, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
 export { listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
-// Gutschein pruefen und Etikett nachdrucken an der Kasse.
-export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, } from './gutschein.js';
+// Gutschein pruefen und Etikett nachdrucken an der Kasse; Gutschein-Sorten (Stufe 4b, 1.17.0).
+export { VOUCHER_KINDS, VOUCHER_STATUSES, checkVoucher, reprintVoucherLabel, VOUCHER_SETTINGS_DEFAULTS, posVoucherSettingsFromWire, VOUCHER_PAYOUTS, VOUCHER_TYPE_KINDS, VOUCHER_AMOUNT_MODES, VOUCHER_TYPE_VALIDITY_PATTERNS, } from './gutschein.js';
 // Schicht, Kassenstand und Lade-Protokoll (1.9.0): Aufrufe, Kataloge, Helfer, Bons.
 export { getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, } from './schicht.js';
 export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, } from './schicht-typen.js';

package/dist/esm/pos/texte.d.ts

@@ -371,6 +371,24 @@ declare const MELDUNGEN_ROH: {
     readonly 'voucher_error.sale_off': {
         readonly text: "Gutscheine verkaufen geht hier noch nicht.";
     };
+    readonly 'voucher_error.type_required': {
+        readonly text: "Bitte eine Gutschein-Sorte wählen.";
+    };
+    readonly 'voucher_error.type_not_found': {
+        readonly text: "Diese Gutschein-Sorte gibt es nicht mehr. Die Kasse lädt die Sorten neu.";
+    };
+    readonly 'voucher_error.amount_mismatch': {
+        readonly text: "Die Gutschein-Sorte hat sich geändert. Die Kasse lädt die Sorten neu.";
+    };
+    readonly 'voucher_error.service_not_allowed': {
+        readonly text: "Dieser Artikel ist nicht als Leistungsgutschein freigegeben.";
+    };
+    readonly 'voucher_error.payout_not_allowed': {
+        readonly text: "Dieser Gutschein kann nicht ausgezahlt werden.";
+    };
+    readonly 'voucher.type_changed': {
+        readonly text: "Diese Gutschein-Sorte hat sich geändert. Bitte die Zeile entfernen und die Kachel neu antippen.";
+    };
     readonly 'voucher.reentry_needed': {
         readonly text: "Die Karte ist belastet, der Beleg fehlt noch: zu jedem Gutschein den Code erneut eingeben, dann den Beleg abschließen.";
     };
@@ -1048,6 +1066,11 @@ export declare const VOUCHER_ERROR_MESSAGES: {
     readonly voucher_partial_cancel: "voucher_error.partial_cancel";
     readonly voucher_settings_missing: "voucher_error.settings_missing";
     readonly too_many_voucher_checks: "voucher_error.too_many_checks";
+    readonly voucher_type_required: "voucher_error.type_required";
+    readonly voucher_type_not_found: "voucher_error.type_not_found";
+    readonly voucher_amount_mismatch: "voucher_error.amount_mismatch";
+    readonly voucher_service_not_allowed: "voucher_error.service_not_allowed";
+    readonly voucher_payout_not_allowed: "voucher_error.payout_not_allowed";
 };
 export type VoucherMessageCode = keyof typeof VOUCHER_ERROR_MESSAGES;
 /** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
@@ -1896,6 +1919,22 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'voucher.add': {
         readonly text: "Hinzufügen";
     };
+    readonly 'voucher.tab': {
+        readonly text: "Gutscheine";
+    };
+    readonly 'voucher.enter_amount': {
+        readonly text: "Betrag eingeben";
+    };
+    readonly 'voucher.service_tile': {
+        readonly text: "Leistungsgutschein";
+    };
+    readonly 'voucher.kind_multi_short': {
+        readonly text: "Mehrzweck";
+    };
+    readonly 'voucher.kind_single_short': {
+        readonly text: "Einzweck {rate} %";
+        readonly placeholders: readonly ["rate"];
+    };
     readonly 'shift.all_payments': {
         readonly text: "Alle Zahlungen dieser Schicht (bar + unbar)";
     };

package/dist/esm/pos/texte.js

@@ -195,6 +195,16 @@ const MELDUNGEN_ROH = {
     'voucher_error.settings_missing': { text: 'Die Gutschein-Einstellungen fehlen. Bitte die Kasse neu laden.' },
     'voucher_error.too_many_checks': { text: 'Zu viele Versuche. Bitte in einer Stunde wieder.' },
     'voucher_error.sale_off': { text: 'Gutscheine verkaufen geht hier noch nicht.' },
+    // Gutschein-Sorten (Stufe 4b, 1.17.0): Verkauf nur ueber eine Sorte; bei den beiden Satzpaaren laedt die Kasse die Sorten neu.
+    'voucher_error.type_required': { text: 'Bitte eine Gutschein-Sorte wählen.' },
+    'voucher_error.type_not_found': { text: 'Diese Gutschein-Sorte gibt es nicht mehr. Die Kasse lädt die Sorten neu.' },
+    'voucher_error.amount_mismatch': { text: 'Die Gutschein-Sorte hat sich geändert. Die Kasse lädt die Sorten neu.' },
+    'voucher_error.service_not_allowed': { text: 'Dieser Artikel ist nicht als Leistungsgutschein freigegeben.' },
+    'voucher_error.payout_not_allowed': { text: 'Dieser Gutschein kann nicht ausgezahlt werden.' },
+    // Satz der Kasse selbst (1.17.0): eine Verkaufszeile im Korb passt nach dem Neuladen der Sorten nicht mehr (Sorte
+    // geaendert, deaktiviert oder geloescht). Die Zeile sperrt das Kassieren, bis sie entfernt und neu gewaehlt ist;
+    // der Satz nach einer Absage des Servers bleibt voucher_error.type_not_found bzw. voucher_error.amount_mismatch.
+    'voucher.type_changed': { text: 'Diese Gutschein-Sorte hat sich geändert. Bitte die Zeile entfernen und die Kachel neu antippen.' },
     // Gutscheine an der Kasse, Stufe 3 (1.13.0): Sätze der Kasse selbst (nicht des Servers).
     'voucher.reentry_needed': { text: 'Die Karte ist belastet, der Beleg fehlt noch: zu jedem Gutschein den Code erneut eingeben, dann den Beleg abschließen.' },
     'voucher.reentry_mismatch': { text: 'Mit diesen Gutscheinen ergibt der Beleg nicht mehr den belasteten Betrag – die Karte zurückbuchen.' },
@@ -599,6 +609,11 @@ export const VOUCHER_ERROR_MESSAGES = {
     voucher_partial_cancel: 'voucher_error.partial_cancel',
     voucher_settings_missing: 'voucher_error.settings_missing',
     too_many_voucher_checks: 'voucher_error.too_many_checks',
+    voucher_type_required: 'voucher_error.type_required',
+    voucher_type_not_found: 'voucher_error.type_not_found',
+    voucher_amount_mismatch: 'voucher_error.amount_mismatch',
+    voucher_service_not_allowed: 'voucher_error.service_not_allowed',
+    voucher_payout_not_allowed: 'voucher_error.payout_not_allowed',
 };
 /** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
 export function voucherErrorMessage(code) {
@@ -940,6 +955,13 @@ const BESCHRIFTUNGEN_ROH = {
     'voucher.code_done': { text: 'Fertig' },
     'voucher.article': { text: 'Artikel' },
     'voucher.add': { text: 'Hinzufügen' },
+    // Gutschein-Sorten als Kacheln im Reiter „Gutscheine“ (Stufe 4b, 1.17.0): Kachel je Sorte mit Betrag
+    // oder „Betrag eingeben“, darunter klein die Art; dazu die feste Kachel „Leistungsgutschein“.
+    'voucher.tab': { text: 'Gutscheine' },
+    'voucher.enter_amount': { text: 'Betrag eingeben' },
+    'voucher.service_tile': { text: 'Leistungsgutschein' },
+    'voucher.kind_multi_short': { text: 'Mehrzweck' },
+    'voucher.kind_single_short': { text: 'Einzweck {rate} %', placeholders: ['rate'] },
     'shift.all_payments': { text: 'Alle Zahlungen dieser Schicht (bar + unbar)' },
     'shift.receipt_count_one': { text: '1 Beleg' },
     'shift.receipt_count_other': { text: '{count} Belege', placeholders: ['count'] },

package/dist/esm/receipt/due.d.ts

@@ -2,8 +2,8 @@ import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod } from '../enums/in
 import type { ReceiptItem } from '../models/receipt-item.js';
 import type { Voucher } from '../models/voucher.js';
 import type { PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
-import { type VoucherDueArticle, type VoucherDueInfo } from './gutschein-plan.js';
-export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueInfo } from './gutschein-plan.js';
+import { type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
+export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueInfo, type VoucherDueType } from './gutschein-plan.js';
 /**
  * Zahlbetrag eines Belegs in ganzen Cent: Zwilling von `createReceipt` im
  * Backend (Nachtrag §8), also `beleg-toepfe.belegToepfe(...).zaehlerDeltaCents`
@@ -42,8 +42,8 @@ export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueI
  * (`gutschein-beleg.plane`, Zwilling in `gutschein-plan.ts`). Was er dafuer
  * aus seinen Daten liest, gibt die Kasse mit: je Einloesung/Auszahlung die
  * Pruefung aus `checkVoucher` (`voucherInfo`, ueber den Code zugeordnet), fuer
- * einen Einzweck-Verkauf die Gutschein-Einstellung der Kasse
- * (`voucherSettings`, Satz), fuer einen Leistungsgutschein-Verkauf den Artikel
+ * einen Wertgutschein-Verkauf die Gutschein-Sorten (`voucherTypes`, Art, Satz,
+ * Betrag; seit 1.17.0), fuer einen Leistungsgutschein-Verkauf den Artikel
  * (`voucherArticles`, Preis und Satz) und `smallBusiness` fuer ein
  * Kleinunternehmer-Konto. Was fehlt oder was der Server abwiese, wirft
  * `invalid_voucher` mit dem erwarteten Server-Code in `voucherErrorCode`.
@@ -86,11 +86,22 @@ export interface ReceiptDueOptions {
      */
     voucherInfo?: readonly VoucherDueInfo[];
     /**
-     * Gutschein-Einstellung der Kasse (`getKasseSettings`, Block `vouchers`):
-     * Pflicht fuer jeden Verkauf eines Mehrzweck- oder Einzweckgutscheins (der
-     * Server verkauft nur mit Einstellung). Fehlt sie oder ist keine Art
-     * gewaehlt: `voucher_settings_missing`; eine andere Art als die
-     * eingestellte: `voucher_invalid`.
+     * Gutschein-Sorten der Kasse (`getKasseSettings`, `vouchers.types`, oder
+     * je Verkauf die gewaehlte): ein Wertgutschein wird nur ueber eine Sorte
+     * verkauft (`typeId` am Wunsch), Art und Satz kommen aus ihr. Fehlt die
+     * Sorte des Wunschs hier: `voucher_type_not_found` (wie beim Server fuer
+     * eine unbekannte oder inaktive); ein anderer Fixbetrag oder eine andere
+     * Art am Wunsch (die Sorte wurde umgestellt): `voucher_amount_mismatch`.
+     */
+    voucherTypes?: readonly VoucherDueType[];
+    /**
+     * Alte Gutschein-Einstellung der Kasse (bis 1.16, Block `vouchers` ohne
+     * Sorten). Nur noch fuer einen Wert-Verkauf ohne `typeId`: nennt sie eine
+     * Art (`valueVoucherType`), rechnet der Zahlbetrag wie bisher (eine andere
+     * Art: `voucher_invalid`); ohne sie oder ohne Art – so liest sich der Block
+     * jedes Servers ab Gutscheine Stufe 4b – `voucher_type_required`. Der
+     * Server verkauft seitdem nur ueber eine Sorte, und `createReceipt` sendet
+     * einen Wert-Verkauf ohne `typeId` nicht mehr.
      */
     voucherSettings?: PosVoucherSettings;
     /**

package/dist/esm/receipt/due.js

@@ -83,6 +83,7 @@ function rechne(items, vouchers, receiptType, options) {
     const plan = planeGutscheine(positionen, vouchers, art, {
         voucherInfo: options.voucherInfo,
         voucherSettings: options.voucherSettings,
+        voucherTypes: options.voucherTypes,
         voucherArticles: options.voucherArticles,
         smallBusiness: options.smallBusiness,
         zeroRateBucketFrom: options.zeroRateBucketFrom,

package/dist/esm/receipt/gutschein-plan.d.ts

@@ -1,5 +1,5 @@
 import type { Voucher } from '../models/voucher.js';
-import type { PosVoucherSettings, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
+import type { PosVoucherSettings, PosVoucherType, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
 /**
  * Gutscheine der neuen Form im Zahlbetrag: Zwilling von
  * `gutschein-beleg.plane` im Backend, soweit er den Zahlbetrag bestimmt.
@@ -14,10 +14,16 @@ import type { PosVoucherSettings, VoucherArticle, VoucherCheck } from '../pos/gu
  * - Mehrzweck einloesen: Eintrag `value`, mindert den Zahlbetrag als Fluss.
  * - Mehrzweck verkaufen: Eintrag `value` (+Fluss); ab dem Stichtag des
  *   0-%-Topfs stattdessen Position im 0-%-Satz ohne Fluss.
- * - Mehrzweck auszahlen: immer Position im 0-%-Satz (minus), kein Fluss.
- * - Einzweck: Position im Satz (Verkauf aus der Einstellung der Kasse,
- *   Einloesung und Auszahlung aus der Pruefung des Gutscheins); als
- *   Kleinunternehmer eingeloest anteilig auf alle Saetze des Korbs.
+ * - Mehrzweck auszahlen: immer Position im 0-%-Satz (minus), kein Fluss;
+ *   nie bei einem Gutschein mit Auszahlung `never`.
+ * - Einzweck: Position im Satz (Verkauf aus der Sorte, Einloesung und
+ *   Auszahlung aus der Pruefung des Gutscheins); als Kleinunternehmer
+ *   eingeloest anteilig auf alle Saetze des Korbs.
+ * - Wertgutschein verkaufen (Stufe 4b): nur ueber eine Sorte (`typeId`); Art
+ *   und Satz kommen aus der Sorte, ein Fixbetrag muss stimmen. Ohne Sorte
+ *   rechnet nur noch ein Aufrufer mit einer alten Gutschein-Einstellung mit
+ *   Art (`voucherSettings.valueVoucherType`) wie bisher; sonst und beim
+ *   Server immer `voucher_type_required`.
  * - Leistung verkaufen: Stueck mal Artikelpreis im Artikelsatz; einloesen: je
  *   Satz eine Minuszeile ueber die gewaehlten Positionen.
  * - Aktion: Rabatt wie `promo`, Betrag aus der Pruefung, hoechstens die Summe.
@@ -50,8 +56,17 @@ export interface VoucherDueInfo {
     code: string;
     check: VoucherCheck;
 }
-/** Artikel fuer den Verkauf eines Dienstleistungsgutscheins: Preis und Satz wie im Artikelstamm. */
-export type VoucherDueArticle = Pick<VoucherArticle, 'id' | 'priceCents' | 'vatRateBp'>;
+/**
+ * Artikel fuer den Verkauf eines Dienstleistungsgutscheins: Preis und Satz wie
+ * im Artikelstamm. `serviceVoucher` (`PosArticle.serviceVoucher`): bei `false`
+ * verkauft der Server ihn nicht (`voucher_service_not_allowed`); ohne Angabe
+ * rechnet der Zahlbetrag wie bisher.
+ */
+export type VoucherDueArticle = Pick<VoucherArticle, 'id' | 'priceCents' | 'vatRateBp'> & {
+    serviceVoucher?: boolean;
+};
+/** Gutschein-Sorte fuer den Verkauf: Kennung, Art, Satz und Betrag wie in `getKasseSettings` (`vouchers.types[]`). */
+export type VoucherDueType = Pick<PosVoucherType, 'id' | 'kind' | 'vatRateBp' | 'amount'>;
 /**
  * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (Backend
  * `gutschein-core.NULLTOPF_AB`). Solange er in der Zukunft liegt, zaehlt ein
@@ -62,6 +77,7 @@ export declare const VOUCHER_ZERO_RATE_BUCKET_FROM = "2099-12-31";
 export interface PlanOptionen {
     voucherInfo?: readonly VoucherDueInfo[];
     voucherSettings?: PosVoucherSettings;
+    voucherTypes?: readonly VoucherDueType[];
     voucherArticles?: readonly VoucherDueArticle[];
     smallBusiness?: boolean;
     zeroRateBucketFrom?: string;