@kreiseck/kasseneck-api 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -4,6 +4,38 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.7.2
+
+### `55` („PIN falsch") ist eine gemessene Host-Ablehnung → `declined`
+
+**Anlass:** Vorfall vom 02.09.2026 am Produktivterminal 3556988 (HPS 1.11.4,
+Firmware 2.3.9), vom Dart-Zwilling `kasseneck_api` 6.4.0 übernommen — die
+erste echte Host-Ablehnung, die je beobachtet wurde. Die Zahlung antwortete
+direkt mit `55`, die Statusabfrage danach elfmal in Folge ebenfalls. Als
+Wissenslücke kostete der Code 90 s Klärung ins Budget, `unresolved`, einen
+stehenden Merker und eine Rückfrage an den Bediener — für eine falsch
+getippte PIN.
+
+- Neu: `WRONG_PIN_CODE`, in `HPS_MEASURED_CODES` als schlüssig geführt.
+- Bewusst **keine** Familienregel für zweistellige Host-Codes: ISO 8583 führt
+  dort auch Genehmigungen (`08`, `10`, `11`, `85`). Die Zwei-`9027`-Regel
+  greift bei Host-Codes nicht (der Status antwortet mit dem Code selbst);
+  ungemessene Host-Codes enden weiterhin bei `unresolved`.
+- `fixtures/hobex-hps-codes.json` neu erzeugt; die Vertragsdatei nennt jetzt
+  unter `ergaenztAn`, welcher Code von welchem Gerät stammt.
+
+### Neu: `HpsPaymentResult.lastResponse` und Terminal-Klartext im Nachweis
+
+Am 02.09.2026 sah der Bediener bei einer Antwort `55` „PIN falsch" nur
+„Ausgang unklar", musste raten und buchte die abgelehnte Zahlung als bezahlt;
+75 EUR Umsatz waren weg. Der Klartext hätte die Entscheidung getragen.
+
+- `lastResponse`: die letzte Terminal-Antwort bei `unresolved`, auch wenn sie
+  nichts entschied — Material für Anzeige und Katalog, nie ein Beleg.
+  `response` bleibt bei `unresolved` weiterhin ungesetzt.
+- Der Nachweis nennt bei einem unbekannten Code den Klartext des Terminals:
+  `Terminal nennt einen unbekannten Code (55) "PIN falsch"`.
+
 ## 0.7.0
 
 ### Neu: Unterpfad `./partner` — die Partner-API

package/README.md

@@ -162,12 +162,55 @@ ergebnis.cancellationOf;  // Bezug auf das Original
 ergebnis.remaining;       // Restmengen des Originals danach
 ```
 
+**Veraltet:** `createCancelReceipt` (Storno über `createReceipt` mit frei
+übergebenen, negierten Positionen) bleibt aus Kompatibilität erreichbar, ist aber
+`@deprecated` — kein Bezug zum Original, keine Restmengen, kein Schutz vor
+doppeltem Storno, keine Gutscheine. Das Backend legt bei diesem Weg
+`deprecation` in die Antwort.
+
 Der Server negiert die Positionen, prüft Restmengen und Rechte („nur eigene
 Belege" oder „alle") und verkettet Original und Storno. Ein Storno-Beleg lässt
 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.
+
 ## Partner-API (`./partner`)
 
 Für Softwarehäuser, die Kasseneck in ihr eigenes Produkt einbauen: Betriebe
@@ -292,7 +335,7 @@ app.post('/kasseneck-webhook', express.raw({ type: '*/*' }), async (req, res) =>
 | `@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 |
 | `…/partner` | Partner-API: Betriebe anlegen, FinanzOnline-Link, Signatur, Kassen, Zugangsdaten, Webhooks samt Signaturprüfung. **Gehört auf einen Server.** |
@@ -301,16 +344,40 @@ app.post('/kasseneck-webhook', express.raw({ type: '*/*' }), async (req, res) =>
 
 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';
+
+const client = createHpsConnectClient({ token: kopplungsToken });
+const zahlweg = createHpsPayments(client, { host: '192.168.1.50', tid: '3600335' });
 
-**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 ergebnis = await zahlweg.pay({ amountCents: 1050 });
+// ergebnis.outcome: 'approved' | 'declined' | 'unresolved' — nie geraten.
+// ergebnis.transactionId ist IMMER gesetzt, auch bei 'unresolved'.
+```
 
-Ebenfalls nicht enthalten: die Druckeransteuerung selbst (dieses Paket erzeugt
-die Bytes, es verschickt sie nicht), Firmenlogos und Rasterbilder, und die
-PDF-Erzeugung.
+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
 
@@ -348,19 +415,24 @@ Wird eine Ausnahme erreichbar, schlägt die Prüfung an: Sonst sänke die Zahl n
 ## 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`. |
+
 | `oberflaeche.json` | Aufrufnamen, Enum-Werte, Rechte-Schlüssel, Tasten-Aktionen, Partner-Listen |
 
-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.
 
 ### Und die Gegenrichtung
 

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 ["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/cjs/client/aufrufe.js

@@ -38,6 +38,7 @@ exports.AUFRUFE = [
     'listPartnerWebhookDeliveries',
     'listPartnerWebhooks',
     'listRegisterUsersForDevice',
+    'listRegisterSessionsForDevice',
     'pairRegisterDevice',
     'registerPinLogin',
     'registerUserLogin',

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

@@ -181,9 +181,13 @@ 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;
     /**
@@ -192,16 +196,15 @@ 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;
     }
 }
 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;
@@ -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/cjs/client/receipts.js

@@ -174,6 +174,12 @@ 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.
  */
 function createCancelReceipt(rufen, options) {
     return createReceipt(rufen, { ...options, receiptType: index_js_1.ReceiptType.cancellation });
@@ -399,6 +405,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, 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
@@ -227,7 +227,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) {
@@ -240,9 +240,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 errors_js_1.KasseneckApiError(functionName, meldung, (0, errors_js_1.fehlerDetails)(daten, geheimnisse));
+    // Nur ein Text zaehlt als Code -- alles andere waere ein geratener Vertrag.
+    return new errors_js_1.KasseneckApiError(functionName, meldung, (0, errors_js_1.fehlerDetails)(daten, geheimnisse), 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 } : {}),