@kreiseck/kasseneck-api 1.16.0 → 1.17.1

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.1";

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.1';

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/client/reports.d.ts

@@ -1,16 +1,17 @@
 import { type Receipt, type ReceiptCompany, type ReportMonth } from '../models/index.js';
 import type { InternerBinaerTransport, InternerTransport } from './aufrufe.js';
 /**
- * Bericht-Downloads — Zwilling von `downloadDailyReport`/`downloadMonthlyReport`
- * in kasseneck_api/lib/kasseneck_api.dart (Zeilen 113-128).
+ * Bericht-Downloads — Zwilling von `getCashregisterReport`,
+ * `downloadDailyReport` und `downloadMonthlyReport` in
+ * kasseneck_api/lib/kasseneck_api.dart.
  *
- * **Beide liefern ein PDF, also Binaerdaten.** Das Flutter-Vorbild liest die
- * Antwort als Zeichenkette und nimmt davon `codeUnits`; in JavaScript waere das
- * schlicht falsch — `response.text()` deutet die Bytes als UTF-8 und ersetzt
- * jedes Byte ueber 0x7F durch U+FFFD. Ein so "heruntergeladener" Tagesbericht
- * liesse sich in keinem Betrachter oeffnen. Dieses Paket weicht daher bewusst
- * ab: es liest `arrayBuffer()` und liefert `Uint8Array` (siehe
- * [createBinaryTransport] in transport.ts).
+ * **Alle drei liefern ein PDF, also Binaerdaten.** `response.text()` waere hier
+ * falsch: es deutet die Bytes als UTF-8 und ersetzt jedes Byte ueber 0x7F
+ * durch U+FFFD, ein so "heruntergeladener" Bericht liesse sich in keinem
+ * Betrachter oeffnen. Gelesen wird `arrayBuffer()`, geliefert `Uint8Array`;
+ * eine Ablehnung mit HTTP 200 und Huelle (`period_not_closed`) wird zum Fehler
+ * (siehe [createBinaryTransport] in transport.ts). Der Dart-Zwilling reichte
+ * sie bis 11.8.0 als PDF durch und prueft seit 11.8.1 ebenso die ersten Bytes.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** Keiner der
  * beiden Download-Endpunkte setzt `allowRegisterUser`; sie funktionieren nur

package/dist/esm/client/reports.js

@@ -2,16 +2,17 @@ import { fromReceiptCompanyPayload, fromReceiptPayload, } from '../models/index.
 import { toViennaWallClock } from '../vienna-time.js';
 import { KasseneckValidationError } from './errors.js';
 /**
- * Bericht-Downloads — Zwilling von `downloadDailyReport`/`downloadMonthlyReport`
- * in kasseneck_api/lib/kasseneck_api.dart (Zeilen 113-128).
+ * Bericht-Downloads — Zwilling von `getCashregisterReport`,
+ * `downloadDailyReport` und `downloadMonthlyReport` in
+ * kasseneck_api/lib/kasseneck_api.dart.
  *
- * **Beide liefern ein PDF, also Binaerdaten.** Das Flutter-Vorbild liest die
- * Antwort als Zeichenkette und nimmt davon `codeUnits`; in JavaScript waere das
- * schlicht falsch — `response.text()` deutet die Bytes als UTF-8 und ersetzt
- * jedes Byte ueber 0x7F durch U+FFFD. Ein so "heruntergeladener" Tagesbericht
- * liesse sich in keinem Betrachter oeffnen. Dieses Paket weicht daher bewusst
- * ab: es liest `arrayBuffer()` und liefert `Uint8Array` (siehe
- * [createBinaryTransport] in transport.ts).
+ * **Alle drei liefern ein PDF, also Binaerdaten.** `response.text()` waere hier
+ * falsch: es deutet die Bytes als UTF-8 und ersetzt jedes Byte ueber 0x7F
+ * durch U+FFFD, ein so "heruntergeladener" Bericht liesse sich in keinem
+ * Betrachter oeffnen. Gelesen wird `arrayBuffer()`, geliefert `Uint8Array`;
+ * eine Ablehnung mit HTTP 200 und Huelle (`period_not_closed`) wird zum Fehler
+ * (siehe [createBinaryTransport] in transport.ts). Der Dart-Zwilling reichte
+ * sie bis 11.8.0 als PDF durch und prueft seit 11.8.1 ebenso die ersten Bytes.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** Keiner der
  * beiden Download-Endpunkte setzt `allowRegisterUser`; sie funktionieren nur

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