@kreiseck/kasseneck-api 1.11.1 → 1.13.0

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

@@ -0,0 +1,104 @@
+import type { Voucher } from '../models/voucher.js';
+import type { PosVoucherSettings, VoucherArticle, VoucherCheck } from '../pos/gutschein.js';
+/**
+ * Gutscheine der neuen Form im Zahlbetrag: Zwilling von
+ * `gutschein-beleg.plane` im Backend, soweit er den Zahlbetrag bestimmt.
+ *
+ * Der Server macht aus den Wuenschen zusaetzliche Positionen (`kind`
+ * `voucher` bzw. `voucher_float`, hinten an Ware und Trinkgeld angehaengt, in
+ * der Reihenfolge der Wuensche) und Eintraege in Belegform; nur Eintraege der
+ * Art Wert (`value`) und Rabatt (`promo`) gehen danach in die Toepfe und in
+ * den Wertgutschein-Fluss (`gutschein-beleg.zahlbetrag`). Genau das steht
+ * hier, mit derselben Euro-Arithmetik:
+ *
+ * - Mehrzweck einloesen: Eintrag `value`, mindert den Zahlbetrag als Fluss.
+ * - Mehrzweck verkaufen: Eintrag `value` (+Fluss); ab dem Stichtag des
+ *   0-%-Topfs stattdessen Position im 0-%-Satz ohne Fluss.
+ * - Mehrzweck auszahlen: immer Position im 0-%-Satz (minus), kein Fluss.
+ * - Einzweck: Position im Satz (Verkauf aus der Einstellung der Kasse,
+ *   Einloesung und Auszahlung aus der Pruefung des Gutscheins); als
+ *   Kleinunternehmer eingeloest anteilig auf alle Saetze des Korbs.
+ * - Leistung verkaufen: Stueck mal Artikelpreis im Artikelsatz; einloesen: je
+ *   Satz eine Minuszeile ueber die gewaehlten Positionen.
+ * - Aktion: Rabatt wie `promo`, Betrag aus der Pruefung, hoechstens die Summe.
+ *
+ * Kein Fehler wird still geschluckt: was der Server mit einem Gutschein-Code
+ * abwiese, liefert `fehler` mit genau diesem Code (`voucher_*`). Der
+ * Klartext-Code steht nie in einem Text.
+ */
+/** Position in der inneren Form des Backends (`beleg-toepfe.interneForm`). */
+export interface Innen {
+    amount: number;
+    priceOne: number;
+    vat: number;
+    tip: 'staff' | 'owner' | null;
+    /** `kind` der Position (Trinkgeld, Rabatt, Gutscheinzeile); Ware hat keines. */
+    kind?: string;
+    articleId?: string;
+}
+/** Gutschein-Eintrag in Belegform, soweit Toepfe und Fluss ihn lesen. */
+export interface Gutschein {
+    action: string;
+    type: string;
+    value: number;
+    /** Betrag steht schon als Position im 0-%-Topf: kein Fluss mehr. */
+    imNullTopf?: boolean;
+}
+/** Je Einloesung bzw. Auszahlung die gepruefte Sicht des Gutscheins (aus `checkVoucher`), zugeordnet ueber den Code. */
+export interface VoucherDueInfo {
+    /** Der Code, wie er gesendet wird (tolerant: Gross/klein, Bindestriche, `O`/`0`, `I`/`L`/`1`). */
+    code: string;
+    check: VoucherCheck;
+}
+/** Artikel fuer den Verkauf eines Dienstleistungsgutscheins: Preis und Satz wie im Artikelstamm. */
+export type VoucherDueArticle = Pick<VoucherArticle, 'id' | 'priceCents' | 'vatRateBp'>;
+/**
+ * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (Backend
+ * `gutschein-core.NULLTOPF_AB`). Solange er in der Zukunft liegt, zaehlt ein
+ * Mehrzweck-Verkauf als Fluss; ab dem Tag als Position im 0-%-Satz. Der
+ * Zahlbetrag bleibt gleich, Toepfe und Fluss verschieben sich.
+ */
+export declare const VOUCHER_ZERO_RATE_BUCKET_FROM = "2099-12-31";
+export interface PlanOptionen {
+    voucherInfo?: readonly VoucherDueInfo[];
+    voucherSettings?: PosVoucherSettings;
+    voucherArticles?: readonly VoucherDueArticle[];
+    smallBusiness?: boolean;
+    zeroRateBucketFrom?: string;
+    /** Wiener Tag `YYYY-MM-DD`; der Aufrufer setzt den heutigen, wenn er fehlt. */
+    today: string;
+}
+export interface Plan {
+    /** Positionen, die der Server hinten anhaengt. */
+    zusatz: Innen[];
+    /** Eintraege, die Toepfe und Fluss lesen (`gutschein-beleg.zahlbetrag`). */
+    gutscheine: Gutschein[];
+    /** Summe der Auszahlungen in Cent. */
+    auszahlungCents: number;
+    /** Mindestens ein Wunsch der neuen Form: der Server rechnet mit `plane`. */
+    mitPlan: boolean;
+    /** Summe der Einloese-Minuszeilen je Topf (Deckung, Vorbelegung). */
+    minusJeTopf: Map<string, number>;
+}
+export interface PlanFehler {
+    fehler: string;
+    text: string;
+}
+type TopfName = 'amountRateStandard' | 'amountRateReduced1' | 'amountRateReduced2' | 'amountRateZero' | 'amountRateSpecial' | 'amountRatOthers';
+/** `vat-buckets.bucketFuerSatz`. */
+export declare function topfFuerSatz(vat: number): TopfName;
+/** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
+export declare function istDeckbar(p: Innen): boolean;
+/** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
+export declare function centSumme(liste: readonly Innen[]): number;
+/** Die Saetze, auf die `kuTeile` verteilt: je Satz `centSumme` der deckbaren Positionen, nur positive. */
+export declare function kuSaetze(kunde: readonly Innen[]): Array<{
+    satzBp: number;
+    basis: number;
+}>;
+/**
+ * Wuensche und gelesene Eintraege in Positionen und Belegeintraege, wie
+ * `plane` sie baut. `kunde` sind Ware und Trinkgeld in innerer Form.
+ */
+export declare function planeGutscheine(kunde: readonly Innen[], vouchers: readonly Voucher[], art: string, o: PlanOptionen): Plan | PlanFehler;
+export {};

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

@@ -0,0 +1,360 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VOUCHER_ZERO_RATE_BUCKET_FROM = void 0;
+exports.topfFuerSatz = topfFuerSatz;
+exports.istDeckbar = istDeckbar;
+exports.centSumme = centSumme;
+exports.kuSaetze = kuSaetze;
+exports.planeGutscheine = planeGutscheine;
+const validator_1 = require("@kreiseck/validator");
+const voucher_js_1 = require("../models/voucher.js");
+/**
+ * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (Backend
+ * `gutschein-core.NULLTOPF_AB`). Solange er in der Zukunft liegt, zaehlt ein
+ * Mehrzweck-Verkauf als Fluss; ab dem Tag als Position im 0-%-Satz. Der
+ * Zahlbetrag bleibt gleich, Toepfe und Fluss verschieben sich.
+ */
+exports.VOUCHER_ZERO_RATE_BUCKET_FROM = '2099-12-31';
+const KINDS = ['voucher', 'voucher_float'];
+const ARTEN = ['multi_purpose', 'single_purpose', 'service', 'promotion'];
+/** `vat-buckets.bucketFuerSatz`. */
+function topfFuerSatz(vat) {
+    switch (vat) {
+        case 20: return 'amountRateStandard';
+        case 10: return 'amountRateReduced1';
+        case 13: return 'amountRateReduced2';
+        case 0: return 'amountRateZero';
+        case 19: return 'amountRateSpecial';
+        case 4.9: return 'amountRateSpecial';
+        default: return 'amountRatOthers';
+    }
+}
+const TOPF_REIHENFOLGE = ['amountRateStandard', 'amountRateReduced1', 'amountRateReduced2', 'amountRateZero', 'amountRateSpecial', 'amountRatOthers'];
+function istGutscheinZeile(p) {
+    return p.kind !== undefined && KINDS.includes(p.kind);
+}
+/** Position, die ein Gutschein decken darf: weder Trinkgeld noch Gutscheinzeile. */
+function istDeckbar(p) {
+    return p.tip == null && p.kind !== 'tip' && !istGutscheinZeile(p);
+}
+/** Wie beleg-toepfe: Euro in Positionsreihenfolge aufsummieren, erst die Summe auf Cent runden. */
+function centSumme(liste) {
+    return Math.round(liste.reduce((s, it) => s + it.priceOne * it.amount, 0) * 100);
+}
+/** `gutschein-core.satzBpAusVat`. */
+function satzBp(vat) {
+    return Math.round(Number(vat) * 100);
+}
+function position(satzBpWert, cents, kind) {
+    return { amount: 1, priceOne: cents / 100, vat: satzBpWert / 100, tip: null, kind };
+}
+/** Code in Normalform (tolerant eingelesen, Pruefzeichen stimmt) oder null. */
+function normalerCode(code) {
+    if (typeof code !== 'string')
+        return null;
+    const v = validator_1.VoucherCode.validate(code);
+    return v.ok ? v.normalized : null;
+}
+/** Ist der Eintrag ein Wunsch der neuen Form (nicht vom Server gelesen)? */
+function istWunsch(v) {
+    return (0, voucher_js_1.isNewFormVoucher)(v) && (0, voucher_js_1.voucherServerFields)(v).length === 0;
+}
+/** Ein gelesener Eintrag (Serverfelder gesetzt): nur Wert und Rabatt tragen Geld ausserhalb der Positionen. */
+function istGelesen(v) {
+    return (0, voucher_js_1.voucherServerFields)(v).length > 0;
+}
+const STATUS_FEHLER = {
+    used_up: 'voucher_used_up', paid_out: 'voucher_used_up', cancelled: 'voucher_cancelled', blocked: 'voucher_blocked', expired: 'voucher_expired',
+};
+/** Die Saetze, auf die `kuTeile` verteilt: je Satz `centSumme` der deckbaren Positionen, nur positive. */
+function kuSaetze(kunde) {
+    const jeSatz = new Map();
+    for (const it of kunde) {
+        if (!istDeckbar(it))
+            continue;
+        const s = satzBp(it.vat);
+        if (!jeSatz.has(s))
+            jeSatz.set(s, []);
+        jeSatz.get(s).push(it);
+    }
+    return [...jeSatz].map(([s, liste]) => ({ satzBp: s, basis: centSumme(liste) })).filter((x) => x.basis > 0);
+}
+/** `gutschein-core.kuTeile`: anteilig zur Positionssumme je Satz, groesster Rest, Topf-Reihenfolge bei Gleichstand. */
+function kuTeile(kunde, betragCents) {
+    const jeSatz = new Map();
+    for (const it of kunde) {
+        if (!istDeckbar(it))
+            continue;
+        const s = satzBp(it.vat);
+        if (!jeSatz.has(s))
+            jeSatz.set(s, []);
+        jeSatz.get(s).push(it);
+    }
+    const rang = (s) => TOPF_REIHENFOLGE.indexOf(topfFuerSatz(s / 100));
+    const saetze = [...jeSatz]
+        .map(([s, liste]) => ({ satzBp: s, basis: centSumme(liste), cents: 0, rest: 0 }))
+        .filter((s) => s.basis > 0)
+        .sort((a, b) => (rang(a.satzBp) - rang(b.satzBp)) || (b.satzBp - a.satzBp));
+    const summe = saetze.reduce((s, x) => s + x.basis, 0);
+    if (summe <= 0 || betragCents > summe)
+        return null;
+    for (const s of saetze) {
+        s.cents = Math.floor((betragCents * s.basis) / summe);
+        s.rest = (betragCents * s.basis) % summe;
+    }
+    let offen = betragCents - saetze.reduce((s, x) => s + x.cents, 0);
+    const nachRest = saetze.map((s, i) => ({ s, i })).sort((a, b) => (b.s.rest - a.s.rest) || (a.i - b.i));
+    for (let k = 0; offen > 0; k++, offen--)
+        nachRest[k].s.cents += 1;
+    return saetze.filter((s) => s.cents > 0).map((s) => ({ satzBp: s.satzBp, cents: s.cents }));
+}
+/**
+ * Wuensche und gelesene Eintraege in Positionen und Belegeintraege, wie
+ * `plane` sie baut. `kunde` sind Ware und Trinkgeld in innerer Form.
+ */
+function planeGutscheine(kunde, vouchers, art, o) {
+    const nein = (fehler, text) => ({ fehler, text });
+    const storno = art === 'cancellation';
+    const wuensche = vouchers.filter(istWunsch);
+    const zusatz = [];
+    const gutscheine = [];
+    // Wert und Rabatt der Altform bzw. gelesener Belege: Euro aus ganzen Cent.
+    const altEintrag = (v, i) => {
+        if (!Number.isSafeInteger(v.valueCents))
+            return nein('voucher_invalid', `Gutschein ${i + 1} hat keinen ganzen Cent-Wert.`);
+        return { action: String(v.action), type: String(v.type), value: Math.round(v.valueCents) / 100, ...(v.zeroRateBucket === true ? { imNullTopf: true } : {}) };
+    };
+    if (wuensche.length === 0) {
+        const nulltopf = !storno && o.today >= (o.zeroRateBucketFrom ?? exports.VOUCHER_ZERO_RATE_BUCKET_FROM);
+        // `gutschein-transaktion.brauchtPlan`: ab dem Stichtag laeuft plane auch fuer einen Altform-Verkauf.
+        const mitPlan = nulltopf && vouchers.some((v) => !istGelesen(v) && v.action === 'sell' && v.type === 'value');
+        if (mitPlan && kunde.some(istGutscheinZeile))
+            return nein('voucher_invalid', 'Gutschein-Positionen setzt nur der Server.');
+        for (const [i, v] of vouchers.entries()) {
+            // Gelesene Eintraege der neuen Form ohne Wert/Rabatt: ihr Geld steht in den Positionen.
+            if (istGelesen(v) && v.type !== 'value' && v.type !== 'promo')
+                continue;
+            const g = altEintrag(v, i);
+            if ('fehler' in g)
+                return g;
+            // Altform-Verkauf ab dem Stichtag: Betrag in den 0-%-Topf.
+            if (nulltopf && !istGelesen(v) && g.action === 'sell' && g.type === 'value') {
+                zusatz.push(position(0, Math.round(v.valueCents), 'voucher_float'));
+                g.imNullTopf = true;
+            }
+            gutscheine.push(g);
+        }
+        return { zusatz, gutscheine, auszahlungCents: 0, mitPlan, minusJeTopf: new Map() };
+    }
+    // Ab hier: mindestens ein Wunsch der neuen Form (createReceipt fuehrt `plane` aus).
+    if (storno)
+        return nein('voucher_invalid', 'Gutscheine der neuen Form gibt es am Storno nur gespiegelt vom Server.');
+    if (art === 'training')
+        return nein('voucher_invalid', 'Gutscheine der neuen Form gibt es nicht auf Schulungsbelegen.');
+    if (kunde.some(istGutscheinZeile))
+        return nein('voucher_invalid', 'Gutschein-Positionen setzt nur der Server.');
+    for (const [i, v] of vouchers.entries()) {
+        if (istGelesen(v))
+            return nein('voucher_invalid', `Gutschein ${i + 1}: Serverfelder an einem Wunsch.`);
+        if ((0, voucher_js_1.isNewFormVoucher)(v) && !(0, voucher_js_1.voucherIsValid)(v))
+            return nein('voucher_invalid', `Gutschein ${i + 1} ist unvollstaendig.`);
+    }
+    // Kein Gutschein mit Gutschein bezahlen, sobald einer der beiden die neue Form hat.
+    const handel = vouchers.filter((v) => v.action === 'sell' || v.action === 'redeem');
+    if (handel.some((v) => v.action === 'sell') && handel.some((v) => v.action === 'redeem') && handel.some(voucher_js_1.isNewFormVoucher))
+        return nein('voucher_invalid', 'Gutscheine verkaufen und einloesen gehen nicht am selben Beleg.');
+    if (wuensche.some((v) => v.type === 'promotion') && vouchers.length > 1)
+        return nein('voucher_invalid', 'Ein Aktionsgutschein steht allein am Beleg.');
+    if (wuensche.some((v) => v.action === 'payout') && vouchers.some((v) => !(0, voucher_js_1.isNewFormVoucher)(v) && v.type === 'promo')) {
+        return nein('voucher_invalid', 'Rabatt und Auszahlung gehen nicht am selben Beleg.');
+    }
+    const codes = wuensche.filter((v) => v.action !== 'sell').map((v) => normalerCode(v.code));
+    if (codes.some((c) => c == null))
+        return nein('voucher_invalid', 'Ein Gutscheincode ist ungueltig.');
+    if (new Set(codes).size !== codes.length)
+        return nein('voucher_invalid', 'Derselbe Gutschein steht zweimal am Beleg.');
+    const ku = o.smallBusiness === true;
+    const nulltopf = o.today >= (o.zeroRateBucketFrom ?? exports.VOUCHER_ZERO_RATE_BUCKET_FROM);
+    const minusJeTopf = new Map();
+    const minus = (s, c) => {
+        const topf = topfFuerSatz(s / 100);
+        minusJeTopf.set(topf, (minusJeTopf.get(topf) ?? 0) + c);
+    };
+    const belegt = new Set();
+    let auszahlungCents = 0;
+    const einstellung = (gewollt) => {
+        const e = o.voucherSettings;
+        // Der Server verkauft nur mit bestaetigter Einstellung (`voucher_settings_missing`), auch Mehrzweck.
+        if (e == null || e.valueVoucherType == null) {
+            return nein('voucher_settings_missing', 'Die Gutschein-Einstellung der Kasse fehlt (voucherSettings).');
+        }
+        return e.valueVoucherType === gewollt ? null : nein('voucher_invalid', 'Die Gutschein-Einstellung der Kasse verkauft eine andere Art.');
+    };
+    const pruefung = (v, i) => {
+        const code = normalerCode(v.code);
+        const info = (o.voucherInfo ?? []).find((x) => normalerCode(x.code) === code);
+        if (info == null)
+            return nein('voucher_not_found', `Gutschein ${i + 1}: keine Pruefung zum Code (checkVoucher).`);
+        if (info.check.type !== v.type)
+            return nein('voucher_invalid', `Gutschein ${i + 1}: die Art passt nicht zur Pruefung.`);
+        return info.check;
+    };
+    const saldo = (check, c, i) => Number.isInteger(check.balanceCents) && c <= check.balanceCents
+        ? null
+        : nein('voucher_insufficient_balance', `Gutschein ${i + 1}: der Betrag uebersteigt den Saldo.`);
+    for (const [i, v] of vouchers.entries()) {
+        if (!(0, voucher_js_1.isNewFormVoucher)(v)) {
+            const g = altEintrag(v, i);
+            if ('fehler' in g)
+                return g;
+            if (nulltopf && g.action === 'sell' && g.type === 'value') {
+                zusatz.push(position(0, Math.round(v.valueCents), 'voucher_float'));
+                g.imNullTopf = true;
+            }
+            gutscheine.push(g);
+            continue;
+        }
+        if (!ARTEN.includes(String(v.type)))
+            return nein('voucher_invalid', `Gutschein ${i + 1}: unbekannte Art.`);
+        if (v.action === 'sell') {
+            if (v.type === 'multi_purpose') {
+                const f = einstellung('multi_purpose');
+                if (f)
+                    return f;
+                const c = v.amountCents;
+                if (nulltopf) {
+                    zusatz.push(position(0, c, 'voucher_float'));
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100, imNullTopf: true });
+                }
+                else {
+                    gutscheine.push({ action: 'sell', type: 'value', value: c / 100 });
+                }
+            }
+            else if (v.type === 'single_purpose') {
+                const f = einstellung('single_purpose');
+                if (f)
+                    return f;
+                const satz = ku ? 0 : o.voucherSettings.vatRateBp;
+                if (!Number.isInteger(satz) || satz < 0)
+                    return nein('voucher_settings_missing', 'Der Satz des Einzweckgutscheins fehlt (Gutschein-Einstellung der Kasse).');
+                zusatz.push(position(satz, v.amountCents, 'voucher'));
+            }
+            else {
+                const a = (o.voucherArticles ?? []).find((x) => x.id === v.articleId);
+                if (a == null)
+                    return nein('voucher_item_mismatch', `Gutschein ${i + 1}: der Artikel fehlt (voucherArticles).`);
+                if (!Number.isInteger(a.priceCents) || a.priceCents <= 0 || !Number.isInteger(a.vatRateBp) || a.vatRateBp < 0) {
+                    return nein('voucher_invalid', `Gutschein ${i + 1}: Artikel ohne Preis oder Satz.`);
+                }
+                const c = v.quantity * a.priceCents;
+                if (c > 1_000_000)
+                    return nein('voucher_invalid', `Gutschein ${i + 1}: Betrag zu hoch.`);
+                zusatz.push(position(ku ? 0 : a.vatRateBp, c, 'voucher'));
+            }
+            continue;
+        }
+        const check = pruefung(v, i);
+        if ('fehler' in check)
+            return check;
+        if (v.action === 'payout') {
+            // `gutschein-core.darfAuszahlen`: aktiv, oder abgelaufen bis zum Ende der Rueckzahlbarkeit.
+            if (!((check.balanceCents ?? 0) > 0))
+                return nein('voucher_used_up', `Gutschein ${i + 1}: kein Saldo.`);
+            if (check.status === 'expired') {
+                const bis = check.validity?.refundableUntil;
+                if (bis && o.today > bis)
+                    return nein('voucher_expired', `Gutschein ${i + 1}: nicht mehr rueckzahlbar.`);
+            }
+            else if (check.status !== 'active') {
+                return nein(STATUS_FEHLER[check.status] ?? 'voucher_invalid', `Gutschein ${i + 1}: Status ${check.status}.`);
+            }
+            const c = v.amountCents;
+            const f = saldo(check, c, i);
+            if (f)
+                return f;
+            if (v.type === 'multi_purpose') {
+                zusatz.push(position(0, -c, 'voucher_float'));
+                gutscheine.push({ action: 'payout', type: 'value', value: c / 100, imNullTopf: true });
+            }
+            else {
+                if (!Number.isInteger(check.vatRateBp))
+                    return nein('voucher_invalid', `Gutschein ${i + 1}: Satz fehlt in der Pruefung.`);
+                zusatz.push(position(check.vatRateBp, -c, 'voucher'));
+            }
+            auszahlungCents += c;
+            continue;
+        }
+        if (check.status !== 'active')
+            return nein(STATUS_FEHLER[check.status] ?? 'voucher_invalid', `Gutschein ${i + 1}: Status ${check.status}.`);
+        if (v.type === 'multi_purpose' || v.type === 'single_purpose') {
+            const c = v.amountCents;
+            const f = saldo(check, c, i);
+            if (f)
+                return f;
+            if (v.type === 'multi_purpose') {
+                gutscheine.push({ action: 'redeem', type: 'value', value: c / 100 });
+            }
+            else if (check.exempt === true || ku) {
+                // Befreit verkauft (`kuEingefroren`) oder Kleinunternehmer-Konto: der gedeckte Teil
+                // verlaesst anteilig alle Toepfe des Korbs.
+                const teile = kuTeile(kunde, c);
+                if (!teile)
+                    return nein('voucher_rate_mismatch', `Gutschein ${i + 1}: der Korb deckt den Betrag nicht.`);
+                for (const t of teile) {
+                    zusatz.push(position(t.satzBp, -t.cents, 'voucher'));
+                    minus(t.satzBp, t.cents);
+                }
+            }
+            else {
+                if (!Number.isInteger(check.vatRateBp))
+                    return nein('voucher_invalid', `Gutschein ${i + 1}: Satz fehlt in der Pruefung.`);
+                zusatz.push(position(check.vatRateBp, -c, 'voucher'));
+                minus(check.vatRateBp, c);
+            }
+        }
+        else if (v.type === 'service') {
+            const artikelId = check.article?.id;
+            let stueck = 0;
+            const jeSatz = new Map();
+            for (const k of v.positions ?? []) {
+                const it = kunde[k];
+                if (it == null || it.kind !== undefined || it.tip != null || !artikelId || it.articleId !== artikelId
+                    || !Number.isInteger(it.amount) || it.amount < 1 || belegt.has(k)) {
+                    return nein('voucher_item_mismatch', `Gutschein ${i + 1}: Position ${k + 1} passt nicht zum Leistungsgutschein.`);
+                }
+                belegt.add(k);
+                stueck += it.amount;
+                const s = satzBp(it.vat);
+                if (!jeSatz.has(s))
+                    jeSatz.set(s, []);
+                jeSatz.get(s).push(it);
+            }
+            if (!Number.isInteger(check.remainingQuantity) || stueck > check.remainingQuantity) {
+                return nein('voucher_insufficient_balance', `Gutschein ${i + 1}: nicht genug offene Stueck.`);
+            }
+            for (const [s, liste] of jeSatz) {
+                const c = centSumme(liste);
+                zusatz.push(position(s, -c, 'voucher'));
+                minus(s, c);
+            }
+        }
+        else {
+            // Aktion: Rabatt ueber die Altmechanik promo.
+            const basis = centSumme(kunde.filter(istDeckbar));
+            const roh = Number.isInteger(check.discountCents) && check.discountCents > 0
+                ? check.discountCents
+                : Math.floor((basis * (Number(check.discountPercentBp) || 0)) / 10000);
+            const rabatt = Math.min(roh, basis);
+            if (!(rabatt > 0))
+                return nein('voucher_invalid', `Gutschein ${i + 1}: kein Rabatt auf diesen Korb.`);
+            gutscheine.push({ action: 'redeem', type: 'promo', value: rabatt / 100 });
+        }
+    }
+    // Einloese-Minuszeilen eines Topfs uebersteigen nie die deckbaren Positionen dieses Topfs.
+    for (const [topf, c] of minusJeTopf) {
+        const basis = centSumme(kunde.filter((it) => istDeckbar(it) && topfFuerSatz(it.vat) === topf));
+        if (c > basis)
+            return nein('voucher_rate_mismatch', 'Ein Gutschein deckt mehr als die Positionen seines Steuersatzes.');
+    }
+    return { zusatz, gutscheine, auszahlungCents, mitPlan: true, minusJeTopf };
+}

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

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

package/dist/cjs/receipt/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.codeTableReferenceImage = exports.codeTableTestSheetBytes = exports.codeTableTestSheet = exports.CODE_TABLE_TEST_SHEET_CHARS = exports.brandMarkImage = exports.BRAND_MARK_PATHS = exports.BRAND_MARK_RASTERS = exports.rasterizeLogo = exports.receiptSheet = exports.qrSheetWidthFraction = exports.logoRasterSize = exports.isLogoPixelSizeAllowed = exports.logoDimensions = exports.paperSizeForChars = exports.DOTS_PER_LINE = exports.DOTS_PER_CHAR = exports.LOGO_MAX_PIXELS = exports.SHEET_LOGO_SIZES = exports.eposDirectStatus = exports.eposDirectPrint = exports.eposParseResponse = exports.eposSoapEnvelope = exports.eposServiceUrl = exports.eposImageXml = exports.eposXmlEscape = exports.eposPrintXmlResult = exports.eposPrintXml = exports.EposConnectionError = exports.CHARS_PER_PAPER_SIZE = exports.gridToText = exports.gridColumnWidths = exports.renderReceiptGrid = exports.escPosLayoutResult = exports.escPosLayoutBytes = exports.assertLogoRaster = exports.formatCents = exports.SMALL_BUSINESS_NOTICE = exports.CURRENT_LAYOUT_RULESET = exports.receiptZdaText = exports.receiptIsSmallBusinessConsistent = exports.receiptAmountsAreZero = exports.receiptIsZero = exports.receiptSignatureIsTest = exports.receiptSignatureFailed = exports.buildReceiptLayout = void 0;
+exports.VOUCHER_ZERO_RATE_BUCKET_FROM = exports.voucherRedeemMaxCents = void 0;
 var layout_js_1 = require("./layout.js");
 Object.defineProperty(exports, "buildReceiptLayout", { enumerable: true, get: function () { return layout_js_1.buildReceiptLayout; } });
 Object.defineProperty(exports, "receiptSignatureFailed", { enumerable: true, get: function () { return layout_js_1.receiptSignatureFailed; } });
@@ -61,3 +62,5 @@ Object.defineProperty(exports, "receiptDueBreakdown", { enumerable: true, get: f
 Object.defineProperty(exports, "ReceiptDueError", { enumerable: true, get: function () { return due_js_1.ReceiptDueError; } });
 Object.defineProperty(exports, "RECEIPT_DUE_ERROR_REASONS", { enumerable: true, get: function () { return due_js_1.RECEIPT_DUE_ERROR_REASONS; } });
 Object.defineProperty(exports, "isReceiptDueError", { enumerable: true, get: function () { return due_js_1.isReceiptDueError; } });
+Object.defineProperty(exports, "voucherRedeemMaxCents", { enumerable: true, get: function () { return due_js_1.voucherRedeemMaxCents; } });
+Object.defineProperty(exports, "VOUCHER_ZERO_RATE_BUCKET_FROM", { enumerable: true, get: function () { return due_js_1.VOUCHER_ZERO_RATE_BUCKET_FROM; } });