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

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