@kreiseck/kasseneck-api 0.31.0 → 1.0.0-rc.2

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

@@ -1,9 +1,9 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
-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 SellReceiptWithPaymentsOptions, 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 { DEFAULT_BASE_URL, POS_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 { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
+export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, type CancelReceiptResult, 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 { downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';
 export { type KasseneckApi, createKasseneckApi } from './api.js';

package/dist/esm/client/index.js

@@ -1,9 +1,9 @@
 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, sendReceiptEmail, } from './receipts.js';
+export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, } from './transport.js';
+export { ALL_CALLS, PUBLIC_CALLS, POS_CALLS, } from './aufrufe.js';
+export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
+export { sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, checkVoucherCombinationError, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
-export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
+export { downloadDailyReport, downloadMonthlyReport, getReportV2 } from './reports.js';
 export { getCashboxStatus, getSignatureStatus, } from './status.js';
 export { createKasseneckApi } from './api.js';

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

@@ -1,22 +1,30 @@
-import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider } from '../enums/index.js';
-import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type ReceiptPaymentInput } from '../models/index.js';
+import { ReceiptType, type ReceiptTypeKey, KeckPaymentMethod, type KeckPaymentMethodKey } from '../enums/index.js';
+import { type Receipt, type ReceiptCompany, type ReceiptItem, type Voucher, type ReceiptSummary, type ReportMonth, type CancellationItem, type CancellationOf, type CancellationReason, type ReceiptPaymentInput, type RegistrationInfo, type ReceiptEmailVia } from '../models/index.js';
 import type { InternerTransport } from './aufrufe.js';
-import type { Pruefangaben, ReceiptLayout } from '../receipt/layout.js';
-import type { LogoStufe } from '../receipt/blatt.js';
+import { type ReceiptLayout } from '../receipt/layout.js';
+import type { PosPaperSize } from '../printing/escpos.js';
+import type { SheetLogoSize } from '../receipt/blatt.js';
 /**
  * Beleg-Endpunkte — Zwilling der Beleg-Aufrufe in
  * kasseneck_api/lib/kasseneck_api.dart.
  *
- * **Verkauf, freier Storno und Nullbeleg laufen ueber einen einzigen
- * Backend-Endpunkt `createReceipt`.** `sellReceipt`, `createCancelReceipt` und
- * `zeroReceipt` sind — wie im Flutter-Vorbild — benannte Bequemlichkeits-
- * schichten ueber [createReceipt]; sie legen den Belegtyp fest und reichen den
- * Rest durch. **[cancelReceipt] geht an den eigenen Endpunkt `cancelReceipt`**:
- * der Server negiert die Positionen des Originals, prueft Restmengen und
- * Rechte und verkettet beide Belege (Storno-API).
+ * **Draht `/v3`, englisch.** Verkauf und Nullbeleg laufen ueber den
+ * Endpunkt `createReceipt`; `sellReceipt` und `zeroReceipt` legen den
+ * Belegtyp fest und reichen den Rest durch. Bezahlt wird immer ueber
+ * `payments[]` (Pflicht unter `/v3`); `paymentMethod` und die Kartenfelder am
+ * Beleg gibt es nicht mehr, die Kartenangaben stehen in der einzelnen
+ * Zahlung. Den Zahlbetrag rechnet `receiptDueCents` vorher aus.
+ * **[cancelReceipt] geht an den eigenen Endpunkt `cancelReceipt`**: der
+ * Server negiert die Positionen des Originals, prueft Restmengen und Rechte
+ * und verkettet beide Belege. Einen Storno ueber `createReceipt` gibt es
+ * nicht mehr.
  *
  * **Kein Wiederholen fehlgeschlagener Aufrufe** (siehe transport.ts): ein
- * Beleg ist nicht folgenlos wiederholbar.
+ * Beleg ist nicht folgenlos wiederholbar. Bei `outcome: 'unknown'`
+ * (`receipt_outcome_unknown`, `cancellation_outcome_unknown`, Netz- oder
+ * Serverfehler nach dem Senden) erst nachlesen, und bei
+ * `payments_sum_mismatch` nennt [paymentsExpectedCents] den Betrag des
+ * Servers; auch dann wiederholt das Paket nie selbst.
  *
  * **Kassen-Benutzer-Weg (`registerUserAuth`, Browser-Kasse):** Von den
  * Endpunkten dieser Datei setzen [listMyReceipts], [getReceipt],
@@ -32,14 +40,8 @@ export interface ReceiptCommonOptions {
     customerDetails?: string[];
     /** Rechtshinweise (z. B. Reverse Charge); gehen als `\n`-verbundene Zeichenkette raus. */
     legalMessage?: string[];
-    /** Kartenanbieter; ohne Angabe gilt `custom`. */
-    creditCardProvider?: CreditCardProvider;
-    /** Transaktionsbezeichner der Kartenzahlung. */
-    cardPaymentId?: string;
     /** Freier Bezeichner des Aufrufers (Projekt, Auftrag, Schicht). */
     customProjectId?: string;
-    /** Rohdaten der Kartenzahlung (Terminal-/Anbieterantwort). */
-    cardPaymentData?: Record<string, unknown>;
     /**
      * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
      * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte
@@ -51,7 +53,7 @@ export interface ReceiptCommonOptions {
 /** Trinkgeld mit eigener Zahlart und/oder Empfaengern (Kassen-Benutzer-IDs, Summe = cents). */
 export interface TipOptions {
     cents: number;
-    /** Zahlart des Trinkgelds; ohne Angabe gilt die des Belegs. */
+    /** Zahlart des Trinkgelds; bei mehreren Zahlarten Pflicht (`tip_payment_method_required`). */
     paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
     /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
     recipients?: TipRecipientShare[];
@@ -70,60 +72,35 @@ export interface TipOptions {
      * das nicht am Geraet umstellen koennen. Ueber einen Geraete-API-Schluessel
      * (ohne angemeldeten Kassen-Benutzer) gilt die Einschraenkung nicht.
      */
-    sofortErhalten?: boolean;
+    receivedImmediately?: boolean;
 }
 export interface TipRecipientShare {
     registerUserId: string;
     cents: number;
 }
-/** Belegtyp und Inhalt — die vollstaendige Eingabe von [createReceipt]. */
+/** Belegtyp und Inhalt, die vollstaendige Eingabe von [createReceipt]. */
 export interface CreateReceiptOptions extends ReceiptCommonOptions {
     receiptType: ReceiptType | ReceiptTypeKey;
-    /** Zahlungsart des Aufrufers — wird vor dem Senden geprueft. */
-    paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
-    /**
-     * Zahlungsart, die aus einer **Serverantwort** stammt (Storno eines
-     * gelesenen Belegs). Geht ungeprueft hinaus: der
-     * Server hat den Wert selbst vergeben und weist unbekannte selbst ab —
-     * ergaenzt er eine Zahlungsart vor dem naechsten Paket-Update, waeren sonst
-     * alle Belege damit unstornierbar. Nur fuer diesen einen Weg gedacht; eine
-     * ausdruecklich uebergebene `paymentMethod` sticht.
-     */
-    paymentMethodFromServer?: string;
     /**
-     * Mehrere Zahlungen je Beleg (siehe [ReceiptPaymentInput]). Schliesst
-     * `paymentMethod`, `paymentMethodFromServer` und die Kartenfelder aus —
-     * die Kartenangaben gehoeren dann in die einzelne Zahlung (Backend:
-     * `PAYMENTS_CONFLICT`). Nur bei `standard` und `training`.
+     * Zahlungen (siehe [ReceiptPaymentInput]); bei `standard` und `training`
+     * Pflicht, auch leer, wenn der Zahlbetrag 0 ist. Null- und Startbeleg
+     * nehmen keine (`payments_not_allowed`). Die Summe muss
+     * [receiptDueCents] treffen.
      */
     payments?: ReceiptPaymentInput[];
     items?: ReceiptItem[];
     vouchers?: Voucher[];
 }
-/** Verkauf mit einer Zahlungsart (`paymentMethod`, Kartenfelder aus [ReceiptCommonOptions]). */
-export interface SellReceiptOptions extends ReceiptCommonOptions {
-    paymentMethod: KeckPaymentMethod | KeckPaymentMethodKey;
-    payments?: undefined;
-    items?: ReceiptItem[];
-    vouchers?: Voucher[];
-}
 /**
- * Verkauf mit mehreren Zahlungen (`payments`, siehe [ReceiptPaymentInput]).
- * Ohne `paymentMethod` und ohne die Kartenfelder aus [ReceiptCommonOptions] —
- * die Kartenangaben stehen in der einzelnen Zahlung (Backend:
- * `PAYMENTS_CONFLICT`, zur Laufzeit ebenso geprueft).
+ * Verkauf: Positionen, Gutscheine, Trinkgeld und die Zahlungen. Die
+ * Kartenangaben (`provider`, `providerPaymentId`, `providerData`) stehen in
+ * der einzelnen Zahlung; die Summe der Zahlungen ist [receiptDueCents].
  */
-export interface SellReceiptWithPaymentsOptions extends ReceiptCommonOptions {
+export interface SellReceiptOptions extends ReceiptCommonOptions {
     payments: ReceiptPaymentInput[];
-    paymentMethod?: undefined;
     items?: ReceiptItem[];
     vouchers?: Voucher[];
 }
-/**
- * `customerDetails` fehlt hier absichtlich (wie im Flutter-Vorbild): die
- * Kundendaten des Stornos sind die des stornierten Belegs, sonst stimmten
- * Beleg und Storno nicht mehr ueberein.
- */
 /**
  * Storno ueber den Endpunkt `cancelReceipt` (Backend: storno-endpoints.js).
  * Der Server negiert die Positionen, prueft Restmengen und Rechte, verkettet
@@ -137,22 +114,17 @@ export type CancelReceiptOptions = {
     items?: CancellationItem[];
     /** Interne Anmerkung (≤ 200 Zeichen), wird gespeichert, nie gedruckt. */
     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>;
     /**
      * Rueckzahlung je Zahlung (Betraege negativ, `refundOf` = `id` der
-     * Originalzahlung). Schliesst `paymentMethod` und die Kartenfelder aus
-     * (Backend: `PAYMENTS_CONFLICT`). Ohne Angabe spiegelt der Server die
-     * Restbetraege jeder Originalzahlung; ein Teilstorno eines Belegs mit
-     * mehreren Zahlungen braucht sie (`STORNO_PAYMENTS_REQUIRED`).
+     * Originalzahlung). Ohne Angabe spiegelt der Server die Restbetraege jeder
+     * Originalzahlung; ein Teilstorno eines Belegs mit mehreren Zahlungen
+     * braucht sie (`cancellation_payments_required`).
+     *
+     * **Karten-Storno:** `provider`, `providerPaymentId` und `providerData`
+     * beschreiben die ERSTATTUNG am Terminal, nie die Originalzahlung. Die
+     * Kennung der Originalzahlung (fuer die Rueckbuchung am Terminal) steht in
+     * `payments[].providerPaymentId` des Originals; die liefert nur der
+     * Kassenweg (Kanal `app`, `registerUserAuth`).
      */
     payments?: ReceiptPaymentInput[];
 } & ({
@@ -170,11 +142,6 @@ export interface CancelReceiptResult {
     cancellationOf: CancellationOf;
     remaining: number[];
 }
-export interface CreateCancelReceiptOptions extends ReceiptCommonOptions {
-    paymentMethod: KeckPaymentMethod | KeckPaymentMethodKey;
-    /** Positionen, wie sie auf dem Storno stehen sollen — **nicht** negiert. */
-    items: ReceiptItem[];
-}
 /**
  * Beleg **und** die Firmen-/Druckdaten derselben Antwort — das Ergebnis der
  * `…WithCompany`-Varianten. Das Backend liefert beides in einem Aufruf
@@ -186,25 +153,45 @@ export interface ReceiptWithCompany {
     /** Kopf/Fuss, wie sie fuer DIESEN Beleg gelten (eingefrorene Version des Backends). */
     company: ReceiptCompany;
     /** Beleg einer Testumgebung (Aufdruck TESTKASSE). */
-    testKasse: boolean;
+    testCashregister: boolean;
     /** Produktionskonto mit Test-Signatureinheit (Aufdruck TESTSIGNATUR). */
-    testSignatur: boolean;
-    /** Kennung der Kopf-Version; null bei altem Backend/Altbeleg ohne Zuordnung. */
-    kopfId: string | null;
-    /** Vom Backend gebautes Zeilenmodell (Regelwerk des Belegs); null, wenn nicht mitgeliefert. */
+    testSignature: boolean;
+    /** Kennung der Kopf-Version; null bei Altbeleg ohne Zuordnung. */
+    headerVersionId: string | null;
+    /**
+     * Vom Backend gebautes Zeilenmodell (`data.layout`, Regelwerk des Belegs,
+     * 80 mm); null, wenn nicht mitgeliefert. Es geht unveraendert an
+     * `escPosLayoutBytes`, `eposPrintXml`, `receiptSheet` und die React-Ansichten.
+     * Drucken und anzeigen ueber [receiptLayoutFromResult].
+     */
     layout: ReceiptLayout | null;
     /**
-     * Registrierdaten fuer den Block „Prüfangaben“ (Nullbelege, Regelwerk 2) --
-     * fuer Clients, die das Layout selbst bauen; null bei altem Backend.
+     * Registrierdaten fuer den Block „Prüfangaben“ (Nullbelege, Regelwerk 2),
+     * fuer Clients, die das Layout selbst bauen; null bei anderen Belegen.
      */
-    pruefangaben: Pruefangaben | null;
+    registrationInfo: RegistrationInfo | null;
     /**
-     * Groesse des Firmenlogos am Beleg (Kasse-Einstellung `logoSkala` des
-     * Betriebs). Bildschirm, Bon und PDF setzen das Logo in genau dieser Stufe;
-     * liefert das Backend sie nicht (alt), gilt `M` -- der Bestandswert.
+     * Groesse des Firmenlogos am Beleg (`logo_scale`). Bildschirm, Bon und PDF
+     * setzen das Logo in genau dieser Stufe; fehlt der Wert, gilt `M`.
      */
-    logoStufe: LogoStufe;
+    logoScale: SheetLogoSize;
 }
+/**
+ * Das Zeilenmodell zum Drucken und Anzeigen eines Belegs aus einer Antwort.
+ *
+ * **Ein Server-Layout gewinnt immer.** Liefert der Server `data.layout`, gilt
+ * genau dieses, in seiner Breite (80 mm): im oeffentlichen Kanal traegt nur
+ * es den Kartenblock (der Beleg selbst kommt dort ohne Anbieterdaten), und
+ * Bildschirm, Bon und PDF zeigen so denselben Beleg. Fehlt es, wird das
+ * Layout hier gebaut, mit den Angaben derselben Antwort (`testCashregister`,
+ * `testSignature`, `registrationInfo`) und in `fallbackPaperSize` (Vorgabe
+ * `mm58` wie in 0.x). Die Druckbreite waehlt allein der Druckweg
+ * (`paperSize` bei `escPosLayoutBytes`, `charsPerLine` bei ePOS und Blatt), nie
+ * dieser Helfer.
+ */
+export declare function receiptLayoutFromResult(result: ReceiptWithCompany, options?: {
+    fallbackPaperSize?: PosPaperSize;
+}): ReceiptLayout;
 /**
  * Gemeinsame Umsetzung aller Belegarten (Zwilling von `_createReceipt`).
  * Bewusst **nicht** Teil der Paketoberflaeche: der Belegtyp gehoert nicht in
@@ -212,33 +199,21 @@ export interface ReceiptWithCompany {
  */
 export declare function createReceipt(rufen: InternerTransport, options: CreateReceiptOptions): Promise<Receipt>;
 /** Normalbeleg (Verkauf) nach RKSV. */
-export declare function sellReceipt(rufen: InternerTransport, options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<Receipt>;
+export declare function sellReceipt(transport: InternerTransport, options: SellReceiptOptions): Promise<Receipt>;
 /**
  * Normalbeleg wie [sellReceipt], liefert zusaetzlich die Firmen-/Druckdaten
  * aus derselben Antwort — alles, was ein Belegdruck braucht, in einem Aufruf.
  */
-export declare function sellReceiptWithCompany(rufen: InternerTransport, options: SellReceiptOptions | SellReceiptWithPaymentsOptions): Promise<ReceiptWithCompany>;
+export declare function sellReceiptWithCompany(transport: InternerTransport, options: SellReceiptOptions): Promise<ReceiptWithCompany>;
 /**
  * Storno-Beleg zu einem bestehenden Beleg — voll oder in Teilen. Prueft die
  * Eingabe, bevor etwas hinausgeht; der Server haelt die Restmengen und die
  * Reichweite des Rechts (eigene/alle) und antwortet mit dem fertigen,
  * signierten Storno-Beleg. Gutscheine des Originals wandern nicht mit.
  */
-export declare function cancelReceipt(rufen: InternerTransport, options: CancelReceiptOptions): Promise<CancelReceiptResult>;
-/**
- * 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>;
+export declare function cancelReceipt(transport: InternerTransport, options: CancelReceiptOptions): Promise<CancelReceiptResult>;
 /** Nullbeleg (RKSV-Pruefbeleg) — ohne Positionen und ohne Zahlungsart. */
-export declare function zeroReceipt(rufen: InternerTransport): Promise<Receipt>;
+export declare function zeroReceipt(transport: InternerTransport): Promise<Receipt>;
 /** Belegliste einer Kasse samt der Kennzahlen, die dieselbe Antwort mitliefert. */
 export interface ReceiptList {
     /** Letzte Belege, neueste zuerst (Backend: nach `counter` absteigend). */
@@ -266,12 +241,7 @@ export interface ReceiptListStats {
     }>;
 }
 export interface ListMyReceiptsOptions {
-    /**
-     * Kasse, deren Belege gelistet werden. Geht als Parameter **`cashregisterid`**
-     * hinaus — klein geschrieben, anders als das `cashregisterId` der Anmeldung:
-     * so heisst der Pflichtparameter dieses Endpunkts im Backend, und ein
-     * Tippfehler faellt sonst erst im Betrieb auf.
-     */
+    /** Kasse, deren Belege gelistet werden (Parameter `cashregisterId`). */
     cashregisterId: string;
     /**
      * Anzahl Belege; ohne Angabe nimmt das Backend 50. Es begrenzt den Wert
@@ -297,21 +267,21 @@ export interface ListMyReceiptsOptions {
  * (der Endpunkt laeuft mit `checkCashRegister: false`), ein Kassen-Benutzer
  * bekommt also nur die ihm zugewiesenen Kassen.
  */
-export declare function listMyReceipts(rufen: InternerTransport, options: ListMyReceiptsOptions): Promise<ReceiptList>;
+export declare function listMyReceipts(transport: InternerTransport, options: ListMyReceiptsOptions): Promise<ReceiptList>;
 /** Einzelnen Beleg der angemeldeten Kasse holen. */
-export declare function getReceipt(rufen: InternerTransport, receiptId: string): Promise<Receipt>;
+export declare function getReceipt(transport: InternerTransport, receiptId: string): Promise<Receipt>;
 /**
  * Wie [getReceipt], liefert zusaetzlich die Firmen-/Druckdaten aus derselben
  * Antwort (Firma, Anschrift, Steuernummer, UID, Fusszeilen, Logo-Adresse,
  * Kleinunternehmer-Kennzeichen) — die Angaben, die ein Beleg im Kopf und Fuss
  * traegt (siehe models/receipt-company.ts).
  */
-export declare function getReceiptWithCompany(rufen: InternerTransport, receiptId: string): Promise<ReceiptWithCompany>;
+export declare function getReceiptWithCompany(transport: InternerTransport, receiptId: string): Promise<ReceiptWithCompany>;
 /**
  * Verschluesselte Volltext-Belegnummer erzeugen — der Bezeichner, unter dem der
  * Beleg oeffentlich abrufbar ist (Beleg-Download, Pruefportal).
  */
-export declare function generateFullReceiptId(rufen: InternerTransport, receiptId: string): Promise<string>;
+export declare function generateFullReceiptId(transport: InternerTransport, receiptId: string): Promise<string>;
 /**
  * Berichtsmonat des allerersten Belegs dieser Kasse — die untere Grenze aller
  * Monatsberichte.
@@ -320,7 +290,7 @@ export declare function generateFullReceiptId(rufen: InternerTransport, receiptI
  * fuehrt kein `allowRegisterUser`, das Backend weist die Browser-Kasse hier ab
  * (siehe Modulkommentar oben). Mit `apiKeyAuth` ist er offen.
  */
-export declare function getFirstReceiptDate(rufen: InternerTransport): Promise<ReportMonth>;
+export declare function getFirstReceiptDate(transport: InternerTransport): Promise<ReportMonth>;
 /**
  * Beleg per E-Mail an den Endkunden — die Eingabe von [sendReceiptEmail].
  *
@@ -341,7 +311,7 @@ export interface SendReceiptEmailOptions {
      * steht im Vertrag, damit eine zweite Sprache spaeter kein neuer Vertrag ist.
      * Ohne Angabe geht das Feld gar nicht erst hinaus.
      */
-    sprache?: string;
+    language?: string;
 }
 /** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
 export interface SendReceiptEmailResult {
@@ -350,12 +320,13 @@ export interface SendReceiptEmailResult {
     /** 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.
+     * Versandweg: `own` (Postfach des Betriebs), `platform` oder
+     * `platform_fallback` ([RECEIPT_EMAIL_VIAS]). `null`, wenn die Antwort ihn
+     * nicht oder mit einem unbekannten Wert 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;
+    via: ReceiptEmailVia | null;
 }
 /**
  * Schickt einen bereits ausgestellten Beleg als **Link auf die oeffentliche
@@ -367,17 +338,17 @@ export interface SendReceiptEmailResult {
  * 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
+ * [KasseneckApiError] mit `code` aus [RECEIPT_EMAIL_ERROR_CODES] heraus:
+ * `invalid_address`, `receipt_not_found` (auch fuer einen Beleg einer
+ * fremden Kasse: das Backend gibt darueber bewusst keine Auskunft),
+ * `too_many_requests` (5 Mails je Beleg in 24 Stunden, 30 je Kasse und
+ * Stunde) und `send_failed`. 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>;
+export declare function sendReceiptEmail(transport: InternerTransport, options: SendReceiptEmailOptions): Promise<SendReceiptEmailResult>;
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten
  * Regelverstoss als Text (oder `null`) — Zwilling von
@@ -385,3 +356,39 @@ export declare function sendReceiptEmail(rufen: InternerTransport, options: Send
  * eine Kassenoberflaeche will das pruefen, **bevor** sie den Beleg abschickt.
  */
 export declare function checkVoucherCombinationError(vouchers: Voucher[], items: ReceiptItem[]): string | null;
+/**
+ * Kennung der Originalzahlung fuer die Rueckbuchung am Terminal (Hobex
+ * `originalTransactionId`, SumUp-Transaktion, ...): `providerPaymentId` der
+ * Zahlung `paymentId` des Originals. Die liefert nur der Kassenweg (Kanal
+ * `app`, `registerUserAuth`); am oeffentlichen Weg fehlt sie, und dann wirft
+ * dieser Aufruf, statt `undefined` an ein Terminal weiterzugeben.
+ */
+export declare function cardRefundReference(receipt: Receipt, paymentId: string): string;
+/**
+ * `createReceipt` und `getReceipt` liefern den Beleg unter `data.receipt`,
+ * daneben die Firmen-/Druckdaten (Firma, Anschrift, Fusszeilen). Diese Lesart
+ * nimmt nur den Beleg: die Druckdaten gehoeren nicht zum RKSV-Kernbeleg (siehe
+ * models/receipt.ts), und die bestehenden Aufrufe sollen ihre Zusage behalten.
+ * Wer beides braucht, nimmt [belegMitFirmaAusHuelle] ueber die
+ * `…WithCompany`-Varianten.
+ *
+ * Paketintern exportiert, damit `./stored` gespeicherte Belege mit demselben
+ * Leser liest; nicht Teil der Paketoberflaeche.
+ */
+export declare function belegAusHuelle(daten: unknown, functionName: string): Receipt;
+/**
+ * Beleg **und** Firmendaten aus derselben Huelle. Der Beleg entscheidet:
+ * fehlt er, ist die Antwort unbrauchbar. Die Firmendaten duerfen dagegen
+ * luecken haben — ein Kundendokument ohne gepflegte Fusszeile ist kein Grund,
+ * einen ausgestellten Beleg nicht anzuzeigen (siehe models/receipt-company.ts).
+ * Paketintern exportiert wie [belegAusHuelle].
+ */
+export declare function belegMitFirmaAusHuelle(daten: unknown, functionName: string): ReceiptWithCompany;
+/**
+ * Zahlbetrag des Servers aus einem `payments_sum_mismatch`
+ * (`details.expectedCents`), sonst `undefined`. Das Paket wiederholt nie
+ * selbst mit diesem Betrag: eine Kartenzahlung ist schon belastet. Die Kasse
+ * entscheidet (Differenz nachkassieren oder erstatten) und schickt dann einen
+ * neuen Verkauf.
+ */
+export declare function paymentsExpectedCents(error: unknown): number | undefined;