@kreiseck/kasseneck-api 0.6.46 → 0.6.50

package/README.md

@@ -167,6 +167,43 @@ sich nicht stornieren, ein voll stornierter Beleg nicht noch einmal. Am
 gelesenen Original liefert `remainingQuantities(receipt)` die Reste vorab (für
 den Storno-Dialog); die Wahrheit hat der Server.
 
+**Fehler entscheidet man am Code, nicht am Text.** Jeder fachliche Fehler von
+`cancelReceipt` trägt `KasseneckApiError.code` aus `CANCELLATION_ERROR_CODES`
+(z. B. `bereits_storniert`, `menge_ueber_rest`, `nur_eigene_belege`). Die
+deutsche Meldung (`serverMessage`) ist Anzeige und darf sich ändern.
+
+```ts
+import { isKasseneckApiError, isCancellationErrorCode } from '@kreiseck/kasseneck-api';
+
+try {
+  await api.cancelReceipt({ receipt: beleg, reason: 'fehleingabe' });
+} catch (fehler) {
+  if (isKasseneckApiError(fehler) && isCancellationErrorCode(fehler.code)) {
+    switch (fehler.code) {
+      case 'bereits_storniert':  // Beleg im Dialog als „storniert" zeigen, Knopf sperren
+      case 'menge_ueber_rest':   // Restmengen neu laden (jemand war schneller)
+      case 'nur_eigene_belege':  // Chef holen
+        break;
+    }
+  }
+  throw fehler;
+}
+```
+
+**Gutscheine.** Ein Wertgutschein wird nur beim Vollstorno (ohne `items`)
+gespiegelt — er ist unteilbar. Ein Rabattgutschein ist am Original bereits in
+den Umsatz eingerechnet; **jeder** Storno nimmt ihn anteilig der stornierten
+Menge zurück: bei 3 Stück à 10 € mit 6 € Rabatt sind 8 € je Stück Entgelt, der
+Storno-Beleg trägt dann „−10,00" plus eine Zeile „Gutschein-Ausgleich +2,00".
+Was ein Storno gewährt hat, steht am Eintrag in `receipt.cancellations[]` als
+`promoAdjustmentCents` (Cent je Steuertopf) — die Kasse kann es im Dialog
+zeigen, rechnen muss sie nichts.
+
+**Bon.** Der Kopfblock des Storno-Bons nennt Bezug, Datum des Originals und
+Grund: „STORNOBELEG / Stornobuchung zu Beleg KASSE1-ID-42 / vom 11.08.2026,
+09:02 Uhr / Grund: Fehleingabe". Das Datum kommt aus `cancellationOf.timeStamp`
+(Backend seit 2026-09-04); Altbelege ohne bleiben ohne die Zeile.
+
 ## Unterpfade
 
 | Unterpfad | Inhalt |
@@ -174,7 +211,7 @@ den Storno-Dialog); die Wahrheit hat der Server.
 | `@kreiseck/kasseneck-api` | Endpunkte, Anmeldung, Transport, Modelle, Enums, Fehler — alles, was mit dem Backend spricht. |
 | `…/receipt` | Beleg-Layout als Datenmodell (framework-frei) und die Brücke zu ESC/POS. |
 | `…/printing` | ESC/POS-Erzeugung: Bytefolgen für Bondrucker, ohne jeden Transport. |
-| `…/payments` | Stripe-Zahllinks und Hobex-Cloud (beides HTTP-Endpunkte des Backends). |
+| `…/payments` | Stripe-Zahllinks, Hobex-Cloud (beides HTTP-Endpunkte des Backends) und Hobex **HPS** über **Kasseneck Connect** (lokaler Geräte-Agent, spricht mit dem Terminal). |
 | `…/register` | Anmeldung der Browser-Kasse: Gerät koppeln und entkoppeln, Benutzer auflisten, per PIN anmelden, Sitzung erneuern und beenden. |
 | `…/kasse` | Kachel-Kasse: Kassen-Einstellungen (betriebsweit / je Gerät), Artikelgruppen und Artikel für Kacheln, Rabattverteilung je Steuersatz, Reichweiten der Kassen-Rechte |
 | `…/react` | Dünner React-Adapter, der ein Beleg-Layout zeichnet. Braucht React. |
@@ -182,16 +219,40 @@ den Storno-Dialog); die Wahrheit hat der Server.
 
 So zieht sich niemand den React-Adapter in ein Node-Programm.
 
-## Was hier grundsätzlich nicht dazugehört
+## Hobex HPS über Kasseneck Connect
+
+Ein Browser hat weiterhin keine rohen TCP-Sockets — ein **direkter**
+Terminal-Kontakt wie beim Flutter-Paket `kasseneck_api` (`HpsClient`) bleibt
+deshalb außerhalb der Reichweite dieses Pakets. **Kasseneck Connect** ist aber
+ein lokaler Geräte-Agent mit gewöhnlicher HTTP-Schnittstelle, der für die Kasse
+mit dem Terminal spricht — und darüber geht es:
+
+```ts
+import { createHpsConnectClient, createHpsPayments } from '@kreiseck/kasseneck-api/payments';
 
-**Hobex HPS, myPOS und SumUp sind nicht Teil dieses Pakets und werden es auch
-nicht.** Hobex HPS spricht lokal über TCP mit dem Terminal, myPOS und SumUp
-sind Android-SDKs. Ein Browser kann das nicht, und kein Bündler ändert daran
-etwas. Wer diese Terminals braucht, nimmt das Flutter-Paket `kasseneck_api`.
+const client = createHpsConnectClient({ token: kopplungsToken });
+const zahlweg = createHpsPayments(client, { host: '192.168.1.50', tid: '3600335' });
 
-Ebenfalls nicht enthalten: die Druckeransteuerung selbst (dieses Paket erzeugt
-die Bytes, es verschickt sie nicht), Firmenlogos und Rasterbilder, und die
-PDF-Erzeugung.
+const ergebnis = await zahlweg.pay({ amountCents: 1050 });
+// ergebnis.outcome: 'approved' | 'declined' | 'unresolved' — nie geraten.
+// ergebnis.transactionId ist IMMER gesetzt, auch bei 'unresolved'.
+```
+
+Der Ausgang ist immer einer von drei: `approved`, `declined` (beweisbar nichts
+belastet) oder `unresolved` (Ausgang unbekannt, eine Wiederholung könnte ein
+zweites Mal belasten). Was das bedeutet und warum es so gebaut ist, steht in
+`src/payments/hobex-hps/payments.ts` — dort ist die Dokumentation der Maßstab,
+nicht dieses README.
+
+**Nur `pay` — bewusst kein `refund`/`cancel`.** Kasseneck Connect exponiert
+dafür (noch) keinen Endpunkt; eine Gutschrift oder ein Storno am HPS-Terminal
+braucht weiterhin die Flutter-App. **myPOS** und **SumUp** bleiben
+Android-SDKs ohne Entsprechung hier.
+
+## Was hier grundsätzlich nicht dazugehört
+
+Die Druckeransteuerung selbst (dieses Paket erzeugt die Bytes, es verschickt
+sie nicht), Firmenlogos und Rasterbilder, und die PDF-Erzeugung.
 
 ## Entwicklung
 
@@ -199,28 +260,52 @@ PDF-Erzeugung.
 npm test              # Testsuite in drei Zeitzonen (Wien, UTC, Kiritimati)
 npm run build         # ESM- und CJS-Bau nach dist/, inkl. Prüfung der exports
 npm run check:consumer # baut den Tarball und übersetzt zwei Verbraucher (CJS/ESM)
+npm run check:erreichbar # fragt die öffentliche Adresse: antwortet dort zu jedem Aufruf eine Function?
 ```
 
 Die drei Zeitzonen sind kein Übereifer: Zeitfehler sind auf einer Wiener
 Maschine zufällig richtig. Belegzeiten werden konsequent als **Wiener
 Wanduhrzeit** gedeutet (`parseServerTimeStamp`), nie über `new Date(text)`.
 
+### `check:erreichbar` — spricht als einzige mit `api.kasseneck.at`
+
+Testsuite und `check:consumer` laufen gegen Attrappen bzw. gegen den Tarball;
+keine von beiden setzt je einen Aufruf ab. Fehlt einem Aufruf die
+Hosting-Weiterleitung, liefert die veröffentlichte Adresse die
+HTML-Auffangseite statt der Function — und das sieht keine Attrappe.
+
+Die Prüfung braucht **keine Zugangsdaten**. Ein Aufruf ohne Anmeldung
+antwortet, wenn dort eine Function steht, mit
+`{"status":"error","message":"Ungültiger Request: Authorization key erwartet."}`.
+Genau das ist der Beweis: Der Aufruf wurde angenommen und die Anmeldung
+geprüft. Eine HTML-Seite oder ein 404 ist der Beweis, dass dort keine Function
+steht. Deshalb prüft das Skript auf ein `status`-Feld und nicht auf Erfolg.
+
+Bewusst außerhalb von `npm test`: Sie braucht Netz. Ist keines da, sagt sie es
+und endet mit 0. Aufrufe, die unter `/v1` absichtlich keine Weiterleitung
+haben — der Kassen-Weg über `kasse.kasseneck.at/api`, die Aufrufe mit
+Firebase-ID-Token — stehen mit Grund in `scripts/erreichbarkeit-ausnahmen.json`.
+Wird eine Ausnahme erreichbar, schlägt die Prüfung an: Sonst sänke die Zahl nie.
+
 ## Vertragsdateien für die Zwillinge
 
 Dieses Paket ist die Quelle für das Dart-Paket `kasseneck_api` und den
-Backend-Validator `kasse-settings-core.js`. Zwei Dateien in `fixtures/` reisen
-im Tarball mit und sagen in Maschinenform, worauf sich alle drei geeinigt haben:
+Backend-Validator `kasse-settings-core.js`. Drei Dateien in `fixtures/` reisen
+im Tarball mit und sagen in Maschinenform, worauf sich beide Seiten geeinigt haben:
 
 | Datei | Inhalt |
 |---|---|
 | `kasse-settings-standard.json` | Feldnamen und Standardwerte der Kassen-Einstellungen |
 | `oberflaeche.json` | Aufrufnamen, Enum-Werte, Rechte-Schlüssel, Tasten-Aktionen |
+| `hobex-hps-codes.json` | Gemessene HPS-Ergebniscodes, ihre Bedeutung und ob sie einen Ausgang festschreiben — der Vertrag hinter `.../payments/hobex-hps`s `isConclusive`. |
 
-Beide werden erzeugt (`npm run fixtures:kasse`, `npm run fixtures:oberflaeche`)
-und nie von Hand geändert; die CI prüft nach jedem Lauf, dass sie zum Code passen.
+Alle drei werden erzeugt (`npm run fixtures:kasse`, `npm run fixtures:oberflaeche`,
+`npm run fixtures:hobex-hps-codes`) und nie von Hand geändert; die CI prüft
+nach jedem Lauf, dass sie zum Code passen.
 
-`oberflaeche.json` trägt die Paketversion. **Nach jedem `npm version` müssen deshalb beide
-Dateien neu erzeugt und mitcommittet werden**, sonst wird die CI rot.
+`oberflaeche.json` und `hobex-hps-codes.json` tragen die Paketversion. **Nach
+jedem `npm version` müssen deshalb alle drei Dateien neu erzeugt und
+mitcommittet werden**, sonst wird die CI rot.
 
 ## Lizenz
 

package/dist/cjs/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 ["cancelReceipt", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getFirstReceiptDate", "getKasseSettings", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listRegisterUsersForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice"];
+export declare const AUFRUFE: readonly ["cancelReceipt", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getFirstReceiptDate", "getKasseSettings", "getPrintJob", "getReceipt", "hobexPayApi", "hobexRefundApi", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyTipRecipients", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice"];
 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/cjs/client/aufrufe.js

@@ -24,6 +24,7 @@ exports.AUFRUFE = [
     'listMyReceipts',
     'listMyTipRecipients',
     'listRegisterUsersForDevice',
+    'listRegisterSessionsForDevice',
     'pairRegisterDevice',
     'registerPinLogin',
     'registerUserLogin',

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

@@ -76,7 +76,13 @@ export declare class KasseneckApiError extends Error {
     readonly functionName: string;
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     readonly serverMessage: string;
-    constructor(functionName: string, serverMessage: string);
+    /**
+     * Stabiler Fehlercode des Backends (`code` aus der Huelle), wenn der
+     * Endpunkt einen legt — heute `cancelReceipt` (siehe CANCELLATION_ERROR_CODES).
+     * Daran entscheiden, nie an [serverMessage]: der Text darf sich aendern.
+     */
+    readonly code: string | undefined;
+    constructor(functionName: string, serverMessage: string, code?: string);
 }
 /** Warum die Antwort keine verwertbare Huelle war. */
 export type HttpFailureReason = 'server-error' | 'empty-body' | 'not-json' | 'missing-status';

package/dist/cjs/client/errors.js

@@ -101,10 +101,17 @@ class KasseneckApiError extends Error {
     functionName;
     /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
     serverMessage;
-    constructor(functionName, serverMessage) {
+    /**
+     * Stabiler Fehlercode des Backends (`code` aus der Huelle), wenn der
+     * Endpunkt einen legt — heute `cancelReceipt` (siehe CANCELLATION_ERROR_CODES).
+     * Daran entscheiden, nie an [serverMessage]: der Text darf sich aendern.
+     */
+    code;
+    constructor(functionName, serverMessage, code) {
         super(`${functionName} fehlgeschlagen: ${serverMessage}`);
         this.functionName = functionName;
         this.serverMessage = serverMessage;
+        this.code = code;
     }
 }
 exports.KasseneckApiError = KasseneckApiError;

package/dist/cjs/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;

package/dist/cjs/client/receipts.js

@@ -399,6 +399,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/cjs/client/transport.js

@@ -181,7 +181,7 @@ function jsonAuswerten(text, functionName, statusCode, inhaltstyp) {
     }
     // Alles, was nicht ausdruecklich Erfolg ist, gilt als fachlicher Fehler —
     // ein unbekannter Statuswert darf nie stillschweigend als Erfolg durchgehen.
-    throw fachfehler(functionName, huelle.message);
+    throw fachfehler(functionName, huelle.message, huelle.code);
 }
 /**
  * Auswertung des Binaerwegs. Der Kern der Zusage: **ein Aufrufer bekommt nie
@@ -227,7 +227,7 @@ function pdfAuswerten(bytes, functionName, statusCode, inhaltstyp) {
     }
     // 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);
+    throw fachfehler(functionName, huelle.message, huelle.code);
 }
 /** `%PDF` am Anfang — die Kennung jeder PDF-Datei. */
 function istPdf(bytes) {
@@ -240,9 +240,10 @@ function alsHuelle(wert) {
     }
     return wert;
 }
-function fachfehler(functionName, message) {
+function fachfehler(functionName, message, code) {
     const meldung = typeof message === 'string' && message.trim() ? message : 'Unbekannter Fehler';
-    return new errors_js_1.KasseneckApiError(functionName, meldung);
+    // Nur ein Text zaehlt als Code -- alles andere waere ein geratener Vertrag.
+    return new errors_js_1.KasseneckApiError(functionName, meldung, typeof code === 'string' && code ? code : undefined);
 }
 /**
  * Nutzlast aus Auth- und Aufruferparametern. Auth-Parameter bilden die

package/dist/cjs/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/cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.AUFRUFE = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
-exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = void 0;
+exports.createBinaryTransport = exports.createTransport = exports.AUFRUFE = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationErrorCode = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
+exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = void 0;
 var index_js_1 = require("./enums/index.js");
 Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
 Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -25,8 +25,10 @@ Object.defineProperty(exports, "fromReceiptPayload", { enumerable: true, get: fu
 Object.defineProperty(exports, "receiptSubSumCents", { enumerable: true, get: function () { return index_js_2.receiptSubSumCents; } });
 Object.defineProperty(exports, "receiptSumCents", { enumerable: true, get: function () { return index_js_2.receiptSumCents; } });
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return index_js_2.CANCELLATION_REASONS; } });
+Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, get: function () { return index_js_2.CANCELLATION_ERROR_CODES; } });
 Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true, get: function () { return index_js_2.CANCELLATION_RESERVATION_MS; } });
 Object.defineProperty(exports, "isCancellationReason", { enumerable: true, get: function () { return index_js_2.isCancellationReason; } });
+Object.defineProperty(exports, "isCancellationErrorCode", { enumerable: true, get: function () { return index_js_2.isCancellationErrorCode; } });
 Object.defineProperty(exports, "remainingQuantities", { enumerable: true, get: function () { return index_js_2.remainingQuantities; } });
 Object.defineProperty(exports, "fromReceiptCompanyPayload", { enumerable: true, get: function () { return index_js_2.fromReceiptCompanyPayload; } });
 Object.defineProperty(exports, "receiptCompanyTaxInfo", { enumerable: true, get: function () { return index_js_2.receiptCompanyTaxInfo; } });

package/dist/cjs/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/cjs/models/cancellation.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = void 0;
+exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = void 0;
 exports.isCancellationReason = isCancellationReason;
+exports.isCancellationErrorCode = isCancellationErrorCode;
 exports.remainingQuantities = remainingQuantities;
 /**
  * Storno-Metadaten — Zwilling von `functions/storno-core.js`.
@@ -23,6 +24,35 @@ exports.CANCELLATION_REASONS = Object.freeze({
 function isCancellationReason(value) {
     return typeof value === 'string' && Object.prototype.hasOwnProperty.call(exports.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.
+ */
+exports.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)
+];
+function isCancellationErrorCode(value) {
+    return typeof value === 'string' && exports.CANCELLATION_ERROR_CODES.includes(value);
+}
 /** Ab wann eine liegengebliebene Reservierung nicht mehr zaehlt (wie im Backend). */
 exports.CANCELLATION_RESERVATION_MS = 120_000;
 /**

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

@@ -44,8 +44,15 @@ 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: (0, money_js_1.euroToCents)(payload.amount),
+        tipCents: (0, money_js_1.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/cjs/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/cjs/models/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
+exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.istZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = exports.isCancellationErrorCode = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_REASONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isDiscountItem = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = void 0;
 var receipt_item_js_1 = require("./receipt-item.js");
 Object.defineProperty(exports, "toReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.toReceiptItemPayload; } });
 Object.defineProperty(exports, "fromReceiptItemPayload", { enumerable: true, get: function () { return receipt_item_js_1.fromReceiptItemPayload; } });
@@ -20,8 +20,10 @@ Object.defineProperty(exports, "receiptSubSumCents", { enumerable: true, get: fu
 Object.defineProperty(exports, "receiptSumCents", { enumerable: true, get: function () { return receipt_js_1.receiptSumCents; } });
 var cancellation_js_1 = require("./cancellation.js");
 Object.defineProperty(exports, "CANCELLATION_REASONS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_REASONS; } });
+Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_ERROR_CODES; } });
 Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true, get: function () { return cancellation_js_1.CANCELLATION_RESERVATION_MS; } });
 Object.defineProperty(exports, "isCancellationReason", { enumerable: true, get: function () { return cancellation_js_1.isCancellationReason; } });
+Object.defineProperty(exports, "isCancellationErrorCode", { enumerable: true, get: function () { return cancellation_js_1.isCancellationErrorCode; } });
 Object.defineProperty(exports, "remainingQuantities", { enumerable: true, get: function () { return cancellation_js_1.remainingQuantities; } });
 var receipt_company_js_1 = require("./receipt-company.js");
 Object.defineProperty(exports, "fromReceiptCompanyPayload", { enumerable: true, get: function () { return receipt_company_js_1.fromReceiptCompanyPayload; } });

package/dist/cjs/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/cjs/models/receipt-summary.js

@@ -46,7 +46,10 @@ 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/cjs/models/receipt.js

@@ -76,7 +76,11 @@ 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 } : {}),
         ...((0, receipt_summary_js_1.istZeroKind)(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(payload.cancellations ? { cancellations: payload.cancellations.map(leseStorno) } : {}),
@@ -90,6 +94,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/cjs/models/voucher.js

@@ -4,6 +4,7 @@ exports.toVoucherPayload = toVoucherPayload;
 exports.voucherIsValid = voucherIsValid;
 exports.fromVoucherPayload = fromVoucherPayload;
 const index_js_1 = require("../enums/index.js");
+const money_js_1 = require("../money.js");
 const enum_payload_js_1 = require("./enum-payload.js");
 function toVoucherPayload(voucher) {
     return {
@@ -35,16 +36,31 @@ function voucherIsValid(voucher) {
     if (voucher.type === index_js_1.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;
 }
 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)
+            ? (0, money_js_1.euroToCents)(payload.value)
             : undefined;
     return {
         name: payload.name ?? undefined,