@kreiseck/kasseneck-api 0.29.0 → 0.31.0

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

@@ -0,0 +1,86 @@
+import { KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider } from '../enums/index.js';
+/**
+ * Eine Zahlung am Beleg — Zwilling der Eintraege in `payments`, wie
+ * `functions/gemeinsam/zahlungen-core.js` (`pruefeZahlungen`) sie normalisiert
+ * und ablegt.
+ *
+ * Ein Beleg kann ueber mehrere Zahlungen bezahlt sein (zwei Karten, Rest bar).
+ * Dann steht die Liste unter `payments`, und das Einzelfeld `paymentMethod`
+ * ist `mixed`, sobald verschiedene Zahlarten vorkommen (zwei Karten ergeben
+ * `creditCard`). Altbelege haben keine Liste; dort gilt weiter
+ * `paymentMethod` samt Kartenfeldern.
+ *
+ * Betraege in ganzen Cent: am Verkauf positiv, am Storno negativ (Rueckzahlung).
+ * `method`/`provider` sind beim Lesen wie ueberall entweder der bekannte
+ * Enum-Eintrag oder der rohe Schluessel (siehe `enum-payload.ts`).
+ */
+export interface ReceiptPayment {
+    /** Vom Server vergeben (`p1`, `p2`, …); Bezugspunkt fuer `refundOf`. */
+    id?: string;
+    method: KeckPaymentMethod | string;
+    amountCents: number;
+    /** Nur bei Barzahlung: gegebener Betrag. */
+    tenderedCents?: number;
+    /** Nur neben `tenderedCents`: Rueckgeld (vom Server gerechnet). */
+    changeCents?: number;
+    /** Kartenanbieter bzw. Terminal. */
+    provider?: CreditCardProvider | string;
+    /** Kennung der Zahlung am Terminal/Anbieter. */
+    providerPaymentId?: string;
+    /** Terminaldaten fuer den Kartenblock (frueher `cardPaymentData`). */
+    providerData?: Record<string, unknown>;
+    /** Nur am Storno: `id` der Originalzahlung, die erstattet wird. */
+    refundOf?: string;
+    /**
+     * Trinkgeld, das mit dieser Zahlung gegeben wurde, in ganzen Cent — TEIL
+     * von `amountCents` (das Terminal bucht Betrag + Trinkgeld zusammen). Nur
+     * an Verkaufs-/Trainingsbelegen.
+     */
+    tipCents?: number;
+}
+/** Nutzlast-Form einer Zahlung (Backend-Dokument bzw. Antwort). */
+export interface ReceiptPaymentPayload {
+    id?: string;
+    method: string;
+    amountCents: number;
+    tenderedCents?: number;
+    changeCents?: number;
+    provider?: string;
+    providerPaymentId?: string;
+    providerData?: Record<string, unknown>;
+    refundOf?: string;
+    tipCents?: number;
+}
+/**
+ * Eine Zahlung, wie der Aufrufer sie an `createReceipt`/`sellReceipt`/
+ * `cancelReceipt` schickt. `id` und `changeCents` vergibt der Server.
+ *
+ * - `method`: jede Zahlungsart ausser `mixed`.
+ * - `amountCents`: ganze Cent, am Verkauf > 0, am Storno < 0.
+ * - `tenderedCents`: nur bei Barzahlung am Verkauf; jede Barzahlung darf ihren
+ *   eigenen gegebenen Betrag tragen (getrennt zahlen: Rueckgeld je Gast).
+ * - `provider`/`providerPaymentId`/`providerData`: bei Karten Pflicht
+ *   (`providerPaymentId` ausser bei `custom`), bei `online` optional, sonst
+ *   nicht erlaubt; am Storno beschreiben sie die Erstattung und sind optional.
+ * - `refundOf`: nur am Storno.
+ * - `tipCents`: Trinkgeld dieser Zahlung, ganze Cent > 0, Teil von
+ *   `amountCents`; nur am Verkauf, nie neben `tip` (den Rest prueft der Server).
+ */
+export interface ReceiptPaymentInput {
+    method: KeckPaymentMethod | KeckPaymentMethodKey;
+    amountCents: number;
+    tenderedCents?: number;
+    provider?: CreditCardProvider;
+    providerPaymentId?: string;
+    providerData?: Record<string, unknown>;
+    refundOf?: string;
+    tipCents?: number;
+}
+/** Lesepfad: nur vorhandene Felder uebernehmen, nichts ergaenzen. */
+export declare function fromReceiptPaymentPayload(payload: ReceiptPaymentPayload): ReceiptPayment;
+/**
+ * Schreibpfad: Zahlungen zurueck in die Nutzlast — streng wie
+ * `toReceiptPayload`: ein roher, unbekannter Schluessel bei `method` oder
+ * `provider` wirft.
+ */
+export declare function toReceiptPaymentPayload(payment: ReceiptPayment): ReceiptPaymentPayload;

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

@@ -0,0 +1,36 @@
+import { KeckPaymentMethod, CreditCardProvider } from '../enums/index.js';
+import { readEnumKey, requireEnumKey } from './enum-payload.js';
+/** Lesepfad: nur vorhandene Felder uebernehmen, nichts ergaenzen. */
+export function fromReceiptPaymentPayload(payload) {
+    return {
+        ...(typeof payload.id === 'string' ? { id: payload.id } : {}),
+        method: readEnumKey(KeckPaymentMethod, payload.method),
+        amountCents: payload.amountCents,
+        ...(typeof payload.tenderedCents === 'number' ? { tenderedCents: payload.tenderedCents } : {}),
+        ...(typeof payload.changeCents === 'number' ? { changeCents: payload.changeCents } : {}),
+        ...(typeof payload.provider === 'string' ? { provider: readEnumKey(CreditCardProvider, payload.provider) } : {}),
+        ...(typeof payload.providerPaymentId === 'string' ? { providerPaymentId: payload.providerPaymentId } : {}),
+        ...(payload.providerData != null && typeof payload.providerData === 'object' ? { providerData: payload.providerData } : {}),
+        ...(typeof payload.refundOf === 'string' ? { refundOf: payload.refundOf } : {}),
+        ...(typeof payload.tipCents === 'number' ? { tipCents: payload.tipCents } : {}),
+    };
+}
+/**
+ * Schreibpfad: Zahlungen zurueck in die Nutzlast — streng wie
+ * `toReceiptPayload`: ein roher, unbekannter Schluessel bei `method` oder
+ * `provider` wirft.
+ */
+export function toReceiptPaymentPayload(payment) {
+    return {
+        ...(payment.id !== undefined ? { id: payment.id } : {}),
+        method: typeof payment.method === 'object' ? payment.method.value : requireEnumKey(KeckPaymentMethod, payment.method, 'Zahlungsart').value,
+        amountCents: payment.amountCents,
+        ...(payment.tenderedCents !== undefined ? { tenderedCents: payment.tenderedCents } : {}),
+        ...(payment.changeCents !== undefined ? { changeCents: payment.changeCents } : {}),
+        ...(payment.provider !== undefined ? { provider: requireEnumKey(CreditCardProvider, payment.provider, 'Kartenanbieter') } : {}),
+        ...(payment.providerPaymentId !== undefined ? { providerPaymentId: payment.providerPaymentId } : {}),
+        ...(payment.providerData !== undefined ? { providerData: payment.providerData } : {}),
+        ...(payment.refundOf !== undefined ? { refundOf: payment.refundOf } : {}),
+        ...(payment.tipCents !== undefined ? { tipCents: payment.tipCents } : {}),
+    };
+}

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

@@ -1,4 +1,5 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
+import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -63,6 +64,13 @@ export interface ReceiptSummary {
     stornoStand: 'offen' | 'teil' | 'voll';
     /** Nur am Nullbeleg, nur fuer Kassen-Benutzer: Anlass (monthly, annual, annual_replacement, outage_end, final, manual). */
     zeroKind?: ZeroKind;
+    /**
+     * Zahlungsliste, nur bei Belegen, die eine tragen. Die Liste liefert nur
+     * die oeffentlichen Felder (id, method, amountCents, provider,
+     * tenderedCents, changeCents, refundOf, tipCents) — Anbieter-Interna
+     * (`providerPaymentId`, `providerData`) bleiben im Backend.
+     */
+    payments?: ReceiptPayment[];
 }
 export interface ReceiptSummaryPayload {
     receiptId?: string | null;
@@ -90,5 +98,6 @@ export interface ReceiptSummaryPayload {
     cancellationReason?: string | null;
     stornoStand?: string | null;
     zeroKind?: string | null;
+    payments?: ReceiptPaymentPayload[] | null;
 }
 export declare function fromReceiptSummaryPayload(payload: ReceiptSummaryPayload): ReceiptSummary;

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

@@ -1,6 +1,7 @@
 import { KeckPaymentMethod, ReceiptType } from '../enums/index.js';
 import { euroToCents } from '../money.js';
 import { readEnumKey } from './enum-payload.js';
+import { fromReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Belegzeile einer Liste — die Form, die `listMyReceipts` liefert
  * (`projectReceiptForCustomer` in functions/index.js).
@@ -48,5 +49,6 @@ export function fromReceiptSummaryPayload(payload) {
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         stornoStand: payload.stornoStand === 'teil' || payload.stornoStand === 'voll' ? payload.stornoStand : 'offen',
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
+        ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(fromReceiptPaymentPayload) } : {}),
     };
 }

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

@@ -3,6 +3,7 @@ import { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead
 import { type Voucher, type VoucherPayload } from './voucher.js';
 import type { Cancellation, CancellationOf, CancellationReason } from './cancellation.js';
 import { type ZeroKind } from './receipt-summary.js';
+import { type ReceiptPayment, type ReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Beleg — Zwilling der Beleg-Nutzlast von `KasseneckReceipt` in
  * kasseneck_api/lib/models/kasseneck_receipt.dart (nur der signatur-/
@@ -54,6 +55,12 @@ export interface Receipt {
     cancellations?: Cancellation[];
     /** Nur an Nullbelegen: Anlass (monthly, annual, annual_replacement, outage_end, final, manual). */
     zeroKind?: ZeroKind;
+    /**
+     * Zahlungsliste (mehrere Zahlungen je Beleg), nur vorhanden, wenn der Beleg
+     * sie traegt. Altbelege haben keine; dort gelten `paymentMethod` und die
+     * Kartenfelder. Siehe [ReceiptPayment].
+     */
+    payments?: ReceiptPayment[];
 }
 export interface ReceiptPayload {
     qr: string;
@@ -78,6 +85,8 @@ export interface ReceiptPayload {
     customProjectId: string | null;
     /** Nur bei Belegen mit Trinkgeld (siehe [Receipt.tipCents]). */
     tipCents?: number | null;
+    /** Nur bei Belegen mit Zahlungsliste (siehe [Receipt.payments]). */
+    payments?: ReceiptPaymentPayload[] | null;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest**. Unterscheidet sich von

package/dist/esm/models/receipt.js

@@ -3,6 +3,7 @@ import { readEnumKey, requireEnumKey } from './enum-payload.js';
 import { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, } from './receipt-item.js';
 import { toVoucherPayload, fromVoucherPayload } from './voucher.js';
 import { istZeroKind } from './receipt-summary.js';
+import { fromReceiptPaymentPayload, toReceiptPaymentPayload } from './receipt-payment.js';
 /**
  * Schreibt die Nutzlast in der **neuen** Form — sie **normalisiert, statt zu
  * spiegeln**: ein Beleg, der in der v1-Positionsform gelesen wurde, geht hier
@@ -43,6 +44,7 @@ export function toReceiptPayload(receipt) {
         signatureSuccess: receipt.signatureSuccess ?? null,
         customProjectId: receipt.customProjectId ?? null,
         ...(receipt.tipCents != null ? { tipCents: receipt.tipCents } : {}),
+        ...(receipt.payments != null ? { payments: receipt.payments.map(toReceiptPaymentPayload) } : {}),
     };
 }
 // Nullbelege haben keine Positionen -> items kann fehlen/null sein (siehe Dart-Vorbild).
@@ -78,6 +80,7 @@ export function fromReceiptPayload(payload) {
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),
         ...(payload.cancellations ? { cancellations: payload.cancellations.map(leseStorno) } : {}),
+        ...(Array.isArray(payload.payments) ? { payments: payload.payments.map(fromReceiptPaymentPayload) } : {}),
     };
 }
 function leseStorno(eintrag) {
@@ -91,8 +94,24 @@ function leseStorno(eintrag) {
         ...(eintrag.promoAdjustmentCents && typeof eintrag.promoAdjustmentCents === 'object'
             ? { promoAdjustmentCents: Object.fromEntries(Object.entries(eintrag.promoAdjustmentCents).map(([k, v]) => [k, Number(v)])) }
             : {}),
+        ...(eintrag.refundedByPayment && typeof eintrag.refundedByPayment === 'object' && !Array.isArray(eintrag.refundedByPayment)
+            ? { refundedByPayment: gueltigeRueckzahlungen(eintrag.refundedByPayment) }
+            : {}),
     };
 }
+// Nur ganzzahlige, nicht-negative Cent-Betraege je Zahlungs-ID; ein Eintrag,
+// der das nicht erfuellt (negativ, Kommazahl, kein Zahlenwert), faellt weg --
+// die uebrigen bleiben. Zwilling der Backend-Erzeugung (storno-core.js
+// pruefeRueckzahlungen), die selbst nur so etwas ablegt.
+function gueltigeRueckzahlungen(rueckzahlungen) {
+    const raus = {};
+    for (const [id, wert] of Object.entries(rueckzahlungen)) {
+        const cents = Number(wert);
+        if (Number.isInteger(cents) && cents >= 0)
+            raus[id] = cents;
+    }
+    return raus;
+}
 /**
  * Zwischensumme in **Cent** — Positionen plus verkaufte Wertgutscheine minus
  * eingeloeste Promotionsgutscheine. Wertgutschein-Einloesungen wirken erst auf

package/dist/esm/payments/hobex-hps/transaction-response.js

@@ -40,40 +40,40 @@ import { TECS_CODES } from './tecs-codes.js';
 /** Der Satz fuer den Bediener je Grund, deutsch. */
 export const HPS_REASON_HINTS = {
     approved: 'Vom Terminal genehmigt.',
-    approvedWithCondition: 'Das Terminal meldet eine Genehmigung mit Vorbehalt (etwa nur über einen Teilbetrag). Ob und in welcher Höhe belastet wurde, bitte am Terminalbeleg prüfen — nicht erneut kassieren, bevor es geklärt ist.',
+    approvedWithCondition: 'Das Terminal meldet eine Genehmigung mit Vorbehalt (etwa nur über einen Teilbetrag). Ob und in welcher Höhe belastet wurde, bitte am Terminalbeleg prüfen – nicht erneut kassieren, bevor es geklärt ist.',
     aborted: 'Der Vorgang wurde abgebrochen. Es wurde kein Geld bewegt.',
-    noCard: 'Es wurde keine Karte vorgehalten. Es wurde kein Geld bewegt — bitte erneut versuchen.',
-    cardReadFailed: 'Die Karte konnte nicht gelesen werden. Es wurde kein Geld bewegt — bitte erneut versuchen, notfalls die Karte stecken statt auflegen.',
-    cardDeclined: 'Die Karte wurde vom Terminal abgelehnt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    issuerDeclined: 'Die Zahlung wurde von der Bank abgelehnt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    cardBlocked: 'Die Karte ist gesperrt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    cardExpired: 'Die Karte ist abgelaufen. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    insufficientFunds: 'Das Konto ist nicht gedeckt oder das Kartenlimit ist erreicht. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    wrongPin: 'Die PIN war falsch. Es wurde kein Geld bewegt — bitte erneut versuchen.',
-    pinTriesExceeded: 'Die PIN wurde zu oft falsch eingegeben. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
-    pinRequired: 'Die Bank verlangt die PIN. Es wurde kein Geld bewegt — bitte erneut versuchen, die Karte stecken und die PIN eingeben.',
+    noCard: 'Es wurde keine Karte vorgehalten. Es wurde kein Geld bewegt – bitte erneut versuchen.',
+    cardReadFailed: 'Die Karte konnte nicht gelesen werden. Es wurde kein Geld bewegt – bitte erneut versuchen, notfalls die Karte stecken statt auflegen.',
+    cardDeclined: 'Die Karte wurde vom Terminal abgelehnt. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    issuerDeclined: 'Die Zahlung wurde von der Bank abgelehnt. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    cardBlocked: 'Die Karte ist gesperrt. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    cardExpired: 'Die Karte ist abgelaufen. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    insufficientFunds: 'Das Konto ist nicht gedeckt oder das Kartenlimit ist erreicht. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    wrongPin: 'Die PIN war falsch. Es wurde kein Geld bewegt – bitte erneut versuchen.',
+    pinTriesExceeded: 'Die PIN wurde zu oft falsch eingegeben. Es wurde kein Geld bewegt – bitte eine andere Karte oder Zahlungsart verwenden.',
+    pinRequired: 'Die Bank verlangt die PIN. Es wurde kein Geld bewegt – bitte erneut versuchen, die Karte stecken und die PIN eingeben.',
     amountInvalid: 'Das Terminal nimmt diesen Betrag nicht an. Es wurde kein Geld bewegt.',
-    tipNotSelected: 'Das Trinkgeld wurde nicht rechtzeitig gewählt. Es wurde kein Geld bewegt — bitte erneut versuchen.',
-    terminalBusy: 'Das Terminal ist noch mit einem anderen Vorgang beschäftigt. Es wurde kein Geld bewegt — kurz warten und erneut versuchen.',
-    terminalBlocked: 'Das Terminal ist gesperrt. Es wurde kein Geld bewegt — bitte hobex kontaktieren.',
-    terminalSetup: 'Das Terminal ist nicht richtig eingerichtet. Es wurde kein Geld bewegt — bitte die Terminal-ID in den Einstellungen prüfen, sonst hobex kontaktieren.',
-    acquirerSetup: 'hobex nimmt dieses Terminal oder diesen Händler so nicht an. Es wurde kein Geld bewegt — bitte hobex kontaktieren.',
-    terminalFault: 'Das Terminal meldet eine Störung. Es wurde kein Geld bewegt — bitte das Terminal neu starten und erneut versuchen.',
-    requestRejected: 'Das Terminal hat die Anfrage abgewiesen. Es wurde kein Geld bewegt — tritt das wieder auf, bitte den Support kontaktieren.',
-    hostRejected: 'hobex hat die Zahlung abgewiesen. Es wurde kein Geld bewegt — bitte erneut versuchen; tritt das wieder auf, hobex kontaktieren.',
-    hostUnavailable: 'Die Bank oder hobex ist gerade nicht erreichbar. Es wurde kein Geld bewegt — bitte später erneut versuchen oder eine andere Zahlungsart verwenden.',
+    tipNotSelected: 'Das Trinkgeld wurde nicht rechtzeitig gewählt. Es wurde kein Geld bewegt – bitte erneut versuchen.',
+    terminalBusy: 'Das Terminal ist noch mit einem anderen Vorgang beschäftigt. Es wurde kein Geld bewegt – kurz warten und erneut versuchen.',
+    terminalBlocked: 'Das Terminal ist gesperrt. Es wurde kein Geld bewegt – bitte hobex kontaktieren.',
+    terminalSetup: 'Das Terminal ist nicht richtig eingerichtet. Es wurde kein Geld bewegt – bitte die Terminal-ID in den Einstellungen prüfen, sonst hobex kontaktieren.',
+    acquirerSetup: 'hobex nimmt dieses Terminal oder diesen Händler so nicht an. Es wurde kein Geld bewegt – bitte hobex kontaktieren.',
+    terminalFault: 'Das Terminal meldet eine Störung. Es wurde kein Geld bewegt – bitte das Terminal neu starten und erneut versuchen.',
+    requestRejected: 'Das Terminal hat die Anfrage abgewiesen. Es wurde kein Geld bewegt – tritt das wieder auf, bitte den Support kontaktieren.',
+    hostRejected: 'hobex hat die Zahlung abgewiesen. Es wurde kein Geld bewegt – bitte erneut versuchen; tritt das wieder auf, hobex kontaktieren.',
+    hostUnavailable: 'Die Bank oder hobex ist gerade nicht erreichbar. Es wurde kein Geld bewegt – bitte später erneut versuchen oder eine andere Zahlungsart verwenden.',
     invalidTransaction: 'Das Terminal kennt die ursprüngliche Zahlung nicht. Es wurde kein Geld bewegt.',
     refundPassword: 'Das Passwort für die Gutschrift war falsch oder wurde nicht eingegeben. Es wurde nichts ausgezahlt.',
-    refundDisabled: 'Gutschriften sind an diesem Terminal abgeschaltet. Es wurde nichts ausgezahlt — bitte hobex kontaktieren.',
+    refundDisabled: 'Gutschriften sind an diesem Terminal abgeschaltet. Es wurde nichts ausgezahlt – bitte hobex kontaktieren.',
     refundRejected: 'Die Gutschrift wurde abgewiesen (Betrag zu hoch, bereits erstattet oder zu viele Versuche). Es wurde nichts ausgezahlt.',
-    hostTimeoutReversed: 'hobex hat nicht rechtzeitig geantwortet, das Terminal hat den Vorgang selbst storniert. Es wird kein Geld bewegt — bitte erneut versuchen.',
-    reversedByHost: 'Die Zahlung wurde wegen einer Störung automatisch storniert. Es wurde kein Geld bewegt — bitte erneut versuchen.',
-    voidedAfterHostFault: 'hobex hat nicht sauber geantwortet, die Zahlung wurde deshalb sicherheitshalber storniert. Es wurde kein Geld bewegt — bitte erneut versuchen.',
-    hostFault: 'Die Verbindung zwischen Terminal und hobex ist gestört. Ob die Karte belastet wurde, weiß das Terminal nicht — bitte nicht erneut kassieren, bevor es geklärt ist.',
-    hostTimeout: 'hobex hat nicht rechtzeitig geantwortet. Ob die Karte belastet wurde, weiß das Terminal nicht — bitte nicht erneut kassieren, bevor es geklärt ist.',
-    internalError: 'Das Terminal meldet einen internen Fehler. Ob die Karte belastet wurde, ist unklar — bitte nicht erneut kassieren, bevor es geklärt ist.',
+    hostTimeoutReversed: 'hobex hat nicht rechtzeitig geantwortet, das Terminal hat den Vorgang selbst storniert. Es wird kein Geld bewegt – bitte erneut versuchen.',
+    reversedByHost: 'Die Zahlung wurde wegen einer Störung automatisch storniert. Es wurde kein Geld bewegt – bitte erneut versuchen.',
+    voidedAfterHostFault: 'hobex hat nicht sauber geantwortet, die Zahlung wurde deshalb sicherheitshalber storniert. Es wurde kein Geld bewegt – bitte erneut versuchen.',
+    hostFault: 'Die Verbindung zwischen Terminal und hobex ist gestört. Ob die Karte belastet wurde, weiß das Terminal nicht – bitte nicht erneut kassieren, bevor es geklärt ist.',
+    hostTimeout: 'hobex hat nicht rechtzeitig geantwortet. Ob die Karte belastet wurde, weiß das Terminal nicht – bitte nicht erneut kassieren, bevor es geklärt ist.',
+    internalError: 'Das Terminal meldet einen internen Fehler. Ob die Karte belastet wurde, ist unklar – bitte nicht erneut kassieren, bevor es geklärt ist.',
     canceled: 'Die Zahlung ist aufgehoben.',
-    cancelDenied: 'Die Zahlung lässt sich nicht mehr aufheben und bleibt belastet — bitte stattdessen eine Gutschrift ausführen.',
+    cancelDenied: 'Die Zahlung lässt sich nicht mehr aufheben und bleibt belastet – bitte stattdessen eine Gutschrift ausführen.',
     originalDeclined: 'Die ursprüngliche Zahlung war abgelehnt; es gibt nichts aufzuheben.',
     notAbortable: 'Der Vorgang ist bereits abgeschlossen und lässt sich nicht mehr abbrechen.',
     noStatement: 'Das Terminal hat zu diesem Vorgang keine Auskunft.',

package/dist/esm/receipt/layout.js

@@ -291,16 +291,13 @@ function stripeBlock(daten, cardPaymentId) {
     return zeilen;
 }
 /**
- * Der Kartenzahlungsblock des Belegs -- fuer JEDEN Anbieter, den das Backend
- * kennt. Ohne `cardPaymentData` bleibt der Block weg; ein unbekannter Anbieter
- * ebenfalls, still und ohne Fehler: ein Beleg muss sich immer zeigen lassen.
+ * Der Kartenzahlungsblock eines Anbieters -- fuer JEDEN Anbieter, den das
+ * Backend kennt. Ein unbekannter Anbieter bekommt keinen Block, still und
+ * ohne Fehler: ein Beleg muss sich immer zeigen lassen.
  */
-function kartenblock(receipt) {
-    const daten = receipt.cardPaymentData;
-    if (daten == null)
-        return [];
+function anbieterBlock(provider, daten, id) {
     const zeilen = (() => {
-        switch (receipt.creditCardProvider) {
+        switch (provider) {
             case 'hobexHps':
             case 'hobexCloudApi':
                 return hobexBlock(daten);
@@ -312,7 +309,7 @@ function kartenblock(receipt) {
             case 'myposPro':
                 return myposBlock(daten);
             case 'stripe':
-                return stripeBlock(daten, receipt.cardPaymentId ?? null);
+                return stripeBlock(daten, id);
             default:
                 return [];
         }
@@ -325,12 +322,117 @@ function kartenblock(receipt) {
     // gehoert aber zum Blatt, nicht zum Terminal.
     return [...zeilen, { kind: 'space', lines: 1 }];
 }
+/**
+ * Die Kartenzahlungsbloecke des Belegs. Mit Zahlungsliste (`payments`) je
+ * Zahlung mit Anbieter und Terminaldaten ein Block, in Zahlungsreihenfolge --
+ * zwei Karten desselben Anbieters ergeben zwei Bloecke; die alten
+ * Einzelfelder zaehlen dann nicht. Bei mehreren Zahlungen steht vor jedem
+ * Block, nicht fett und zentriert, die Nummer der Zahlung aus der
+ * Aufschluesselung („2. Kartenzahlung") -- so ist jeder Block seiner Zeile
+ * zuzuordnen. Ohne (oder mit leerer) Liste der bisherige Weg ueber
+ * `creditCardProvider`/`cardPaymentData`/`cardPaymentId` -- ebenso bei
+ * hoechstens einer Zahlung ohne `providerData`, wenn die Altfelder gesetzt sind.
+ */
+function kartenblock(receipt) {
+    const zahlungen = receipt.payments;
+    // Eine einzelne Zahlung ohne Terminaldaten neben gesetzten Altfeldern
+    // (creditCardProvider + cardPaymentData): der bisherige Block, wie ohne Liste.
+    const altfelderTragen = zahlungen != null && zahlungen.length <= 1
+        && zahlungen.every((z) => z.providerData == null)
+        && receipt.creditCardProvider != null && receipt.cardPaymentData != null;
+    if (zahlungen != null && zahlungen.length > 0 && !altfelderTragen) {
+        const zeilen = [];
+        zahlungen.forEach((zahlung, i) => {
+            if (zahlung.provider == null || zahlung.providerData == null)
+                return;
+            const block = anbieterBlock(zahlung.provider, zahlung.providerData, zahlung.providerPaymentId ?? null);
+            if (block.length === 0)
+                return;
+            if (zahlungen.length > 1)
+                zeilen.push(textZeile(zahlungNummerText(zahlung, i), 'center'));
+            zeilen.push(...block);
+        });
+        return zeilen;
+    }
+    const daten = receipt.cardPaymentData;
+    if (daten == null)
+        return [];
+    return anbieterBlock(receipt.creditCardProvider, daten, receipt.cardPaymentId ?? null);
+}
 function zahlungsartText(wert) {
     if (wert != null && typeof wert === 'object') {
         return wert.label;
     }
     return typeof wert === 'string' ? wert : '';
 }
+/** Barzahlarten -- Zwilling von `BAR_ZAHLARTEN` (functions/gemeinsam/tip-core.js). */
+const BAR_ZAHLARTEN = ['cash', 'uberCash', 'boltCash'];
+function zahlartSchluessel(wert) {
+    if (wert != null && typeof wert === 'object')
+        return wert.value;
+    return typeof wert === 'string' ? wert : '';
+}
+/**
+ * Nummerierter Text einer Zahlung („1. Kartenzahlung", „3. Barzahlung") --
+ * in der Aufschluesselung und ueber ihrem Kartenblock dieselbe Nummer, in
+ * Zahlungsreihenfolge ab 1.
+ */
+function zahlungNummerText(zahlung, index) {
+    return `${index + 1}. ${zahlungsartText(zahlung.method)}`;
+}
+/** „davon Trinkgeld" eingerueckt unter einer Zahlung, die Trinkgeld traegt. */
+function zahlungTrinkgeldZeilen(zahlung) {
+    if (typeof zahlung.tipCents !== 'number' || zahlung.tipCents <= 0)
+        return [];
+    return [paarZeile('  davon Trinkgeld', `${formatCents(zahlung.tipCents)} €`, 8, 4)];
+}
+/**
+ * Gegeben/Rueckgeld unter einer Barzahlung mit `tenderedCents`. Fehlt
+ * `changeCents` (der Server rechnet es sonst selbst), ergibt es sich aus
+ * gegeben minus Betrag.
+ */
+function barZeilen(zahlung) {
+    if (!BAR_ZAHLARTEN.includes(zahlartSchluessel(zahlung.method)) || typeof zahlung.tenderedCents !== 'number')
+        return [];
+    const rueckgeld = typeof zahlung.changeCents === 'number' ? zahlung.changeCents : zahlung.tenderedCents - zahlung.amountCents;
+    return [
+        paarZeile('  Gegeben:', `${formatCents(zahlung.tenderedCents)} €`, 8, 4),
+        paarZeile('  Rückgeld:', `${formatCents(rueckgeld)} €`, 8, 4),
+    ];
+}
+/**
+ * Die Zahlungszeilen unter „Gesamt:".
+ *
+ * - Ohne Zahlungsliste: „Zahlungsart: <Label>" aus `paymentMethod`, wie immer.
+ * - Genau eine Zahlung: dieselbe Zeile, Label aus der Zahlung.
+ * - Mehrere Zahlungen (auch zwei Karten, die `paymentMethod: creditCard`
+ *   ergeben -- entschieden wird an der Laenge, nie an `mixed`): „Zahlungsarten:"
+ *   und je Zahlung eine nummerierte Zeile mit Betrag, ohne Anbieter (der
+ *   steht im Kartenblock mit derselben Nummer). Breite 8:4 -- auf 58 mm
+ *   bleiben der Betragsspalte elf Zeichen, genug fuer „-9999,99 €".
+ *
+ * Unter jeder Zahlung in dieser Reihenfolge: „davon Trinkgeld" (bei
+ * `tipCents`), dann bei einer Barzahlung mit gegebenem Betrag „Gegeben:" und
+ * „Rückgeld:" -- alles, was zu einer Zahlung gehoert, zwei Zeichen eingerueckt,
+ * die Zahlung selbst buendig.
+ */
+function zahlungsZeilen(receipt) {
+    const zahlungen = receipt.payments;
+    if (zahlungen == null || zahlungen.length === 0) {
+        return [paarZeile('Zahlungsart:', zahlungsartText(receipt.paymentMethod))];
+    }
+    if (zahlungen.length === 1) {
+        const zahlung = zahlungen[0];
+        return [paarZeile('Zahlungsart:', zahlungsartText(zahlung.method)), ...zahlungTrinkgeldZeilen(zahlung), ...barZeilen(zahlung)];
+    }
+    const zeilen = [textZeile('Zahlungsarten:')];
+    zahlungen.forEach((zahlung, i) => {
+        zeilen.push(paarZeile(zahlungNummerText(zahlung, i), `${formatCents(zahlung.amountCents)} €`, 8, 4));
+        zeilen.push(...zahlungTrinkgeldZeilen(zahlung));
+        zeilen.push(...barZeilen(zahlung));
+    });
+    return zeilen;
+}
 // -------------------------------------------------------- Kleinunternehmer
 /**
  * Hinweis auf die Steuerbefreiung, den ein Kleinunternehmerbeleg tragen muss —
@@ -898,7 +1000,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push({ kind: 'rule', char: '-' });
     }
     lines.push(paarZeile('Gesamt:', `${formatCents(summeCents)} €`));
-    lines.push(paarZeile('Zahlungsart:', zahlungsartText(receipt.paymentMethod)));
+    lines.push(...zahlungsZeilen(receipt));
     lines.push({ kind: 'space', lines: 1 });
     // --- Rechtshinweise und Ausfallhinweis
     const hinweise = company.isSmallBusiness

package/fixtures/belege/split-bar-rueckgeld.json

@@ -0,0 +1,58 @@
+{
+  "company": {
+    "companyName": "Bäckerei Muster",
+    "street": "Hauptplatz 1",
+    "zip": "4830",
+    "city": "Hallstatt",
+    "phone": "+43 6134 12345",
+    "uid": "ATU12345678",
+    "taxnr": "",
+    "isSmallBusiness": false,
+    "footer1": "Vielen Dank für Ihren Einkauf",
+    "footer2": "www.baeckerei-muster.at",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-72",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-09-25T10:15:30",
+    "items": [
+      {
+        "name": "Semmel",
+        "quantity": 6,
+        "unitPriceCents": 79,
+        "vatRate": 10
+      },
+      {
+        "name": "Kaffee klein",
+        "quantity": 2,
+        "unitPriceCents": 280,
+        "vatRate": 20
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "cash",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "6F0404F0",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-72_2026-09-25T10:15:30_5,60_4,74_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 1034,
+        "tenderedCents": 5000,
+        "changeCents": 3966
+      }
+    ]
+  },
+  "options": {
+    "paperSize": "mm58"
+  }
+}

package/fixtures/belege/split-eine-karte-trinkgeld.json

@@ -0,0 +1,75 @@
+{
+  "company": {
+    "companyName": "Bäckerei Muster",
+    "street": "Hauptplatz 1",
+    "zip": "4830",
+    "city": "Hallstatt",
+    "phone": "+43 6134 12345",
+    "uid": "ATU12345678",
+    "taxnr": "",
+    "isSmallBusiness": false,
+    "footer1": "Vielen Dank für Ihren Einkauf",
+    "footer2": "www.baeckerei-muster.at",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-78",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-09-25T10:15:30",
+    "items": [
+      {
+        "name": "Tagesteller",
+        "quantity": 2,
+        "unitPriceCents": 1890,
+        "vatRate": 10
+      },
+      {
+        "name": "Trinkgeld Personal",
+        "quantity": 1,
+        "unitPriceCents": 420,
+        "vatRate": 0,
+        "kind": "tip",
+        "recipient": {
+          "registerUserId": "ru1",
+          "name": "Anna"
+        },
+        "paymentMethod": "creditCard"
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "6F0404F0",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-78_2026-09-25T10:15:30_0,00_37,80_0,00_4,20_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "payments": [
+      {
+        "id": "p1",
+        "method": "creditCard",
+        "amountCents": 4200,
+        "tipCents": 420,
+        "provider": "sumup",
+        "providerPaymentId": "TEZBA9K7QK",
+        "providerData": {
+          "cardType": "MASTERCARD",
+          "cardLastDigits": "4720",
+          "paymentType": "CONTACTLESS",
+          "amount": 4200,
+          "currency": "EUR",
+          "transactionCode": "TEZBA9K7QK",
+          "entryMode": "contactless"
+        }
+      }
+    ],
+    "tipCents": 420
+  },
+  "options": {
+    "paperSize": "mm58"
+  }
+}