@kreiseck/kasseneck-api 1.11.0 → 1.12.0

package/dist/esm/pos/settings.js

@@ -11,6 +11,7 @@
  * derselben Werte liegt unter `fixtures/stored/`. Trinkgeld ist bewusst AUS,
  * bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
+import { posVoucherSettingsFromWire } from './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
@@ -326,6 +327,7 @@ export function sanitizePosSettings(stored) {
     return {
         business: mergePosSettings(POS_BUSINESS_DEFAULTS, teil('business')),
         device: mergePosSettings(POS_DEVICE_DEFAULTS, teil('device')),
+        vouchers: posVoucherSettingsFromWire(eigen(roh, 'vouchers') ? roh['vouchers'] : undefined),
     };
 }
 /**

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

@@ -318,6 +318,58 @@ 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 '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 +979,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 +1668,84 @@ 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 'shift.all_payments': {
         readonly text: "Alle Zahlungen dieser Schicht (bar + unbar)";
     };

package/dist/esm/pos/texte.js

@@ -177,6 +177,24 @@ const MELDUNGEN_ROH = {
     'cancellation.tip_source_missing': { text: 'Bitte wählen: Woher kommt das Trinkgeld zurück?' },
     // Beleg mit Wertgutschein: keine Frage, das Trinkgeld geht mit (Ruling R59, asksRefundTip).
     'cancellation.tip_refunded_with_voucher': { text: 'Beleg mit Gutschein: Das Trinkgeld wird mitstorniert.' },
+    // --- Gutscheine: Fehlersätze (Zuordnung in VOUCHER_ERROR_MESSAGES) ---------
+    'voucher_error.not_found': { text: 'Diesen Gutschein gibt es in diesem Betrieb nicht.' },
+    'voucher_error.invalid': { text: 'Dieser Gutschein ist nicht gültig.' },
+    'voucher_error.invalid_code': { text: 'Der Code ist nicht vollständig oder falsch abgetippt.' },
+    'voucher_error.expired': { text: 'Der Gutschein ist abgelaufen.' },
+    'voucher_error.used_up': { text: 'Der Gutschein ist bereits aufgebraucht.' },
+    'voucher_error.blocked': { text: 'Der Gutschein ist gesperrt.' },
+    'voucher_error.cancelled': { text: 'Der Gutschein wurde storniert.' },
+    'voucher_error.insufficient_balance': { text: 'Auf dem Gutschein ist nicht genug Guthaben.' },
+    'voucher_error.exceeds_total': { text: 'Der Gutschein deckt mehr, als offen ist. Bitte den Betrag anpassen.' },
+    'voucher_error.balance_changed': { text: 'Der Gutschein wurde gerade anderswo verwendet. Bitte neu prüfen.' },
+    'voucher_error.rate_mismatch': { text: 'Dieser Gutschein gilt nur für Leistungen mit {rate} %.', placeholders: ['rate'] },
+    'voucher_error.item_mismatch': { text: 'Dieser Gutschein gilt nicht für die gewählten Positionen.' },
+    'voucher_error.already_used': { text: 'Dieser Gutschein wurde bereits verwendet.' },
+    'voucher_error.partial_cancel': { text: 'Belege mit Gutschein lassen sich nur ganz stornieren.' },
+    'voucher_error.settings_missing': { text: 'Die Gutschein-Einstellungen fehlen. Bitte die Kasse neu laden.' },
+    'voucher_error.too_many_checks': { text: 'Zu viele Versuche. Bitte in einer Stunde wieder.' },
+    'voucher_error.sale_off': { text: 'Gutscheine verkaufen geht hier noch nicht.' },
     // --- Getrennt zahlen -----------------------------------------------------
     // Ein Tisch zahlt in Teilen, ein Beleg fuer alles. Das Teure ist eine schon
     // belastete Karte: jeder Satz, der sie betrifft, nennt den Betrag, und keiner
@@ -544,6 +562,34 @@ export function cancellationPaymentErrorMessage(code) {
     const fehler = CANCELLATION_PAYMENT_ERROR_MESSAGES;
     return (code !== undefined && code !== null && fehler[code]) || 'cancellation.failed';
 }
+/**
+ * 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 const VOUCHER_ERROR_MESSAGES = {
+    voucher_not_found: 'voucher_error.not_found',
+    voucher_invalid: 'voucher_error.invalid',
+    voucher_invalid_code: 'voucher_error.invalid_code',
+    voucher_expired: 'voucher_error.expired',
+    voucher_used_up: 'voucher_error.used_up',
+    voucher_blocked: 'voucher_error.blocked',
+    voucher_cancelled: 'voucher_error.cancelled',
+    voucher_insufficient_balance: 'voucher_error.insufficient_balance',
+    voucher_exceeds_total: 'voucher_error.exceeds_total',
+    voucher_balance_changed: 'voucher_error.balance_changed',
+    voucher_rate_mismatch: 'voucher_error.rate_mismatch',
+    voucher_item_mismatch: 'voucher_error.item_mismatch',
+    voucher_already_used: 'voucher_error.already_used',
+    voucher_partial_cancel: 'voucher_error.partial_cancel',
+    voucher_settings_missing: 'voucher_error.settings_missing',
+    too_many_voucher_checks: 'voucher_error.too_many_checks',
+};
+/** Der Satz zu einem Gutschein-`code`; `undefined` für jeden anderen Code. */
+export function voucherErrorMessage(code) {
+    const fehler = VOUCHER_ERROR_MESSAGES;
+    return code !== undefined && code !== null ? fehler[code] : undefined;
+}
 /**
  * Beschriftungen: Knoepfe, Ueberschriften, Zeilennamen – was kein Satz ist.
  *
@@ -821,6 +867,30 @@ const BESCHRIFTUNGEN_ROH = {
     'shift.collected_outside_drawer': { text: 'Kassiert, aber nicht in der Kassenlade' },
     'shift.non_cash_short': { text: 'unbar' },
     'shift.voucher_redeemed': { text: 'Gutschein eingelöst' },
+    // Gutscheine an der Kasse (1.12.0)
+    'voucher.button': { text: 'Gutschein' },
+    'voucher.redeem': { text: 'Gutschein einlösen' },
+    'voucher.sell': { text: 'Gutschein verkaufen' },
+    'voucher.payout': { text: 'Gutschein auszahlen' },
+    'voucher.code': { text: 'Code' },
+    'voucher.scan': { text: 'Code scannen' },
+    'voucher.check': { text: 'Prüfen' },
+    'voucher.amount': { text: 'Betrag' },
+    'voucher.balance': { text: 'Rest am Gutschein: {amount}', placeholders: ['amount'] },
+    'voucher.remaining_quantity': { text: '{n} von {total} übrig', placeholders: ['n', 'total'] },
+    'voucher.reason': { text: 'Grund' },
+    'voucher.multi_purpose': { text: 'Mehrzweckgutschein' },
+    'voucher.single_purpose': { text: 'Einzweckgutschein {rate} %', placeholders: ['rate'] },
+    'voucher.service': { text: 'Leistungsgutschein' },
+    'voucher.promotion': { text: 'Aktionsgutschein' },
+    'voucher.payment_line': { text: 'Gutschein ····-{suffix}', placeholders: ['suffix'] },
+    'voucher.covers_items': { text: 'Deckt: {items}', placeholders: ['items'] },
+    'voucher.code_shown_once': { text: 'Code nur jetzt sichtbar: {code}', placeholders: ['code'] },
+    'voucher.not_in_split': { text: 'Gutscheine gehen beim getrennten Kassieren nicht.' },
+    'voucher.payout_not_possible': { text: 'Dieser Gutschein lässt sich nicht auszahlen.' },
+    'voucher.add_article': { text: '{article} hinzufügen', placeholders: ['article'] },
+    'voucher.payout_confirm': { text: '{amount} bar auszahlen?', placeholders: ['amount'] },
+    'cancellation.voucher_back': { text: '{amount} geht zurück auf den Gutschein', placeholders: ['amount'] },
     'shift.all_payments': { text: 'Alle Zahlungen dieser Schicht (bar + unbar)' },
     'shift.receipt_count_one': { text: '1 Beleg' },
     'shift.receipt_count_other': { text: '{count} Belege', placeholders: ['count'] },

package/dist/esm/react/index.js

@@ -42,8 +42,14 @@ export function HiddenQr({ data, text = 'Antippen zum Anzeigen', children }) {
 }
 function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
     switch (zeile.kind) {
-        case 'text':
-            return (_jsx("div", { className: "keck-receipt-text", style: { textAlign: AUSRICHTUNG[zeile.align], fontWeight: zeile.bold ? 'bold' : 'normal' }, children: zeile.text.length > 0 ? zeile.text : ' ' }));
+        case 'text': {
+            // Haengender Einzug wie im Zeichenraster: fuehrende Leerzeichen eines
+            // linksbuendigen Textes werden zum Einzug aller Zeilen (HTML liesse sie
+            // sonst wegfallen). Ohne fuehrende Leerzeichen bleibt alles wie bisher.
+            const einzug = zeile.align === 'left' && zeile.text.trimStart() !== '' ? zeile.text.length - zeile.text.trimStart().length : 0;
+            const text = einzug > 0 ? zeile.text.trimStart() : zeile.text;
+            return (_jsx("div", { className: "keck-receipt-text", style: { textAlign: AUSRICHTUNG[zeile.align], fontWeight: zeile.bold ? 'bold' : 'normal', ...(einzug > 0 ? { paddingLeft: `${einzug}ch` } : {}) }, children: text.length > 0 ? text : ' ' }));
+        }
         case 'columns':
             return (_jsx("div", { className: "keck-receipt-row", style: { display: 'flex', width: '100%', ...(zeile.bold === true ? { fontWeight: 'bold' } : {}) }, children: zeile.columns.map((spalte, index) => (_jsx("div", { className: "keck-receipt-cell", style: {
                         // Die Breite ist ein Zwoelftel-Anteil (wie beim Bondrucker);

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

@@ -1,6 +1,9 @@
 import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod } from '../enums/index.js';
 import type { ReceiptItem } from '../models/receipt-item.js';
 import type { Voucher } from '../models/voucher.js';
+import type { PosVoucherSettings, VoucherCheck } from '../pos/gutschein.js';
+import { type VoucherDueArticle, type VoucherDueInfo } from './gutschein-plan.js';
+export { VOUCHER_ZERO_RATE_BUCKET_FROM, type VoucherDueArticle, type VoucherDueInfo } from './gutschein-plan.js';
 /**
  * Zahlbetrag eines Belegs in ganzen Cent: Zwilling von `createReceipt` im
  * Backend (Nachtrag §8), also `beleg-toepfe.belegToepfe(...).zaehlerDeltaCents`
@@ -34,6 +37,19 @@ import type { Voucher } from '../models/voucher.js';
  * sobald Trinkgeld ohne `recipients` vorkommt. Ohne angemeldeten Benutzer
  * (Geraete-Schluessel) gilt `'staff'`.
  *
+ * **Gutscheine der neuen Form** (Mehrzweck, Einzweck, Leistung, Aktion,
+ * Auszahlung): der Server macht daraus Positionen und Eintraege
+ * (`gutschein-beleg.plane`, Zwilling in `gutschein-plan.ts`). Was er dafuer
+ * aus seinen Daten liest, gibt die Kasse mit: je Einloesung/Auszahlung die
+ * Pruefung aus `checkVoucher` (`voucherInfo`, ueber den Code zugeordnet), fuer
+ * einen Einzweck-Verkauf die Gutschein-Einstellung der Kasse
+ * (`voucherSettings`, Satz), fuer einen Leistungsgutschein-Verkauf den Artikel
+ * (`voucherArticles`, Preis und Satz) und `smallBusiness` fuer ein
+ * Kleinunternehmer-Konto. Was fehlt oder was der Server abwiese, wirft
+ * `invalid_voucher` mit dem erwarteten Server-Code in `voucherErrorCode`.
+ * Ein Beleg nur aus Auszahlungen hat einen negativen Zahlbetrag (genau eine
+ * Barzahlung ueber diesen Betrag).
+ *
  * **Nicht rechenbar:** jede unbrauchbare Eingabe wirft [ReceiptDueError]
  * (`code: 'receipt_due_unavailable'`, `reason` im Einzelnen), nie still eine
  * falsche Zahl. Dann ist nichts gesendet.
@@ -62,6 +78,42 @@ export interface ReceiptDueOptions {
     }>;
     /** Pflicht, sobald Trinkgeld ohne `recipients` vorkommt (siehe Modulkommentar). */
     tipRecipient?: ReceiptDueTipRecipient;
+    /**
+     * Je Einloesung bzw. Auszahlung der neuen Form die Pruefung aus
+     * `checkVoucher`, ueber den Code zugeordnet. Fehlt sie fuer einen Code,
+     * wirft die Rechnung `invalid_voucher` mit `voucherErrorCode:
+     * 'voucher_not_found'` (die Kasse hat den Code nicht geprueft).
+     */
+    voucherInfo?: readonly VoucherDueInfo[];
+    /**
+     * Gutschein-Einstellung der Kasse (`getKasseSettings`, Block `vouchers`):
+     * Pflicht fuer jeden Verkauf eines Mehrzweck- oder Einzweckgutscheins (der
+     * Server verkauft nur mit Einstellung). Fehlt sie oder ist keine Art
+     * gewaehlt: `voucher_settings_missing`; eine andere Art als die
+     * eingestellte: `voucher_invalid`.
+     */
+    voucherSettings?: PosVoucherSettings;
+    /**
+     * Artikel fuer den Verkauf von Dienstleistungsgutscheinen (Preis und Satz,
+     * wie im Artikelstamm). Fehlt der verkaufte Artikel hier:
+     * `voucher_item_mismatch`, wie beim Server fuer einen unbekannten Artikel.
+     */
+    voucherArticles?: readonly VoucherDueArticle[];
+    /**
+     * Das Konto ist Kleinunternehmer (Konto-Fakten): Einzweck/Leistung werden zu
+     * 0 % verkauft, eine Einzweck-Einloesung verteilt sich anteilig auf alle
+     * Saetze des Korbs. Dasselbe gilt fuer einen befreit verkauften Gutschein
+     * (`VoucherCheck.exempt`) in jedem Konto, wie der Server (`kuEingefroren || ku`).
+     */
+    smallBusiness?: boolean;
+    /**
+     * Stichtag des 0-%-Topfs fuer Mehrzweck-Verkaeufe (`YYYY-MM-DD`). Vorgabe
+     * [VOUCHER_ZERO_RATE_BUCKET_FROM], wie im Backend. Nur angeben, wenn der
+     * Server ihn nachweislich anders fuehrt (Test-Umgebung).
+     */
+    zeroRateBucketFrom?: string;
+    /** Wiener Tag des Belegs (`YYYY-MM-DD`); Vorgabe: heute in Wien. */
+    today?: string;
 }
 /** Die sechs RKSV-Toepfe in Cent, Namen wie am Beleg des Backends. */
 export interface ReceiptDueBuckets {
@@ -108,7 +160,13 @@ export declare class ReceiptDueError extends Error {
     readonly reason: ReceiptDueErrorReason;
     /** Immer `'rejected'`: es ging nichts hinaus. */
     readonly outcome: "rejected";
-    constructor(reason: ReceiptDueErrorReason, message: string);
+    /**
+     * Nur bei `invalid_voucher`: der Gutschein-Code, mit dem der Server
+     * denselben Beleg abwiese (`voucher_rate_mismatch`, `voucher_exceeds_total`,
+     * `voucher_not_found` …), fuer die Meldung an der Kasse.
+     */
+    readonly voucherErrorCode?: string;
+    constructor(reason: ReceiptDueErrorReason, message: string, voucherErrorCode?: string);
 }
 export declare function isReceiptDueError(error: unknown): error is ReceiptDueError;
 type BelegArt = ReceiptType | ReceiptTypeKey | string;
@@ -116,4 +174,27 @@ type BelegArt = ReceiptType | ReceiptTypeKey | string;
 export declare function receiptDueCents(items: readonly ReceiptItem[], vouchers: readonly Voucher[], receiptType: BelegArt, options?: ReceiptDueOptions): number;
 /** Wie [receiptDueCents], dazu Zaehler-Delta, Wertgutschein-Anteil und Toepfe. */
 export declare function receiptDueBreakdown(items: readonly ReceiptItem[], vouchers: readonly Voucher[], receiptType: BelegArt, options?: ReceiptDueOptions): ReceiptDueBreakdown;
-export {};
+/** Schon gewaehlte Gutscheine und Optionen des Belegs, vor dem Gutschein, der vorbelegt wird. */
+export interface VoucherRedeemContext {
+    vouchers?: readonly Voucher[];
+    options?: ReceiptDueOptions;
+}
+/**
+ * Hoechstbetrag zum Vorbelegen einer Einloesung an der Kasse, in Cent, nie
+ * negativ: der groesste Betrag, den der Server fuer diesen Gutschein annimmt.
+ *
+ * Obergrenze: Saldo, offener Betrag; bei Einzweck die deckbaren Positionen im
+ * Topf seines Satzes abzueglich der schon gewaehlten Einloesungen dort. Befreit
+ * verkauft bzw. als Kleinunternehmer verteilt der Server anteilig auf alle
+ * Saetze (`kuTeile`); dann begrenzt jeder Topf: sein Anteil plus die schon
+ * gewaehlten Einloesungen dort darf seine Positionen nicht uebersteigen.
+ *
+ * Unter dieser Grenze wird jeder Kandidat mit genau der Rechnung von
+ * [receiptDueCents] geprueft (Rundung halber Cent, groesster Rest), zuerst
+ * Cent fuer Cent abwaerts (64 Schritte). Findet das nichts, sucht eine
+ * Bisektion ueber [1, Grenze] und prueft danach 16 Cent aufwaerts: am Rand
+ * des groessten Rests ist die Annahme nicht monoton. Leistung (wird ueber
+ * Positionen eingeloest), Aktion (Rabatt rechnet der Server) und jeder nicht
+ * aktive Gutschein: 0.
+ */
+export declare function voucherRedeemMaxCents(items: readonly ReceiptItem[], voucher: VoucherCheck, before?: VoucherRedeemContext): number;