@kreiseck/kasseneck-api 1.16.0 → 1.17.0

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 = "d11de425770bc431be9766199e4c9b3e712eb8e0eea84658f771a0f79d98e90e";
+exports.VOKABULAR_QUELLE = "3088cb472f3fef3ed4ff969bf0d37d051363714096616a9263270c58266bde14";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 exports.SCHEMAS = {
     "getReceipt": {
@@ -54,9 +54,12 @@ exports.SCHEMAS = {
                     "faceValueCents": "nennwertCents",
                     "quantity": "stueck",
                     "articleName": "artikelName",
+                    "typeId": "sorteId",
+                    "typeName": "sorteName",
                     "validity": {
                         "__": "gueltigkeit",
                         "pattern": "muster",
+                        "redeemableYears": "jahre",
                         "redeemableUntil": "einloesbarBis",
                         "refundableUntil": "rueckzahlbarBis",
                         "validUntil": "gueltigBis"
@@ -204,20 +207,72 @@ exports.SCHEMAS = {
             "vouchers": {
                 "__": "gutscheine",
                 "sale": "verkauf",
+                "typeSale": "sortenVerkauf",
                 "valueVoucherType": "wertArt",
                 "vatRateBp": "satzBp",
                 "label": {
                     "__": "etikett",
                     "size": "groesse",
+                    "rotation": "drehung",
                     "fields": {
                         "__": "felder",
                         "business": "betrieb",
                         "value": "wert",
                         "validity": "gueltigkeit",
-                        "checkPage": "pruefseite"
+                        "checkPage": "pruefseite",
+                        "designation": "bezeichnung"
                     },
                     "freeText": "freitext"
-                }
+                },
+                "labelDefault": {
+                    "__": "etikettStandard",
+                    "size": "groesse",
+                    "rotation": "drehung",
+                    "fields": {
+                        "__": "felder",
+                        "business": "betrieb",
+                        "value": "wert",
+                        "validity": "gueltigkeit",
+                        "checkPage": "pruefseite",
+                        "designation": "bezeichnung"
+                    },
+                    "freeText": "freitext"
+                },
+                "types": [
+                    {
+                        "__": "sorten",
+                        "kind": "art",
+                        "vatRateBp": "satzBp",
+                        "amount": {
+                            "__": "betrag",
+                            "mode": "modus"
+                        },
+                        "validity": {
+                            "__": "gueltigkeit",
+                            "pattern": "muster",
+                            "years": "jahre"
+                        },
+                        "payout": "auszahlung",
+                        "label": {
+                            "__": "etikett",
+                            "size": "groesse",
+                            "rotation": "drehung",
+                            "fields": {
+                                "__": "felder",
+                                "business": "betrieb",
+                                "value": "wert",
+                                "validity": "gueltigkeit",
+                                "checkPage": "pruefseite",
+                                "designation": "bezeichnung"
+                            },
+                            "freeText": "freitext"
+                        },
+                        "order": "reihenfolge",
+                        "active": "aktiv",
+                        "soldCount": "verkauft"
+                    }
+                ],
+                "serviceArticles": "leistungsArtikel"
             }
         },
         "werte": {
@@ -272,6 +327,18 @@ exports.SCHEMAS = {
             "vouchers.valueVoucherType": {
                 "mehrzweck": "multi_purpose",
                 "einzweck": "single_purpose"
+            },
+            "vouchers.types[].kind": {
+                "$catalog": "GUTSCHEIN_ART"
+            },
+            "vouchers.types[].amount.mode": {
+                "$catalog": "GUTSCHEIN_BETRAG_MODUS"
+            },
+            "vouchers.types[].validity.pattern": {
+                "$catalog": "GUTSCHEIN_SORTE_MUSTER"
+            },
+            "vouchers.types[].payout": {
+                "$catalog": "GUTSCHEIN_AUSZAHLUNG"
             }
         }
     },
@@ -282,6 +349,7 @@ exports.SCHEMAS = {
                     "__": "articles",
                     "quantityRule": "mengenregel",
                     "askQuantity": "mengeFragen",
+                    "serviceVoucher": "gutscheinLeistung",
                     "maxQuantity": "maxMenge",
                     "tile": {
                         "__": "kasse",
@@ -324,6 +392,7 @@ exports.ARTIKEL_FELDER = [
     "askQuantity",
     "maxQuantity",
     "revenueGroupId",
+    "serviceVoucher",
     "active",
     "groupId",
     "tile",
@@ -484,11 +553,23 @@ exports.KATALOGE = {
         "leistung": "service",
         "aktion": "promotion"
     },
+    "GUTSCHEIN_AUSZAHLUNG": {
+        "erlaubt": "allowed",
+        "nie": "never"
+    },
+    "GUTSCHEIN_BETRAG_MODUS": {
+        "frei": "free",
+        "fix": "fixed"
+    },
     "GUTSCHEIN_MUSTER": {
         "unbefristet": "unlimited",
         "1+3": "1+3",
         "frei": "custom"
     },
+    "GUTSCHEIN_SORTE_MUSTER": {
+        "unbefristet": "unlimited",
+        "jahre": "years"
+    },
     "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.16.0";
+export declare const PACKAGE_VERSION = "1.17.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.16.0';
+exports.PACKAGE_VERSION = '1.17.0';

package/dist/esm/client/receipts.js

@@ -1,4 +1,5 @@
 import { ReceiptType, KeckPaymentMethod, CreditCardProvider, VoucherAction, VoucherType, } from '../enums/index.js';
+import { istWertVerkauf } from '../models/voucher.js';
 import { fromReceiptCompanyPayload, fromReceiptPayload, toReceiptItemPayload, toVoucherPayload, receiptItemIsValid, voucherIsValid, isNewFormVoucher, voucherServerFields, fromReceiptSummaryPayload, isCancellationReason, isReturnDisposition, RETURN_DISPOSITIONS, isTipRefundSource, TIP_REFUND_SOURCES, RECEIPT_EMAIL_VIAS, readRegistrationInfo, } from '../models/index.js';
 import { RECEIPT_OUTPUT_ENTRIES_MAX, RECEIPT_OUTPUT_KINDS, RECEIPT_OUTPUT_RESULTS, receiptOutputsFromWire, } from '../models/receipt-output.js';
 import { VoucherCode } from '@kreiseck/validator';
@@ -122,6 +123,13 @@ export function createReceiptParams(options) {
         if (typ.value === ReceiptType.training.value && vouchers.some(isNewFormVoucher)) {
             throw eingabefehler('Gutscheine der neuen Form gibt es nicht auf Schulungsbelegen (receiptType training).');
         }
+        // Gutscheine Stufe 4b: ein Wertgutschein nur ueber eine Sorte, die Sorte nur an einem solchen Verkauf.
+        if (vouchers.some((voucher) => istWertVerkauf(voucher) && voucher.typeId == null)) {
+            throw eingabefehler('voucher_type_required: Ein Mehrzweck- oder Einzweckgutschein wird nur ueber eine Gutschein-Sorte verkauft (typeId aus getKasseSettings vouchers.types).');
+        }
+        if (vouchers.some((voucher) => voucher.typeId != null && !istWertVerkauf(voucher))) {
+            throw eingabefehler('voucher_invalid: typeId gehoert nur an den Verkauf eines Mehrzweck- oder Einzweckgutscheins.');
+        }
         if (vouchers.some((voucher) => !voucherIsValid(voucher))) {
             throw eingabefehler('Ungueltiger Gutschein uebergeben.');
         }

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isVoucherItem, isVoucherFloatItem, type Voucher, type VoucherArticle, type IssuedVoucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, receiptValueVoucherSign, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, RECEIPT_OUTPUT_KINDS, type ReceiptOutputKind, RECEIPT_OUTPUT_LOG_KINDS, type ReceiptOutputLogKind, RECEIPT_OUTPUT_RESULTS, type ReceiptOutputResult, RECEIPT_OUTPUT_ENTRIES_MAX, type ReceiptOutput, type ReceiptOutputActor, RECEIPT_OUTPUT_ENTRY_ERROR_CODES, type ReceiptOutputEntryErrorCode, RECEIPT_OUTPUT_ERROR_CODES, type ReceiptOutputErrorCode, isReceiptOutputErrorCode, receiptOutputErrorCode, isReceiptOutputError, receiptOutputFieldErrors, type ReceiptOutputFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, TIP_REFUND_SOURCES, type TipRefundSource, isTipRefundSource, openStaffTipCents, cancellationItemsForTip, cancellationCashRefundCents, asksTipRefundSource, asksRefundTip, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, type CashregisterAutoLogout, type CashregisterAutoLogoutPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, type KasseneckPdfOrDataTransport, type PdfOrData, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, createPdfOrDataTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, type ReceiptOutputEntry, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type RejectedReceiptOutput, logReceiptOutputs, downloadDailyReport, downloadMonthlyReport, getCashregisterReport, type CashregisterReportPeriod, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, listReceipts, listAllReceipts, fromListReceiptsSummaryPayload, LIST_RECEIPTS_VIEWS, LIST_RECEIPTS_ORDERS, LIST_RECEIPTS_LIMIT_MAX, LIST_RECEIPTS_DAYS_MAX, LIST_ALL_RECEIPTS_MAX_PAGES, LIST_RECEIPTS_ERROR_CODES, type ListReceiptsErrorCode, type ListReceiptsView, type ListReceiptsOrder, type ListReceiptsOptions, type ListReceiptsWindow, type ListReceiptsGrossByRate, type ListReceiptsSummary, type ListReceiptsDaySummary, type ListReceiptsPage, type ListedReceipt, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.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 './receipt/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 './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type PosBusinessSettings, type PosDeviceSettings, type PosSettings, type ArticleGroup, type PosArticle, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, } from './pos/index.js';

package/dist/esm/models/voucher.d.ts

@@ -14,6 +14,12 @@ export interface Voucher {
     name?: string;
     code?: string;
     action: VoucherAction | string;
+    /**
+     * Art des Gutscheins. Beim Verkauf ueber eine Sorte die Art der Sorte
+     * (`PosVoucherType.kind`): der Server prueft sie gegen die Sorte und lehnt
+     * eine andere ab (`voucher_invalid`). Am Draht darf sie dort fehlen (die Art
+     * kommt dann aus der Sorte); ein so gelesener Wunsch geht ohne `type` hinaus.
+     */
     type: VoucherType | string;
     valueCents?: number;
     /** Neue Form: Betrag in Cent (Verkauf, Einloesung, Auszahlung). */
@@ -26,6 +32,18 @@ export interface Voucher {
     positions?: number[];
     /** Neue Form, Auszahlung: Grund, 1 bis 200 Zeichen. */
     reason?: string;
+    /**
+     * Neue Form, Wertgutschein verkaufen: die Gutschein-Sorte
+     * (`PosVoucherType.id` aus `getKasseSettings`). Pflicht fuer jeden Verkauf
+     * eines Mehrzweck- oder Einzweckgutscheins (Server: `voucher_type_required`),
+     * an jeder anderen Aktion oder Art verboten. Am gelesenen Eintrag die Sorte
+     * des Verkaufs (fehlt ohne Sorte).
+     */
+    typeId?: string;
+    /** Name der Sorte beim Verkauf (eingefroren). */
+    typeName?: string;
+    /** Auszahlung des verkauften Gutscheins (`allowed`/`never`, eingefroren). */
+    payout?: string;
     voucherType?: string;
     voucherId?: string;
     /** Letzte vier Zeichen des Codes; der Klartext steht nie am Beleg. */
@@ -53,8 +71,13 @@ export interface IssuedVoucher {
     quantity?: number;
     /** Nur bei Leistungsgutscheinen: Name des verkauften Artikels; sonst fehlt das Feld. */
     articleName?: string;
+    /** Verkauf ueber eine Sorte: ihre Kennung und ihr Name; sonst fehlen die Felder. */
+    typeId?: string;
+    typeName?: string;
     validity?: {
         pattern: string;
+        /** Sorte „N Jahre“: die Zahl N (Muster `1+3` fuer jedes N, die Daten gelten); fehlt sonst. */
+        redeemableYears?: number;
         redeemableUntil: string | null;
         refundableUntil: string | null;
         validUntil: string | null;
@@ -87,6 +110,9 @@ export interface VoucherPayload {
     quantity?: number;
     positions?: number[];
     reason?: string;
+    typeId?: string;
+    typeName?: string;
+    payout?: string;
     voucherType?: string;
     voucherId?: string;
     codeSuffix?: string;
@@ -100,10 +126,19 @@ export interface VoucherPayload {
 }
 /** Arten der neuen Gutscheinform (die Altwerte sind `value` und `promo`). */
 export declare const NEUE_GUTSCHEINARTEN: readonly string[];
-/** Gehoert der Gutschein zur neuen Form (Art oder Aktion `payout`)? */
-export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action'>): boolean;
-/** Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`. */
-export declare const GUTSCHEIN_SERVERFELDER: readonly ["voucherId", "codeSuffix", "zeroRateBucket", "voucherType"];
+/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
+export declare function isNewFormVoucher(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
+/**
+ * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
+ * oder nur ueber die Sorte). Paketintern: Zahlbetrag und Pruefung vor dem
+ * Senden entscheiden daran, ob eine Sorte noetig ist.
+ */
+export declare function istWertVerkauf(voucher: Pick<Voucher, 'type' | 'action' | 'typeId'>): boolean;
+/**
+ * Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`.
+ * Sortenname und Auszahlung friert der Server beim Verkauf ein (Stufe 4b).
+ */
+export declare const GUTSCHEIN_SERVERFELDER: readonly ["voucherId", "codeSuffix", "zeroRateBucket", "voucherType", "typeName", "payout"];
 /** Welche Serverfelder tragt der Gutschein (leere Liste = keines)? */
 export declare function voucherServerFields(voucher: Voucher): string[];
 export declare function toVoucherPayload(voucher: Voucher): VoucherPayload;
@@ -115,3 +150,10 @@ export declare function toVoucherPayload(voucher: Voucher): VoucherPayload;
  */
 export declare function voucherIsValid(voucher: Voucher): boolean;
 export declare function fromVoucherPayload(payload: VoucherPayload): Voucher;
+/**
+ * Die Form eines Wunschs der neuen Form. `sorteNoetig: false` laesst einen
+ * Wert-Verkauf ohne `typeId` zu: so rechnet der Zahlbetrag den Verkauf eines
+ * Aufrufers bis 1.16 mit der alten Gutschein-Einstellung weiter (der Server ab
+ * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
+ */
+export declare function wunschFormGueltig(v: Voucher, sorteNoetig: boolean): boolean;

package/dist/esm/models/voucher.js

@@ -8,23 +8,44 @@ export const NEUE_GUTSCHEINARTEN = [
     VoucherType.service,
     VoucherType.promotion,
 ];
-/** Gehoert der Gutschein zur neuen Form (Art oder Aktion `payout`)? */
+/**
+ * Verkauf ueber eine Sorte ohne Art (`typeId` ohne `type`): die Art kommt aus
+ * der Sorte. Zwilling von `gutschein-beleg.istSortenVerkauf`.
+ */
+function istSortenVerkaufOhneArt(voucher) {
+    return voucher.action === VoucherAction.sell && voucher.type == null && voucher.typeId != null;
+}
+/** Gehoert der Gutschein zur neuen Form (Art, Aktion `payout` oder Verkauf ueber eine Sorte ohne Art)? */
 export function isNewFormVoucher(voucher) {
-    return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout;
+    return NEUE_GUTSCHEINARTEN.includes(voucher.type) || voucher.action === VoucherAction.payout || istSortenVerkaufOhneArt(voucher);
+}
+/**
+ * Wert-Verkauf: ein Mehrzweck- oder Einzweckgutschein wird verkauft (mit Art
+ * oder nur ueber die Sorte). Paketintern: Zahlbetrag und Pruefung vor dem
+ * Senden entscheiden daran, ob eine Sorte noetig ist.
+ */
+export function istWertVerkauf(voucher) {
+    return voucher.action === VoucherAction.sell
+        && (voucher.type === VoucherType.multi_purpose || voucher.type === VoucherType.single_purpose || istSortenVerkaufOhneArt(voucher));
 }
-/** Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`. */
-export const GUTSCHEIN_SERVERFELDER = ['voucherId', 'codeSuffix', 'zeroRateBucket', 'voucherType'];
+/**
+ * Felder, die nur der Server setzt; an einem Wunsch sind sie `voucher_invalid`.
+ * Sortenname und Auszahlung friert der Server beim Verkauf ein (Stufe 4b).
+ */
+export const GUTSCHEIN_SERVERFELDER = ['voucherId', 'codeSuffix', 'zeroRateBucket', 'voucherType', 'typeName', 'payout'];
 /** Welche Serverfelder tragt der Gutschein (leere Liste = keines)? */
 export function voucherServerFields(voucher) {
     return GUTSCHEIN_SERVERFELDER.filter((feld) => voucher[feld] != null);
 }
 const NEUE_FELDER = [
-    'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'voucherType', 'voucherId', 'codeSuffix',
+    'amountCents', 'articleId', 'quantity', 'positions', 'reason', 'typeId', 'typeName', 'payout', 'voucherType', 'voucherId', 'codeSuffix',
     'vatRateBp', 'article', 'balanceAfterCents', 'remainingQuantityAfter', 'taxedWith', 'exempt', 'zeroRateBucket',
 ];
 export function toVoucherPayload(voucher) {
     const action = requireEnumKey(VoucherAction, voucher.action, 'Gutschein-Aktion');
-    const type = requireEnumKey(VoucherType, voucher.type, 'Gutscheinart');
+    // Verkauf ueber eine Sorte ohne Art: `type` bleibt weg wie im Wunsch (die Art kommt aus der Sorte).
+    const ohneArt = istSortenVerkaufOhneArt(voucher);
+    const type = ohneArt ? undefined : requireEnumKey(VoucherType, voucher.type, 'Gutscheinart');
     // Felder der neuen Form gehen roh hinaus, soweit gesetzt (auch an einem
     // gelesenen Altbeleg: dort fehlen sie, die Nutzlast bleibt byte-gleich).
     const roh = voucher;
@@ -34,7 +55,7 @@ export function toVoucherPayload(voucher) {
             neu[feld] = roh[feld];
     return {
         action,
-        type,
+        ...(ohneArt ? {} : { type }),
         // Die neue Form kennt kein `valueCents`; nur ein gelesener Eintrag (die
         // Auszahlung steht beim Server als Wert mit Cent) traegt es weiter.
         ...(isNewFormVoucher(voucher) && voucher.valueCents == null ? {} : { valueCents: voucher.valueCents ?? null }),
@@ -87,11 +108,13 @@ export function fromVoucherPayload(payload) {
         : payload.value != null
             ? euroToCents(payload.value)
             : undefined;
+    // Ein Verkaufswunsch ueber eine Sorte darf ohne Art sein: dann bleibt `type` weg (nicht `undefined`).
+    const ohneArt = payload.type == null && payload.action === VoucherAction.sell && payload.typeId != null;
     return {
         name: payload.name ?? undefined,
         code: payload.code ?? undefined,
         action: readEnumKey(VoucherAction, payload.action),
-        type: readEnumKey(VoucherType, payload.type),
+        ...(ohneArt ? {} : { type: readEnumKey(VoucherType, payload.type) }),
         valueCents,
         ...lesenNeu(payload),
     };
@@ -112,15 +135,31 @@ const MAX_GRUND = 200;
 const istCent = (n) => typeof n === 'number' && Number.isInteger(n) && n >= 1 && n <= MAX_BETRAG_CENTS;
 const istMenge = (n) => typeof n === 'number' && Number.isInteger(n) && n >= 1 && n <= MAX_STUECK;
 const hatText = (t) => typeof t === 'string' && t.trim().length > 0;
+/**
+ * Form einer Sorten-Kennung am Wunsch (gutschein-core.ID_MUSTER ohne den
+ * Ausschluss): eine reservierte `__…__` ist der Form nach gueltig, der Server
+ * kennt sie nur nicht (`voucher_type_not_found`), ebenso der Zahlbetrag.
+ */
+const SORTE_ID_FORM = /^[A-Za-z0-9_-]{1,128}$/;
 /**
  * Wunsch der neuen Form sendbar? Bildet die Regeln des Servers ab: Serverfelder
  * nie, Betrag/Menge ganz und positiv, Code bei Einloesung und Auszahlung,
  * Auszahlung nur Mehrzweck/Einzweck mit Grund (1 bis 200 Zeichen), Aktion nur
  * einloesbar, Leistung braucht Artikel und Menge (Verkauf) bzw. Positionen
- * (Einloesung). Felder, die zu einer anderen Aktion/Art gehoeren, sind
+ * (Einloesung), ein Wertgutschein wird nur ueber eine Sorte verkauft
+ * (`typeId`). Felder, die zu einer anderen Aktion/Art gehoeren, sind
  * ebenfalls nicht erlaubt (der Server wiese sie ab).
  */
 function newFormVoucherIsValid(v) {
+    return wunschFormGueltig(v, true);
+}
+/**
+ * Die Form eines Wunschs der neuen Form. `sorteNoetig: false` laesst einen
+ * Wert-Verkauf ohne `typeId` zu: so rechnet der Zahlbetrag den Verkauf eines
+ * Aufrufers bis 1.16 mit der alten Gutschein-Einstellung weiter (der Server ab
+ * Stufe 4b antwortet darauf `voucher_type_required`). Paketintern.
+ */
+export function wunschFormGueltig(v, sorteNoetig) {
     if (voucherServerFields(v).length > 0)
         return false;
     const r = v;
@@ -130,6 +169,14 @@ function newFormVoucherIsValid(v) {
     }
     if (v.valueCents != null)
         return false;
+    // Die Sorte gehoert nur an einen Wert-Verkauf (Server: sorteId sonst voucher_invalid).
+    if (istWertVerkauf(v)) {
+        if (v.typeId == null ? sorteNoetig : (typeof v.typeId !== 'string' || !SORTE_ID_FORM.test(v.typeId)))
+            return false;
+        return v.articleId == null && v.quantity == null && v.positions == null && v.reason == null && istCent(v.amountCents);
+    }
+    if (v.typeId != null)
+        return false;
     const allein = v.type === VoucherType.multi_purpose || v.type === VoucherType.single_purpose;
     if (v.action === VoucherAction.payout) {
         return allein && hatText(v.code) && istCent(v.amountCents) && hatText(v.reason) && v.reason.trim().length <= MAX_GRUND
@@ -140,8 +187,6 @@ function newFormVoucherIsValid(v) {
     if (allein) {
         if (v.articleId != null || v.quantity != null || v.positions != null)
             return false;
-        if (v.action === VoucherAction.sell)
-            return istCent(v.amountCents);
         if (v.action === VoucherAction.redeem)
             return hatText(v.code) && istCent(v.amountCents);
         return false;

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

@@ -88,6 +88,14 @@ export interface PosArticle {
      * traegt (aeltere Backends) -- dann nicht aus anderen Feldern ableiten.
      */
     stockTracked?: boolean | null;
+    /**
+     * Als Leistungsgutschein verkaufbar (Gutscheine Stufe 4b, Haken im
+     * Artikelstamm). Die Kachel „Leistungsgutschein“ bietet nur diese Artikel
+     * an; der Server verkauft einen anderen nicht (`voucher_service_not_allowed`).
+     * Optional wie `stockLocationIds`, der Leser setzt es immer: nur ein
+     * ausdrueckliches `true` gilt.
+     */
+    serviceVoucher?: boolean;
 }
 /** Deckelt eine gewuenschte Menge an der Hoechstmenge des Artikels (null = keine Grenze). */
 export declare function allowedQuantity(a: Pick<PosArticle, 'maxQuantity'>, wanted: number): number;
@@ -113,6 +121,7 @@ export interface PosArticlePayload {
     ean?: string | null;
     internalCode?: string | null;
     stockTracked?: boolean | null;
+    serviceVoucher?: boolean | null;
 }
 export declare function fromPosArticlePayload(p: PosArticlePayload): PosArticle;
 /**

package/dist/esm/pos/artikel.js

@@ -71,6 +71,7 @@ export function fromPosArticlePayload(p) {
         ean: textOderNull(p.ean),
         internalCode: textOderNull(p.internalCode),
         stockTracked: typeof p.stockTracked === 'boolean' ? p.stockTracked : null,
+        serviceVoucher: p.serviceVoucher === true,
     };
 }
 /**

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;
 /**