@kreiseck/kasseneck-api 0.7.2 → 0.9.0

package/dist/esm/kasse/texte.js

@@ -0,0 +1,145 @@
+/**
+ * Was die Kasse selbst sagt — auf dem Bildschirm, in beiden Huellen.
+ *
+ * Die Browser-Kasse und die Kassen-App sind eine Kasse. Was der Kassier bei
+ * einem Fehler liest, steht hier genau einmal; beide Apps beziehen den Satz
+ * von hier, und wer ihn aendert, aendert ihn auf beiden Seiten oder gar nicht.
+ *
+ * Nicht hier: die fachlichen Saetze des Backends („Kopplungs-Code ist
+ * abgelaufen.", „PIN falsch, noch 2 Versuche"). Die gehen unveraendert durch.
+ *
+ * Ein Satz sagt, was los ist, und was zu tun ist. Nie Innereien.
+ *
+ * Schluessel: `bereich.name`. Ein Schluessel wird nie umgedeutet — wer den
+ * Sinn aendert, legt einen neuen an. `nur` nennt die Seite, wenn ein Satz nur
+ * auf einer Plattform vorkommen kann.
+ */
+const MELDUNGEN_ROH = {
+    // --- Transport -----------------------------------------------------------
+    'netz.keine_verbindung': { text: 'Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'netz.zeitablauf': { text: 'Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    'server.unerwartet': { text: 'Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.', platzhalter: ['status'] },
+    // --- Kopplung ------------------------------------------------------------
+    'kopplung.code_fehlt': { text: 'Bitte den Kopplungs-Code eingeben.' },
+    'kopplung.fehlgeschlagen': { text: 'Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'kopplung.unvollstaendig': { text: 'Die Kopplung ist unvollständig zurückgekommen. Bitte im Panel einen neuen Code erzeugen und noch einmal versuchen.' },
+    'geraet.browser_speicher': { text: 'Dieses Gerät konnte nicht gespeichert werden — der Browser-Speicher steht nicht zur Verfügung. Bitte den privaten Modus verlassen.', nur: ['web'] },
+    // --- Anmeldung und Sitzung -----------------------------------------------
+    'anmeldung.pin_fehlt': { text: 'Bitte die PIN eingeben.' },
+    'anmeldung.fehlgeschlagen': { text: 'Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.' },
+    'anmeldung.nicht_abgeschlossen': { text: 'Die Anmeldung konnte nicht abgeschlossen werden. Bitte erneut versuchen.' },
+    'anmeldung.wird_abgeschlossen': { text: 'Anmeldung wird gerade abgeschlossen — bitte gleich noch einmal drücken.' },
+    'sitzung.abgelaufen': { text: 'Die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.abgelaufen_ohne_netz': { text: 'Keine Verbindung zum Server — die Sitzung ist abgelaufen. Bitte erneut anmelden.' },
+    'sitzung.keine': { text: 'Keine Sitzung.' },
+    'rechte.nicht_aenderbar': { text: 'Das darfst du nicht ändern — das Recht dafür vergibt der Inhaber im Panel.' },
+    // --- Verkauf und Positionen ----------------------------------------------
+    'kasse.laden_fehlgeschlagen': { text: 'Die Kasse konnte nicht geladen werden.' },
+    'artikel.laden_fehlgeschlagen': { text: 'Die Artikel konnten nicht geladen werden.' },
+    'artikel.keine_freigegeben': { text: 'Keine Artikel an dieser Kasse. Im Panel unter „Kacheln & Gruppen“ freischalten.' },
+    'artikel.keine_gefunden': { text: 'Keine Artikel gefunden.' },
+    'artikel.steuersatz_unbekannt': { text: '„{name}“ hat einen Steuersatz, den die Kasse nicht kennt.', platzhalter: ['name'] },
+    'position.betrag_fehlt': { text: 'Bitte einen Betrag eingeben.' },
+    'position.bezeichnung_fehlt': { text: 'Bitte eine Bezeichnung eingeben — sie steht am Beleg.' },
+    'rabatt.prozent_ungueltig': { text: 'Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.' },
+    // --- Abschluss -----------------------------------------------------------
+    'abschluss.fehlgeschlagen': { text: 'Der Abschluss ist fehlgeschlagen.' },
+    'abschluss.unklar': { text: 'Unklar, ob der Beleg entstanden ist — die Antwort kam nicht an. Bitte nicht noch einmal abschließen: der Beleg kann bereits erstellt und signiert sein. Im Panel unter „Belege“ nachsehen; nur wenn er dort fehlt, den Verkauf erneut abschließen.' },
+    'abschluss.nullbeleg_fehlgeschlagen': { text: 'Der Nullbeleg konnte nicht erstellt werden.' },
+    'abschluss.signatur_ausgefallen': { text: 'Die Signatureinheit hat nicht geantwortet. Der Beleg ist gültig und trägt den Vermerk „Sicherheitseinrichtung ausgefallen“.' },
+    // --- Kartenzahlung -------------------------------------------------------
+    'kartenzahlung.nicht_moeglich': { text: 'Kartenzahlung nicht möglich.' },
+    'kartenzahlung.nicht_zustande': { text: 'Die Kartenzahlung ist nicht zustande gekommen.' },
+    'kartenzahlung.nicht_gestartet': { text: 'Kartenzahlung nicht gestartet: {grund}', platzhalter: ['grund'] },
+    'kartenzahlung.unklar': { text: 'Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein.' },
+    // Die Kennung ist der einzige Anker, um die Zahlung am Terminal-Beleg wiederzufinden — liegt sie vor, gilt dieser Satz statt kartenzahlung.unklar.
+    'kartenzahlung.unklar_mit_kennung': { text: 'Unklar, ob die Kartenzahlung durchgegangen ist — die Verbindung zum Terminal riss ab. Bitte am Terminal-Beleg nachsehen, BEVOR neu kassiert wird: die Karte kann belastet sein. Kennung der Zahlung: {kennung}.', platzhalter: ['kennung'] },
+    'kartenzahlung.connect_nicht_verbunden': { text: 'Kartenzahlung nicht möglich: Kasseneck Connect ist nicht verbunden — Einstellungen → Kasseneck Connect.', nur: ['web'] },
+    'terminal.keines_gefunden': { text: 'Kein Hobex-Terminal gefunden — ist es eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'terminal.nicht_bereit': { text: 'Terminal antwortet, ist aber nicht betriebsbereit: {antwort} — TID prüfen.', platzhalter: ['antwort'], nur: ['web'] },
+    'gptom.app_fehlt': { text: 'Die GP-Tom-App ist auf diesem Gerät nicht da.', nur: ['app'] },
+    'gptom.suche_fehlgeschlagen': { text: 'GP Tom: Suche nach der App fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_fehlgeschlagen': { text: 'GP Tom: Zahlung fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.terminal_antwortet_nicht': { text: 'Das Terminal hat nicht geantwortet: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    'gptom.zahlung_nicht_abgeschlossen': { text: 'Die Zahlung wurde nicht abgeschlossen ({code}).', platzhalter: ['code'], nur: ['app'] },
+    // --- Belege und Storno ---------------------------------------------------
+    'belege.laden_fehlgeschlagen': { text: 'Die Belege konnten nicht geladen werden.' },
+    'belege.keine_im_zeitraum': { text: 'Keine Belege in diesem Zeitraum.' },
+    'beleg.laden_fehlgeschlagen': { text: 'Der Beleg konnte nicht geladen werden.' },
+    'beleg.nicht_gefunden': { text: 'Der Beleg wurde nicht gefunden.' },
+    'storno.fehlgeschlagen': { text: 'Das Storno ist fehlgeschlagen.' },
+    'storno.grund_fehlt': { text: 'Bitte einen Grund wählen.' },
+    'storno.position_fehlt': { text: 'Bitte mindestens eine Position wählen.' },
+    // --- Druck ---------------------------------------------------------------
+    'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
+    'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
+    'druck.testdruck_fehlgeschlagen': { text: 'Der Testdruck ist fehlgeschlagen.' },
+    'druck.testdruck_nicht_moeglich': { text: 'Der Testdruck ist fehlgeschlagen: {grund}', platzhalter: ['grund'] },
+    'druck.kein_drucker': { text: 'Kein Bondrucker eingerichtet — in den Einstellungen unter Drucker & Lade.' },
+    'druck.drucker_nicht_erreichbar': { text: 'Drucker nicht erreichbar.' },
+    'druck.job_abgelaufen': { text: 'Drucker hat den Beleg nicht abgeholt (abgelaufen).', nur: ['web'] },
+    'druck.kein_drucker_gefunden': { text: 'Kein Drucker gefunden — ist er eingeschaltet und im selben Netz wie dieser Rechner?', nur: ['web'] },
+    'druck.nur_chrome': { text: '{weg}-Druck geht nur in Chrome oder Edge (Windows, Mac, Android) — nicht in Safari und nicht am iPad.', platzhalter: ['weg'], nur: ['web'] },
+    'druck.kein_weg_drucker': { text: 'Kein {weg}-Drucker verbunden — „{weg}-Drucker verbinden“ und den Drucker im Dialog wählen.', platzhalter: ['weg'], nur: ['web'] },
+    'bluetooth.aus': { text: 'Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.', nur: ['app'] },
+    'bluetooth.freigabe_fehlt': { text: 'Bitte die Freigabe in den Geräte-Einstellungen erteilen.', nur: ['app'] },
+    'bluetooth.suche_fehlgeschlagen': { text: 'Die Suche ist fehlgeschlagen: {grund}', platzhalter: ['grund'], nur: ['app'] },
+    // --- Kasseneck Connect (nur Browser) -------------------------------------
+    'connect.antwortet_nicht': { text: 'Kasseneck Connect antwortet nicht — läuft das Programm auf diesem Rechner?', nur: ['web'] },
+    'connect.code_abgelaufen': { text: 'Der Kopplungs-Code ist abgelaufen — im Agent einen neuen erzeugen („kasseneck-connect pair“).', nur: ['web'] },
+    'connect.zu_viele_versuche': { text: 'Zu viele Fehlversuche — eine Minute warten und noch einmal versuchen.', nur: ['web'] },
+    'connect.drucker_antwortet_nicht': { text: 'Der Drucker antwortet nicht — Strom, Netzwerk und IP prüfen.', nur: ['web'] },
+    'connect.nicht_gekoppelt': { text: 'Diese Kasse ist mit Kasseneck Connect nicht gekoppelt — in den Einstellungen „Koppeln“ drücken.', nur: ['web'] },
+    'connect.drucker_unbekannt': { text: 'Diesen Drucker kennt Kasseneck Connect nicht (mehr) — bitte neu suchen.', nur: ['web'] },
+    'connect.ursprung_nicht_freigegeben': { text: 'Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).', nur: ['web'] },
+    'connect.nicht_installiert': { text: 'Kasseneck Connect nicht gefunden — bitte installieren.', nur: ['web'] },
+    // --- Einstellungen -------------------------------------------------------
+    'einstellungen.laden_fehlgeschlagen': { text: 'Die Einstellungen konnten nicht geladen werden.' },
+    'einstellungen.speichern_fehlgeschlagen': { text: 'Die Einstellung konnte nicht gespeichert werden.' },
+    'einstellungen.noch_nicht_geladen': { text: 'Noch nicht geladen — bitte kurz warten oder neu anmelden.' },
+    'einstellungen.ip_ungueltig': { text: 'Keine gültige IP-Adresse (z. B. 192.168.1.50).' },
+    'entkopplung.fehlgeschlagen': { text: 'Entkoppeln fehlgeschlagen.' },
+    'logo.hochladen_fehlgeschlagen': { text: 'Hochladen fehlgeschlagen.' },
+    'logo.entfernen_fehlgeschlagen': { text: 'Entfernen fehlgeschlagen.' },
+    // --- Nur App -------------------------------------------------------------
+    'app.nicht_im_browser': { text: 'Die Kassen-App läuft nicht im Browser — dafür gibt es kasse.kasseneck.at.', nur: ['app'] },
+    'app.im_browser_oeffnen': { text: 'Bitte im Browser öffnen: {ziel}', platzhalter: ['ziel'], nur: ['app'] },
+};
+// Auf den gemeinsamen Typ gebracht: `Object.entries(MELDUNGEN)` liefert sonst
+// pro Schluessel den engsten Literaltyp, und `platzhalter`/`nur` waeren nur
+// auf manchen Zweigen der Vereinigung vorhanden.
+export const MELDUNGEN = MELDUNGEN_ROH;
+/**
+ * In welcher Reihenfolge ein Fehler eingeordnet wird — auf beiden Seiten
+ * dieselbe. Die Arten:
+ *   api        — HTTP 200, `status:'error'`: der Satz des Backends, woertlich
+ *   klartext   — schon fuer den Bildschirm geschrieben: sein eigener Text
+ *   zeitablauf — die Frist lief ab, die Anfrage war draussen
+ *   netz       — keine Verbindung zustande gekommen oder abgerissen
+ *   unerwartet — der Server hat geantwortet, aber nicht wie zugesagt
+ *                (HTML statt JSON, 500, fehlende Huelle); `status` = HTTP-Code
+ *   sonst      — alles Uebrige ist technisch: der Ersatzsatz des Vorgangs
+ */
+export const FEHLERREGELN = [
+    { art: 'api', verhalten: 'server_text' },
+    { art: 'klartext', verhalten: 'eigener_text' },
+    { art: 'zeitablauf', schluessel: 'netz.zeitablauf' },
+    { art: 'netz', schluessel: 'netz.keine_verbindung' },
+    { art: 'unerwartet', schluessel: 'server.unerwartet' },
+    { art: 'sonst', verhalten: 'ersatz' },
+];
+/** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
+export function meldung(schluessel, werte = {}) {
+    const eintrag = MELDUNGEN[schluessel];
+    return eintrag.text.replace(/\{([a-z]+)\}/g, (_, name) => {
+        const wert = werte[name];
+        if (wert === undefined)
+            throw new Error(`meldung(${schluessel}): Platzhalter {${name}} ohne Wert`);
+        return String(wert);
+    });
+}
+/** Gilt der Satz auf dieser Seite? */
+export function meldungGiltFuer(schluessel, seite) {
+    const eintrag = MELDUNGEN[schluessel];
+    return eintrag.nur === undefined || eintrag.nur.includes(seite);
+}

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

@@ -22,11 +22,15 @@ import type { PosPaperSize } from '../printing/escpos.js';
  *
  * Bewusst **nicht** enthalten: Firmenlogo und Rasterbilder (brauchen
  * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung
- * und Druckeransteuerung. Von den anbieterspezifischen Kartenzahlungsbloecken
- * des Vorbilds (GP Tom, SumUp, myPOS, Stripe) ist nur der **Hobex-Block**
- * enthalten: die Browser-Kasse bedient das HPS-Terminal selbst (via Kasseneck
- * Connect) und druckt den Bon aus genau diesem Modell — die uebrigen Anbieter
- * drucken in ihren eigenen Apps.
+ * und Druckeransteuerung.
+ *
+ * Die anbieterspezifischen Kartenzahlungsbloecke sind dagegen **alle**
+ * enthalten (Hobex, GP Tom, SumUp, myPOS, Stripe). Bis 0.8.0 trug das Modell
+ * nur den Hobex-Block, weil die Browser-Kasse nur das HPS-Terminal selbst
+ * bedient und die uebrigen Anbieter „in ihren eigenen Apps drucken". Das
+ * Argument gilt fuer die Frage, wer das TERMINAL bedient — nicht dafuer, was
+ * auf dem BELEGDOKUMENT steht. Aus der einen Regel wurde die andere, und
+ * derselbe Beleg trug im PDF weniger als auf dem Bon.
  */
 /** Ausrichtung einer Zeile bzw. einer Spalte. */
 export type LayoutAlign = 'left' | 'center' | 'right';
@@ -129,6 +133,8 @@ export interface BuildReceiptLayoutOptions {
  * diesem Paket ausnahmslos ganzzahlig gerechnet).
  */
 export declare function formatCents(cents: number): string;
+/** Zwilling von `stripeReceiptLines` (print_paper.dart). */
+export declare function stripeReceiptLines(daten: Record<string, unknown>, cardPaymentId: string | null): string[];
 /**
  * Hinweis auf die Steuerbefreiung, den ein Kleinunternehmerbeleg tragen muss —
  * ohne ihn stuende in der USt-Tabelle „D 0 %" ohne jede Begruendung, und ab

package/dist/esm/receipt/layout.js

@@ -60,6 +60,36 @@ function originalDatum(timeStamp) {
  * `typeof null === 'object'` ist, ergab das beim Lesen von `.label` einen
  * nackten TypeError.
  */
+/**
+ * Die anbieterspezifischen Kartenzahlungsbloecke.
+ *
+ * WARUM DIESE BLOECKE HIER STEHEN
+ *
+ * Bis 0.8.0 trug dieses Modell nur den Hobex-Block, mit der Begruendung, die
+ * uebrigen Anbieter druckten "in ihren eigenen Apps". Das Argument gilt fuer
+ * die Frage, wer das TERMINAL bedient -- nicht dafuer, was auf dem
+ * BELEGDOKUMENT steht. Aus der einen Regel wurde die andere, und damit
+ * verschwanden vier Bloecke: Wer denselben Beleg als PDF oeffnete, sah "nur
+ * Kartenzahlung", waehrend der Bon daneben Marke, letzte Ziffern, Betrag und
+ * Referenz auswies. Vorher (backend `generateReceiptPdf`) hatte das PDF alle
+ * sieben Anbieter.
+ *
+ * Gebaut werden die Zeilen deshalb hier, an genau EINER Stelle. Wer sie
+ * anderswo noch einmal baut, oeffnet die Drift wieder.
+ *
+ * Vorbild ist `print_paper.dart` im Dart-Paket (`_gpTom`, `_hobexHps`,
+ * `_sumup`, `_mypos`, `_stripe`); die Fixtures unter `fixtures/belege/karte-*`
+ * halten je Anbieter eine Zeile-fuer-Zeile-Probe fest.
+ */
+/** Ein Feld aus `cardPaymentData` als Text; fehlend/null wird leer. */
+function kartenFeld(daten, schluessel) {
+    const v = daten[schluessel];
+    return v == null ? '' : String(v);
+}
+/** Nicht-leere Teile mit Mittelpunkt verbinden. */
+function verbunden(teile) {
+    return teile.filter(Boolean).join(' · ');
+}
 /**
  * Kartenzahlungsblock fuer Hobex (HPS am Geraet wie Cloud-API): die Felder
  * kommen aus `cardPaymentData` in der Form von [hobexReceiptToCardPaymentData]
@@ -67,43 +97,234 @@ function originalDatum(timeStamp) {
  * Antwortcode. Bei CVM "1" verlangt die Karte eine Unterschrift; dafuer
  * bekommt der Bon eine Linie. Der PAN haengt beim HPS das Ablaufdatum mit
  * Unterstrich an ("…4720_2810") — gedruckt wird nur die maskierte Nummer.
- *
- * Andere Anbieter (GP Tom, SumUp, myPOS, Stripe) drucken in ihren eigenen
- * Apps; ihre Bloecke bleiben bewusst draussen (siehe Kopfkommentar).
  */
-function hobexKartenblock(receipt) {
-    const provider = receipt.creditCardProvider;
-    const daten = receipt.cardPaymentData;
-    if ((provider !== 'hobexHps' && provider !== 'hobexCloudApi') || daten == null) {
-        return [];
-    }
-    const feld = (k) => {
-        const v = daten[k];
-        return v == null ? '' : String(v);
-    };
-    const paar = (teile) => teile.filter(Boolean).join(' · ');
-    const pan = feld('cardNumber').split('_')[0] ?? '';
-    const rc = feld('responseCode');
+function hobexBlock(daten) {
+    const feld = (k) => kartenFeld(daten, k);
     const zeilen = [textZeile('Hobex Beleg', 'center', true)];
     const inhalt = [
         feld('date'),
-        paar([feld('tid') && `TID ${feld('tid')}`, feld('no') && `Nr. ${feld('no')}`]),
-        paar([feld('type'), feld('cardBrand')]),
-        pan,
-        rc && `RC ${rc}`,
+        verbunden([feld('tid') && `TID ${feld('tid')}`, feld('no') && `Nr. ${feld('no')}`]),
+        verbunden([feld('type'), feld('cardBrand')]),
+        feld('cardNumber').split('_')[0] ?? '',
+        feld('responseCode') && `RC ${feld('responseCode')}`,
+    ];
+    for (const zeile of inhalt) {
+        if (zeile)
+            zeilen.push(textZeile(zeile, 'center'));
+    }
+    if (feld('cvm') === '1')
+        zeilen.push(...unterschriftsfeld());
+    return zeilen;
+}
+/** Zwei Leerzeilen, Linie, Wort -- das Unterschriftsfeld auf dem Bon. */
+function unterschriftsfeld() {
+    return [
+        { kind: 'space', lines: 2 },
+        textZeile('------------------', 'center'),
+        textZeile('Unterschrift', 'center'),
+    ];
+}
+/**
+ * GP-Tom-`transactionType`: das Plugin-`toMap` schreibt den Schluessel mit
+ * Tippfehler (`transacitonType`), aeltere Daten tragen ihn gar nicht. Beide
+ * Schreibweisen werden gelesen -- ein Beleg von damals soll nicht anders
+ * aussehen als einer von heute.
+ */
+function gpTomVorgangsart(daten) {
+    switch (daten.transactionType ?? daten.transacitonType) {
+        case 1: return 'Sale';
+        case 2: return 'Void';
+        case 3: return 'Refund';
+        case 4: return 'Close Batch';
+        default: return '';
+    }
+}
+/** GP-Tom-Betrag: ganze Zahl = Cent, sonst schon ein Eurobetrag. */
+function gpTomBetrag(wert) {
+    if (typeof wert !== 'number')
+        return '-';
+    return Number.isInteger(wert) ? formatCents(wert) : wert.toFixed(2).replace('.', ',');
+}
+function gpTomBlock(daten) {
+    const feld = (k) => kartenFeld(daten, k);
+    const art = gpTomVorgangsart(daten);
+    const zeilen = [textZeile('GP Tom Beleg', 'center', true)];
+    const inhalt = [
+        `Batch: ${feld('batchNumber')}`,
+        `Receipt: ${feld('externalTransactionID')}`,
+        `TID: ${feld('terminalID')}`,
+        feld('emvAid'),
+        (daten.emvAppLable != null || daten.cardDataEntry != null)
+            ? `${feld('emvAppLable')} ${feld('cardDataEntry')}`.trim() : '',
+        feld('cardNumber'),
+        `${art ? `${art} ` : ''}Amount ${feld('currencyCode')} ${gpTomBetrag(daten.amount)}`,
+        daten.pinOk === true ? 'PIN OK' : 'PIN NOT OK',
+        `Authorization Code ${feld('approvedCode')}`,
+        `Sequence Number: ${feld('sequenceNumber')}`,
     ];
     for (const zeile of inhalt) {
         if (zeile)
             zeilen.push(textZeile(zeile, 'center'));
     }
-    if (feld('cvm') === '1') {
-        zeilen.push({ kind: 'space', lines: 2 });
-        zeilen.push(textZeile('------------------', 'center'));
-        zeilen.push(textZeile('Unterschrift', 'center'));
+    return zeilen;
+}
+function sumupBlock(daten) {
+    const feld = (k) => kartenFeld(daten, k);
+    const betrag = typeof daten.amount === 'number'
+        ? (Number.isInteger(daten.amount) ? formatCents(daten.amount) : daten.amount.toFixed(2).replace('.', ','))
+        : '-';
+    return [
+        textZeile('Sumup Beleg', 'center', true),
+        paarZeile('Kartentyp:', feld('cardType') || 'n/a'),
+        paarZeile('Kartennummer:', `**** **** **** ${feld('cardLastDigits')}`),
+        paarZeile('Zahlungstyp:', feld('paymentType') || 'n/a'),
+        paarZeile('Gesamtbetrag:', `${betrag} ${feld('currency')}`.trim()),
+        paarZeile('Transaktionscode:', feld('transactionCode') || '-'),
+        paarZeile('Modus:', feld('entryMode').toUpperCase()),
+    ];
+}
+/**
+ * myPOS liefert den Zeitpunkt als `YYMMDDhhmmss` ohne Trenner. Ein Wert, der
+ * nicht so aussieht, wird UNVERAENDERT durchgereicht statt zerschnitten: eine
+ * halb geratene Uhrzeit auf einem Beleg ist schlimmer als ein roher Wert.
+ */
+function myposZeitpunkt(wert) {
+    const t = /^(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/.exec(wert);
+    if (!t)
+        return wert;
+    return `${t[3]}.${t[2]}.20${t[1]} ${t[4]}:${t[5]}:${t[6]}`;
+}
+function myposBlock(daten) {
+    const feld = (k) => kartenFeld(daten, k);
+    const zeilen = [
+        textZeile('MyPos Beleg', 'center', true),
+        paarZeile('TERMINAL ID:', feld('TID') || '-'),
+        paarZeile('DATUM:', myposZeitpunkt(feld('date_time'))),
+    ];
+    if (feld('application_name'))
+        zeilen.push(textZeile(feld('application_name'), 'center', true));
+    zeilen.push(paarZeile('KARTE:', feld('pan') || '-'));
+    if (daten.signature_required === true)
+        zeilen.push(...unterschriftsfeld());
+    zeilen.push(paarZeile('STAN:', feld('STAN') ? feld('STAN').padStart(6, '0') : '-'));
+    zeilen.push(paarZeile('AUTH. CODE:', feld('authorization_code') || '-'));
+    zeilen.push(paarZeile('RRN:', feld('reference_number') || '-'));
+    zeilen.push(paarZeile('AID:', feld('AID') || '-'));
+    return zeilen;
+}
+const STRIPE_KARTENART = {
+    debit: 'Debitkarte',
+    credit: 'Kreditkarte',
+    prepaid: 'Prepaid-Karte',
+};
+const STRIPE_WALLET = {
+    apple_pay: 'Apple Pay',
+    google_pay: 'Google Pay',
+};
+/** EPS-Bank-Slug (`bank_austria`) -> Anzeigename (`Bank Austria`). */
+function stripeEpsBank(slug) {
+    return slug.split('_').filter(Boolean)
+        .map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+}
+function stripeMarkenZeile(daten) {
+    const teile = [];
+    if (daten.cardBrand != null)
+        teile.push(String(daten.cardBrand));
+    const art = STRIPE_KARTENART[String(daten.cardFunding)];
+    if (art)
+        teile.push(art);
+    let zeile = teile.join(' ');
+    if (daten.wallet != null) {
+        const wallet = STRIPE_WALLET[String(daten.wallet)] ?? String(daten.wallet);
+        zeile = zeile ? `${zeile} (${wallet})` : `(${wallet})`;
+    }
+    return zeile;
+}
+/**
+ * Stripe-Zahlzeitpunkt: Sekunden seit Epoche, gedruckt in **Wiener** Zeit.
+ * Ueber `toViennaWallClock`, nicht ueber die lokale Zeitzone -- ein Beleg
+ * traegt Ortszeit des Betriebs, nicht die des Geraets, das ihn oeffnet.
+ */
+function stripeZeitpunkt(sekunden) {
+    const t = toViennaWallClock(new Date(sekunden * 1000));
+    const zwei = (n) => String(n).padStart(2, '0');
+    return `${zwei(t.day)}.${zwei(t.month)}.${t.year} ${zwei(t.hour)}:${zwei(t.minute)}`;
+}
+/** Zwilling von `stripeReceiptLines` (print_paper.dart). */
+export function stripeReceiptLines(daten, cardPaymentId) {
+    const zeilen = [];
+    const art = daten.paymentMethodType == null ? null : String(daten.paymentMethodType);
+    if (art === 'card') {
+        const marke = stripeMarkenZeile(daten);
+        if (marke)
+            zeilen.push(marke);
+        if (daten.cardLastDigits != null)
+            zeilen.push(`**** **** **** ${daten.cardLastDigits}`);
+        if (daten.threeDSecure === 'authenticated')
+            zeilen.push('3-D Secure: ja');
+    }
+    else if (art === 'eps') {
+        if (daten.epsBank != null)
+            zeilen.push(`EPS - ${stripeEpsBank(String(daten.epsBank))}`);
+    }
+    else if (art != null) {
+        zeilen.push(art.toUpperCase());
+    }
+    if (typeof daten.amount === 'number' && Number.isInteger(daten.amount)) {
+        const waehrung = daten.currency == null ? 'EUR' : String(daten.currency).toUpperCase();
+        zeilen.push(`Gesamtbetrag ${formatCents(daten.amount)} ${waehrung}`);
+    }
+    if (typeof daten.paidAt === 'number' && Number.isInteger(daten.paidAt)) {
+        zeilen.push(`Bezahlt: ${stripeZeitpunkt(daten.paidAt)}`);
+    }
+    if (daten.statementDescriptor != null)
+        zeilen.push(`Abrechnung: ${daten.statementDescriptor}`);
+    if (cardPaymentId != null)
+        zeilen.push(`Referenz: ${cardPaymentId}`);
+    return zeilen;
+}
+function stripeBlock(daten, cardPaymentId) {
+    const zeilen = [textZeile('Online-Zahlung (Stripe)', 'center', true)];
+    for (const zeile of stripeReceiptLines(daten, cardPaymentId)) {
+        zeilen.push(textZeile(zeile, 'center'));
     }
-    zeilen.push({ kind: 'space', lines: 1 });
     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.
+ */
+function kartenblock(receipt) {
+    const daten = receipt.cardPaymentData;
+    if (daten == null)
+        return [];
+    const zeilen = (() => {
+        switch (receipt.creditCardProvider) {
+            case 'hobexHps':
+            case 'hobexCloudApi':
+                return hobexBlock(daten);
+            case 'gpTomAndroid':
+            case 'gpTomIos':
+                return gpTomBlock(daten);
+            case 'sumup':
+                return sumupBlock(daten);
+            case 'myposPro':
+                return myposBlock(daten);
+            case 'stripe':
+                return stripeBlock(daten, receipt.cardPaymentId ?? null);
+            default:
+                return [];
+        }
+    })();
+    if (zeilen.length === 0)
+        return [];
+    // Eine Leerzeile hinter JEDEM Block, nicht nur hinter manchen. Das Vorbild
+    // ist hier uneinheitlich (nur `_sumup` setzt am Ende ein `addFeed()`), was
+    // den Abstand zur Fusszeile vom Anbieter abhaengig machte. Die Leerzeile
+    // gehoert aber zum Blatt, nicht zum Terminal.
+    return [...zeilen, { kind: 'space', lines: 1 }];
+}
 function zahlungsartText(wert) {
     if (wert != null && typeof wert === 'object') {
         return wert.label;
@@ -697,7 +918,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
     lines.push({ kind: 'qr', data: receipt.qr });
     lines.push({ kind: 'space', lines: 1 });
     // --- Kartenzahlungsblock (Hobex) — wie im Vorbild UNTER dem QR-Code.
-    lines.push(...hobexKartenblock(receipt));
+    lines.push(...kartenblock(receipt));
     // --- Dankestext und Fusszeilen
     if (company.thanksMessage.length > 0) {
         lines.push({ kind: 'space', lines: 1 });

package/fixtures/belege/karte-eigener.json

@@ -0,0 +1,44 @@
+{
+  "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-66",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-08-13T10:15:30",
+    "items": [
+      {
+        "name": "Behandlung",
+        "quantity": 1,
+        "unitPriceCents": 12000,
+        "vatRate": 20
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "6F0404F0",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-66_2026-08-13T10:15:30_120,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "creditCardProvider": "custom"
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/belege/karte-gptom-ios.json

@@ -0,0 +1,59 @@
+{
+  "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-67",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-08-13T10:15:30",
+    "items": [
+      {
+        "name": "Behandlung",
+        "quantity": 1,
+        "unitPriceCents": 12000,
+        "vatRate": 20
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "6F0404F0",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-67_2026-08-13T10:15:30_120,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "creditCardProvider": "gpTomIos",
+    "cardPaymentData": {
+      "batchNumber": 12,
+      "externalTransactionID": "TX-9911",
+      "terminalID": "T-55",
+      "emvAid": "A0000000031010",
+      "emvAppLable": "VISA CREDIT",
+      "cardDataEntry": "CONTACTLESS",
+      "cardNumber": "**** **** **** 4720",
+      "currencyCode": "EUR",
+      "amount": 12000,
+      "pinOk": false,
+      "approvedCode": "123456",
+      "sequenceNumber": 42,
+      "transacitonType": 3
+    }
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/belege/karte-gptom.json

@@ -0,0 +1,59 @@
+{
+  "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-61",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-08-13T10:15:30",
+    "items": [
+      {
+        "name": "Behandlung",
+        "quantity": 1,
+        "unitPriceCents": 12000,
+        "vatRate": 20
+      }
+    ],
+    "vouchers": [],
+    "paymentMethod": "creditCard",
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "6F0404F0",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-61_2026-08-13T10:15:30_120,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_6F0404F0_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "creditCardProvider": "gpTomAndroid",
+    "cardPaymentData": {
+      "batchNumber": 12,
+      "externalTransactionID": "TX-9911",
+      "terminalID": "T-55",
+      "emvAid": "A0000000031010",
+      "emvAppLable": "VISA CREDIT",
+      "cardDataEntry": "CONTACTLESS",
+      "cardNumber": "**** **** **** 4720",
+      "currencyCode": "EUR",
+      "amount": 12000,
+      "pinOk": true,
+      "approvedCode": "123456",
+      "sequenceNumber": 42,
+      "transactionType": 1
+    }
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}