@kreiseck/kasseneck-api 0.7.0 → 0.7.2

package/dist/cjs/register/pairing.d.ts

@@ -27,6 +27,14 @@ export interface RegisterClientInfo {
         w: number;
         h: number;
     };
+    /**
+     * Welcher Build der Anwendung gerade laeuft (frei, z. B. "0.6.46+3120").
+     * Bei einer Stoerungsmeldung die entscheidende Angabe: ohne sie laesst sich
+     * ein alter Build im Browser-Cache weder belegen noch ausschliessen -- und
+     * genau der steckt oft hinter "bei mir geht es aber". Das Backend kuerzt auf
+     * 80 Zeichen (register-geraetedaten.js, clientAusParams).
+     */
+    app?: string;
 }
 /** Standort aus der Browser-Ortung (freiwillig); Grundlage der Standortsperre. */
 export interface RegisterGeo {
@@ -214,6 +222,15 @@ export interface RegisterUserLoginOptions extends RegisterDeviceConnection, Regi
      * es bei der Abweisung "Kasse wird gerade auf … verwendet".
      */
     takeover?: boolean;
+    /**
+     * Welche Sitzung soll weichen? Kennung aus [listRegisterSessionsForDevice].
+     * Ohne Angabe verdraengt das Backend die aelteste -- so wie bisher.
+     *
+     * Eine Kennung, die nicht mehr laeuft, wird ABGEWIESEN statt still durch die
+     * aelteste ersetzt: Wer waehlt, bekommt seine Wahl oder eine Fehlermeldung,
+     * nie einen Unbeteiligten.
+     */
+    takeoverSessionId?: string;
 }
 export interface RegisterPinLoginOptions extends RegisterDeviceConnection, RegisterDeviceCredentials, RegisterGeraeteAngaben {
     /**
@@ -227,6 +244,8 @@ export interface RegisterPinLoginOptions extends RegisterDeviceConnection, Regis
     cashregisterId: string;
     /** Wie [RegisterUserLoginOptions.takeover]. */
     takeover?: boolean;
+    /** Wie [RegisterUserLoginOptions.takeoverSessionId]. */
+    takeoverSessionId?: string;
 }
 /**
  * Geraet koppeln: der Kopplungs-Code wird gegen den dauerhaften Ausweis dieses
@@ -252,6 +271,46 @@ export declare function pairRegisterDevice(options: PairRegisterDeviceOptions):
  * Geraet meldet Erfolg. Danach das Geraet lokal vergessen.
  */
 export declare function unpairRegisterDevice(options: ListRegisterUsersForDeviceOptions): Promise<void>;
+/** Eine laufende Sitzung an einer Kasse -- Zeile in der Auswahl. */
+export interface RegisterSession {
+    id: string;
+    deviceId: string | null;
+    /** Name des Geraets; „Kasse", wenn keiner gesetzt wurde. */
+    deviceLabel: string;
+    startedAt: number | null;
+    expiresAt: number | null;
+    /** Laeuft diese Sitzung auf DIESEM Geraet? */
+    selbst: boolean;
+    /**
+     * Wer angemeldet ist. Fehlt an einem nur-PIN-Geraet: Dort zeigt schon die
+     * Benutzerliste keine Namen, und was dort nicht steht, darf hier nicht
+     * durch die Hintertuer kommen. `undefined` heisst „wird nicht genannt",
+     * nicht „hat keinen Namen".
+     */
+    userName?: string;
+}
+/** Was eine Kasse gerade haelt -- Lizenzzahl und laufende Sitzungen. */
+export interface RegisterSessionsStand {
+    /** Wie viele Sitzungen gleichzeitig laufen duerfen. */
+    licenses: number;
+    /** Aelteste zuerst: oben steht, was das Backend ohne Wahl verdraengen wuerde. */
+    sessions: RegisterSession[];
+}
+export interface ListRegisterSessionsForDeviceOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
+}
+/**
+ * Welche Sitzungen haelt diese Kasse gerade?
+ *
+ * Fuer den Anmeldebildschirm: Sind alle Lizenzplaetze belegt, muss eine
+ * weichen -- und der Kassier soll sehen, WELCHE, statt dass das Backend still
+ * die aelteste nimmt. Die Wahl geht dann als
+ * [RegisterUserLoginOptions.takeoverSessionId] mit.
+ *
+ * Ausgewiesen wird sich ueber das Geraete-Geheimnis, wie bei
+ * [listRegisterUsersForDevice]: An diesem Punkt gibt es weder Sitzung noch
+ * Token. Die Kasse bestimmt das Backend aus dem Geraet, nicht aus dem Aufruf.
+ */
+export declare function listRegisterSessionsForDevice(options: ListRegisterSessionsForDeviceOptions): Promise<RegisterSessionsStand>;
 export declare function listRegisterUsersForDevice(options: ListRegisterUsersForDeviceOptions): Promise<RegisterDeviceUsers>;
 /**
  * Kassen-Benutzer per PIN anmelden. **Ohne Anmeldung** — dieser Aufruf

package/dist/cjs/register/pairing.js

@@ -5,6 +5,7 @@ exports.cancelScopeOf = cancelScopeOf;
 exports.receiptsScopeOf = receiptsScopeOf;
 exports.pairRegisterDevice = pairRegisterDevice;
 exports.unpairRegisterDevice = unpairRegisterDevice;
+exports.listRegisterSessionsForDevice = listRegisterSessionsForDevice;
 exports.listRegisterUsersForDevice = listRegisterUsersForDevice;
 exports.registerUserLogin = registerUserLogin;
 exports.registerPinLogin = registerPinLogin;
@@ -119,6 +120,48 @@ async function unpairRegisterDevice(options) {
     pflicht(name, 'deviceSecret', deviceSecret);
     await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
 }
+/**
+ * Welche Sitzungen haelt diese Kasse gerade?
+ *
+ * Fuer den Anmeldebildschirm: Sind alle Lizenzplaetze belegt, muss eine
+ * weichen -- und der Kassier soll sehen, WELCHE, statt dass das Backend still
+ * die aelteste nimmt. Die Wahl geht dann als
+ * [RegisterUserLoginOptions.takeoverSessionId] mit.
+ *
+ * Ausgewiesen wird sich ueber das Geraete-Geheimnis, wie bei
+ * [listRegisterUsersForDevice]: An diesem Punkt gibt es weder Sitzung noch
+ * Token. Die Kasse bestimmt das Backend aus dem Geraet, nicht aus dem Aufruf.
+ */
+async function listRegisterSessionsForDevice(options) {
+    const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
+    const name = 'listRegisterSessionsForDevice';
+    pflicht(name, 'ownerUid', ownerUid);
+    pflicht(name, 'deviceId', deviceId);
+    pflicht(name, 'deviceSecret', deviceSecret);
+    const daten = await transportFuer(verbindung)(name, { ownerUid, deviceId, deviceSecret }, undefined, [deviceSecret]);
+    const liste = daten?.sessions;
+    if (!Array.isArray(liste)) {
+        throw antwortfehler(name, 'Antwort enthaelt keine Sitzungsliste (data.sessions fehlt)');
+    }
+    const sessions = liste.map((eintrag) => {
+        const roh = (typeof eintrag === 'object' && eintrag !== null ? eintrag : {});
+        return {
+            // Ohne Kennung waere die Zeile nicht waehlbar -- eine Schaltflaeche, die
+            // nichts tun kann, ist schlimmer als keine.
+            id: pflichtfeld(name, roh, 'id'),
+            deviceId: typeof roh['deviceId'] === 'string' && roh['deviceId'] ? roh['deviceId'] : null,
+            deviceLabel: text(roh['deviceLabel']) || 'Kasse',
+            startedAt: typeof roh['startedAt'] === 'number' ? roh['startedAt'] : null,
+            expiresAt: typeof roh['expiresAt'] === 'number' ? roh['expiresAt'] : null,
+            selbst: roh['selbst'] === true,
+            // Nur uebernehmen, wenn wirklich einer kam: ein leerer String stuende
+            // in der Oberflaeche als namenlose Zeile, statt die Spalte wegzulassen.
+            ...(typeof roh['userName'] === 'string' && roh['userName'] ? { userName: roh['userName'] } : {}),
+        };
+    });
+    const licenses = typeof daten?.licenses === 'number' && daten.licenses > 0 ? daten.licenses : 1;
+    return { licenses, sessions };
+}
 async function listRegisterUsersForDevice(options) {
     const { ownerUid, deviceId, deviceSecret, ...verbindung } = options;
     const name = 'listRegisterUsersForDevice';
@@ -192,7 +235,7 @@ function regel(wert) {
  * sperren gestaffelt (ab dem fuenften 30 Sekunden, ab dem neunten 15 Minuten).
  */
 async function registerUserLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, userId, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerUserLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -210,6 +253,9 @@ async function registerUserLogin(options) {
         // Nur die ausdrueckliche Uebernahme geht mit: das Backend prueft auf
         // `=== true`, und ein mitgesendetes `false` waere nur Rauschen.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);
@@ -221,7 +267,7 @@ async function registerUserLogin(options) {
  * zaehlen und sperren dort am **Geraet**, nicht an einem Benutzer.
  */
 async function registerPinLogin(options) {
-    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, client, geo, ...verbindung } = options;
+    const { ownerUid, deviceId, deviceSecret, pin, cashregisterId, takeover, takeoverSessionId, client, geo, ...verbindung } = options;
     const name = 'registerPinLogin';
     pflicht(name, 'ownerUid', ownerUid);
     pflicht(name, 'deviceId', deviceId);
@@ -236,6 +282,9 @@ async function registerPinLogin(options) {
         cashregisterId,
         // Nur die ausdrueckliche Uebernahme geht mit — wie bei registerUserLogin.
         takeover: takeover === true ? true : undefined,
+        // Leerer String heisst „nichts gewaehlt" und gehoert nicht in die
+        // Nutzlast -- das Backend wiese ihn sonst als unbekannte Sitzung ab.
+        takeoverSessionId: takeoverSessionId ? takeoverSessionId : undefined,
         client, geo: geo ?? undefined,
     }, undefined, [pin, deviceSecret]);
     return sitzungAusAntwort(name, daten);

package/dist/esm/client/aufrufe.d.ts

@@ -13,7 +13,7 @@
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
 import type { TransportBodyFields } from './transport.js';
-export declare const AUFRUFE: readonly ["activateCashregister", "cancelReceipt", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listCustomerCashregisters", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updatePartnerWebhook"];
+export declare const AUFRUFE: readonly ["activateCashregister", "cancelReceipt", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listCustomerCashregisters", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "requestCustomerSignature", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updatePartnerWebhook"];
 export type Aufruf = typeof AUFRUFE[number];
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
 export type InternerTransport = <T = unknown>(functionName: Aufruf, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;

package/dist/esm/client/aufrufe.js

@@ -35,6 +35,7 @@ export const AUFRUFE = [
     'listPartnerWebhookDeliveries',
     'listPartnerWebhooks',
     'listRegisterUsersForDevice',
+    'listRegisterSessionsForDevice',
     'pairRegisterDevice',
     'registerPinLogin',
     'registerUserLogin',

package/dist/esm/client/errors.d.ts

@@ -95,9 +95,13 @@ export declare class KasseneckApiError extends Error {
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     readonly serverMessage: string;
     /**
-     * Maschinenlesbarer Fehlercode aus `data.code`, sofern die Antwort einen
-     * fuehrt (`vertrag_offen`, `rate_limited`, …). Die aelteren Endpunkte des
-     * Backends antworten ohne Code — dann `undefined`.
+     * Stabiler, maschinenlesbarer Fehlercode des Backends, wenn der Endpunkt
+     * einen legt. Zwei Ablageorte kommen vor und beide zaehlen: das Feld `code`
+     * neben `message` (cancelReceipt, siehe CANCELLATION_ERROR_CODES) und
+     * `data.code` (Partner-API: `vertrag_offen`, `rate_limited`, …). Nur
+     * Bezeichner gelten — ein Freitext waere kein Code. Die aelteren Endpunkte
+     * antworten ohne Code — dann `undefined`. **Daran entscheiden, nie an
+     * [serverMessage]:** der Text darf sich aendern, der Code nicht.
      */
     readonly code: string | undefined;
     /**
@@ -106,7 +110,7 @@ export declare class KasseneckApiError extends Error {
      * beilegt. Immer ein Objekt, notfalls ein leeres.
      */
     readonly details: Record<string, unknown>;
-    constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>);
+    constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>, code?: string);
 }
 /** Warum die Antwort keine verwertbare Huelle war. */
 export type HttpFailureReason = 'server-error' | 'empty-body' | 'not-json' | 'missing-status';

package/dist/esm/client/errors.js

@@ -171,9 +171,13 @@ export class KasseneckApiError extends Error {
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     serverMessage;
     /**
-     * Maschinenlesbarer Fehlercode aus `data.code`, sofern die Antwort einen
-     * fuehrt (`vertrag_offen`, `rate_limited`, …). Die aelteren Endpunkte des
-     * Backends antworten ohne Code — dann `undefined`.
+     * Stabiler, maschinenlesbarer Fehlercode des Backends, wenn der Endpunkt
+     * einen legt. Zwei Ablageorte kommen vor und beide zaehlen: das Feld `code`
+     * neben `message` (cancelReceipt, siehe CANCELLATION_ERROR_CODES) und
+     * `data.code` (Partner-API: `vertrag_offen`, `rate_limited`, …). Nur
+     * Bezeichner gelten — ein Freitext waere kein Code. Die aelteren Endpunkte
+     * antworten ohne Code — dann `undefined`. **Daran entscheiden, nie an
+     * [serverMessage]:** der Text darf sich aendern, der Code nicht.
      */
     code;
     /**
@@ -182,16 +186,15 @@ export class KasseneckApiError extends Error {
      * beilegt. Immer ein Objekt, notfalls ein leeres.
      */
     details;
-    constructor(functionName, serverMessage, details = {}) {
+    constructor(functionName, serverMessage, details = {}, code) {
         super(`${functionName} fehlgeschlagen: ${serverMessage}`);
         this.functionName = functionName;
         this.serverMessage = serverMessage;
         this.details = details;
-        // Der Code steht in `details` und zusaetzlich als eigenes Feld: das eine
-        // ist die Nutzlast, das andere die Frage, die ein Aufrufer wirklich
-        // stellt. Nur Bezeichner gelten — ein Freitext waere kein Code.
-        const code = details['code'];
-        this.code = typeof code === 'string' && BEZEICHNER.test(code) ? code : undefined;
+        // Der Code neben `message` hat Vorrang; fehlt er, gilt `data.code` aus
+        // den Details. So bleibt die Klasse fuer beide Ablageorte dieselbe.
+        const kandidat = code !== undefined ? code : details['code'];
+        this.code = typeof kandidat === 'string' && BEZEICHNER.test(kandidat) ? kandidat : undefined;
     }
 }
 const GRUND_TEXT = {

package/dist/esm/client/receipts.d.ts

@@ -54,6 +54,22 @@ export interface TipOptions {
     paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
     /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
     recipients?: TipRecipientShare[];
+    /**
+     * Hat der Empfaenger das Geld schon? `true` = ja (Bargeld mitgenommen,
+     * Kartentrinkgeld sofort aus der Lade ausgezahlt), `false` = der Betrieb
+     * behaelt es und schuldet es.
+     *
+     * Entscheidend ist NICHT die Zahlart, sondern der Besitz -- § 2j Abs 2 AVRAG
+     * kennt beide Faelle. Ohne Angabe gilt die Voreinstellung des Betriebs (bar:
+     * schon erhalten, bargeldlos: einbehalten); diese Angabe braucht es nur fuer
+     * die Ausnahme.
+     *
+     * NUR mit dem Recht `tipAssign` bei persoenlicher Anmeldung: das Merkmal
+     * entscheidet, ob der Betrieb Geld schuldet, und gewoehnliches Personal soll
+     * das nicht am Geraet umstellen koennen. Ueber einen Geraete-API-Schluessel
+     * (ohne angemeldeten Kassen-Benutzer) gilt die Einschraenkung nicht.
+     */
+    sofortErhalten?: boolean;
 }
 export interface TipRecipientShare {
     registerUserId: string;
@@ -169,6 +185,12 @@ export declare function cancelReceipt(rufen: InternerTransport, options: CancelR
  * Stornobeleg aus frei uebergebenen Positionen — fuer den Fall, dass der
  * Originalbeleg nicht als Objekt vorliegt. Die Positionen gehen **unveraendert**
  * hinaus; das Vorzeichen setzt der Aufrufer.
+ *
+ * @deprecated Alter Storno-Weg ohne Bezug: kein Verweis auf das Original,
+ * keine Restmengen, kein Schutz vor doppeltem Storno, Gutscheine werden nicht
+ * zurueckgenommen. Das Backend nimmt ihn weiter an und legt `deprecation` in
+ * die Antwort. Stattdessen [cancelReceipt] (Endpunkt `cancelReceipt`): Bezug,
+ * Grund, Teilstorno, Fehlercodes.
  */
 export declare function createCancelReceipt(rufen: InternerTransport, options: CreateCancelReceiptOptions): Promise<Receipt>;
 /** Nullbeleg (RKSV-Pruefbeleg) — ohne Positionen und ohne Zahlungsart. */

package/dist/esm/client/receipts.js

@@ -160,6 +160,12 @@ export async function cancelReceipt(rufen, options) {
  * Stornobeleg aus frei uebergebenen Positionen — fuer den Fall, dass der
  * Originalbeleg nicht als Objekt vorliegt. Die Positionen gehen **unveraendert**
  * hinaus; das Vorzeichen setzt der Aufrufer.
+ *
+ * @deprecated Alter Storno-Weg ohne Bezug: kein Verweis auf das Original,
+ * keine Restmengen, kein Schutz vor doppeltem Storno, Gutscheine werden nicht
+ * zurueckgenommen. Das Backend nimmt ihn weiter an und legt `deprecation` in
+ * die Antwort. Stattdessen [cancelReceipt] (Endpunkt `cancelReceipt`): Bezug,
+ * Grund, Teilstorno, Fehlercodes.
  */
 export function createCancelReceipt(rufen, options) {
     return createReceipt(rufen, { ...options, receiptType: ReceiptType.cancellation });
@@ -385,6 +391,16 @@ function gepruefterTip(tip) {
     const nutzlast = { cents: tip.cents };
     if (tip.paymentMethod != null)
         nutzlast['paymentMethod'] = gepruefteZahlungsart(tip.paymentMethod);
+    // Nur mitschicken, wenn gesetzt: fehlt das Feld, entscheidet die
+    // Voreinstellung des Betriebs. Ein `false` waere dort eine Aussage, kein
+    // Weglassen. Der Wortlaut des Fehlers ist der des Backends
+    // (tip-core.normalizeTip) -- wer ihn hier sieht, sieht denselben Satz.
+    if (tip.sofortErhalten != null) {
+        if (typeof tip.sofortErhalten !== 'boolean') {
+            throw eingabefehler('Trinkgeld: sofortErhalten muss true oder false sein.');
+        }
+        nutzlast['sofortErhalten'] = tip.sofortErhalten;
+    }
     if (tip.recipients != null) {
         if (!Array.isArray(tip.recipients) || tip.recipients.length === 0) {
             throw eingabefehler('Trinkgeld: recipients darf nicht leer sein.');

package/dist/esm/client/transport.js

@@ -176,7 +176,7 @@ function jsonAuswerten(text, functionName, statusCode, inhaltstyp, geheimnisse)
     }
     // Alles, was nicht ausdruecklich Erfolg ist, gilt als fachlicher Fehler —
     // ein unbekannter Statuswert darf nie stillschweigend als Erfolg durchgehen.
-    throw fachfehler(functionName, huelle.message, huelle.data, geheimnisse);
+    throw fachfehler(functionName, huelle.message, huelle.data, geheimnisse, huelle.code);
 }
 /**
  * Auswertung des Binaerwegs. Der Kern der Zusage: **ein Aufrufer bekommt nie
@@ -222,7 +222,7 @@ function pdfAuswerten(bytes, functionName, statusCode, inhaltstyp, geheimnisse)
     }
     // Derselbe fachliche Fehler wie auf dem JSON-Weg — fuer den Aufrufer macht
     // es keinen Unterschied, ob er ein PDF oder eine Nutzlast erwartet hat.
-    throw fachfehler(functionName, huelle.message, huelle.data, geheimnisse);
+    throw fachfehler(functionName, huelle.message, huelle.data, geheimnisse, huelle.code);
 }
 /** `%PDF` am Anfang — die Kennung jeder PDF-Datei. */
 function istPdf(bytes) {
@@ -235,9 +235,10 @@ function alsHuelle(wert) {
     }
     return wert;
 }
-function fachfehler(functionName, message, daten, geheimnisse) {
+function fachfehler(functionName, message, daten, geheimnisse, code) {
     const meldung = typeof message === 'string' && message.trim() ? message : 'Unbekannter Fehler';
-    return new KasseneckApiError(functionName, meldung, fehlerDetails(daten, geheimnisse));
+    // Nur ein Text zaehlt als Code -- alles andere waere ein geratener Vertrag.
+    return new KasseneckApiError(functionName, meldung, fehlerDetails(daten, geheimnisse), typeof code === 'string' && code ? code : undefined);
 }
 /**
  * Nutzlast aus Auth- und Aufruferparametern. Auth-Parameter bilden die

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 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, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, 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 ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, 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, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, AUFRUFE, type Aufruf, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 export { ReceiptType, VatRate, KeckPaymentMethod, CreditCardProvider, VoucherType, VoucherAction, StripeLinkMode, } from './enums/index.js';
-export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, AUFRUFE, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

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

@@ -18,10 +18,29 @@ export declare const CANCELLATION_REASONS: Readonly<{
 }>;
 export type CancellationReason = keyof typeof CANCELLATION_REASONS;
 export declare function isCancellationReason(value: unknown): value is CancellationReason;
+/**
+ * Stabile Fehlercodes von `cancelReceipt` — Zwilling von
+ * `functions/storno-core.js` STORNO_FEHLERCODES. Das Backend legt sie bei
+ * jedem fachlichen Fehler als `code` neben die Meldung; das Paket reicht sie
+ * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** —
+ * die deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
+ * ohne Code; dort bleibt `code` undefined.
+ */
+export declare const CANCELLATION_ERROR_CODES: readonly ["beleg_nicht_gefunden", "belegart_nicht_stornierbar", "trainingsbeleg", "bereits_storniert", "position_ungueltig", "menge_ueber_rest", "grund_unbekannt", "anmerkung_zu_lang", "items_ungueltig", "kasse_nicht_zugewiesen", "keine_berechtigung", "nur_eigene_belege", "kasse_unvollstaendig", "storno_fehlgeschlagen"];
+export type CancellationErrorCode = (typeof CANCELLATION_ERROR_CODES)[number];
+export declare function isCancellationErrorCode(value: unknown): value is CancellationErrorCode;
 /** Bezug eines Storno-Belegs auf sein Original. */
 export interface CancellationOf {
     receiptId: string;
     fullReceiptId: string | null;
+    /**
+     * Zeitstempel des Originals (Server-Format, Wiener Wanduhr) — das Layout
+     * nennt ihn im Kopfblock des Storno-Bons („vom 11.08.2026, 09:02 Uhr").
+     * Fehlt bei Altbelegen; dann bleibt die Zeile weg.
+     */
+    timeStamp?: string;
 }
 /** Eine stornierte Position: Index im Original und Menge. */
 export interface CancellationItem {
@@ -40,6 +59,15 @@ export interface Cancellation {
     by: string | null;
     note: string | null;
     items: CancellationItem[];
+    /**
+     * Rabattgutschein-Ausgleich, den DIESER Storno gewaehrt hat — Cent je
+     * Steuertopf des Backends (`amountRateStandard`, `amountRateReduced1`, …).
+     * Ein Rabattgutschein ist am Original schon in den Umsatz eingerechnet;
+     * jeder Storno nimmt ihn anteilig der stornierten Menge zurueck (bei 3 Stueck
+     * a 10 EUR mit 6 EUR Rabatt: 2,00 je Stueck). Fehlt das Feld, hat der Eintrag
+     * nichts gewaehrt (Altbestand vor dieser Regel) — der naechste Storno holt nach.
+     */
+    promoAdjustmentCents?: Record<string, number>;
 }
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 export declare const CANCELLATION_RESERVATION_MS = 120000;

package/dist/esm/models/cancellation.js

@@ -18,6 +18,35 @@ export const CANCELLATION_REASONS = Object.freeze({
 export function isCancellationReason(value) {
     return typeof value === 'string' && Object.prototype.hasOwnProperty.call(CANCELLATION_REASONS, value);
 }
+/**
+ * Stabile Fehlercodes von `cancelReceipt` — Zwilling von
+ * `functions/storno-core.js` STORNO_FEHLERCODES. Das Backend legt sie bei
+ * jedem fachlichen Fehler als `code` neben die Meldung; das Paket reicht sie
+ * als [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** —
+ * die deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
+ * ohne Code; dort bleibt `code` undefined.
+ */
+export const CANCELLATION_ERROR_CODES = [
+    'beleg_nicht_gefunden', // Original fehlt oder gehoert nicht zu dieser Kasse
+    'belegart_nicht_stornierbar', // Original ist selbst Storno-, Null- oder Startbeleg
+    'trainingsbeleg', // Trainingsbelege werden nicht storniert
+    'bereits_storniert', // keine Restmenge mehr (auch beim positionslosen Beleg)
+    'position_ungueltig', // Index unbekannt oder doppelt
+    'menge_ueber_rest', // Menge nicht ganzzahlig >= 1 oder groesser als der Rest
+    'grund_unbekannt', // reason fehlt oder nicht im Katalog
+    'anmerkung_zu_lang', // note laenger als 200 Zeichen
+    'items_ungueltig', // items ist keine Liste
+    'kasse_nicht_zugewiesen', // Register-Benutzer darf diese Kasse nicht
+    'keine_berechtigung', // Register-Benutzer ohne Storno-Recht
+    'nur_eigene_belege', // Recht "eigene", fremder Beleg
+    'kasse_unvollstaendig', // api_key/token fehlen am Konto bzw. an der Kasse
+    'storno_fehlgeschlagen', // der Storno-Beleg selbst wurde abgelehnt (z. B. Signatur)
+];
+export function isCancellationErrorCode(value) {
+    return typeof value === 'string' && CANCELLATION_ERROR_CODES.includes(value);
+}
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 export const CANCELLATION_RESERVATION_MS = 120_000;
 /**

package/dist/esm/models/hobex-receipt.js

@@ -1,5 +1,5 @@
 import { CreditCardProvider } from '../enums/index.js';
-import { centsToEuro } from '../money.js';
+import { centsToEuro, euroToCents } from '../money.js';
 export function toHobexReceiptPayload(beleg) {
     return {
         transactionId: beleg.transactionId,
@@ -38,8 +38,15 @@ export function fromHobexReceiptPayload(payload) {
         responseCode: payload.responseCode,
         transactionType: payload.transactionType,
         currency: payload.currency,
-        amountCents: Math.round((payload.amount ?? 0) * 100),
-        tipCents: Math.round((payload.tip ?? 0) * 100),
+        // Euro->Cent ueber die eine gehaertete Stelle im Paket ([euroToCents],
+        // money.ts) statt einer eigenen `Math.round(x * 100)` -- die Hobex-Antwort
+        // ist eine fremde Antwort und wird hier nur auf transactionId/
+        // transactionDate geprueft (siehe payments/hobex.ts, belegAusNutzlast);
+        // amount/tip bleiben ungeprueft. Ein nicht-numerischer oder
+        // nicht-endlicher Wert ergab bis zu dieser Fassung `NaN` -- lautlos, ohne
+        // dass irgendwo geworfen wurde. [euroToCents] liefert dafuer `0`.
+        amountCents: euroToCents(payload.amount),
+        tipCents: euroToCents(payload.tip),
         cvm: String(payload.cvm),
         // Die Cloud-API-Nutzlast traegt keinen eigenen Provider-Schluessel — der
         // Provider ergibt sich aus dem Transportweg (Cloud vs. HPS), nicht aus

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

@@ -1,7 +1,7 @@
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';
+export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, } from './cashregister.js';
 export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

package/dist/esm/models/index.js

@@ -1,7 +1,7 @@
 export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
-export { CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';
+export { CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
 export { fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { fromCashregisterPayload, } from './cashregister.js';
 export { fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

package/dist/esm/models/receipt-summary.d.ts

@@ -56,6 +56,7 @@ export interface ReceiptSummary {
     /** Nur am Storno-Beleg: das Original. */
     cancellationOf?: {
         receiptId: string | null;
+        timeStamp?: string;
     };
     cancellationReason?: string;
     /** offen | teil | voll -- Storno-Stand des Originals. */
@@ -84,6 +85,7 @@ export interface ReceiptSummaryPayload {
     } | null;
     cancellationOf?: {
         receiptId?: string | null;
+        timeStamp?: string | null;
     } | null;
     cancellationReason?: string | null;
     stornoStand?: string | null;

package/dist/esm/models/receipt-summary.js

@@ -41,7 +41,10 @@ export function fromReceiptSummaryPayload(payload) {
         signatureOk: payload.signature_ok !== false,
         items: Array.isArray(payload.items) ? payload.items.map((i) => ({ name: i?.name ?? '', quantity: typeof i?.quantity === 'number' ? i.quantity : 0 })) : [],
         ...(payload.operator ? { operator: { uid: payload.operator.uid ?? null, name: payload.operator.name ?? '' } } : {}),
-        ...(payload.cancellationOf ? { cancellationOf: { receiptId: payload.cancellationOf.receiptId ?? null } } : {}),
+        ...(payload.cancellationOf ? { cancellationOf: {
+                receiptId: payload.cancellationOf.receiptId ?? null,
+                ...(typeof payload.cancellationOf.timeStamp === 'string' && payload.cancellationOf.timeStamp ? { timeStamp: payload.cancellationOf.timeStamp } : {}),
+            } } : {}),
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         stornoStand: payload.stornoStand === 'teil' || payload.stornoStand === 'voll' ? payload.stornoStand : 'offen',
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),

package/dist/esm/models/receipt.js

@@ -70,7 +70,11 @@ export function fromReceiptPayload(payload) {
         signatureSuccess: payload.signatureSuccess ?? undefined,
         customProjectId: payload.customProjectId ?? undefined,
         ...(typeof payload.tipCents === 'number' ? { tipCents: payload.tipCents } : {}),
-        ...(payload.cancellationOf ? { cancellationOf: { receiptId: payload.cancellationOf.receiptId, fullReceiptId: payload.cancellationOf.fullReceiptId ?? null } } : {}),
+        ...(payload.cancellationOf ? { cancellationOf: {
+                receiptId: payload.cancellationOf.receiptId,
+                fullReceiptId: payload.cancellationOf.fullReceiptId ?? null,
+                ...(typeof payload.cancellationOf.timeStamp === 'string' && payload.cancellationOf.timeStamp ? { timeStamp: payload.cancellationOf.timeStamp } : {}),
+            } } : {}),
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(payload.cancellations ? { cancellations: payload.cancellations.map(leseStorno) } : {}),
@@ -84,6 +88,9 @@ function leseStorno(eintrag) {
         by: eintrag.by ?? null,
         note: eintrag.note ?? null,
         items: (eintrag.items ?? []).map((p) => ({ index: Number(p.index), quantity: Number(p.quantity) })),
+        ...(eintrag.promoAdjustmentCents && typeof eintrag.promoAdjustmentCents === 'object'
+            ? { promoAdjustmentCents: Object.fromEntries(Object.entries(eintrag.promoAdjustmentCents).map(([k, v]) => [k, Number(v)])) }
+            : {}),
     };
 }
 /**

package/dist/esm/models/voucher.js

@@ -1,4 +1,5 @@
 import { VoucherAction, VoucherType } from '../enums/index.js';
+import { euroToCents } from '../money.js';
 import { readEnumKey, requireEnumKey } from './enum-payload.js';
 export function toVoucherPayload(voucher) {
     return {
@@ -30,16 +31,31 @@ export function voucherIsValid(voucher) {
     if (voucher.type === VoucherType.promo && voucher.valueCents == null) {
         return false;
     }
-    if (voucher.valueCents != null && voucher.valueCents <= 0) {
+    // `!Number.isFinite` VOR den Vergleich, nicht dahinter: `NaN <= 0` und
+    // `Infinity <= 0` sind beide `false`, ein Vergleich mit einem
+    // nicht-endlichen Wert ist also IMMER falsch und liesse ihn hier
+    // durchrutschen. Gemessen (28.08.2026): ein Gutschein mit `valueCents: NaN`
+    // (aus einem kaputten `value` in der Nutzlast, siehe [fromVoucherPayload])
+    // oder `valueCents: Infinity` galt bis zu dieser Fassung als GUELTIG und
+    // waere still in die Belegsummen gewandert. Diese Pruefung greift
+    // unabhaengig davon, ob `valueCents` ueber [fromVoucherPayload] oder direkt
+    // gesetzt wurde -- die gehaertete Umrechnung dort allein reicht nicht.
+    if (voucher.valueCents != null && (!Number.isFinite(voucher.valueCents) || voucher.valueCents <= 0)) {
         return false;
     }
     return true;
 }
 export function fromVoucherPayload(payload) {
+    // Euro->Cent ueber die eine gehaertete Stelle im Paket ([euroToCents],
+    // money.ts) statt einer eigenen `Math.round(payload.value * 100)` --
+    // [euroToCents] prueft `Number.isFinite` und liefert fuer einen
+    // nicht-numerischen oder nicht-endlichen Wert `0` statt eines lautlosen
+    // `NaN`. Siehe auch [voucherIsValid]: `0` faellt dort ueber die
+    // "<= 0"-Pruefung, ein `NaN` waere durchgerutscht.
     const valueCents = payload.valueCents != null
         ? payload.valueCents
         : payload.value != null
-            ? Math.round(payload.value * 100)
+            ? euroToCents(payload.value)
             : undefined;
     return {
         name: payload.name ?? undefined,