@kreiseck/kasseneck-api 0.7.2 → 0.9.0

package/dist/cjs/receipt/layout.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SMALL_BUSINESS_NOTICE = exports.AKTUELLES_REGELWERK = void 0;
 exports.formatCents = formatCents;
+exports.stripeReceiptLines = stripeReceiptLines;
 exports.receiptSignatureFailed = receiptSignatureFailed;
 exports.receiptSignatureIsTest = receiptSignatureIsTest;
 exports.receiptIsZero = receiptIsZero;
@@ -71,6 +72,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]
@@ -78,43 +109,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 = (0, vienna_time_js_1.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). */
+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;
@@ -708,7 +930,7 @@ 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/dist/esm/kasse/index.d.ts

@@ -10,3 +10,4 @@ export { verteileRabatt } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetzDrucker, type DruckJob, type DruckJobStatus, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, } from './texte.js';

package/dist/esm/kasse/index.js

@@ -14,3 +14,5 @@ export { verteileRabatt } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf } from '../register/pairing.js';
 export { listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
+// Was die Kasse selbst sagt — ein Katalog fuer Browser-Kasse und App.
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, } from './texte.js';

package/dist/esm/kasse/texte.d.ts

@@ -0,0 +1,336 @@
+/**
+ * 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.
+ */
+export type Seite = 'web' | 'app';
+export interface Meldung {
+    readonly text: string;
+    /** Erlaubte Platzhalter `{name}`; muessen exakt die im Text sein. */
+    readonly platzhalter?: readonly string[];
+    /** Fehlt es, gilt der Satz fuer beide Seiten. */
+    readonly nur?: readonly Seite[];
+}
+declare const MELDUNGEN_ROH: {
+    readonly 'netz.keine_verbindung': {
+        readonly text: "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.";
+    };
+    readonly 'netz.zeitablauf': {
+        readonly text: "Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.";
+    };
+    readonly 'server.unerwartet': {
+        readonly text: "Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.";
+        readonly platzhalter: readonly ["status"];
+    };
+    readonly 'kopplung.code_fehlt': {
+        readonly text: "Bitte den Kopplungs-Code eingeben.";
+    };
+    readonly 'kopplung.fehlgeschlagen': {
+        readonly text: "Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.";
+    };
+    readonly 'kopplung.unvollstaendig': {
+        readonly text: "Die Kopplung ist unvollständig zurückgekommen. Bitte im Panel einen neuen Code erzeugen und noch einmal versuchen.";
+    };
+    readonly 'geraet.browser_speicher': {
+        readonly text: "Dieses Gerät konnte nicht gespeichert werden — der Browser-Speicher steht nicht zur Verfügung. Bitte den privaten Modus verlassen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'anmeldung.pin_fehlt': {
+        readonly text: "Bitte die PIN eingeben.";
+    };
+    readonly 'anmeldung.fehlgeschlagen': {
+        readonly text: "Die Anmeldung ist fehlgeschlagen. Bitte erneut versuchen.";
+    };
+    readonly 'anmeldung.nicht_abgeschlossen': {
+        readonly text: "Die Anmeldung konnte nicht abgeschlossen werden. Bitte erneut versuchen.";
+    };
+    readonly 'anmeldung.wird_abgeschlossen': {
+        readonly text: "Anmeldung wird gerade abgeschlossen — bitte gleich noch einmal drücken.";
+    };
+    readonly 'sitzung.abgelaufen': {
+        readonly text: "Die Sitzung ist abgelaufen. Bitte erneut anmelden.";
+    };
+    readonly 'sitzung.abgelaufen_ohne_netz': {
+        readonly text: "Keine Verbindung zum Server — die Sitzung ist abgelaufen. Bitte erneut anmelden.";
+    };
+    readonly 'sitzung.keine': {
+        readonly text: "Keine Sitzung.";
+    };
+    readonly 'rechte.nicht_aenderbar': {
+        readonly text: "Das darfst du nicht ändern — das Recht dafür vergibt der Inhaber im Panel.";
+    };
+    readonly 'kasse.laden_fehlgeschlagen': {
+        readonly text: "Die Kasse konnte nicht geladen werden.";
+    };
+    readonly 'artikel.laden_fehlgeschlagen': {
+        readonly text: "Die Artikel konnten nicht geladen werden.";
+    };
+    readonly 'artikel.keine_freigegeben': {
+        readonly text: "Keine Artikel an dieser Kasse. Im Panel unter „Kacheln & Gruppen“ freischalten.";
+    };
+    readonly 'artikel.keine_gefunden': {
+        readonly text: "Keine Artikel gefunden.";
+    };
+    readonly 'artikel.steuersatz_unbekannt': {
+        readonly text: "„{name}“ hat einen Steuersatz, den die Kasse nicht kennt.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'position.betrag_fehlt': {
+        readonly text: "Bitte einen Betrag eingeben.";
+    };
+    readonly 'position.bezeichnung_fehlt': {
+        readonly text: "Bitte eine Bezeichnung eingeben — sie steht am Beleg.";
+    };
+    readonly 'rabatt.prozent_ungueltig': {
+        readonly text: "Bitte einen Prozentwert zwischen 0,1 und 100 eingeben.";
+    };
+    readonly 'abschluss.fehlgeschlagen': {
+        readonly text: "Der Abschluss ist fehlgeschlagen.";
+    };
+    readonly 'abschluss.unklar': {
+        readonly 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.";
+    };
+    readonly 'abschluss.nullbeleg_fehlgeschlagen': {
+        readonly text: "Der Nullbeleg konnte nicht erstellt werden.";
+    };
+    readonly 'abschluss.signatur_ausgefallen': {
+        readonly text: "Die Signatureinheit hat nicht geantwortet. Der Beleg ist gültig und trägt den Vermerk „Sicherheitseinrichtung ausgefallen“.";
+    };
+    readonly 'kartenzahlung.nicht_moeglich': {
+        readonly text: "Kartenzahlung nicht möglich.";
+    };
+    readonly 'kartenzahlung.nicht_zustande': {
+        readonly text: "Die Kartenzahlung ist nicht zustande gekommen.";
+    };
+    readonly 'kartenzahlung.nicht_gestartet': {
+        readonly text: "Kartenzahlung nicht gestartet: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'kartenzahlung.unklar': {
+        readonly 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.";
+    };
+    readonly 'kartenzahlung.unklar_mit_kennung': {
+        readonly 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}.";
+        readonly platzhalter: readonly ["kennung"];
+    };
+    readonly 'kartenzahlung.connect_nicht_verbunden': {
+        readonly text: "Kartenzahlung nicht möglich: Kasseneck Connect ist nicht verbunden — Einstellungen → Kasseneck Connect.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'terminal.keines_gefunden': {
+        readonly text: "Kein Hobex-Terminal gefunden — ist es eingeschaltet und im selben Netz wie dieser Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'terminal.nicht_bereit': {
+        readonly text: "Terminal antwortet, ist aber nicht betriebsbereit: {antwort} — TID prüfen.";
+        readonly platzhalter: readonly ["antwort"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'gptom.app_fehlt': {
+        readonly text: "Die GP-Tom-App ist auf diesem Gerät nicht da.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.suche_fehlgeschlagen': {
+        readonly text: "GP Tom: Suche nach der App fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.zahlung_fehlgeschlagen': {
+        readonly text: "GP Tom: Zahlung fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.terminal_antwortet_nicht': {
+        readonly text: "Das Terminal hat nicht geantwortet: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'gptom.zahlung_nicht_abgeschlossen': {
+        readonly text: "Die Zahlung wurde nicht abgeschlossen ({code}).";
+        readonly platzhalter: readonly ["code"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'belege.laden_fehlgeschlagen': {
+        readonly text: "Die Belege konnten nicht geladen werden.";
+    };
+    readonly 'belege.keine_im_zeitraum': {
+        readonly text: "Keine Belege in diesem Zeitraum.";
+    };
+    readonly 'beleg.laden_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht geladen werden.";
+    };
+    readonly 'beleg.nicht_gefunden': {
+        readonly text: "Der Beleg wurde nicht gefunden.";
+    };
+    readonly 'storno.fehlgeschlagen': {
+        readonly text: "Das Storno ist fehlgeschlagen.";
+    };
+    readonly 'storno.grund_fehlt': {
+        readonly text: "Bitte einen Grund wählen.";
+    };
+    readonly 'storno.position_fehlt': {
+        readonly text: "Bitte mindestens eine Position wählen.";
+    };
+    readonly 'druck.fehlgeschlagen': {
+        readonly text: "Der Ausdruck ist fehlgeschlagen.";
+    };
+    readonly 'druck.nicht_moeglich': {
+        readonly text: "Druck nicht möglich: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'druck.testdruck_fehlgeschlagen': {
+        readonly text: "Der Testdruck ist fehlgeschlagen.";
+    };
+    readonly 'druck.testdruck_nicht_moeglich': {
+        readonly text: "Der Testdruck ist fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+    };
+    readonly 'druck.kein_drucker': {
+        readonly text: "Kein Bondrucker eingerichtet — in den Einstellungen unter Drucker & Lade.";
+    };
+    readonly 'druck.drucker_nicht_erreichbar': {
+        readonly text: "Drucker nicht erreichbar.";
+    };
+    readonly 'druck.job_abgelaufen': {
+        readonly text: "Drucker hat den Beleg nicht abgeholt (abgelaufen).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.kein_drucker_gefunden': {
+        readonly text: "Kein Drucker gefunden — ist er eingeschaltet und im selben Netz wie dieser Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.nur_chrome': {
+        readonly text: "{weg}-Druck geht nur in Chrome oder Edge (Windows, Mac, Android) — nicht in Safari und nicht am iPad.";
+        readonly platzhalter: readonly ["weg"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'druck.kein_weg_drucker': {
+        readonly text: "Kein {weg}-Drucker verbunden — „{weg}-Drucker verbinden“ und den Drucker im Dialog wählen.";
+        readonly platzhalter: readonly ["weg"];
+        readonly nur: readonly ["web"];
+    };
+    readonly 'bluetooth.aus': {
+        readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'bluetooth.freigabe_fehlt': {
+        readonly text: "Bitte die Freigabe in den Geräte-Einstellungen erteilen.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'bluetooth.suche_fehlgeschlagen': {
+        readonly text: "Die Suche ist fehlgeschlagen: {grund}";
+        readonly platzhalter: readonly ["grund"];
+        readonly nur: readonly ["app"];
+    };
+    readonly 'connect.antwortet_nicht': {
+        readonly text: "Kasseneck Connect antwortet nicht — läuft das Programm auf diesem Rechner?";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.code_abgelaufen': {
+        readonly text: "Der Kopplungs-Code ist abgelaufen — im Agent einen neuen erzeugen („kasseneck-connect pair“).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.zu_viele_versuche': {
+        readonly text: "Zu viele Fehlversuche — eine Minute warten und noch einmal versuchen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.drucker_antwortet_nicht': {
+        readonly text: "Der Drucker antwortet nicht — Strom, Netzwerk und IP prüfen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.nicht_gekoppelt': {
+        readonly text: "Diese Kasse ist mit Kasseneck Connect nicht gekoppelt — in den Einstellungen „Koppeln“ drücken.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.drucker_unbekannt': {
+        readonly text: "Diesen Drucker kennt Kasseneck Connect nicht (mehr) — bitte neu suchen.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.ursprung_nicht_freigegeben': {
+        readonly text: "Kasseneck Connect nimmt von dieser Adresse nichts an (Ursprung nicht freigegeben).";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'connect.nicht_installiert': {
+        readonly text: "Kasseneck Connect nicht gefunden — bitte installieren.";
+        readonly nur: readonly ["web"];
+    };
+    readonly 'einstellungen.laden_fehlgeschlagen': {
+        readonly text: "Die Einstellungen konnten nicht geladen werden.";
+    };
+    readonly 'einstellungen.speichern_fehlgeschlagen': {
+        readonly text: "Die Einstellung konnte nicht gespeichert werden.";
+    };
+    readonly 'einstellungen.noch_nicht_geladen': {
+        readonly text: "Noch nicht geladen — bitte kurz warten oder neu anmelden.";
+    };
+    readonly 'einstellungen.ip_ungueltig': {
+        readonly text: "Keine gültige IP-Adresse (z. B. 192.168.1.50).";
+    };
+    readonly 'entkopplung.fehlgeschlagen': {
+        readonly text: "Entkoppeln fehlgeschlagen.";
+    };
+    readonly 'logo.hochladen_fehlgeschlagen': {
+        readonly text: "Hochladen fehlgeschlagen.";
+    };
+    readonly 'logo.entfernen_fehlgeschlagen': {
+        readonly text: "Entfernen fehlgeschlagen.";
+    };
+    readonly 'app.nicht_im_browser': {
+        readonly text: "Die Kassen-App läuft nicht im Browser — dafür gibt es kasse.kasseneck.at.";
+        readonly nur: readonly ["app"];
+    };
+    readonly 'app.im_browser_oeffnen': {
+        readonly text: "Bitte im Browser öffnen: {ziel}";
+        readonly platzhalter: readonly ["ziel"];
+        readonly nur: readonly ["app"];
+    };
+};
+export type MeldungsSchluessel = keyof typeof MELDUNGEN_ROH;
+export declare const MELDUNGEN: Record<MeldungsSchluessel, Meldung>;
+/**
+ * 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 declare const FEHLERREGELN: readonly [{
+    readonly art: "api";
+    readonly verhalten: "server_text";
+}, {
+    readonly art: "klartext";
+    readonly verhalten: "eigener_text";
+}, {
+    readonly art: "zeitablauf";
+    readonly schluessel: "netz.zeitablauf";
+}, {
+    readonly art: "netz";
+    readonly schluessel: "netz.keine_verbindung";
+}, {
+    readonly art: "unerwartet";
+    readonly schluessel: "server.unerwartet";
+}, {
+    readonly art: "sonst";
+    readonly verhalten: "ersatz";
+}];
+export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
+export declare function meldung(schluessel: MeldungsSchluessel, werte?: Record<string, string | number>): string;
+/** Gilt der Satz auf dieser Seite? */
+export declare function meldungGiltFuer(schluessel: MeldungsSchluessel, seite: Seite): boolean;
+export {};