@kreiseck/kasseneck-api 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -4,6 +4,63 @@ 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.13.0
+
+### Beleg per E-Mail an den Gast (`sendReceiptEmail`)
+
+**Anlass:** Der Endpunkt ist im Backend live (keck#361), beide Kassen haben den
+Weg gebaut — hinter einer Schnittstelle, hinter der nichts stand, weil kein
+Paket den Aufruf kannte. Verschickt wird ein **Link auf die öffentliche
+Belegseite**, kein PDF im Anhang: die Belegseite führt dasselbe Zeilenmodell
+wie Bildschirm und Bon, ein mitgeschicktes PDF wäre dieselbe Sache ein zweites
+Mal, nur unveränderlich veraltet. Der Beleg selbst bleibt unberührt (BAO §131 /
+RKSV); das Versandprotokoll führt das Backend neben ihm.
+
+- **`sendReceiptEmail({ fullReceiptId, to, sprache? })`** — auch auf der
+  Fassade `createKasseneckApi`. Antwort: `{ to, at, via }` — Adresse in der
+  protokollierten Form, Zeitpunkt als ISO mit Wiener Zonenoffset, Versandweg
+  (`eigen`, `plattform`, `plattform-fallback`; fehlt er, ist `via` `null` und
+  nicht etwa ein Fehler — er sagt etwas über den Weg, nichts über den Erfolg).
+- **Kein `cashregisterId` in den Optionen.** Die Kasse kommt aus der Anmeldung:
+  beim Gerät über die Kopfzeile `cashregister-token`, beim Kassen-Benutzer über
+  den Parameter, den `registerUserAuth` ohnehin setzt. Eine dritte Stelle wäre
+  nur eine Gelegenheit, eine andere Kasse zu behaupten als die, an der man
+  angemeldet ist — und das Backend nimmt den Belegpfad aus der angemeldeten.
+- **`RECEIPT_EMAIL_ERROR_CODES`**, Typ `ReceiptEmailErrorCode` und der Wächter
+  `isReceiptEmailErrorCode`: `adresse_ungueltig`, `beleg_nicht_gefunden`
+  (auch für einen Beleg einer fremden Kasse — das Backend gibt darüber bewusst
+  keine Auskunft), `zu_oft` (5 Mails je Beleg in 24 Stunden, 30 je Kasse und
+  Stunde) und `versand_fehlgeschlagen`. Die Codes kommen unverändert als
+  `KasseneckApiError.code` heraus; das Paket legt keine eigenen an. **Am Code
+  entscheiden, nie am deutschen Text.**
+- Die Adresse prüft das Paket **nicht** selbst — nur leer/fehlend wird vor dem
+  Senden abgewiesen (`fullReceiptId`, `to`; beides getrimmt, weil es von Hand
+  ins Feld kommt). Eine zweite, eigene Adressregel könnte strenger sein als die
+  des Backends und eine gültige Adresse abweisen, ohne dass es auffällt.
+- `sendReceiptEmail` steht in `AUFRUFE` und damit in
+  `fixtures/oberflaeche.json` — der Zwilling `kasseneck_api` (Dart) prüft
+  dagegen.
+
+## 0.12.0
+
+### Storno mit Kartendaten der Erstattung
+
+**Anlass:** sastre zieht vom alten Storno-Weg (`createCancelReceipt`, ohne
+Bezug) auf `cancelReceipt` um. Bei einer Kartenerstattung haengt sastre heute
+die Terminaldaten der Gutschrift/Aufhebung an den Stornobeleg -- ueber den
+neuen Endpunkt ging das bisher nicht, der Kartenblock fiele vom Storno-Bon.
+Backend: keck#371.
+
+- **`cancelReceipt` nimmt `creditCardProvider`, `cardPaymentId` und
+  `cardPaymentData` an** -- die Daten der ERSTATTUNG, nie der Originalzahlung.
+  Nur bei Rueckzahlweg Karte: ein ausdruecklich anderer `paymentMethod` wird
+  schon hier abgewiesen, ohne Angabe entscheidet das Backend an der
+  Zahlungsart des Originals. Ein unbekannter Kartenanbieter geht gar nicht erst
+  raus.
+- Ohne Kartendaten aendert sich nichts.
+- `package-lock.json` traegt wieder die Paketversion (stand seit 0.11.0 auf
+  0.10.0).
+
 ## 0.11.0
 
 ### Die QR-Modulgröße wird gerechnet, nicht gesetzt — samt Notausgang und Modell 1

package/README.md

@@ -211,6 +211,32 @@ 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.
 
+## Beleg per E-Mail an den Gast
+
+```ts
+const bestaetigung = await api.sendReceiptEmail({
+  fullReceiptId: beleg.fullReceiptId,   // oder api.generateFullReceiptId(receiptId)
+  to: 'gast@example.at',
+  sprache: 'de',                        // optional; heute wertet das Backend nur 'de' aus
+});
+bestaetigung.to;   // Adresse, wie das Backend sie protokolliert hat
+bestaetigung.at;   // Zeitpunkt, ISO mit Wiener Zonenoffset
+bestaetigung.via;  // 'eigen' | 'plattform' | 'plattform-fallback' | null
+```
+
+Verschickt wird ein **Link auf die öffentliche Belegseite**, kein PDF im
+Anhang: die Belegseite führt dasselbe Zeilenmodell wie Bildschirm und Bon und
+liefert dort auf Wunsch ein PDF. Der Beleg selbst bleibt unberührt (BAO §131 /
+RKSV) — das Versandprotokoll führt das Backend neben ihm.
+
+Die Kasse kommt aus der Anmeldung (Kopfzeile `cashregister-token` bzw. der
+Parameter, den `registerUserAuth` setzt), nicht aus den Optionen; ein Beleg
+einer anderen Kasse ist deshalb dieselbe Auskunft wie ein Beleg, den es nicht
+gibt. Auch hier gilt: **am Code entscheiden, nicht am Text.** Die Codes stehen
+in `RECEIPT_EMAIL_ERROR_CODES` (`isReceiptEmailErrorCode`):
+`adresse_ungueltig`, `beleg_nicht_gefunden`, `zu_oft` (5 Mails je Beleg in 24
+Stunden, 30 je Kasse und Stunde) und `versand_fehlgeschlagen`.
+
 ## Partner-API (`./partner`)
 
 Für Softwarehäuser, die Kasseneck in ihr eigenes Produkt einbauen: Betriebe

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

@@ -3,7 +3,7 @@ import { type CreateStripeLinkOptions, type StripeCaptureResult } from '../payme
 import { type HobexPayOptions, type HobexRefundOptions } from '../payments/hobex.js';
 import { type TransportOptions } from './transport.js';
 import { type CashboxStatus, type SignatureStatus } from './status.js';
-import { type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
+import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
 /**
  * Schlichte Factory ueber den Endpunkt-Funktionen: bindet einen Transport
  * einmal und liefert die Aufrufe ohne den wiederkehrenden ersten Parameter.
@@ -47,6 +47,8 @@ export interface KasseneckApi {
     generateFullReceiptId(receiptId: string): Promise<string>;
     /** Berichtsmonat des ersten Belegs (nicht fuer den Kassen-Benutzer-Weg). */
     getFirstReceiptDate(): Promise<ReportMonth>;
+    /** Beleg als Link auf die oeffentliche Belegseite per E-Mail schicken. */
+    sendReceiptEmail(options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
     /** Belegliste einer Kasse samt Kennzahlen (nur mit ID-Token, siehe receipts.ts). */
     listMyReceipts(options: ListMyReceiptsOptions): Promise<ReceiptList>;
     /** Kassen des angemeldeten Benutzers (nur mit ID-Token, siehe cashregisters.ts). */

package/dist/cjs/client/api.js

@@ -25,6 +25,7 @@ function createKasseneckApi(options) {
         generateFullReceiptId: (receiptId) => (0, receipts_js_1.generateFullReceiptId)(rufen, receiptId),
         getFirstReceiptDate: () => (0, receipts_js_1.getFirstReceiptDate)(rufen),
         listMyReceipts: (o) => (0, receipts_js_1.listMyReceipts)(rufen, o),
+        sendReceiptEmail: (o) => (0, receipts_js_1.sendReceiptEmail)(rufen, o),
         listMyCashregisters: () => (0, cashregisters_js_1.listMyCashregisters)(rufen),
         downloadDailyReport: (date) => (0, reports_js_1.downloadDailyReport)(rufenBinaer, date),
         downloadMonthlyReport: (reportMonth) => (0, reports_js_1.downloadMonthlyReport)(rufenBinaer, reportMonth),

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", "listRegisterSessionsForDevice", "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", "sendReceiptEmail", "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

@@ -46,6 +46,7 @@ exports.AUFRUFE = [
     'requestCustomerSignature',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
+    'sendReceiptEmail',
     'setMyKasseSettings',
     'setMyRegisterDeviceSettings',
     'stripeCaptureIntent',

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

@@ -2,7 +2,7 @@ export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
 export { AUFRUFE, type Aufruf, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/cjs/client/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.checkVoucherCombinationError = 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 = exports.AUFRUFE = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
+exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.sendReceiptEmail = exports.checkVoucherCombinationError = 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 = exports.AUFRUFE = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
 Object.defineProperty(exports, "registerUserAuth", { enumerable: true, get: function () { return auth_js_1.registerUserAuth; } });
@@ -34,6 +34,7 @@ Object.defineProperty(exports, "generateFullReceiptId", { enumerable: true, get:
 Object.defineProperty(exports, "getFirstReceiptDate", { enumerable: true, get: function () { return receipts_js_1.getFirstReceiptDate; } });
 Object.defineProperty(exports, "listMyReceipts", { enumerable: true, get: function () { return receipts_js_1.listMyReceipts; } });
 Object.defineProperty(exports, "checkVoucherCombinationError", { enumerable: true, get: function () { return receipts_js_1.checkVoucherCombinationError; } });
+Object.defineProperty(exports, "sendReceiptEmail", { enumerable: true, get: function () { return receipts_js_1.sendReceiptEmail; } });
 var cashregisters_js_1 = require("./cashregisters.js");
 Object.defineProperty(exports, "listMyCashregisters", { enumerable: true, get: function () { return cashregisters_js_1.listMyCashregisters; } });
 var reports_js_1 = require("./reports.js");

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

@@ -117,6 +117,14 @@ export type CancelReceiptOptions = {
     note?: string;
     /** Rueckzahlweg; ohne Angabe die Zahlungsart des stornierten Belegs. */
     paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
+    /**
+     * Kartendaten der ERSTATTUNG (Gutschrift oder Aufhebung am Terminal) fuer
+     * den Kartenblock am Storno-Bon -- nur bei Rueckzahlweg Karte. Beschreiben
+     * nie die Originalzahlung; das Backend uebernimmt sie nicht vom Original.
+     */
+    creditCardProvider?: CreditCardProvider;
+    cardPaymentId?: string;
+    cardPaymentData?: Record<string, unknown>;
 } & ({
     receipt: Receipt;
     cashregisterId?: string;
@@ -277,6 +285,63 @@ export declare function generateFullReceiptId(rufen: InternerTransport, receiptI
  * (siehe Modulkommentar oben). Mit `apiKeyAuth` ist er offen.
  */
 export declare function getFirstReceiptDate(rufen: InternerTransport): Promise<ReportMonth>;
+/**
+ * Beleg per E-Mail an den Endkunden — die Eingabe von [sendReceiptEmail].
+ *
+ * `cashregisterId` steht hier bewusst **nicht**: der Geraeteweg bindet die
+ * Kasse ueber die Kopfzeile `cashregister-token`, der Kassen-Benutzer-Weg
+ * ueber den Parameter, den `registerUserAuth` ohnehin schon setzt. Eine
+ * dritte Stelle waere nur eine Gelegenheit, eine andere Kasse zu behaupten,
+ * als die, an der man angemeldet ist — und das Backend nimmt den Belegpfad aus
+ * der angemeldeten Kasse, nicht aus der Nutzlast.
+ */
+export interface SendReceiptEmailOptions {
+    /** Verschluesselte Volltext-Belegnummer (siehe [generateFullReceiptId]). */
+    fullReceiptId: string;
+    /** Empfaengeradresse, wie der Gast sie am Tresen nennt. */
+    to: string;
+    /**
+     * Sprache der Mail. Heute wertet das Backend genau `'de'` aus; der Parameter
+     * steht im Vertrag, damit eine zweite Sprache spaeter kein neuer Vertrag ist.
+     * Ohne Angabe geht das Feld gar nicht erst hinaus.
+     */
+    sprache?: string;
+}
+/** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
+export interface SendReceiptEmailResult {
+    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    to: string;
+    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
+    at: string;
+    /**
+     * Versandweg: `eigen` (Postfach des Betriebs), `plattform` oder
+     * `plattform-fallback`. `null`, wenn die Antwort ihn nicht nennt — das ist
+     * eine Auskunft ueber den Weg, keine ueber den Erfolg, und darf den
+     * bestaetigten Versand nicht zu einem Fehler machen.
+     */
+    via: string | null;
+}
+/**
+ * Schickt einen bereits ausgestellten Beleg als **Link auf die oeffentliche
+ * Belegseite** an eine Adresse (Endpunkt `sendReceiptEmail`, Backend
+ * beleg-mail-endpoints.js). Kein PDF im Anhang: die Belegseite fuehrt dasselbe
+ * Zeilenmodell wie Bildschirm und Bon und liefert dort auf Wunsch ein PDF.
+ *
+ * **Der Beleg bleibt unberuehrt** (BAO §131/RKSV): das Versandprotokoll fuehrt
+ * das Backend in einer Unter-Sammlung neben dem Beleg.
+ *
+ * **Am Code entscheiden, nie am Text:** fachliche Fehler kommen als
+ * [KasseneckApiError] mit `code` aus [RECEIPT_EMAIL_ERROR_CODES] heraus —
+ * `adresse_ungueltig`, `beleg_nicht_gefunden` (auch fuer einen Beleg einer
+ * fremden Kasse: das Backend gibt darueber bewusst keine Auskunft), `zu_oft`
+ * (5 Mails je Beleg in 24 Stunden, 30 je Kasse und Stunde) und
+ * `versand_fehlgeschlagen`. Dieses Paket reicht sie unveraendert durch und
+ * legt keine eigenen Codes an.
+ *
+ * **Kein Wiederholen ohne Zutun des Bedieners:** ein zweiter Versuch schickt
+ * eine zweite Mail und zaehlt auf die Schleuse.
+ */
+export declare function sendReceiptEmail(rufen: InternerTransport, options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von

package/dist/cjs/client/receipts.js

@@ -11,6 +11,7 @@ exports.getReceipt = getReceipt;
 exports.getReceiptWithCompany = getReceiptWithCompany;
 exports.generateFullReceiptId = generateFullReceiptId;
 exports.getFirstReceiptDate = getFirstReceiptDate;
+exports.sendReceiptEmail = sendReceiptEmail;
 exports.checkVoucherCombinationError = checkVoucherCombinationError;
 const index_js_1 = require("../enums/index.js");
 const index_js_2 = require("../models/index.js");
@@ -154,6 +155,24 @@ async function cancelReceipt(rufen, options) {
         params.note = options.note;
     if (options.paymentMethod != null)
         params.paymentMethod = gepruefteZahlungsart(options.paymentMethod);
+    const karte = options.creditCardProvider != null || options.cardPaymentId != null || options.cardPaymentData != null;
+    if (karte) {
+        // Ohne paymentMethod entscheidet das Backend an der Zahlungsart des
+        // Originals; ein ausdruecklich anderer Rueckzahlweg ist hier schon falsch.
+        if (params.paymentMethod != null && params.paymentMethod !== index_js_1.KeckPaymentMethod.creditCard.value) {
+            throw new errors_js_1.KasseneckValidationError('cancelReceipt', 'Kartendaten gibt es nur bei paymentMethod creditCard', 'request');
+        }
+        if (options.creditCardProvider != null) {
+            if (!Object.prototype.hasOwnProperty.call(index_js_1.CreditCardProvider, options.creditCardProvider)) {
+                throw new errors_js_1.KasseneckValidationError('cancelReceipt', `Kartenanbieter: unbekannter Schluessel "${options.creditCardProvider}"`, 'request');
+            }
+            params.creditCardProvider = options.creditCardProvider;
+        }
+        if (options.cardPaymentId != null && options.cardPaymentId !== '')
+            params.cardPaymentId = options.cardPaymentId;
+        if (options.cardPaymentData != null)
+            params.cardPaymentData = options.cardPaymentData;
+    }
     const daten = await rufen('cancelReceipt', params);
     const receipt = belegAusHuelle(daten, 'cancelReceipt');
     const huelle = daten;
@@ -309,6 +328,54 @@ async function getFirstReceiptDate(rufen) {
         throw antwortfehler('getFirstReceiptDate', 'Antwort enthaelt keinen lesbaren Zeitstempel');
     }
 }
+/**
+ * Schickt einen bereits ausgestellten Beleg als **Link auf die oeffentliche
+ * Belegseite** an eine Adresse (Endpunkt `sendReceiptEmail`, Backend
+ * beleg-mail-endpoints.js). Kein PDF im Anhang: die Belegseite fuehrt dasselbe
+ * Zeilenmodell wie Bildschirm und Bon und liefert dort auf Wunsch ein PDF.
+ *
+ * **Der Beleg bleibt unberuehrt** (BAO §131/RKSV): das Versandprotokoll fuehrt
+ * das Backend in einer Unter-Sammlung neben dem Beleg.
+ *
+ * **Am Code entscheiden, nie am Text:** fachliche Fehler kommen als
+ * [KasseneckApiError] mit `code` aus [RECEIPT_EMAIL_ERROR_CODES] heraus —
+ * `adresse_ungueltig`, `beleg_nicht_gefunden` (auch fuer einen Beleg einer
+ * fremden Kasse: das Backend gibt darueber bewusst keine Auskunft), `zu_oft`
+ * (5 Mails je Beleg in 24 Stunden, 30 je Kasse und Stunde) und
+ * `versand_fehlgeschlagen`. Dieses Paket reicht sie unveraendert durch und
+ * legt keine eigenen Codes an.
+ *
+ * **Kein Wiederholen ohne Zutun des Bedieners:** ein zweiter Versuch schickt
+ * eine zweite Mail und zaehlt auf die Schleuse.
+ */
+async function sendReceiptEmail(rufen, options) {
+    // Getrimmt, weil beides von Hand oder per Scanner ins Feld kommt und ein
+    // angehaengtes Leerzeichen sonst als ungueltige Adresse zurueckkaeme --
+    // nach einem Aufruf, der schon eine Zeile im Protokoll gekostet hat.
+    const fullReceiptId = typeof options.fullReceiptId === 'string' ? options.fullReceiptId.trim() : '';
+    const to = typeof options.to === 'string' ? options.to.trim() : '';
+    if (fullReceiptId === '') {
+        throw new errors_js_1.KasseneckValidationError('sendReceiptEmail', 'fullReceiptId fehlt', 'request');
+    }
+    if (to === '') {
+        throw new errors_js_1.KasseneckValidationError('sendReceiptEmail', 'to fehlt (Empfaengeradresse)', 'request');
+    }
+    // Die Adresse selbst wird hier NICHT geprueft: das Backend prueft sie mit
+    // kreiseck_validator und antwortet mit `adresse_ungueltig`. Eine zweite,
+    // eigene Regel im Paket koennte strenger sein als die des Backends und eine
+    // gueltige Adresse abweisen, ohne dass jemand die Abweichung bemerkt.
+    const params = { fullReceiptId, to };
+    if (options.sprache !== undefined && options.sprache !== '')
+        params.sprache = options.sprache;
+    const daten = await rufen('sendReceiptEmail', params);
+    if (typeof daten?.to !== 'string' || daten.to === '') {
+        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
+    }
+    if (typeof daten.at !== 'string' || daten.at === '') {
+        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
+    }
+    return { to: daten.to, at: daten.at, via: typeof daten.via === 'string' && daten.via !== '' ? daten.via : null };
+}
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von

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, 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 { 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, type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, 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, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, 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.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;
+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.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_ERROR_CODES = 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.sendReceiptEmail = 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 = exports.createBinaryTransport = exports.createTransport = 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; } });
@@ -29,6 +29,8 @@ Object.defineProperty(exports, "CANCELLATION_ERROR_CODES", { enumerable: true, g
 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, "RECEIPT_EMAIL_ERROR_CODES", { enumerable: true, get: function () { return index_js_2.RECEIPT_EMAIL_ERROR_CODES; } });
+Object.defineProperty(exports, "isReceiptEmailErrorCode", { enumerable: true, get: function () { return index_js_2.isReceiptEmailErrorCode; } });
 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; } });
@@ -77,6 +79,7 @@ Object.defineProperty(exports, "getFirstReceiptDate", { enumerable: true, get: f
 Object.defineProperty(exports, "listMyReceipts", { enumerable: true, get: function () { return index_js_3.listMyReceipts; } });
 Object.defineProperty(exports, "listMyCashregisters", { enumerable: true, get: function () { return index_js_3.listMyCashregisters; } });
 Object.defineProperty(exports, "checkVoucherCombinationError", { enumerable: true, get: function () { return index_js_3.checkVoucherCombinationError; } });
+Object.defineProperty(exports, "sendReceiptEmail", { enumerable: true, get: function () { return index_js_3.sendReceiptEmail; } });
 Object.defineProperty(exports, "downloadDailyReport", { enumerable: true, get: function () { return index_js_3.downloadDailyReport; } });
 Object.defineProperty(exports, "downloadMonthlyReport", { enumerable: true, get: function () { return index_js_3.downloadMonthlyReport; } });
 Object.defineProperty(exports, "getCashboxStatus", { enumerable: true, get: function () { return index_js_3.getCashboxStatus; } });

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

@@ -2,6 +2,7 @@ export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead,
 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, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
+export { type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, } from './receipt-email.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.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;
+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.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_ERROR_CODES = 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; } });
@@ -25,6 +25,9 @@ Object.defineProperty(exports, "CANCELLATION_RESERVATION_MS", { enumerable: true
 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_email_js_1 = require("./receipt-email.js");
+Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_CODES", { enumerable: true, get: function () { return receipt_email_js_1.RECEIPT_EMAIL_ERROR_CODES; } });
+Object.defineProperty(exports, "isReceiptEmailErrorCode", { enumerable: true, get: function () { return receipt_email_js_1.isReceiptEmailErrorCode; } });
 var receipt_company_js_1 = require("./receipt-company.js");
 Object.defineProperty(exports, "fromReceiptCompanyPayload", { enumerable: true, get: function () { return receipt_company_js_1.fromReceiptCompanyPayload; } });
 Object.defineProperty(exports, "receiptCompanyTaxInfo", { enumerable: true, get: function () { return receipt_company_js_1.receiptCompanyTaxInfo; } });

package/dist/cjs/models/receipt-email.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Beleg per E-Mail — Zwilling von `functions/beleg-mail-core.js`.
+ *
+ * Hier steht nur der Fehlercode-Katalog: der Aufruf selbst ist
+ * [sendReceiptEmail] (client/receipts.ts), und was verschickt wird, ist ein
+ * **Link auf die oeffentliche Belegseite** — der Beleg selbst bleibt
+ * unberuehrt (BAO §131/RKSV), das Versandprotokoll fuehrt das Backend in einer
+ * Unter-Sammlung neben ihm.
+ */
+/**
+ * Stabile Fehlercodes von `sendReceiptEmail` — Zwilling von
+ * `beleg-mail-core.js` 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 RECEIPT_EMAIL_ERROR_CODES: readonly ["adresse_ungueltig", "beleg_nicht_gefunden", "zu_oft", "versand_fehlgeschlagen"];
+export type ReceiptEmailErrorCode = (typeof RECEIPT_EMAIL_ERROR_CODES)[number];
+export declare function isReceiptEmailErrorCode(value: unknown): value is ReceiptEmailErrorCode;

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

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Beleg per E-Mail — Zwilling von `functions/beleg-mail-core.js`.
+ *
+ * Hier steht nur der Fehlercode-Katalog: der Aufruf selbst ist
+ * [sendReceiptEmail] (client/receipts.ts), und was verschickt wird, ist ein
+ * **Link auf die oeffentliche Belegseite** — der Beleg selbst bleibt
+ * unberuehrt (BAO §131/RKSV), das Versandprotokoll fuehrt das Backend in einer
+ * Unter-Sammlung neben ihm.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECEIPT_EMAIL_ERROR_CODES = void 0;
+exports.isReceiptEmailErrorCode = isReceiptEmailErrorCode;
+/**
+ * Stabile Fehlercodes von `sendReceiptEmail` — Zwilling von
+ * `beleg-mail-core.js` 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.RECEIPT_EMAIL_ERROR_CODES = [
+    'adresse_ungueltig', // Empfaengeradresse unbrauchbar (Pruefung im Backend)
+    'beleg_nicht_gefunden', // Beleg gibt es nicht ODER er gehoert einer anderen Kasse
+    'zu_oft', // Schleuse: 5 Mails je Beleg (24 h), 30 je Kasse und Stunde
+    'versand_fehlgeschlagen', // die Mail selbst ging nicht hinaus
+];
+function isReceiptEmailErrorCode(value) {
+    return typeof value === 'string' && exports.RECEIPT_EMAIL_ERROR_CODES.includes(value);
+}

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

@@ -3,7 +3,7 @@ import { type CreateStripeLinkOptions, type StripeCaptureResult } from '../payme
 import { type HobexPayOptions, type HobexRefundOptions } from '../payments/hobex.js';
 import { type TransportOptions } from './transport.js';
 import { type CashboxStatus, type SignatureStatus } from './status.js';
-import { type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
+import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions } from './receipts.js';
 /**
  * Schlichte Factory ueber den Endpunkt-Funktionen: bindet einen Transport
  * einmal und liefert die Aufrufe ohne den wiederkehrenden ersten Parameter.
@@ -47,6 +47,8 @@ export interface KasseneckApi {
     generateFullReceiptId(receiptId: string): Promise<string>;
     /** Berichtsmonat des ersten Belegs (nicht fuer den Kassen-Benutzer-Weg). */
     getFirstReceiptDate(): Promise<ReportMonth>;
+    /** Beleg als Link auf die oeffentliche Belegseite per E-Mail schicken. */
+    sendReceiptEmail(options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
     /** Belegliste einer Kasse samt Kennzahlen (nur mit ID-Token, siehe receipts.ts). */
     listMyReceipts(options: ListMyReceiptsOptions): Promise<ReceiptList>;
     /** Kassen des angemeldeten Benutzers (nur mit ID-Token, siehe cashregisters.ts). */

package/dist/esm/client/api.js

@@ -3,7 +3,7 @@ import { hobexPay, hobexRefund } from '../payments/hobex.js';
 import { createTransport, createBinaryTransport } from './transport.js';
 import { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 import { getCashboxStatus, getSignatureStatus } from './status.js';
-import { sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, } from './receipts.js';
+import { sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, } from './receipts.js';
 import { listMyCashregisters } from './cashregisters.js';
 import { renewRegisterSession, endRegisterSession } from '../register/session.js';
 export function createKasseneckApi(options) {
@@ -22,6 +22,7 @@ export function createKasseneckApi(options) {
         generateFullReceiptId: (receiptId) => generateFullReceiptId(rufen, receiptId),
         getFirstReceiptDate: () => getFirstReceiptDate(rufen),
         listMyReceipts: (o) => listMyReceipts(rufen, o),
+        sendReceiptEmail: (o) => sendReceiptEmail(rufen, o),
         listMyCashregisters: () => listMyCashregisters(rufen),
         downloadDailyReport: (date) => downloadDailyReport(rufenBinaer, date),
         downloadMonthlyReport: (reportMonth) => downloadMonthlyReport(rufenBinaer, reportMonth),

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

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

package/dist/esm/client/aufrufe.js

@@ -43,6 +43,7 @@ export const AUFRUFE = [
     'requestCustomerSignature',
     'sendPartnerCustomerFonLink',
     'sendPartnerWebhookTest',
+    'sendReceiptEmail',
     'setMyKasseSettings',
     'setMyRegisterDeviceSettings',
     'stripeCaptureIntent',

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

@@ -2,7 +2,7 @@ export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
 export { AUFRUFE, type Aufruf, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/esm/client/index.js

@@ -2,7 +2,7 @@ export { apiKeyAuth, registerUserAuth, } from './auth.js';
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, } from './transport.js';
 export { AUFRUFE, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, checkVoucherCombinationError, } from './receipts.js';
+export { sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, checkVoucherCombinationError, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { getCashboxStatus, getSignatureStatus, } from './status.js';

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

@@ -117,6 +117,14 @@ export type CancelReceiptOptions = {
     note?: string;
     /** Rueckzahlweg; ohne Angabe die Zahlungsart des stornierten Belegs. */
     paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
+    /**
+     * Kartendaten der ERSTATTUNG (Gutschrift oder Aufhebung am Terminal) fuer
+     * den Kartenblock am Storno-Bon -- nur bei Rueckzahlweg Karte. Beschreiben
+     * nie die Originalzahlung; das Backend uebernimmt sie nicht vom Original.
+     */
+    creditCardProvider?: CreditCardProvider;
+    cardPaymentId?: string;
+    cardPaymentData?: Record<string, unknown>;
 } & ({
     receipt: Receipt;
     cashregisterId?: string;
@@ -277,6 +285,63 @@ export declare function generateFullReceiptId(rufen: InternerTransport, receiptI
  * (siehe Modulkommentar oben). Mit `apiKeyAuth` ist er offen.
  */
 export declare function getFirstReceiptDate(rufen: InternerTransport): Promise<ReportMonth>;
+/**
+ * Beleg per E-Mail an den Endkunden — die Eingabe von [sendReceiptEmail].
+ *
+ * `cashregisterId` steht hier bewusst **nicht**: der Geraeteweg bindet die
+ * Kasse ueber die Kopfzeile `cashregister-token`, der Kassen-Benutzer-Weg
+ * ueber den Parameter, den `registerUserAuth` ohnehin schon setzt. Eine
+ * dritte Stelle waere nur eine Gelegenheit, eine andere Kasse zu behaupten,
+ * als die, an der man angemeldet ist — und das Backend nimmt den Belegpfad aus
+ * der angemeldeten Kasse, nicht aus der Nutzlast.
+ */
+export interface SendReceiptEmailOptions {
+    /** Verschluesselte Volltext-Belegnummer (siehe [generateFullReceiptId]). */
+    fullReceiptId: string;
+    /** Empfaengeradresse, wie der Gast sie am Tresen nennt. */
+    to: string;
+    /**
+     * Sprache der Mail. Heute wertet das Backend genau `'de'` aus; der Parameter
+     * steht im Vertrag, damit eine zweite Sprache spaeter kein neuer Vertrag ist.
+     * Ohne Angabe geht das Feld gar nicht erst hinaus.
+     */
+    sprache?: string;
+}
+/** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
+export interface SendReceiptEmailResult {
+    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    to: string;
+    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
+    at: string;
+    /**
+     * Versandweg: `eigen` (Postfach des Betriebs), `plattform` oder
+     * `plattform-fallback`. `null`, wenn die Antwort ihn nicht nennt — das ist
+     * eine Auskunft ueber den Weg, keine ueber den Erfolg, und darf den
+     * bestaetigten Versand nicht zu einem Fehler machen.
+     */
+    via: string | null;
+}
+/**
+ * Schickt einen bereits ausgestellten Beleg als **Link auf die oeffentliche
+ * Belegseite** an eine Adresse (Endpunkt `sendReceiptEmail`, Backend
+ * beleg-mail-endpoints.js). Kein PDF im Anhang: die Belegseite fuehrt dasselbe
+ * Zeilenmodell wie Bildschirm und Bon und liefert dort auf Wunsch ein PDF.
+ *
+ * **Der Beleg bleibt unberuehrt** (BAO §131/RKSV): das Versandprotokoll fuehrt
+ * das Backend in einer Unter-Sammlung neben dem Beleg.
+ *
+ * **Am Code entscheiden, nie am Text:** fachliche Fehler kommen als
+ * [KasseneckApiError] mit `code` aus [RECEIPT_EMAIL_ERROR_CODES] heraus —
+ * `adresse_ungueltig`, `beleg_nicht_gefunden` (auch fuer einen Beleg einer
+ * fremden Kasse: das Backend gibt darueber bewusst keine Auskunft), `zu_oft`
+ * (5 Mails je Beleg in 24 Stunden, 30 je Kasse und Stunde) und
+ * `versand_fehlgeschlagen`. Dieses Paket reicht sie unveraendert durch und
+ * legt keine eigenen Codes an.
+ *
+ * **Kein Wiederholen ohne Zutun des Bedieners:** ein zweiter Versuch schickt
+ * eine zweite Mail und zaehlt auf die Schleuse.
+ */
+export declare function sendReceiptEmail(rufen: InternerTransport, options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von

package/dist/esm/client/receipts.js

@@ -140,6 +140,24 @@ export async function cancelReceipt(rufen, options) {
         params.note = options.note;
     if (options.paymentMethod != null)
         params.paymentMethod = gepruefteZahlungsart(options.paymentMethod);
+    const karte = options.creditCardProvider != null || options.cardPaymentId != null || options.cardPaymentData != null;
+    if (karte) {
+        // Ohne paymentMethod entscheidet das Backend an der Zahlungsart des
+        // Originals; ein ausdruecklich anderer Rueckzahlweg ist hier schon falsch.
+        if (params.paymentMethod != null && params.paymentMethod !== KeckPaymentMethod.creditCard.value) {
+            throw new KasseneckValidationError('cancelReceipt', 'Kartendaten gibt es nur bei paymentMethod creditCard', 'request');
+        }
+        if (options.creditCardProvider != null) {
+            if (!Object.prototype.hasOwnProperty.call(CreditCardProvider, options.creditCardProvider)) {
+                throw new KasseneckValidationError('cancelReceipt', `Kartenanbieter: unbekannter Schluessel "${options.creditCardProvider}"`, 'request');
+            }
+            params.creditCardProvider = options.creditCardProvider;
+        }
+        if (options.cardPaymentId != null && options.cardPaymentId !== '')
+            params.cardPaymentId = options.cardPaymentId;
+        if (options.cardPaymentData != null)
+            params.cardPaymentData = options.cardPaymentData;
+    }
     const daten = await rufen('cancelReceipt', params);
     const receipt = belegAusHuelle(daten, 'cancelReceipt');
     const huelle = daten;
@@ -295,6 +313,54 @@ export async function getFirstReceiptDate(rufen) {
         throw antwortfehler('getFirstReceiptDate', 'Antwort enthaelt keinen lesbaren Zeitstempel');
     }
 }
+/**
+ * Schickt einen bereits ausgestellten Beleg als **Link auf die oeffentliche
+ * Belegseite** an eine Adresse (Endpunkt `sendReceiptEmail`, Backend
+ * beleg-mail-endpoints.js). Kein PDF im Anhang: die Belegseite fuehrt dasselbe
+ * Zeilenmodell wie Bildschirm und Bon und liefert dort auf Wunsch ein PDF.
+ *
+ * **Der Beleg bleibt unberuehrt** (BAO §131/RKSV): das Versandprotokoll fuehrt
+ * das Backend in einer Unter-Sammlung neben dem Beleg.
+ *
+ * **Am Code entscheiden, nie am Text:** fachliche Fehler kommen als
+ * [KasseneckApiError] mit `code` aus [RECEIPT_EMAIL_ERROR_CODES] heraus —
+ * `adresse_ungueltig`, `beleg_nicht_gefunden` (auch fuer einen Beleg einer
+ * fremden Kasse: das Backend gibt darueber bewusst keine Auskunft), `zu_oft`
+ * (5 Mails je Beleg in 24 Stunden, 30 je Kasse und Stunde) und
+ * `versand_fehlgeschlagen`. Dieses Paket reicht sie unveraendert durch und
+ * legt keine eigenen Codes an.
+ *
+ * **Kein Wiederholen ohne Zutun des Bedieners:** ein zweiter Versuch schickt
+ * eine zweite Mail und zaehlt auf die Schleuse.
+ */
+export async function sendReceiptEmail(rufen, options) {
+    // Getrimmt, weil beides von Hand oder per Scanner ins Feld kommt und ein
+    // angehaengtes Leerzeichen sonst als ungueltige Adresse zurueckkaeme --
+    // nach einem Aufruf, der schon eine Zeile im Protokoll gekostet hat.
+    const fullReceiptId = typeof options.fullReceiptId === 'string' ? options.fullReceiptId.trim() : '';
+    const to = typeof options.to === 'string' ? options.to.trim() : '';
+    if (fullReceiptId === '') {
+        throw new KasseneckValidationError('sendReceiptEmail', 'fullReceiptId fehlt', 'request');
+    }
+    if (to === '') {
+        throw new KasseneckValidationError('sendReceiptEmail', 'to fehlt (Empfaengeradresse)', 'request');
+    }
+    // Die Adresse selbst wird hier NICHT geprueft: das Backend prueft sie mit
+    // kreiseck_validator und antwortet mit `adresse_ungueltig`. Eine zweite,
+    // eigene Regel im Paket koennte strenger sein als die des Backends und eine
+    // gueltige Adresse abweisen, ohne dass jemand die Abweichung bemerkt.
+    const params = { fullReceiptId, to };
+    if (options.sprache !== undefined && options.sprache !== '')
+        params.sprache = options.sprache;
+    const daten = await rufen('sendReceiptEmail', params);
+    if (typeof daten?.to !== 'string' || daten.to === '') {
+        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
+    }
+    if (typeof daten.at !== 'string' || daten.at === '') {
+        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
+    }
+    return { to: daten.to, at: daten.at, via: typeof daten.via === 'string' && daten.via !== '' ? daten.via : null };
+}
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, 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 { 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, type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, 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, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/esm/index.js

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

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

@@ -2,6 +2,7 @@ export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead,
 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, type CancellationErrorCode, CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
+export { type ReceiptEmailErrorCode, RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, } from './receipt-email.js';
 export { type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, } from './cashregister.js';
 export { type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

package/dist/esm/models/index.js

@@ -2,6 +2,7 @@ export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, re
 export { toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
 export { CANCELLATION_REASONS, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isCancellationErrorCode, remainingQuantities, } from './cancellation.js';
+export { RECEIPT_EMAIL_ERROR_CODES, isReceiptEmailErrorCode, } from './receipt-email.js';
 export { fromReceiptCompanyPayload, receiptCompanyTaxInfo, } from './receipt-company.js';
 export { fromCashregisterPayload, } from './cashregister.js';
 export { fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind } from './receipt-summary.js';

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

@@ -0,0 +1,22 @@
+/**
+ * Beleg per E-Mail — Zwilling von `functions/beleg-mail-core.js`.
+ *
+ * Hier steht nur der Fehlercode-Katalog: der Aufruf selbst ist
+ * [sendReceiptEmail] (client/receipts.ts), und was verschickt wird, ist ein
+ * **Link auf die oeffentliche Belegseite** — der Beleg selbst bleibt
+ * unberuehrt (BAO §131/RKSV), das Versandprotokoll fuehrt das Backend in einer
+ * Unter-Sammlung neben ihm.
+ */
+/**
+ * Stabile Fehlercodes von `sendReceiptEmail` — Zwilling von
+ * `beleg-mail-core.js` 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 RECEIPT_EMAIL_ERROR_CODES: readonly ["adresse_ungueltig", "beleg_nicht_gefunden", "zu_oft", "versand_fehlgeschlagen"];
+export type ReceiptEmailErrorCode = (typeof RECEIPT_EMAIL_ERROR_CODES)[number];
+export declare function isReceiptEmailErrorCode(value: unknown): value is ReceiptEmailErrorCode;

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

@@ -0,0 +1,28 @@
+/**
+ * Beleg per E-Mail — Zwilling von `functions/beleg-mail-core.js`.
+ *
+ * Hier steht nur der Fehlercode-Katalog: der Aufruf selbst ist
+ * [sendReceiptEmail] (client/receipts.ts), und was verschickt wird, ist ein
+ * **Link auf die oeffentliche Belegseite** — der Beleg selbst bleibt
+ * unberuehrt (BAO §131/RKSV), das Versandprotokoll fuehrt das Backend in einer
+ * Unter-Sammlung neben ihm.
+ */
+/**
+ * Stabile Fehlercodes von `sendReceiptEmail` — Zwilling von
+ * `beleg-mail-core.js` FEHLERCODES. Das Backend legt sie bei jedem fachlichen
+ * Fehler als `code` neben die Meldung; das Paket reicht sie als
+ * [KasseneckApiError.code] durch. **Entscheide am Code, nie am Text** — die
+ * deutsche Meldung darf sich aendern, der Code nicht.
+ *
+ * Nur Auth-/Parameterfehler (Sitzung abgelaufen, Pflichtfeld fehlt) kommen
+ * ohne Code; dort bleibt `code` undefined.
+ */
+export const RECEIPT_EMAIL_ERROR_CODES = [
+    'adresse_ungueltig', // Empfaengeradresse unbrauchbar (Pruefung im Backend)
+    'beleg_nicht_gefunden', // Beleg gibt es nicht ODER er gehoert einer anderen Kasse
+    'zu_oft', // Schleuse: 5 Mails je Beleg (24 h), 30 je Kasse und Stunde
+    'versand_fehlgeschlagen', // die Mail selbst ging nicht hinaus
+];
+export function isReceiptEmailErrorCode(value) {
+    return typeof value === 'string' && RECEIPT_EMAIL_ERROR_CODES.includes(value);
+}

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.11.0",
+  "version": "0.13.0",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.11.0",
+  "version": "0.13.0",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.11.0",
+  "version": "0.13.0",
   "aufrufe": [
     "activateCashregister",
     "cancelReceipt",
@@ -45,6 +45,7 @@
     "requestCustomerSignature",
     "sendPartnerCustomerFonLink",
     "sendPartnerWebhookTest",
+    "sendReceiptEmail",
     "setMyKasseSettings",
     "setMyRegisterDeviceSettings",
     "stripeCaptureIntent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "JavaScript-Zwilling von kasseneck_api (Flutter) fuer das Kasseneck-Backend",
   "license": "Apache-2.0",
   "author": "Kreiseck",