@kreiseck/kasseneck-api 1.15.0 → 1.17.0

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;

package/dist/esm/receipt/gutschein-plan.js

@@ -1,5 +1,5 @@
 import { VoucherCode } from '@kreiseck/validator';
-import { isNewFormVoucher, voucherIsValid, voucherServerFields } from '../models/voucher.js';
+import { isNewFormVoucher, istWertVerkauf, voucherIsValid, voucherServerFields, wunschFormGueltig } from '../models/voucher.js';
 /**
  * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (Backend
  * `gutschein-core.NULLTOPF_AB`). Solange er in der Zukunft liegt, zaehlt ein
@@ -44,6 +44,23 @@ function satzBp(vat) {
 function position(satzBpWert, cents, kind) {
     return { amount: 1, priceOne: cents / 100, vat: satzBpWert / 100, tip: null, kind };
 }
+/** Reservierte Kennung (`__…__`): gibt es am Server nie als Sorte (gutschein-core.RESERVIERTE_ID). */
+const RESERVIERTE_ID = /^__.*__$/;
+/**
+ * Die Sorte zum Wunsch, wie der Server sie verkaufen wuerde, oder null
+ * (unbekannt): Mehrzweck ohne Satz, Einzweck mit Satz > 0, Betrag frei oder
+ * fest von 1,00 bis 10.000,00 €. Eine unstimmige Sorte verkauft der Server
+ * nicht (`gutschein-beleg.sorteFuerVerkauf` ueber `gutschein-core.pruefeSorte`).
+ */
+function sorteZumWunsch(typen, typeId) {
+    const t = (typen ?? []).find((x) => x.id === typeId);
+    if (t == null)
+        return null;
+    const satzOk = t.kind === 'multi_purpose' ? t.vatRateBp == null : t.kind === 'single_purpose' && Number.isInteger(t.vatRateBp) && t.vatRateBp > 0;
+    const betragOk = t.amount?.mode === 'free'
+        || (t.amount?.mode === 'fixed' && Number.isInteger(t.amount.cents) && t.amount.cents >= 100 && t.amount.cents <= 1_000_000);
+    return satzOk && betragOk ? t : null;
+}
 /** Code in Normalform (tolerant eingelesen, Pruefzeichen stimmt) oder null. */
 function normalerCode(code) {
     if (typeof code !== 'string')
@@ -152,7 +169,23 @@ export function planeGutscheine(kunde, vouchers, art, o) {
     for (const [i, v] of vouchers.entries()) {
         if (istGelesen(v))
             return nein('voucher_invalid', `Gutschein ${i + 1}: Serverfelder an einem Wunsch.`);
-        if (isNewFormVoucher(v) && !voucherIsValid(v))
+        if (!isNewFormVoucher(v))
+            continue;
+        if (istWertVerkauf(v) && v.typeId == null) {
+            // Wie gutschein-beleg.pruefeWuensche: ein Wert-Verkauf ohne Sorte ist voucher_type_required.
+            // Nur eine alte Gutschein-Einstellung MIT Art (Aufrufer bis 1.16) rechnet wie bisher; ein Server ab
+            // Stufe 4b schickt `valueVoucherType` immer null, dort hilft kein Neuladen – die Sorte fehlt.
+            if (o.voucherSettings?.valueVoucherType == null)
+                return nein('voucher_type_required', `Gutschein ${i + 1}: die Gutschein-Sorte fehlt (typeId).`);
+            if (!wunschFormGueltig(v, false))
+                return nein('voucher_invalid', `Gutschein ${i + 1} ist unvollstaendig.`);
+            continue;
+        }
+        // Eine reservierte Kennung weist der Server vor jeder anderen Pruefung als unbekannt ab.
+        if (istWertVerkauf(v) && typeof v.typeId === 'string' && RESERVIERTE_ID.test(v.typeId)) {
+            return nein('voucher_type_not_found', `Gutschein ${i + 1}: diese Gutschein-Sorte gibt es nicht.`);
+        }
+        if (!voucherIsValid(v))
             return nein('voucher_invalid', `Gutschein ${i + 1} ist unvollstaendig.`);
     }
     // Kein Gutschein mit Gutschein bezahlen, sobald einer der beiden die neue Form hat.
@@ -210,6 +243,34 @@ export function planeGutscheine(kunde, vouchers, art, o) {
             gutscheine.push(g);
             continue;
         }
+        if (istWertVerkauf(v) && v.typeId != null) {
+            // Verkauf ueber eine Sorte (gutschein-beleg.plane): unbekannt, andere Art, falscher Fixbetrag. Eine andere Art
+            // heisst: die Kasse hat eine alte Sicht (Sorte umgestellt) – wie ein anderer Fixbetrag voucher_amount_mismatch,
+            // die Kasse laedt die Sorten neu.
+            const sorte = sorteZumWunsch(o.voucherTypes, v.typeId);
+            if (sorte == null)
+                return nein('voucher_type_not_found', `Gutschein ${i + 1}: die Gutschein-Sorte fehlt (voucherTypes).`);
+            if (v.type != null && v.type !== sorte.kind)
+                return nein('voucher_amount_mismatch', `Gutschein ${i + 1}: die Art passt nicht (mehr) zur Gutschein-Sorte.`);
+            if (sorte.amount.mode === 'fixed' && v.amountCents !== sorte.amount.cents) {
+                return nein('voucher_amount_mismatch', `Gutschein ${i + 1}: der Betrag passt nicht zum Fixbetrag der Gutschein-Sorte.`);
+            }
+            const c = v.amountCents;
+            if (sorte.kind === 'multi_purpose') {
+                if (nulltopf) {
+                    zusatz.push(position(0, c, 'voucher_float'));
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100, imNullTopf: true });
+                }
+                else {
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100 });
+                }
+            }
+            else {
+                // Kleinunternehmer: befreit verkauft, der Satz der Sorte legt nur fest, wofuer der Gutschein gilt.
+                zusatz.push(position(ku ? 0 : sorte.vatRateBp, c, 'voucher'));
+            }
+            continue;
+        }
         if (!ARTEN.includes(String(v.type)))
             return nein('voucher_invalid', `Gutschein ${i + 1}: unbekannte Art.`);
         if (v.action === 'sell') {
@@ -239,6 +300,8 @@ export function planeGutscheine(kunde, vouchers, art, o) {
                 const a = (o.voucherArticles ?? []).find((x) => x.id === v.articleId);
                 if (a == null)
                     return nein('voucher_item_mismatch', `Gutschein ${i + 1}: der Artikel fehlt (voucherArticles).`);
+                if (a.serviceVoucher === false)
+                    return nein('voucher_service_not_allowed', `Gutschein ${i + 1}: der Artikel ist nicht als Leistungsgutschein freigegeben.`);
                 if (!Number.isInteger(a.priceCents) || a.priceCents <= 0 || !Number.isInteger(a.vatRateBp) || a.vatRateBp < 0) {
                     return nein('voucher_invalid', `Gutschein ${i + 1}: Artikel ohne Preis oder Satz.`);
                 }
@@ -253,7 +316,9 @@ export function planeGutscheine(kunde, vouchers, art, o) {
         if ('fehler' in check)
             return check;
         if (v.action === 'payout') {
-            // `gutschein-core.darfAuszahlen`: aktiv, oder abgelaufen bis zum Ende der Rueckzahlbarkeit.
+            // `gutschein-core.darfAuszahlen`: Auszahlung nicht gesperrt, aktiv oder abgelaufen bis zum Ende der Rueckzahlbarkeit.
+            if (check.payout === 'never')
+                return nein('voucher_payout_not_allowed', `Gutschein ${i + 1}: dieser Gutschein wird nie ausgezahlt.`);
             if (!((check.balanceCents ?? 0) > 0))
                 return nein('voucher_used_up', `Gutschein ${i + 1}: kein Saldo.`);
             if (check.status === 'expired') {

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

@@ -8,4 +8,4 @@ export { rasterizeLogo } from './bild.js';
 export { type BrandMarkRaster, BRAND_MARK_RASTERS, BRAND_MARK_PATHS } from './marke-daten.js';
 export { brandMarkImage } from './marke.js';
 export { type CodeTableTestSheetInput, type CodeTableTestSheetRow, type CodeTableTestSheet, CODE_TABLE_TEST_SHEET_CHARS, codeTableTestSheet, codeTableTestSheetBytes, codeTableReferenceImage, } from './code-table-test-sheet.js';
-export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, type VoucherDueInfo, type VoucherDueArticle, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } from './due.js';
+export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, type VoucherDueInfo, type VoucherDueArticle, type VoucherDueType, type VoucherRedeemContext, voucherRedeemMaxCents, VOUCHER_ZERO_RATE_BUCKET_FROM, } from './due.js';

package/dist/esm/stored/draht.js

@@ -137,12 +137,17 @@ function belegRueckgabeNachAussen(beleg) {
     return raus;
 }
 // ---- Gutschein-Eintraege am Beleg ---------------------------------------------
-/** Zwilling von `BELEG_GUTSCHEIN` (api-vokabular-v3): aussen -> innen. */
+/**
+ * Zwilling von `BELEG_GUTSCHEIN` (api-vokabular-v3): aussen -> innen. Sorte,
+ * Sortenname und Auszahlung friert der Server beim Verkauf ueber eine Sorte
+ * ein (Gutscheine Stufe 4b); die Auszahlung traegt dazu einen Wert aus dem
+ * Katalog `GUTSCHEIN_AUSZAHLUNG` (erlaubt/nie).
+ */
 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',
+    reason: 'grund', zeroRateBucket: 'imNullTopf', typeId: 'sorteId', typeName: 'sorteName', payout: 'auszahlung',
 };
 const BELEG_GUTSCHEIN_AUSSEN = Object.fromEntries(Object.entries(BELEG_GUTSCHEIN).map(([aussen, innen]) => [innen, aussen]));
 const GUTSCHEIN_ARTIKEL_AUSSEN = { satzBp: 'vatRateBp', preisCents: 'priceCents' };
@@ -154,6 +159,7 @@ function gutscheinEintragNachAussen(v) {
     if (!istObjekt(v))
         return v;
     const art = KATALOGE.GUTSCHEIN_ART ?? {};
+    const auszahlung = KATALOGE.GUTSCHEIN_AUSZAHLUNG ?? {};
     const typNeu = typeof v.type === 'string' && hat(art, v.type);
     if (!typNeu && !Object.keys(v).some((k) => hat(BELEG_GUTSCHEIN_AUSSEN, k)))
         return v;
@@ -165,6 +171,8 @@ function gutscheinEintragNachAussen(v) {
             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 if (k === 'auszahlung')
+            raus.payout = typeof w === 'string' && hat(auszahlung, w) ? auszahlung[w] : w;
         else
             raus[hat(BELEG_GUTSCHEIN_AUSSEN, k) ? BELEG_GUTSCHEIN_AUSSEN[k] : k] = w;
     }

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

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