@kreiseck/kasseneck-api 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -4,6 +4,79 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.9.3
+
+### `qrModus` am Geraet: mit welchem Befehl der Signatur-QR auf den Bon kommt
+
+**Anlass:** Der Drucker-Wizard laesst zwei Probedrucke machen — einen QR als
+Rasterbild, einen ueber den nativen ESC/POS-Befehl — und fragt, welcher lesbar
+war. Diese Antwort musste bisher nirgends hin: die Kassen druckten fest im
+Rastermodus. An Geraeten, die GS v 0 nicht koennen, kam damit ein Bon ohne
+lesbaren QR heraus, und das ist nach § 132a BAO keine Belegerteilung — der
+Ausfall faellt am Tresen niemandem auf.
+
+- `QR_MODUS` (`raster` | `escpos`) als Laufzeitliste und Typ `KasseQrModus`.
+- `KasseSettingsGeraet.qrModus`, Vorgabe `raster` — der bisherige Weg bleibt
+  damit fuer jedes bestehende Geraet unveraendert.
+- **Am Geraet und nicht am Betrieb:** welchen Befehl ein Thermodrucker
+  versteht, entscheidet das Modell an dieser einen Kasse.
+
+## 0.9.2
+
+### Sechzehn Saetze: einen Beleg weitergeben, und der Drucker-Wizard
+
+**Anlass:** Ein alter Beleg soll sich weitergeben lassen — Link kopieren,
+teilen, per E-Mail senden — und der Drucker richtet sich kuenftig ueber einen
+Wizard ein, der erst testet und bestaetigen laesst und dann speichert. Beides
+entsteht **gleichzeitig** in der Browser-Kasse und in der Kassen-App. Ohne
+diese Schluessel haetten beide Seiten dieselben sieben Lagen unabhaengig
+formuliert, und der Kassier haette zwei verschiedene Woerter fuer dieselbe
+Sache gelesen — genau das, wogegen es diesen Katalog gibt.
+
+- **Beleg weitergeben:** `beleg.link_kopiert`, `beleg.teilen_text`
+  (`betrieb`, `nummer`, `betrag`, `link`), `beleg.nicht_teilbar`,
+  `beleg.test_hinweis_teilen`.
+- **Per E-Mail senden:** `beleg.mail_gesendet` (`an`) und die vier Ausgaenge
+  `beleg.mail_adresse_ungueltig`, `beleg.mail_zu_oft`,
+  `beleg.mail_fehlgeschlagen`, `beleg.mail_nicht_gefunden`.
+- **Drucker-Wizard** (beide Kassen, deshalb ohne `nur`):
+  `druck.wizard_verbinden` (`name`), `druck.wizard_testdruck_frage`,
+  `druck.wizard_qr_frage`, `druck.wizard_qr_keiner_hinweis`,
+  `druck.wizard_nichts_gekommen`, `druck.wizard_gespeichert` (`name`),
+  `druck.wizard_abgebrochen`.
+
+**Neu: `BELEG_MAIL_FEHLER` und `belegMailFehler(code)`** — die Zuordnung vom
+`code` des Backends (`adresse_ungueltig`, `zu_oft`, `versand_fehlgeschlagen`,
+`beleg_nicht_gefunden`) auf den Satz. Grund: die vier Ausgaenge verlangen vom
+Kassier vier verschiedene Handlungen, und beide Kassen sollen am **Code**
+entscheiden statt an einer Formulierung, die sich im Backend jederzeit aendern
+darf. Ein unbekannter Code faellt auf `beleg.mail_fehlgeschlagen` zurueck — ein
+leerer Schirm waere schlimmer als ein zu allgemeiner Satz. Die Zuordnung steht
+als `belegMailFehler` mit in `fixtures/kasse-texte.json`, weil die App den
+Katalog aus dem Tarball liest und das Web die Quelle direkt importiert.
+
+Bewusst ein Objekt und **keine** Liste in Grossschrift: der
+Oberflaechen-Vertrag liest jede exportierte Liste als Enum der
+Kasseneinstellungen ein, und der Dart-Zwilling schickt deren Werte durch
+`KasseSettings.aus`. Fehlercodes haetten dort nichts verloren.
+
+**Abweichung von der Vorlage, bewusst:** `beleg.mail_nicht_gefunden` sagt
+„Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden." und
+nicht denselben Satz wie das schon vorhandene `beleg.nicht_gefunden`. Dort
+scheitert das Oeffnen, hier das Senden; der Kassier steht vor einem Adressfeld
+und muss lesen, dass nichts hinausgegangen ist. Ein Satz zweimal im Katalog
+faellt ohnehin schon seit 0.9.1 im Test auf.
+
+**Neue abgeleitete Pruefungen:** kein Satz zum Weitergeben eines Belegs ist an
+eine Seite gebunden; der Teilen-Text traegt den Link, und zwar am Schluss;
+jeder platzhalterlose `beleg.mail_`-Satz haengt an genau einem Backend-Code (und
+kein Code an zweien); der einzige `beleg.mail_`-Satz mit Platzhalter ist der
+ueber das Gelingen; jeder Satz des Wizards gilt auf beiden Seiten.
+
+`FEHLERREGELN` bleibt unveraendert: die Codes sind die Verfeinerung **eines**
+Aufrufs (`sendReceiptEmail`), keine neue Art, einen Transportfehler
+einzuordnen.
+
 ## 0.9.1
 
 ### Elf Saetze fuer die vier Ausgaenge einer Kartenzahlung und das Terminal-Protokoll

package/dist/cjs/kasse/index.d.ts

@@ -3,11 +3,11 @@
  * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
  * (die Rewrites-Waechter der Web-App leiten daraus ab).
  */
-export { type KasseStil, type KasseSchrift, type KasseWasserzeichen, type KasseMenge, type KasseTgModus, type KasseKassierenModus, type KasseKartenanbieter, KARTENANBIETER, type KasseBelegAusgabe, type KasseTastenAktion, type KasseTastenkarte, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, type KasseLayout, type KasseKatpos, type KasseHoehe, type KasseDruckerArt, type KasseTerminalVia, type KasseTerminalArt, type KassePapier, type KasseZeichensatz, type KasseSchnitt, type KasseLadeAuto, type KasseLogoGroesse, type KasseSchriftEinst, type KasseKachelstil, type KasseAutoAbMin, type KasseRabatt, type KasseWzSeite, type KasseWzStaerke, type KasseLogoSkala, type KasseWzSkala, type KasseFertigSekunden, type Schalterkarte, type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
+export { type KasseStil, type KasseSchrift, type KasseWasserzeichen, type KasseMenge, type KasseTgModus, type KasseKassierenModus, type KasseKartenanbieter, KARTENANBIETER, type KasseBelegAusgabe, type KasseTastenAktion, type KasseTastenkarte, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, type KasseLayout, type KasseKatpos, type KasseHoehe, type KasseDruckerArt, type KasseTerminalVia, type KasseTerminalArt, type KassePapier, type KasseZeichensatz, type KasseSchnitt, type KasseLadeAuto, type KasseQrModus, type KasseLogoGroesse, type KasseSchriftEinst, type KasseKachelstil, type KasseAutoAbMin, type KasseRabatt, type KasseWzSeite, type KasseWzStaerke, type KasseLogoSkala, type KasseWzSkala, type KasseFertigSekunden, type Schalterkarte, type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, QR_MODUS, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
 export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, type KasseArtikel, type KasseArtikelPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, type Mengenregel, type MengenVorgabe, mengenregelFuerEinheit, mengenVorgabe, mengeErlaubt, } from './artikel.js';
 export { getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings } from './client.js';
 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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, } from './texte.js';

package/dist/cjs/kasse/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.mengeErlaubt = exports.mengenVorgabe = exports.mengenregelFuerEinheit = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.TASTEN_AKTIONEN = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.KASSE_TASTEN_AKTIONEN = exports.KARTENANBIETER = void 0;
-exports.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = void 0;
+exports.createPrintJob = exports.listMyPrinters = exports.receiptsScopeOf = exports.cancelScopeOf = exports.verteileRabatt = exports.setMyRegisterDeviceSettings = exports.setMyKasseSettings = exports.getKasseSettings = exports.mengeErlaubt = exports.mengenVorgabe = exports.mengenregelFuerEinheit = exports.listMyArticles = exports.listMyArticleGroups = exports.fromKasseArtikelPayload = exports.fromArticleGroupPayload = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.TASTEN_AKTIONEN = exports.QR_MODUS = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = exports.mergeKasseSettings = exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.KASSE_TASTEN_AKTIONEN = exports.KARTENANBIETER = void 0;
+exports.belegMailFehler = exports.BELEG_MAIL_FEHLER = exports.meldungGiltFuer = exports.meldung = exports.FEHLERREGELN = exports.MELDUNGEN = exports.listMyTipRecipients = exports.getPrintJob = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
@@ -32,6 +32,7 @@ Object.defineProperty(exports, "PAPIER", { enumerable: true, get: function () {
 Object.defineProperty(exports, "ZEICHENSATZ", { enumerable: true, get: function () { return settings_js_1.ZEICHENSATZ; } });
 Object.defineProperty(exports, "SCHNITT", { enumerable: true, get: function () { return settings_js_1.SCHNITT; } });
 Object.defineProperty(exports, "LADE_AUTO", { enumerable: true, get: function () { return settings_js_1.LADE_AUTO; } });
+Object.defineProperty(exports, "QR_MODUS", { enumerable: true, get: function () { return settings_js_1.QR_MODUS; } });
 Object.defineProperty(exports, "TASTEN_AKTIONEN", { enumerable: true, get: function () { return settings_js_1.TASTEN_AKTIONEN; } });
 Object.defineProperty(exports, "LOGO_GROESSE", { enumerable: true, get: function () { return settings_js_1.LOGO_GROESSE; } });
 Object.defineProperty(exports, "SCHRIFT_EINST", { enumerable: true, get: function () { return settings_js_1.SCHRIFT_EINST; } });
@@ -74,3 +75,5 @@ Object.defineProperty(exports, "MELDUNGEN", { enumerable: true, get: function ()
 Object.defineProperty(exports, "FEHLERREGELN", { enumerable: true, get: function () { return texte_js_1.FEHLERREGELN; } });
 Object.defineProperty(exports, "meldung", { enumerable: true, get: function () { return texte_js_1.meldung; } });
 Object.defineProperty(exports, "meldungGiltFuer", { enumerable: true, get: function () { return texte_js_1.meldungGiltFuer; } });
+Object.defineProperty(exports, "BELEG_MAIL_FEHLER", { enumerable: true, get: function () { return texte_js_1.BELEG_MAIL_FEHLER; } });
+Object.defineProperty(exports, "belegMailFehler", { enumerable: true, get: function () { return texte_js_1.belegMailFehler; } });

package/dist/cjs/kasse/settings.d.ts

@@ -50,6 +50,21 @@ export declare const SCHNITT: readonly ["partial", "full", "none"];
 export type KasseSchnitt = typeof SCHNITT[number];
 export declare const LADE_AUTO: readonly ["bar", "immer", "nie"];
 export type KasseLadeAuto = typeof LADE_AUTO[number];
+/**
+ * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
+ *
+ * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
+ * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
+ * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
+ * Zeichensalat.
+ *
+ * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
+ * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
+ * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
+ * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
+ */
+export declare const QR_MODUS: readonly ["raster", "escpos"];
+export type KasseQrModus = typeof QR_MODUS[number];
 /** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
 export declare const LOGO_GROESSE: readonly ["S", "M", "L"];
 export type KasseLogoGroesse = typeof LOGO_GROESSE[number];
@@ -176,6 +191,8 @@ export interface KasseSettingsGeraet {
     papier: KassePapier;
     zeichensatz: KasseZeichensatz;
     schnitt: KasseSchnitt;
+    /** Befehl fuer den Signatur-QR auf dem Bon; der Drucker-Wizard probiert beide aus. */
+    qrModus: KasseQrModus;
     ladeAn: boolean;
     ladeAuto: KasseLadeAuto;
     terminalIp: string;

package/dist/cjs/kasse/settings.js

@@ -9,7 +9,7 @@
  * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.TASTEN_AKTIONEN = exports.KASSE_TASTEN_AKTIONEN = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KARTENANBIETER = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = void 0;
+exports.KASSE_GERAET_STANDARD = exports.KASSE_BETRIEB_STANDARD = exports.KASSE_TASTEN_STANDARD = exports.TASTEN_AKTIONEN = exports.KASSE_TASTEN_AKTIONEN = exports.FERTIG_SEKUNDEN = exports.WZ_SKALA = exports.LOGO_SKALA = exports.WZ_STAERKE = exports.WZ_SEITE = exports.RABATT = exports.AUTO_AB_MIN = exports.KACHELSTIL = exports.SCHRIFT_EINST = exports.LOGO_GROESSE = exports.QR_MODUS = exports.LADE_AUTO = exports.SCHNITT = exports.ZEICHENSATZ = exports.PAPIER = exports.TERMINAL_ART = exports.TERMINAL_VIA = exports.DRUCKER_ART = exports.HOEHE = exports.KATPOS = exports.LAYOUT = exports.BELEG_AUSGABE = exports.KARTENANBIETER = exports.KASSIEREN_MODUS = exports.TG_MODUS = exports.MENGE = exports.WASSERZEICHEN = exports.SCHRIFT = exports.STIL = void 0;
 exports.mergeKasseSettings = mergeKasseSettings;
 /*
  * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
@@ -42,6 +42,20 @@ exports.PAPIER = ['mm58', 'mm80'];
 exports.ZEICHENSATZ = ['CP1252', 'CP437'];
 exports.SCHNITT = ['partial', 'full', 'none'];
 exports.LADE_AUTO = ['bar', 'immer', 'nie'];
+/**
+ * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
+ *
+ * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
+ * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
+ * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
+ * Zeichensalat.
+ *
+ * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
+ * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
+ * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
+ * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
+ */
+exports.QR_MODUS = ['raster', 'escpos'];
 /*
  * Auch die uebrigen Wertemengen der Einstellungen stehen jetzt als Liste da —
  * vorher waren sie nur als Union am Feld ausgeschrieben. Ein Zwilling konnte
@@ -115,7 +129,7 @@ exports.KASSE_GERAET_STANDARD = Object.freeze({
     tasten: { ...exports.KASSE_TASTEN_STANDARD },
     druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerName: '', druckerId: '', druckerDevid: 'local_printer',
     connectDruckerId: '',
-    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial',
+    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial', qrModus: 'raster',
     ladeAn: false, ladeAuto: 'bar',
     terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
     terminalArt: 'keins', terminalTid: '', tastenMarken: true,

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

@@ -221,6 +221,35 @@ declare const MELDUNGEN_ROH: {
     readonly 'storno.position_fehlt': {
         readonly text: "Bitte mindestens eine Position wählen.";
     };
+    readonly 'beleg.link_kopiert': {
+        readonly text: "Der Link zum Beleg liegt in der Zwischenablage.";
+    };
+    readonly 'beleg.teilen_text': {
+        readonly text: "Beleg {nummer} von {betrieb} über {betrag}: {link}";
+        readonly platzhalter: readonly ["betrieb", "nummer", "betrag", "link"];
+    };
+    readonly 'beleg.nicht_teilbar': {
+        readonly text: "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.";
+    };
+    readonly 'beleg.test_hinweis_teilen': {
+        readonly text: "Test-Umgebung — der Beleg ist steuerlich nicht gültig.";
+    };
+    readonly 'beleg.mail_gesendet': {
+        readonly text: "Der Beleg wurde an {an} gesendet.";
+        readonly platzhalter: readonly ["an"];
+    };
+    readonly 'beleg.mail_adresse_ungueltig': {
+        readonly text: "Diese E-Mail-Adresse ist nicht gültig.";
+    };
+    readonly 'beleg.mail_zu_oft': {
+        readonly text: "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.";
+    };
+    readonly 'beleg.mail_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.";
+    };
+    readonly 'beleg.mail_nicht_gefunden': {
+        readonly text: "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.";
+    };
     readonly 'druck.fehlgeschlagen': {
         readonly text: "Der Ausdruck ist fehlgeschlagen.";
     };
@@ -259,6 +288,29 @@ declare const MELDUNGEN_ROH: {
         readonly platzhalter: readonly ["weg"];
         readonly nur: readonly ["web"];
     };
+    readonly 'druck.wizard_verbinden': {
+        readonly text: "Verbinde mit {name} …";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_testdruck_frage': {
+        readonly text: "Ist der Testdruck gekommen?";
+    };
+    readonly 'druck.wizard_qr_frage': {
+        readonly text: "Welcher QR-Code ist sauber gedruckt?";
+    };
+    readonly 'druck.wizard_qr_keiner_hinweis': {
+        readonly text: "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.";
+    };
+    readonly 'druck.wizard_nichts_gekommen': {
+        readonly text: "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?";
+    };
+    readonly 'druck.wizard_gespeichert': {
+        readonly text: "{name} ist eingerichtet.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_abgebrochen': {
+        readonly text: "Nichts gespeichert.";
+    };
     readonly 'bluetooth.aus': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
         readonly nur: readonly ["app"];
@@ -368,6 +420,37 @@ export declare const FEHLERREGELN: readonly [{
     readonly verhalten: "ersatz";
 }];
 export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export declare const BELEG_MAIL_FEHLER: {
+    readonly adresse_ungueltig: "beleg.mail_adresse_ungueltig";
+    readonly zu_oft: "beleg.mail_zu_oft";
+    readonly versand_fehlgeschlagen: "beleg.mail_fehlgeschlagen";
+    readonly beleg_nicht_gefunden: "beleg.mail_nicht_gefunden";
+};
+export type BelegMailFehlercode = keyof typeof BELEG_MAIL_FEHLER;
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export declare function belegMailFehler(code: string | undefined | null): MeldungsSchluessel;
 /** 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? */

package/dist/cjs/kasse/texte.js

@@ -16,7 +16,8 @@
  * auf einer Plattform vorkommen kann.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FEHLERREGELN = exports.MELDUNGEN = void 0;
+exports.BELEG_MAIL_FEHLER = exports.FEHLERREGELN = exports.MELDUNGEN = void 0;
+exports.belegMailFehler = belegMailFehler;
 exports.meldung = meldung;
 exports.meldungGiltFuer = meldungGiltFuer;
 const MELDUNGEN_ROH = {
@@ -95,6 +96,30 @@ const MELDUNGEN_ROH = {
     '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.' },
+    // --- Beleg weitergeben: Link, Teilen, E-Mail -----------------------------
+    // Kopieren, Teilen und Senden fuehren zu demselben Ziel: der oeffentlichen
+    // Belegseite (beleg.kasseneck.at/<fullReceiptId>). Kein Satz davon ist
+    // plattformgebunden — nur die Huelle unterscheidet sich, nicht das Wort.
+    'beleg.link_kopiert': { text: 'Der Link zum Beleg liegt in der Zwischenablage.' },
+    // Der Text, der beim Teilen mitgeht. Der Link steht am Schluss, damit ihn
+    // jede Huelle (SMS, Messenger, Mail) bis zum Ende als Link erkennt und nicht
+    // mitten im Satz abbricht.
+    'beleg.teilen_text': { text: 'Beleg {nummer} von {betrieb} über {betrag}: {link}', platzhalter: ['betrieb', 'nummer', 'betrag', 'link'] },
+    // Belege aus dem Altbestand tragen keine `fullReceiptId`; ohne sie gibt es
+    // keine Belegseite. Der Satz nennt den Grund, sonst sucht der Kassier den
+    // Fehler bei sich und versucht es ein zweites Mal.
+    'beleg.nicht_teilbar': { text: 'Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.' },
+    // Ein Testbeleg hat eine Belegseite, ist aber steuerlich nichts wert. Wer
+    // den Link weitergibt, muss das vorher lesen, nicht hinterher.
+    'beleg.test_hinweis_teilen': { text: 'Test-Umgebung — der Beleg ist steuerlich nicht gültig.' },
+    'beleg.mail_gesendet': { text: 'Der Beleg wurde an {an} gesendet.', platzhalter: ['an'] },
+    'beleg.mail_adresse_ungueltig': { text: 'Diese E-Mail-Adresse ist nicht gültig.' },
+    'beleg.mail_zu_oft': { text: 'Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.' },
+    'beleg.mail_fehlgeschlagen': { text: 'Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.' },
+    // Bewusst nicht derselbe Satz wie `beleg.nicht_gefunden`: dort scheitert das
+    // Oeffnen, hier das Senden. Der Kassier steht vor einem Adressfeld und muss
+    // lesen, dass nichts hinausgegangen ist.
+    'beleg.mail_nicht_gefunden': { text: 'Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.' },
     // --- Druck ---------------------------------------------------------------
     'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
     'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
@@ -106,6 +131,22 @@ const MELDUNGEN_ROH = {
     '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'] },
+    // Der Drucker-Wizard: suchen, verbinden, Testdruck, QR-Probe, erst dann
+    // speichern. Derselbe Ablauf in beiden Kassen — deshalb hat kein Satz ein
+    // `nur`, obwohl der Weg zum Drucker verschieden ist (Bluetooth in der App,
+    // Web Bluetooth im Browser). Was der Chef liest, ist beidesmal dasselbe.
+    'druck.wizard_verbinden': { text: 'Verbinde mit {name} …', platzhalter: ['name'] },
+    'druck.wizard_testdruck_frage': { text: 'Ist der Testdruck gekommen?' },
+    'druck.wizard_qr_frage': { text: 'Welcher QR-Code ist sauber gedruckt?' },
+    // Kein Modus druckt einen lesbaren QR-Code: gespeichert wird trotzdem (mit
+    // Raster als Vorgabe), aber der Chef muss wissen, dass der QR-Code dann vom
+    // Bildschirm gelesen werden muss — nach RKSV gehoert er an den Beleg.
+    'druck.wizard_qr_keiner_hinweis': { text: 'Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.' },
+    'druck.wizard_nichts_gekommen': { text: 'Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?' },
+    'druck.wizard_gespeichert': { text: '{name} ist eingerichtet.', platzhalter: ['name'] },
+    // Abbrechen an jeder Stelle: nichts gespeichert. Der Satz sagt genau das,
+    // damit niemand einen halb eingerichteten Drucker vermutet.
+    'druck.wizard_abgebrochen': { text: 'Nichts gespeichert.' },
     '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'] },
@@ -153,6 +194,39 @@ exports.FEHLERREGELN = [
     { art: 'unerwartet', schluessel: 'server.unerwartet' },
     { art: 'sonst', verhalten: 'ersatz' },
 ];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+exports.BELEG_MAIL_FEHLER = {
+    adresse_ungueltig: 'beleg.mail_adresse_ungueltig',
+    zu_oft: 'beleg.mail_zu_oft',
+    versand_fehlgeschlagen: 'beleg.mail_fehlgeschlagen',
+    beleg_nicht_gefunden: 'beleg.mail_nicht_gefunden',
+};
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+function belegMailFehler(code) {
+    const fehler = exports.BELEG_MAIL_FEHLER;
+    return (code !== undefined && code !== null && fehler[code]) || 'beleg.mail_fehlgeschlagen';
+}
 /** Der Satz zum Schluessel, Platzhalter ersetzt. Fehlt ein Wert, wirft es — ein `{status}` am Tresen waere schlimmer. */
 function meldung(schluessel, werte = {}) {
     const eintrag = exports.MELDUNGEN[schluessel];

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

@@ -3,11 +3,11 @@
  * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
  * (die Rewrites-Waechter der Web-App leiten daraus ab).
  */
-export { type KasseStil, type KasseSchrift, type KasseWasserzeichen, type KasseMenge, type KasseTgModus, type KasseKassierenModus, type KasseKartenanbieter, KARTENANBIETER, type KasseBelegAusgabe, type KasseTastenAktion, type KasseTastenkarte, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, type KasseLayout, type KasseKatpos, type KasseHoehe, type KasseDruckerArt, type KasseTerminalVia, type KasseTerminalArt, type KassePapier, type KasseZeichensatz, type KasseSchnitt, type KasseLadeAuto, type KasseLogoGroesse, type KasseSchriftEinst, type KasseKachelstil, type KasseAutoAbMin, type KasseRabatt, type KasseWzSeite, type KasseWzStaerke, type KasseLogoSkala, type KasseWzSkala, type KasseFertigSekunden, type Schalterkarte, type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
+export { type KasseStil, type KasseSchrift, type KasseWasserzeichen, type KasseMenge, type KasseTgModus, type KasseKassierenModus, type KasseKartenanbieter, KARTENANBIETER, type KasseBelegAusgabe, type KasseTastenAktion, type KasseTastenkarte, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, type KasseLayout, type KasseKatpos, type KasseHoehe, type KasseDruckerArt, type KasseTerminalVia, type KasseTerminalArt, type KassePapier, type KasseZeichensatz, type KasseSchnitt, type KasseLadeAuto, type KasseQrModus, type KasseLogoGroesse, type KasseSchriftEinst, type KasseKachelstil, type KasseAutoAbMin, type KasseRabatt, type KasseWzSeite, type KasseWzStaerke, type KasseLogoSkala, type KasseWzSkala, type KasseFertigSekunden, type Schalterkarte, type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, QR_MODUS, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
 export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, type KasseArtikel, type KasseArtikelPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, type Mengenregel, type MengenVorgabe, mengenregelFuerEinheit, mengenVorgabe, mengeErlaubt, } from './artikel.js';
 export { getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings } from './client.js';
 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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, } from './texte.js';

package/dist/esm/kasse/index.js

@@ -5,7 +5,7 @@
  */
 export { KARTENANBIETER, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, 
 // Die Enums als Laufzeitlisten — dieselben Werte, die die Typen oben tragen.
-STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
+STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, QR_MODUS, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
 export { fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, mengenregelFuerEinheit, mengenVorgabe, mengeErlaubt, } from './artikel.js';
 export { getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings } from './client.js';
 export { verteileRabatt } from '../receipt/discount.js';
@@ -15,4 +15,4 @@ 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';
+export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, } from './texte.js';

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

@@ -50,6 +50,21 @@ export declare const SCHNITT: readonly ["partial", "full", "none"];
 export type KasseSchnitt = typeof SCHNITT[number];
 export declare const LADE_AUTO: readonly ["bar", "immer", "nie"];
 export type KasseLadeAuto = typeof LADE_AUTO[number];
+/**
+ * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
+ *
+ * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
+ * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
+ * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
+ * Zeichensalat.
+ *
+ * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
+ * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
+ * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
+ * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
+ */
+export declare const QR_MODUS: readonly ["raster", "escpos"];
+export type KasseQrModus = typeof QR_MODUS[number];
 /** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
 export declare const LOGO_GROESSE: readonly ["S", "M", "L"];
 export type KasseLogoGroesse = typeof LOGO_GROESSE[number];
@@ -176,6 +191,8 @@ export interface KasseSettingsGeraet {
     papier: KassePapier;
     zeichensatz: KasseZeichensatz;
     schnitt: KasseSchnitt;
+    /** Befehl fuer den Signatur-QR auf dem Bon; der Drucker-Wizard probiert beide aus. */
+    qrModus: KasseQrModus;
     ladeAn: boolean;
     ladeAuto: KasseLadeAuto;
     terminalIp: string;

package/dist/esm/kasse/settings.js

@@ -38,6 +38,20 @@ export const PAPIER = ['mm58', 'mm80'];
 export const ZEICHENSATZ = ['CP1252', 'CP437'];
 export const SCHNITT = ['partial', 'full', 'none'];
 export const LADE_AUTO = ['bar', 'immer', 'nie'];
+/**
+ * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
+ *
+ * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
+ * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
+ * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
+ * Zeichensalat.
+ *
+ * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
+ * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
+ * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
+ * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
+ */
+export const QR_MODUS = ['raster', 'escpos'];
 /*
  * Auch die uebrigen Wertemengen der Einstellungen stehen jetzt als Liste da —
  * vorher waren sie nur als Union am Feld ausgeschrieben. Ein Zwilling konnte
@@ -111,7 +125,7 @@ export const KASSE_GERAET_STANDARD = Object.freeze({
     tasten: { ...KASSE_TASTEN_STANDARD },
     druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerName: '', druckerId: '', druckerDevid: 'local_printer',
     connectDruckerId: '',
-    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial',
+    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial', qrModus: 'raster',
     ladeAn: false, ladeAuto: 'bar',
     terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
     terminalArt: 'keins', terminalTid: '', tastenMarken: true,

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

@@ -221,6 +221,35 @@ declare const MELDUNGEN_ROH: {
     readonly 'storno.position_fehlt': {
         readonly text: "Bitte mindestens eine Position wählen.";
     };
+    readonly 'beleg.link_kopiert': {
+        readonly text: "Der Link zum Beleg liegt in der Zwischenablage.";
+    };
+    readonly 'beleg.teilen_text': {
+        readonly text: "Beleg {nummer} von {betrieb} über {betrag}: {link}";
+        readonly platzhalter: readonly ["betrieb", "nummer", "betrag", "link"];
+    };
+    readonly 'beleg.nicht_teilbar': {
+        readonly text: "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.";
+    };
+    readonly 'beleg.test_hinweis_teilen': {
+        readonly text: "Test-Umgebung — der Beleg ist steuerlich nicht gültig.";
+    };
+    readonly 'beleg.mail_gesendet': {
+        readonly text: "Der Beleg wurde an {an} gesendet.";
+        readonly platzhalter: readonly ["an"];
+    };
+    readonly 'beleg.mail_adresse_ungueltig': {
+        readonly text: "Diese E-Mail-Adresse ist nicht gültig.";
+    };
+    readonly 'beleg.mail_zu_oft': {
+        readonly text: "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.";
+    };
+    readonly 'beleg.mail_fehlgeschlagen': {
+        readonly text: "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.";
+    };
+    readonly 'beleg.mail_nicht_gefunden': {
+        readonly text: "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.";
+    };
     readonly 'druck.fehlgeschlagen': {
         readonly text: "Der Ausdruck ist fehlgeschlagen.";
     };
@@ -259,6 +288,29 @@ declare const MELDUNGEN_ROH: {
         readonly platzhalter: readonly ["weg"];
         readonly nur: readonly ["web"];
     };
+    readonly 'druck.wizard_verbinden': {
+        readonly text: "Verbinde mit {name} …";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_testdruck_frage': {
+        readonly text: "Ist der Testdruck gekommen?";
+    };
+    readonly 'druck.wizard_qr_frage': {
+        readonly text: "Welcher QR-Code ist sauber gedruckt?";
+    };
+    readonly 'druck.wizard_qr_keiner_hinweis': {
+        readonly text: "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.";
+    };
+    readonly 'druck.wizard_nichts_gekommen': {
+        readonly text: "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?";
+    };
+    readonly 'druck.wizard_gespeichert': {
+        readonly text: "{name} ist eingerichtet.";
+        readonly platzhalter: readonly ["name"];
+    };
+    readonly 'druck.wizard_abgebrochen': {
+        readonly text: "Nichts gespeichert.";
+    };
     readonly 'bluetooth.aus': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
         readonly nur: readonly ["app"];
@@ -368,6 +420,37 @@ export declare const FEHLERREGELN: readonly [{
     readonly verhalten: "ersatz";
 }];
 export type Fehlerart = (typeof FEHLERREGELN)[number]['art'];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export declare const BELEG_MAIL_FEHLER: {
+    readonly adresse_ungueltig: "beleg.mail_adresse_ungueltig";
+    readonly zu_oft: "beleg.mail_zu_oft";
+    readonly versand_fehlgeschlagen: "beleg.mail_fehlgeschlagen";
+    readonly beleg_nicht_gefunden: "beleg.mail_nicht_gefunden";
+};
+export type BelegMailFehlercode = keyof typeof BELEG_MAIL_FEHLER;
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export declare function belegMailFehler(code: string | undefined | null): MeldungsSchluessel;
 /** 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? */

package/dist/esm/kasse/texte.js

@@ -90,6 +90,30 @@ const MELDUNGEN_ROH = {
     '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.' },
+    // --- Beleg weitergeben: Link, Teilen, E-Mail -----------------------------
+    // Kopieren, Teilen und Senden fuehren zu demselben Ziel: der oeffentlichen
+    // Belegseite (beleg.kasseneck.at/<fullReceiptId>). Kein Satz davon ist
+    // plattformgebunden — nur die Huelle unterscheidet sich, nicht das Wort.
+    'beleg.link_kopiert': { text: 'Der Link zum Beleg liegt in der Zwischenablage.' },
+    // Der Text, der beim Teilen mitgeht. Der Link steht am Schluss, damit ihn
+    // jede Huelle (SMS, Messenger, Mail) bis zum Ende als Link erkennt und nicht
+    // mitten im Satz abbricht.
+    'beleg.teilen_text': { text: 'Beleg {nummer} von {betrieb} über {betrag}: {link}', platzhalter: ['betrieb', 'nummer', 'betrag', 'link'] },
+    // Belege aus dem Altbestand tragen keine `fullReceiptId`; ohne sie gibt es
+    // keine Belegseite. Der Satz nennt den Grund, sonst sucht der Kassier den
+    // Fehler bei sich und versucht es ein zweites Mal.
+    'beleg.nicht_teilbar': { text: 'Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse.' },
+    // Ein Testbeleg hat eine Belegseite, ist aber steuerlich nichts wert. Wer
+    // den Link weitergibt, muss das vorher lesen, nicht hinterher.
+    'beleg.test_hinweis_teilen': { text: 'Test-Umgebung — der Beleg ist steuerlich nicht gültig.' },
+    'beleg.mail_gesendet': { text: 'Der Beleg wurde an {an} gesendet.', platzhalter: ['an'] },
+    'beleg.mail_adresse_ungueltig': { text: 'Diese E-Mail-Adresse ist nicht gültig.' },
+    'beleg.mail_zu_oft': { text: 'Dieser Beleg wurde schon oft gesendet — bitte später noch einmal.' },
+    'beleg.mail_fehlgeschlagen': { text: 'Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen.' },
+    // Bewusst nicht derselbe Satz wie `beleg.nicht_gefunden`: dort scheitert das
+    // Oeffnen, hier das Senden. Der Kassier steht vor einem Adressfeld und muss
+    // lesen, dass nichts hinausgegangen ist.
+    'beleg.mail_nicht_gefunden': { text: 'Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden.' },
     // --- Druck ---------------------------------------------------------------
     'druck.fehlgeschlagen': { text: 'Der Ausdruck ist fehlgeschlagen.' },
     'druck.nicht_moeglich': { text: 'Druck nicht möglich: {grund}', platzhalter: ['grund'] },
@@ -101,6 +125,22 @@ const MELDUNGEN_ROH = {
     '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'] },
+    // Der Drucker-Wizard: suchen, verbinden, Testdruck, QR-Probe, erst dann
+    // speichern. Derselbe Ablauf in beiden Kassen — deshalb hat kein Satz ein
+    // `nur`, obwohl der Weg zum Drucker verschieden ist (Bluetooth in der App,
+    // Web Bluetooth im Browser). Was der Chef liest, ist beidesmal dasselbe.
+    'druck.wizard_verbinden': { text: 'Verbinde mit {name} …', platzhalter: ['name'] },
+    'druck.wizard_testdruck_frage': { text: 'Ist der Testdruck gekommen?' },
+    'druck.wizard_qr_frage': { text: 'Welcher QR-Code ist sauber gedruckt?' },
+    // Kein Modus druckt einen lesbaren QR-Code: gespeichert wird trotzdem (mit
+    // Raster als Vorgabe), aber der Chef muss wissen, dass der QR-Code dann vom
+    // Bildschirm gelesen werden muss — nach RKSV gehoert er an den Beleg.
+    'druck.wizard_qr_keiner_hinweis': { text: 'Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm.' },
+    'druck.wizard_nichts_gekommen': { text: 'Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?' },
+    'druck.wizard_gespeichert': { text: '{name} ist eingerichtet.', platzhalter: ['name'] },
+    // Abbrechen an jeder Stelle: nichts gespeichert. Der Satz sagt genau das,
+    // damit niemand einen halb eingerichteten Drucker vermutet.
+    'druck.wizard_abgebrochen': { text: 'Nichts gespeichert.' },
     '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'] },
@@ -148,6 +188,39 @@ export const FEHLERREGELN = [
     { art: 'unerwartet', schluessel: 'server.unerwartet' },
     { art: 'sonst', verhalten: 'ersatz' },
 ];
+/**
+ * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
+ *
+ * `FEHLERREGELN` bleibt davon unberuehrt — das hier ist keine neue Art, einen
+ * Transportfehler einzuordnen, sondern die Verfeinerung EINES Aufrufs
+ * (`sendReceiptEmail`). Die vier Ausgaenge sind fuer den Kassier vier
+ * verschiedene Handlungen: Adresse verbessern, spaeter noch einmal, noch
+ * einmal senden, Beleg suchen. Beide Kassen entscheiden am `code`, nicht am
+ * Satz des Backends — sonst haengt das Wort am Tresen an einer Formulierung,
+ * die sich im Backend jederzeit aendern darf.
+ *
+ * Bewusst ein Objekt und keine Liste in GROSSSCHRIFT: der
+ * Oberflaechen-Vertrag (`fixtures/oberflaeche.json`) liest jede exportierte
+ * Liste als Enum der Kasseneinstellungen ein, und der Dart-Zwilling schickt
+ * deren Werte durch `KasseSettings.aus`. Fehlercodes haben dort nichts
+ * verloren; sie stehen in `fixtures/kasse-texte.json`.
+ */
+export const BELEG_MAIL_FEHLER = {
+    adresse_ungueltig: 'beleg.mail_adresse_ungueltig',
+    zu_oft: 'beleg.mail_zu_oft',
+    versand_fehlgeschlagen: 'beleg.mail_fehlgeschlagen',
+    beleg_nicht_gefunden: 'beleg.mail_nicht_gefunden',
+};
+/**
+ * Der Satz zu einem `code` des Backends. Einen Code, den dieses Paket noch
+ * nicht kennt, faengt der allgemeine Satz auf: das Senden ist gescheitert und
+ * darf wiederholt werden. Ein leerer Schirm waere schlimmer als ein zu
+ * allgemeiner Satz.
+ */
+export function belegMailFehler(code) {
+    const fehler = BELEG_MAIL_FEHLER;
+    return (code !== undefined && code !== null && fehler[code]) || 'beleg.mail_fehlgeschlagen';
+}
 /** 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];

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.3",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-settings-standard.json

@@ -134,6 +134,7 @@
     "papier": "mm80",
     "zeichensatz": "CP1252",
     "schnitt": "partial",
+    "qrModus": "raster",
     "ladeAn": false,
     "ladeAuto": "bar",
     "terminalIp": "",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.3",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."
@@ -255,6 +255,42 @@
     "storno.position_fehlt": {
       "text": "Bitte mindestens eine Position wählen."
     },
+    "beleg.link_kopiert": {
+      "text": "Der Link zum Beleg liegt in der Zwischenablage."
+    },
+    "beleg.teilen_text": {
+      "text": "Beleg {nummer} von {betrieb} über {betrag}: {link}",
+      "platzhalter": [
+        "betrieb",
+        "nummer",
+        "betrag",
+        "link"
+      ]
+    },
+    "beleg.nicht_teilbar": {
+      "text": "Für diesen Beleg gibt es keinen Link — er stammt aus einer älteren Kasse."
+    },
+    "beleg.test_hinweis_teilen": {
+      "text": "Test-Umgebung — der Beleg ist steuerlich nicht gültig."
+    },
+    "beleg.mail_gesendet": {
+      "text": "Der Beleg wurde an {an} gesendet.",
+      "platzhalter": [
+        "an"
+      ]
+    },
+    "beleg.mail_adresse_ungueltig": {
+      "text": "Diese E-Mail-Adresse ist nicht gültig."
+    },
+    "beleg.mail_zu_oft": {
+      "text": "Dieser Beleg wurde schon oft gesendet — bitte später noch einmal."
+    },
+    "beleg.mail_fehlgeschlagen": {
+      "text": "Der Beleg konnte nicht gesendet werden. Bitte noch einmal versuchen."
+    },
+    "beleg.mail_nicht_gefunden": {
+      "text": "Dieser Beleg wurde nicht gefunden — er konnte nicht gesendet werden."
+    },
     "druck.fehlgeschlagen": {
       "text": "Der Ausdruck ist fehlgeschlagen."
     },
@@ -309,6 +345,33 @@
         "web"
       ]
     },
+    "druck.wizard_verbinden": {
+      "text": "Verbinde mit {name} …",
+      "platzhalter": [
+        "name"
+      ]
+    },
+    "druck.wizard_testdruck_frage": {
+      "text": "Ist der Testdruck gekommen?"
+    },
+    "druck.wizard_qr_frage": {
+      "text": "Welcher QR-Code ist sauber gedruckt?"
+    },
+    "druck.wizard_qr_keiner_hinweis": {
+      "text": "Kein QR-Code kam sauber — der Beleg zeigt den QR-Code dann am Bildschirm."
+    },
+    "druck.wizard_nichts_gekommen": {
+      "text": "Nichts gekommen? Drucker an, Papier drin, richtiges Gerät gewählt?"
+    },
+    "druck.wizard_gespeichert": {
+      "text": "{name} ist eingerichtet.",
+      "platzhalter": [
+        "name"
+      ]
+    },
+    "druck.wizard_abgebrochen": {
+      "text": "Nichts gespeichert."
+    },
     "bluetooth.aus": {
       "text": "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.",
       "nur": [
@@ -440,5 +503,11 @@
       "art": "sonst",
       "verhalten": "ersatz"
     }
-  ]
+  ],
+  "belegMailFehler": {
+    "adresse_ungueltig": "beleg.mail_adresse_ungueltig",
+    "zu_oft": "beleg.mail_zu_oft",
+    "versand_fehlgeschlagen": "beleg.mail_fehlgeschlagen",
+    "beleg_nicht_gefunden": "beleg.mail_nicht_gefunden"
+  }
 }

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.9.1",
+  "version": "0.9.3",
   "aufrufe": [
     "activateCashregister",
     "cancelReceipt",
@@ -138,6 +138,10 @@
       "mm58",
       "mm80"
     ],
+    "qrModus": [
+      "raster",
+      "escpos"
+    ],
     "rabatt": [
       "aus",
       "an"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "JavaScript-Zwilling von kasseneck_api (Flutter) fuer das Kasseneck-Backend",
   "license": "Apache-2.0",
   "author": "Kreiseck",