@kreiseck/kasseneck-api 1.11.1 → 1.13.0

package/dist/cjs/pos/gutschein.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VOUCHER_SETTINGS_DEFAULTS = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = void 0;
+exports.posVoucherSettingsFromWire = posVoucherSettingsFromWire;
+exports.checkVoucher = checkVoucher;
+exports.reprintVoucherLabel = reprintVoucherLabel;
+const validator_1 = require("@kreiseck/validator");
+const errors_js_1 = require("../client/errors.js");
+exports.VOUCHER_KINDS = Object.freeze(['multi_purpose', 'single_purpose', 'service', 'promotion']);
+exports.VOUCHER_STATUSES = Object.freeze(['active', 'used_up', 'expired', 'paid_out', 'cancelled', 'blocked']);
+const VOUCHER_VALIDITY_PATTERNS = ['unlimited', '1+3', 'custom'];
+/** Ohne Block `vouchers` (alter Server, Konto ohne Schalter): Verkaufen ist aus. */
+exports.VOUCHER_SETTINGS_DEFAULTS = Object.freeze({
+    sale: false, valueVoucherType: null, vatRateBp: null,
+});
+/**
+ * Block `vouchers` einer Einstellungs-Antwort, geschlossen im Zweifel: ist
+ * irgendein Feld unstimmig, gilt der ganze Block als nicht gelesen und
+ * Verkaufen bleibt aus (kein Wurf, sonst ginge das Laden aller Einstellungen
+ * verloren). Stimmig heisst: `sale` ein Wahrheitswert, die Art
+ * `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.
+ */
+function posVoucherSettingsFromWire(block) {
+    const zu = () => ({ ...exports.VOUCHER_SETTINGS_DEFAULTS });
+    if (block === null || typeof block !== 'object' || Array.isArray(block))
+        return zu();
+    const b = block;
+    const sale = b['sale'];
+    const art = b['valueVoucherType'] ?? null;
+    const satz = b['vatRateBp'] ?? null;
+    if (typeof sale !== 'boolean')
+        return zu();
+    if (art !== null && art !== 'multi_purpose' && art !== 'single_purpose')
+        return zu();
+    if (satz !== null && !(typeof satz === 'number' && Number.isInteger(satz) && satz >= 0))
+        return zu();
+    if (sale && art === null)
+        return zu();
+    if (art === 'single_purpose' && satz === null)
+        return zu();
+    if (art === 'multi_purpose' && satz !== null)
+        return zu();
+    return { sale, valueVoucherType: art, vatRateBp: satz };
+}
+function fehler(name, grund) {
+    return new errors_js_1.KasseneckValidationError(name, `Antwort: ${grund}`, 'response');
+}
+function objekt(name, pfad, w) {
+    if (w === null || typeof w !== 'object' || Array.isArray(w))
+        throw fehler(name, `${pfad} ist kein Objekt`);
+    return w;
+}
+const fehlt = (w) => w === undefined || w === null;
+function ganzzahlWennDa(name, pfad, ziel, o, feld) {
+    const w = o[feld];
+    if (fehlt(w))
+        return;
+    if (typeof w !== 'number' || !Number.isSafeInteger(w))
+        throw fehler(name, `${pfad}.${feld} ist keine ganze Zahl`);
+    ziel[feld] = w;
+}
+function textPflicht(name, pfad, o, feld) {
+    const w = o[feld];
+    if (typeof w !== 'string' || w === '')
+        throw fehler(name, `${pfad}.${feld} fehlt`);
+    return w;
+}
+function wahl(name, pfad, o, feld, erlaubt) {
+    const w = o[feld];
+    if (typeof w !== 'string' || !erlaubt.includes(w))
+        throw fehler(name, `${pfad}.${feld} ist unbekannt`);
+    return w;
+}
+function gueltigkeit(name, w) {
+    const o = objekt(name, 'validity', w);
+    const raus = { pattern: wahl(name, 'validity', o, 'pattern', VOUCHER_VALIDITY_PATTERNS) };
+    for (const feld of ['redeemableUntil', 'refundableUntil', 'validUntil']) {
+        const t = o[feld];
+        if (fehlt(t))
+            continue;
+        if (typeof t !== 'string' || t === '')
+            throw fehler(name, `validity.${feld} ist kein Datum`);
+        raus[feld] = t;
+    }
+    return raus;
+}
+function artikel(name, w) {
+    const o = objekt(name, 'article', w);
+    const raus = { id: textPflicht(name, 'article', o, 'id'), name: textPflicht(name, 'article', o, 'name') };
+    for (const feld of ['vatRateBp', 'priceCents']) {
+        const z = o[feld];
+        if (typeof z !== 'number' || !Number.isSafeInteger(z))
+            throw fehler(name, `article.${feld} ist keine ganze Zahl`);
+        raus[feld] = z;
+    }
+    return raus;
+}
+function leseCheck(name, w) {
+    const o = objekt(name, 'data', w);
+    const raus = {
+        type: wahl(name, 'data', o, 'type', exports.VOUCHER_KINDS),
+        status: wahl(name, 'data', o, 'status', exports.VOUCHER_STATUSES),
+        codeSuffix: textPflicht(name, 'data', o, 'codeSuffix'),
+    };
+    for (const feld of ['balanceCents', 'faceValueCents', 'quantity', 'remainingQuantity', 'vatRateBp', 'discountCents', 'discountPercentBp']) {
+        ganzzahlWennDa(name, 'data', raus, o, feld);
+    }
+    if (!fehlt(o.article))
+        raus.article = artikel(name, o.article);
+    if (!fehlt(o.validity))
+        raus.validity = gueltigkeit(name, o.validity);
+    if (!fehlt(o.exempt)) {
+        if (typeof o.exempt !== 'boolean')
+            throw fehler(name, 'data.exempt ist kein Wahrheitswert');
+        raus.exempt = o.exempt;
+    }
+    return raus;
+}
+/**
+ * Gutschein am Code pruefen (Gutschein-Recht `voucherRedeem`). Der Code wird
+ * tolerant eingelesen (Gross/klein, Bindestriche, `O`/`0`, `I`/`L`/`1`) und
+ * vor dem Senden auf sein Pruefzeichen geprueft: ein Tippfehler geht nie ueber
+ * das Netz, sondern endet mit `KasseneckValidationError`. Fachliche Fehler
+ * kommen als `KasseneckApiError` mit dem Code des Servers
+ * (`voucher_not_found`, `too_many_voucher_checks`, `not_permitted` …).
+ */
+async function checkVoucher(transport, code) {
+    const name = 'checkVoucher';
+    const geprueft = typeof code === 'string' ? validator_1.VoucherCode.validate(code) : null;
+    // Der Code steht bewusst nicht in der Meldung.
+    if (!geprueft || !geprueft.ok)
+        throw new errors_js_1.KasseneckValidationError(name, 'code ist kein gueltiger Gutscheincode', 'request');
+    // Der Code reist im Rumpf: als Geheimnis nennen, damit er in keinem Fehler (Servertext, Ursache) auftaucht.
+    const geheim = [geprueft.normalized, validator_1.VoucherCode.format(geprueft.normalized)];
+    let antwort;
+    try {
+        antwort = await transport(name, { code: geprueft.normalized }, undefined, geheim);
+    }
+    catch (fehler) {
+        // Der Transport siebt nur Ursachen; ein Servertext, der den Code wiederholt, wird hier geschwaerzt.
+        if (fehler instanceof errors_js_1.KasseneckApiError && geheim.some((g) => fehler.serverMessage.includes(g))) {
+            const text = geheim.reduce((t, g) => t.split(g).join('****'), fehler.serverMessage);
+            throw new errors_js_1.KasseneckApiError(name, text, fehler.details, fehler.code);
+        }
+        throw fehler;
+    }
+    return leseCheck(name, antwort);
+}
+/**
+ * Etikett eines Gutscheins noch einmal drucken (Gutschein-Recht
+ * `voucherManage`). Antwort ist der Klartext-Code zum Drucken; er gehoert
+ * nur in den Speicher bis zum Druck. Aufrufer duerfen ihn nicht protokollieren,
+ * speichern oder in Meldungen nennen; Lesefehler dieser Antwort nennen ihn nie.
+ */
+async function reprintVoucherLabel(transport, id) {
+    const name = 'reprintVoucherLabel';
+    if (typeof id !== 'string' || id.trim() === '')
+        throw new errors_js_1.KasseneckValidationError(name, 'id fehlt', 'request');
+    const o = objekt(name, 'data', await transport(name, { id }));
+    return { code: textPflicht(name, 'data', o, 'code') };
+}

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

@@ -11,15 +11,16 @@ export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, t
 export { getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, setMyPosLogo, posSettingsFromWire, type SetMyPosLogoOptions, } from './client.js';
 export { POS_ERROR_CODES, type PosErrorCode, isPosErrorCode, posErrorCode, isPosError, type PosFieldError, posFieldErrors, } from './errors.js';
 export { distributeDiscount } from '../receipt/discount.js';
-export { cancelScopeOf, receiptsScopeOf, stockViewOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
+export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, type VoucherPerms, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
 export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type StockLocationAddress, type StockLevel, type StockValue, type StockList, type ListMyStockOptions, type SetMyCashregisterStockLocationOptions, type CashregisterStockLocation, listMyStockLocations, listMyStock, setMyCashregisterStockLocation, } from './lager.js';
 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 { 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';
 export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.js';
-export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, VOUCHER_ERROR_MESSAGES, voucherErrorMessage, LABELS, labelText, RETURN_DISPOSITION_LABELS, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/cjs/pos/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.posTipKeptByDefault = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
-exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = void 0;
-exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = void 0;
+exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.posVoucherSettingsFromWire = exports.VOUCHER_SETTINGS_DEFAULTS = exports.reprintVoucherLabel = exports.checkVoucher = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = void 0;
+exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
@@ -86,6 +86,7 @@ var pairing_js_1 = require("../register/pairing.js");
 Object.defineProperty(exports, "cancelScopeOf", { enumerable: true, get: function () { return pairing_js_1.cancelScopeOf; } });
 Object.defineProperty(exports, "receiptsScopeOf", { enumerable: true, get: function () { return pairing_js_1.receiptsScopeOf; } });
 Object.defineProperty(exports, "stockViewOf", { enumerable: true, get: function () { return pairing_js_1.stockViewOf; } });
+Object.defineProperty(exports, "voucherPermsOf", { enumerable: true, get: function () { return pairing_js_1.voucherPermsOf; } });
 var drucker_js_1 = require("./drucker.js");
 Object.defineProperty(exports, "PRINT_JOB_STATUSES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_STATUSES; } });
 Object.defineProperty(exports, "PRINT_JOB_SOURCES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_SOURCES; } });
@@ -107,6 +108,14 @@ Object.defineProperty(exports, "listMyStocktakeCounts", { enumerable: true, get:
 Object.defineProperty(exports, "recordMyStocktakeCount", { enumerable: true, get: function () { return inventur_js_1.recordMyStocktakeCount; } });
 Object.defineProperty(exports, "voidMyStocktakeCount", { enumerable: true, get: function () { return inventur_js_1.voidMyStocktakeCount; } });
 Object.defineProperty(exports, "parseQuantityMilli", { enumerable: true, get: function () { return inventur_js_1.parseQuantityMilli; } });
+// Gutschein pruefen und Etikett nachdrucken an der Kasse.
+var gutschein_js_1 = require("./gutschein.js");
+Object.defineProperty(exports, "VOUCHER_KINDS", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_KINDS; } });
+Object.defineProperty(exports, "VOUCHER_STATUSES", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_STATUSES; } });
+Object.defineProperty(exports, "checkVoucher", { enumerable: true, get: function () { return gutschein_js_1.checkVoucher; } });
+Object.defineProperty(exports, "reprintVoucherLabel", { enumerable: true, get: function () { return gutschein_js_1.reprintVoucherLabel; } });
+Object.defineProperty(exports, "VOUCHER_SETTINGS_DEFAULTS", { enumerable: true, get: function () { return gutschein_js_1.VOUCHER_SETTINGS_DEFAULTS; } });
+Object.defineProperty(exports, "posVoucherSettingsFromWire", { enumerable: true, get: function () { return gutschein_js_1.posVoucherSettingsFromWire; } });
 // Schicht, Kassenstand und Lade-Protokoll (1.9.0): Aufrufe, Kataloge, Helfer, Bons.
 var schicht_js_1 = require("./schicht.js");
 Object.defineProperty(exports, "getMyDrawerState", { enumerable: true, get: function () { return schicht_js_1.getMyDrawerState; } });
@@ -151,6 +160,8 @@ Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_MESSAGES", { enumerable: tru
 Object.defineProperty(exports, "receiptEmailErrorMessage", { enumerable: true, get: function () { return texte_js_1.receiptEmailErrorMessage; } });
 Object.defineProperty(exports, "CANCELLATION_PAYMENT_ERROR_MESSAGES", { enumerable: true, get: function () { return texte_js_1.CANCELLATION_PAYMENT_ERROR_MESSAGES; } });
 Object.defineProperty(exports, "cancellationPaymentErrorMessage", { enumerable: true, get: function () { return texte_js_1.cancellationPaymentErrorMessage; } });
+Object.defineProperty(exports, "VOUCHER_ERROR_MESSAGES", { enumerable: true, get: function () { return texte_js_1.VOUCHER_ERROR_MESSAGES; } });
+Object.defineProperty(exports, "voucherErrorMessage", { enumerable: true, get: function () { return texte_js_1.voucherErrorMessage; } });
 Object.defineProperty(exports, "LABELS", { enumerable: true, get: function () { return texte_js_1.LABELS; } });
 Object.defineProperty(exports, "labelText", { enumerable: true, get: function () { return texte_js_1.labelText; } });
 Object.defineProperty(exports, "RETURN_DISPOSITION_LABELS", { enumerable: true, get: function () { return texte_js_1.RETURN_DISPOSITION_LABELS; } });

package/dist/cjs/pos/settings.d.ts

@@ -11,6 +11,7 @@
  * derselben Werte liegt unter `fixtures/stored/`. Trinkgeld ist bewusst AUS,
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
+import { type PosVoucherSettings } from './gutschein.js';
 export declare const THEME: readonly ["clear", "warm", "night", "contrast"];
 export type PosTheme = typeof THEME[number];
 export declare const FONT_SIZE: readonly ["S", "M", "L", "XL"];
@@ -268,6 +269,8 @@ export interface PosDeviceSettings {
 export interface PosSettings {
     business: PosBusinessSettings;
     device: PosDeviceSettings;
+    /** Gutschein-Verkauf der Kasse (Block `vouchers`); ohne Block ist Verkaufen aus. */
+    vouchers: PosVoucherSettings;
 }
 export declare const POS_BUSINESS_DEFAULTS: Readonly<PosBusinessSettings>;
 export declare const POS_DEVICE_DEFAULTS: Readonly<PosDeviceSettings>;

package/dist/cjs/pos/settings.js

@@ -1,4 +1,14 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._ALTFORM_0X = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_SHARED_PAIRS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = void 0;
+exports.posShortcutConflict = posShortcutConflict;
+exports._optionalerWert = _optionalerWert;
+exports.posTipKeptByDefault = posTipKeptByDefault;
+exports._istAltwert0x = _istAltwert0x;
+exports.mergePosSettings = mergePosSettings;
+exports.sanitizePosSettings = sanitizePosSettings;
+exports.unknownPosSettingValues = unknownPosSettingValues;
+exports.posSettingsChanges = posSettingsChanges;
 /**
  * Kassen-Einstellungen der Browser-Kasse und der Kassen-App in der Form des
  * Drahts `/api/v3` (Nachtrag Stufe 4, §11.7.2): Schluessel und Katalogwerte
@@ -12,16 +22,7 @@
  * derselben Werte liegt unter `fixtures/stored/`. Trinkgeld ist bewusst AUS,
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._ALTFORM_0X = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_SHARED_PAIRS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = void 0;
-exports.posShortcutConflict = posShortcutConflict;
-exports._optionalerWert = _optionalerWert;
-exports.posTipKeptByDefault = posTipKeptByDefault;
-exports._istAltwert0x = _istAltwert0x;
-exports.mergePosSettings = mergePosSettings;
-exports.sanitizePosSettings = sanitizePosSettings;
-exports.unknownPosSettingValues = unknownPosSettingValues;
-exports.posSettingsChanges = posSettingsChanges;
+const gutschein_js_1 = require("./gutschein.js");
 /*
  * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
  * (`typeof LISTE[number]`). So gibt es die Werte nur einmal, und die Zwillinge
@@ -337,6 +338,7 @@ function sanitizePosSettings(stored) {
     return {
         business: mergePosSettings(exports.POS_BUSINESS_DEFAULTS, teil('business')),
         device: mergePosSettings(exports.POS_DEVICE_DEFAULTS, teil('device')),
+        vouchers: (0, gutschein_js_1.posVoucherSettingsFromWire)(eigen(roh, 'vouchers') ? roh['vouchers'] : undefined),
     };
 }
 /**

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

@@ -318,6 +318,104 @@ declare const MELDUNGEN_ROH: {
     readonly 'cancellation.tip_refunded_with_voucher': {
         readonly text: "Beleg mit Gutschein: Das Trinkgeld wird mitstorniert.";
     };
+    readonly 'voucher_error.not_found': {
+        readonly text: "Diesen Gutschein gibt es in diesem Betrieb nicht.";
+    };
+    readonly 'voucher_error.invalid': {
+        readonly text: "Dieser Gutschein ist nicht gültig.";
+    };
+    readonly 'voucher_error.invalid_code': {
+        readonly text: "Der Code ist nicht vollständig oder falsch abgetippt.";
+    };
+    readonly 'voucher_error.expired': {
+        readonly text: "Der Gutschein ist abgelaufen.";
+    };
+    readonly 'voucher_error.used_up': {
+        readonly text: "Der Gutschein ist bereits aufgebraucht.";
+    };
+    readonly 'voucher_error.blocked': {
+        readonly text: "Der Gutschein ist gesperrt.";
+    };
+    readonly 'voucher_error.cancelled': {
+        readonly text: "Der Gutschein wurde storniert.";
+    };
+    readonly 'voucher_error.insufficient_balance': {
+        readonly text: "Auf dem Gutschein ist nicht genug Guthaben.";
+    };
+    readonly 'voucher_error.exceeds_total': {
+        readonly text: "Der Gutschein deckt mehr, als offen ist. Bitte den Betrag anpassen.";
+    };
+    readonly 'voucher_error.balance_changed': {
+        readonly text: "Der Gutschein wurde gerade anderswo verwendet. Bitte neu prüfen.";
+    };
+    readonly 'voucher_error.rate_mismatch': {
+        readonly text: "Dieser Gutschein gilt nur für Leistungen mit {rate} %.";
+        readonly placeholders: readonly ["rate"];
+    };
+    readonly 'voucher_error.item_mismatch': {
+        readonly text: "Dieser Gutschein gilt nicht für die gewählten Positionen.";
+    };
+    readonly 'voucher_error.already_used': {
+        readonly text: "Dieser Gutschein wurde bereits verwendet.";
+    };
+    readonly 'voucher_error.partial_cancel': {
+        readonly text: "Belege mit Gutschein lassen sich nur ganz stornieren.";
+    };
+    readonly 'voucher_error.settings_missing': {
+        readonly text: "Die Gutschein-Einstellungen fehlen. Bitte die Kasse neu laden.";
+    };
+    readonly 'voucher_error.too_many_checks': {
+        readonly text: "Zu viele Versuche. Bitte in einer Stunde wieder.";
+    };
+    readonly 'voucher_error.sale_off': {
+        readonly text: "Gutscheine verkaufen geht hier noch nicht.";
+    };
+    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.";
+    };
+    readonly 'voucher.reentry_mismatch': {
+        readonly text: "Mit diesen Gutscheinen ergibt der Beleg nicht mehr den belasteten Betrag – die Karte zurückbuchen.";
+    };
+    readonly 'voucher.not_this_voucher': {
+        readonly text: "Das ist nicht der Gutschein ····-{suffix}.";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'voucher.reentry_no_permission': {
+        readonly text: "Die Karte ist belastet, der Beleg fehlt noch: den Gutschein-Code kann nur jemand mit dem Recht zum Einlösen nachtragen – sonst die Karte zurückbuchen.";
+    };
+    readonly 'voucher.already_covered': {
+        readonly text: "Diese Positionen deckt schon ein anderer Gutschein.";
+    };
+    readonly 'voucher.payout_reason_too_long': {
+        readonly text: "Der Grund hat höchstens 200 Zeichen.";
+    };
+    readonly 'voucher.payout_reason_missing': {
+        readonly text: "Für die Auszahlung fehlt der Grund.";
+    };
+    readonly 'voucher.payout_check_first': {
+        readonly text: "Die letzte Auszahlung ging unklar aus und kann schon gebucht sein. Erst unter „Belege“ die Liste neu laden und nachsehen, dann ist eine neue möglich.";
+    };
+    readonly 'voucher.sale_max_amount': {
+        readonly text: "Höchstens {amount} je Gutschein.";
+        readonly placeholders: readonly ["amount"];
+    };
+    readonly 'voucher.sale_not_at_terminal': {
+        readonly text: "Gutscheine mit Karte am Terminal zu verkaufen geht an dieser Kasse noch nicht – bar kassieren.";
+    };
+    readonly 'voucher.no_redeem_with_sale': {
+        readonly text: "Auf einem Beleg, der Gutscheine verkauft, lässt sich kein Gutschein einlösen.";
+    };
+    readonly 'voucher.code_not_on_receipt': {
+        readonly text: "Der Code steht nicht auf dem Bon – jetzt auf den Gutschein schreiben.";
+    };
+    readonly 'cancellation.voucher_sale_cancelled': {
+        readonly text: "Der Gutschein ····-{suffix} wird mitstorniert und gilt danach nicht mehr.";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'cancellation.promo_valid_again': {
+        readonly text: "Der Aktionsgutschein ····-{suffix} gilt danach wieder.";
+        readonly placeholders: readonly ["suffix"];
+    };
     readonly 'split.setting_hint': {
         readonly text: "Ein Tisch zahlt in Teilen: jede Zahlung bar oder mit Karte, mit eigenem Trinkgeld – am Ende ein Beleg für alles.";
     };
@@ -927,6 +1025,32 @@ export type CancellationPaymentMessageCode = keyof typeof CANCELLATION_PAYMENT_E
  * `cancellation.failed` auf – wie bei `receiptEmailErrorMessage`.
  */
 export declare function cancellationPaymentErrorMessage(code: string | undefined | null): MessageKey;
+/**
+ * Gutschein-Fehler (`/v3`): welcher `code` des Backends welchen Satz bekommt.
+ * Wie RECEIPT_EMAIL_ERROR_MESSAGES: beide Kassen entscheiden am Code. Ein
+ * unbekannter Code geht den allgemeinen Weg des Aufrufs.
+ */
+export declare const VOUCHER_ERROR_MESSAGES: {
+    readonly voucher_not_found: "voucher_error.not_found";
+    readonly voucher_invalid: "voucher_error.invalid";
+    readonly voucher_invalid_code: "voucher_error.invalid_code";
+    readonly voucher_expired: "voucher_error.expired";
+    readonly voucher_used_up: "voucher_error.used_up";
+    readonly voucher_blocked: "voucher_error.blocked";
+    readonly voucher_cancelled: "voucher_error.cancelled";
+    readonly voucher_insufficient_balance: "voucher_error.insufficient_balance";
+    readonly voucher_exceeds_total: "voucher_error.exceeds_total";
+    readonly voucher_balance_changed: "voucher_error.balance_changed";
+    readonly voucher_rate_mismatch: "voucher_error.rate_mismatch";
+    readonly voucher_item_mismatch: "voucher_error.item_mismatch";
+    readonly voucher_already_used: "voucher_error.already_used";
+    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";
+};
+export type VoucherMessageCode = keyof typeof VOUCHER_ERROR_MESSAGES;
+/** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
+export declare function voucherErrorMessage(code: string | undefined | null): MessageKey | undefined;
 /**
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
  *
@@ -1590,6 +1714,111 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'shift.voucher_redeemed': {
         readonly text: "Gutschein eingelöst";
     };
+    readonly 'voucher.button': {
+        readonly text: "Gutschein";
+    };
+    readonly 'voucher.redeem': {
+        readonly text: "Gutschein einlösen";
+    };
+    readonly 'voucher.sell': {
+        readonly text: "Gutschein verkaufen";
+    };
+    readonly 'voucher.payout': {
+        readonly text: "Gutschein auszahlen";
+    };
+    readonly 'voucher.code': {
+        readonly text: "Code";
+    };
+    readonly 'voucher.scan': {
+        readonly text: "Code scannen";
+    };
+    readonly 'voucher.check': {
+        readonly text: "Prüfen";
+    };
+    readonly 'voucher.amount': {
+        readonly text: "Betrag";
+    };
+    readonly 'voucher.balance': {
+        readonly text: "Rest am Gutschein: {amount}";
+        readonly placeholders: readonly ["amount"];
+    };
+    readonly 'voucher.remaining_quantity': {
+        readonly text: "{n} von {total} übrig";
+        readonly placeholders: readonly ["n", "total"];
+    };
+    readonly 'voucher.reason': {
+        readonly text: "Grund";
+    };
+    readonly 'voucher.multi_purpose': {
+        readonly text: "Mehrzweckgutschein";
+    };
+    readonly 'voucher.single_purpose': {
+        readonly text: "Einzweckgutschein {rate} %";
+        readonly placeholders: readonly ["rate"];
+    };
+    readonly 'voucher.service': {
+        readonly text: "Leistungsgutschein";
+    };
+    readonly 'voucher.promotion': {
+        readonly text: "Aktionsgutschein";
+    };
+    readonly 'voucher.payment_line': {
+        readonly text: "Gutschein ····-{suffix}";
+        readonly placeholders: readonly ["suffix"];
+    };
+    readonly 'voucher.covers_items': {
+        readonly text: "Deckt: {items}";
+        readonly placeholders: readonly ["items"];
+    };
+    readonly 'voucher.code_shown_once': {
+        readonly text: "Code nur jetzt sichtbar: {code}";
+        readonly placeholders: readonly ["code"];
+    };
+    readonly 'voucher.not_in_split': {
+        readonly text: "Gutscheine gehen beim getrennten Kassieren nicht.";
+    };
+    readonly 'voucher.payout_not_possible': {
+        readonly text: "Dieser Gutschein lässt sich nicht auszahlen.";
+    };
+    readonly 'voucher.add_article': {
+        readonly text: "{article} hinzufügen";
+        readonly placeholders: readonly ["article"];
+    };
+    readonly 'voucher.payout_confirm': {
+        readonly text: "{amount} bar auszahlen?";
+        readonly placeholders: readonly ["amount"];
+    };
+    readonly 'cancellation.voucher_back': {
+        readonly text: "{amount} geht zurück auf den Gutschein";
+        readonly placeholders: readonly ["amount"];
+    };
+    readonly 'voucher.apply': {
+        readonly text: "Übernehmen";
+    };
+    readonly 'voucher.redeemable_until': {
+        readonly text: "einlösbar bis {date}";
+        readonly placeholders: readonly ["date"];
+    };
+    readonly 'voucher.remove_line': {
+        readonly text: "{line} entfernen";
+        readonly placeholders: readonly ["line"];
+    };
+    readonly 'voucher.reenter_code': {
+        readonly text: "Code erneut eingeben";
+    };
+    readonly 'voucher.refundable_until': {
+        readonly text: "rückzahlbar bis {date}";
+        readonly placeholders: readonly ["date"];
+    };
+    readonly 'voucher.code_done': {
+        readonly text: "Fertig";
+    };
+    readonly 'voucher.article': {
+        readonly text: "Artikel";
+    };
+    readonly 'voucher.add': {
+        readonly text: "Hinzufügen";
+    };
     readonly 'shift.all_payments': {
         readonly text: "Alle Zahlungen dieser Schicht (bar + unbar)";
     };