@kreiseck/kasseneck-api 0.6.9 → 0.6.45

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

@@ -27,7 +27,36 @@ export interface ReceiptItem {
     quantity: number;
     vat: VatRate | number;
     priceCents: number;
+    /**
+     * Trinkgeld-Position (vom Backend aus dem Parameter `tip` erzeugt, siehe
+     * [ReceiptCommonOptions.tip]) oder Rabatt-Position (`verteileRabatt`).
+     * Mitarbeiter-Trinkgeld ist Durchlaeufer (0 %, kein Umsatz),
+     * Inhaber-Trinkgeld (`recipient.owner`) Umsatz. Rabatt-Positionen sind
+     * negative Entgeltminderungen je Steuersatz; die Kennzeichnung steuert nur
+     * die Bon-Darstellung (Summenzeile mit Aufteilung), nie die Beträge.
+     */
+    kind?: 'tip' | 'discount';
+    /** Empfaenger der Trinkgeld-Position; `null` = nicht zugeordnet. */
+    recipient?: TipRecipient | null;
+    /** Zahlart der Trinkgeld-Position (kann von der des Belegs abweichen). */
+    paymentMethod?: string;
+    /**
+     * Artikel-Verweis (Artikelstamm) — Grundlage der Erloesgruppen-Zuordnung
+     * im Bericht. Optional; Handeingaben haben keinen.
+     */
+    articleId?: string;
 }
+/** Empfaenger einer Trinkgeld-Position (Kassen-Benutzer, Snapshot des Namens). */
+export interface TipRecipient {
+    registerUserId: string;
+    name: string;
+    /** true: Inhaber — das Trinkgeld ist Umsatz mit USt. */
+    owner?: boolean;
+}
+/** Trinkgeld-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export declare function isTipItem(item: ReceiptItem | ReceiptItemPayloadRead): boolean;
+/** Rabatt-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export declare function isDiscountItem(item: ReceiptItem | ReceiptItemPayloadRead): boolean;
 /**
  * Nutzlast-Form, die dieses Paket **schreibt** (v2):
  * `{ name, quantity, unitPriceCents, vatRate }`.
@@ -37,6 +66,12 @@ export interface ReceiptItemPayload {
     quantity: number;
     unitPriceCents: number;
     vatRate: number;
+    /** Trinkgeld-/Rabatt-Kennzeichnung, siehe [ReceiptItem.kind]. */
+    kind?: 'tip' | 'discount';
+    recipient?: TipRecipient | null;
+    paymentMethod?: string;
+    /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
+    articleId?: string;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest** — v2 und v1 nebeneinander, alles
@@ -54,6 +89,10 @@ export interface ReceiptItemPayload {
  */
 export interface ReceiptItemPayloadRead {
     name?: string | null;
+    /** Trinkgeld-Position (Backend), siehe [ReceiptItem.kind]. */
+    kind?: string | null;
+    recipient?: TipRecipient | null;
+    paymentMethod?: string | null;
     /** v2: Menge */
     quantity?: number | null;
     /** v2: Einzelpreis in Cent */
@@ -68,6 +107,8 @@ export interface ReceiptItemPayloadRead {
     priceOne?: number | null;
     /** v1: Steuersatz */
     vat?: number | null;
+    /** Artikel-Verweis, siehe [ReceiptItem.articleId]. */
+    articleId?: string | null;
 }
 export declare function toReceiptItemPayload(item: ReceiptItem): ReceiptItemPayload;
 /**

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

@@ -1,16 +1,41 @@
 import { VatRate } from '../enums/index.js';
 import { readVatRateByRate, requireVatRateByRate } from './enum-payload.js';
+/** Trinkgeld-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export function isTipItem(item) {
+    return item != null && item.kind === 'tip';
+}
+/** Rabatt-Position? Die eine Erkennungsstelle — niemand prueft `kind` selbst. */
+export function isDiscountItem(item) {
+    return item != null && item.kind === 'discount';
+}
 export function toReceiptItemPayload(item) {
     // Schreibpfad bleibt streng: ein unaufgeloester (unbekannter) Steuersatz
     // darf nicht unbesehen wieder hinausgehen.
     const vat = typeof item.vat === 'number' ? requireVatRateByRate(item.vat) : item.vat;
     pruefeMenge(item.quantity);
-    return {
+    const nutzlast = {
         name: item.name,
         quantity: item.quantity,
         unitPriceCents: item.priceCents,
         vatRate: vat.rate,
     };
+    // Trinkgeld-Kennzeichnung reist mit — sonst wuerde ein Storno dieser
+    // Position am Backend als Warenzeile ankommen und aus den Trinkgeld-
+    // Aggregaten nicht wieder herausgerechnet.
+    if (item.kind === 'tip') {
+        nutzlast.kind = 'tip';
+        nutzlast.recipient = item.recipient ?? null;
+        if (item.paymentMethod != null)
+            nutzlast.paymentMethod = item.paymentMethod;
+    }
+    // Rabatt-Kennzeichnung reist mit — sonst kaeme ein Storno dieser Position
+    // am Bon wieder als gewoehnliche Warenzeile mit "1 x" an.
+    if (item.kind === 'discount')
+        nutzlast.kind = 'discount';
+    // Artikel-Verweis reist mit (Erloesgruppen im Bericht); leere Werte nicht.
+    if (item.articleId != null && item.articleId !== '')
+        nutzlast.articleId = item.articleId;
+    return nutzlast;
 }
 /**
  * Liest beide Nutzlast-Formen (siehe [ReceiptItemPayloadRead]). Reihenfolge
@@ -39,6 +64,19 @@ export function fromReceiptItemPayload(payload) {
         // der Fall entsteht also nur bei einer kaputten Nutzlast).
         vat: satz != null ? readVatRateByRate(satz) : VatRate.vat0,
         priceCents: cents != null ? Math.round(cents) : euro != null ? Math.round(euro * 100) : 0,
+        // Trinkgeld-Felder nur, wenn es wirklich eine Tip-Position ist: eine
+        // Warenzeile bleibt so schlank wie bisher (Golden-Belege, deepEqual).
+        ...(payload.kind === 'tip'
+            ? {
+                kind: 'tip',
+                recipient: payload.recipient ?? null,
+                ...(payload.paymentMethod != null ? { paymentMethod: payload.paymentMethod } : {}),
+            }
+            : payload.kind === 'discount'
+                ? { kind: 'discount' }
+                : {}),
+        // Artikel-Verweis erhalten (Storno-Spiegelung schreibt ihn wieder mit).
+        ...(typeof payload.articleId === 'string' && payload.articleId !== '' ? { articleId: payload.articleId } : {}),
     };
 }
 /** Erster brauchbarer Zahlenwert der Reihe; `null`/`undefined`/NaN zaehlen nicht. */

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

@@ -41,6 +41,11 @@ export interface Receipt {
     legalMessage: string[];
     signatureSuccess?: boolean;
     customProjectId?: string;
+    /**
+     * Summe aller Trinkgeld-Positionen in Cent (Storno negativ) — abgeleitetes
+     * Lesefeld des Backends, nur vorhanden, wenn der Beleg Trinkgeld traegt.
+     */
+    tipCents?: number;
     /** Nur am Storno-Beleg: das stornierte Original. */
     cancellationOf?: CancellationOf;
     /** Nur am Storno-Beleg: Grund-Code aus [CANCELLATION_REASONS]. */
@@ -71,6 +76,8 @@ export interface ReceiptPayload {
     legalMessage: string;
     signatureSuccess: boolean | null;
     customProjectId: string | null;
+    /** Nur bei Belegen mit Trinkgeld (siehe [Receipt.tipCents]). */
+    tipCents?: number | null;
 }
 /**
  * Nutzlast-Form, die dieses Paket **liest**. Unterscheidet sich von

package/dist/esm/models/receipt.js

@@ -42,6 +42,7 @@ export function toReceiptPayload(receipt) {
         legalMessage: receipt.legalMessage.join('\n'),
         signatureSuccess: receipt.signatureSuccess ?? null,
         customProjectId: receipt.customProjectId ?? null,
+        ...(receipt.tipCents != null ? { tipCents: receipt.tipCents } : {}),
     };
 }
 // Nullbelege haben keine Positionen -> items kann fehlen/null sein (siehe Dart-Vorbild).
@@ -68,6 +69,7 @@ export function fromReceiptPayload(payload) {
         legalMessage: leereZeile(payload.legalMessage),
         signatureSuccess: payload.signatureSuccess ?? undefined,
         customProjectId: payload.customProjectId ?? undefined,
+        ...(typeof payload.tipCents === 'number' ? { tipCents: payload.tipCents } : {}),
         ...(payload.cancellationOf ? { cancellationOf: { receiptId: payload.cancellationOf.receiptId, fullReceiptId: payload.cancellationOf.fullReceiptId ?? null } } : {}),
         ...(payload.cancellationReason ? { cancellationReason: payload.cancellationReason } : {}),
         ...(istZeroKind(payload.zeroKind) ? { zeroKind: payload.zeroKind } : {}),

package/dist/esm/payments/hobex.d.ts

@@ -1,5 +1,5 @@
 import { type HobexReceipt } from '../models/index.js';
-import type { KasseneckTransport } from '../client/transport.js';
+import type { InternerTransport } from '../client/aufrufe.js';
 /**
  * Cent -> Euro. **Die einzige Umrechnungsstelle dieses Moduls.** Betraege
  * werden im ganzen Paket in Cent gefuehrt (exakte Ganzzahl-Arithmetik); die
@@ -46,7 +46,7 @@ export interface HobexTransactionIdOptions {
  * **Der Endpunkt heisst `hobexPayApi`** — mit Suffix; ohne ihn gibt es ihn
  * nicht.
  */
-export declare function hobexPay(rufen: KasseneckTransport, options: HobexPayOptions): Promise<HobexReceipt>;
+export declare function hobexPay(rufen: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
  * Erstattet eine zuvor ueber die Hobex-Cloud getaetigte Zahlung. Das Backend
  * storniert zuerst (Void, solange der Tagesabschluss aussteht) und erstattet
@@ -61,7 +61,7 @@ export declare function hobexPay(rufen: KasseneckTransport, options: HobexPayOpt
  *
  * **Der Endpunkt heisst `hobexRefundApi`** — mit Suffix.
  */
-export declare function hobexRefund(rufen: KasseneckTransport, options: HobexRefundOptions): Promise<void>;
+export declare function hobexRefund(rufen: InternerTransport, options: HobexRefundOptions): Promise<void>;
 /**
  * Erzeugt eine neue Hobex-Transaktionskennung: 19 Ziffern aus Zeitanteil und
  * Zufall (Zwilling von `newHobexTransactionId` im Vorbild, Zeile 522).

package/dist/esm/payments/stripe.d.ts

@@ -1,6 +1,6 @@
 import { StripeLinkMode, type StripeLinkModeKey } from '../enums/index.js';
 import { type ReceiptItem, type StripeUrlSession } from '../models/index.js';
-import type { KasseneckTransport } from '../client/transport.js';
+import type { InternerTransport } from '../client/aufrufe.js';
 export interface CreateStripeLinkOptions {
     /** Positionen des Zahlungslinks; mindestens eine, alle gueltig. */
     items: ReceiptItem[];
@@ -50,7 +50,7 @@ export interface StripeCaptureResult {
  * Methodenname und Endpunktname fallen wie schon beim Monatsbericht
  * auseinander (siehe client/reports.ts).
  */
-export declare function createStripeLink(rufen: KasseneckTransport, options: CreateStripeLinkOptions): Promise<StripeUrlSession>;
+export declare function createStripeLink(rufen: InternerTransport, options: CreateStripeLinkOptions): Promise<StripeUrlSession>;
 /**
  * Zieht die zuvor nur reservierte Zahlung einer `authorization`-Sitzung ein.
  *
@@ -58,4 +58,4 @@ export declare function createStripeLink(rufen: KasseneckTransport, options: Cre
  * das Vorbild und so das Backend. Der naheliegende Singular waere ein fehlender
  * Pflichtparameter.
  */
-export declare function stripeCaptureIntent(rufen: KasseneckTransport, stripeSessionId: string): Promise<StripeCaptureResult>;
+export declare function stripeCaptureIntent(rufen: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

package/dist/esm/printing/escpos.js

@@ -613,4 +613,11 @@ export function escPosQrCode(doc, text, options = {}) {
     if (options.correction !== undefined)
         qrOptionen.correction = options.correction;
     anhaengen(doc, qrCodeBytes(text, qrOptionen));
+    // Ausrichtung SOFORT zuruecksetzen: `ESC a` gilt nur am Zeilenanfang. Die
+    // Spalten-Positionierung (`ESC $`) schickt ihren Reset sonst mitten in der
+    // Zeile — Epson ignoriert ihn, und alles nach dem QR rueckte nach rechts
+    // (belegt am TM-T20, 2026-08-20).
+    if ((options.align ?? 'center') !== 'left') {
+        escPosSetStyles(doc, { align: 'left' });
+    }
 }

package/dist/esm/react/index.js

@@ -16,7 +16,12 @@ export function ReceiptLayoutView({ layout, className, renderQr, qrVerdeckt = fa
  */
 export function QrVerdeckt({ data, text = 'Antippen zum Anzeigen', children }) {
     const [offen, setOffen] = useState(false);
-    return (_jsxs("button", { type: "button", className: offen ? 'keck-receipt-qr-toggle keck-receipt-qr-toggle--offen' : 'keck-receipt-qr-toggle', "aria-pressed": offen, "aria-label": offen ? 'QR-Code verdecken' : 'QR-Code anzeigen', "data-qr": data, onClick: () => setOffen((o) => !o), style: { position: 'relative', display: 'inline-block', border: 'none', background: 'transparent', padding: 0, cursor: 'pointer' }, children: [_jsx("span", { style: { display: 'inline-block', filter: offen ? undefined : 'blur(6px)', transition: 'filter .15s ease' }, children: children }), !offen && (_jsx("span", { className: "keck-receipt-qr-toggle-text", style: { position: 'absolute', inset: 0, display: 'grid', placeItems: 'center', fontSize: '0.75em', fontWeight: 700 }, children: text }))] }));
+    return (_jsxs("button", { type: "button", className: offen ? 'keck-receipt-qr-toggle keck-receipt-qr-toggle--offen' : 'keck-receipt-qr-toggle', "aria-pressed": offen, "aria-label": offen ? 'QR-Code verdecken' : text, "data-qr": data, onClick: () => setOffen((o) => !o), style: { position: 'relative', display: 'inline-block', border: 'none', background: 'transparent', padding: 0, cursor: 'pointer' }, children: [_jsx("span", { style: { display: 'inline-block', filter: offen ? undefined : 'blur(3px)', transition: 'filter .15s ease' }, children: children }), !offen && (
+            // Tipp-Finger statt Textzeile: versteht jeder, verdeckt fast nichts.
+            // Der Text bleibt als aria-label fuer Hilfsmittel. Einfarbige
+            // Strichzeichnung statt Emoji — Emojis rendern je Plattform anders
+            // und stechen farblich aus dem Beleg heraus.
+            _jsx("span", { "aria-hidden": "true", className: "keck-receipt-qr-toggle-text", style: { position: 'absolute', inset: 0, display: 'grid', placeItems: 'center' }, children: _jsx("span", { style: { display: 'grid', placeItems: 'center', width: '2.2em', height: '2.2em', borderRadius: '50%', background: 'rgba(255,255,255,.92)', boxShadow: '0 1px 4px rgba(0,0,0,.25)', color: 'rgba(0,0,0,.72)' }, children: _jsxs("svg", { className: "keck-receipt-qr-toggle-finger", width: "1.25em", height: "1.25em", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", children: [_jsx("path", { d: "M10 9.5V4a2 2 0 0 0-2-2a2 2 0 0 0-2 2v10" }), _jsx("path", { d: "M14 10V9a2 2 0 0 0-2-2a2 2 0 0 0-2 2v1" }), _jsx("path", { d: "M18 11v-1a2 2 0 0 0-2-2a2 2 0 0 0-2 2" }), _jsx("path", { d: "M18 11a2 2 0 1 1 4 0v3a8 8 0 0 1-8 8h-2c-2.8 0-4.5-.86-5.99-2.34l-3.6-3.6a2 2 0 0 1 2.83-2.82L7 15" })] }) }) }))] }));
 }
 function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
     switch (zeile.kind) {
@@ -28,6 +33,11 @@ function Zeile({ zeile, renderQr, qrVerdeckt, qrVerdecktText }) {
                         // so bleibt die Aufteilung auf allen Ausgabewegen dieselbe.
                         flex: `0 0 ${((spalte.width / 12) * 100).toFixed(4)}%`,
                         textAlign: AUSRICHTUNG[spalte.align],
+                        // minWidth 0: Flex-Zellen haben sonst min-content-Breite --
+                        // ein langes Wort ohne Leerzeichen (Hex-Seriennummer der
+                        // Signaturkarte) wuerde die Zelle sprengen und abgeschnitten,
+                        // statt per break-word umzubrechen.
+                        minWidth: 0,
                         overflowWrap: 'break-word',
                     }, children: spalte.text }, index))) }));
         case 'rule':

package/dist/esm/receipt/discount.js

@@ -46,6 +46,6 @@ export function verteileRabatt(positionen, rabattCents, name = 'Rabatt') {
         }
     }
     return liste
-        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i] }))
+        .map((g, i) => ({ name, quantity: 1, vat: g.vat, priceCents: -anteile[i], kind: 'discount' }))
         .filter((z) => z.priceCents < 0);
 }

package/dist/esm/receipt/layout-escpos.js

@@ -47,11 +47,16 @@ export function escPosLayoutBytes(layout, options = {}) {
             case 'qr':
                 escPosQrCode(doc, zeile.qr ?? '', qrOptionen);
                 break;
-            case 'banner':
-                // Belegart/Warnung: fett, doppelte Hoehe; Warnungen zusaetzlich invers.
-                // Der Text ist bereits zentriert aufgefuellt (Raster).
-                escPosText(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2, reverse: zeile.ton === 'warnung' } });
+            case 'banner': {
+                // Belegart/Warnung: fett zwischen zwei Volllinien — derselbe Rahmen-
+                // Stil wie im Beleg-Viewer und im PDF (frueher druckte der Bon invers
+                // weiss-auf-schwarz und sah damit anders aus als jede Anzeige).
+                const rahmen = '='.repeat(ZEICHEN_JE_PAPIER[paperSize]);
+                escPosText(doc, rahmen, { styles: { align: 'left', bold: true } });
+                escPosText(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: true, height: 2 } });
+                escPosText(doc, rahmen, { styles: { align: 'left', bold: true } });
                 break;
+            }
             default:
                 escPosText(doc, zeile.text.trimEnd(), { styles: { align: 'left', bold: zeile.bold } });
                 break;

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

@@ -21,9 +21,12 @@ import type { PosPaperSize } from '../printing/escpos.js';
  * stuende auch auf dem Bildschirm „EUR".
  *
  * Bewusst **nicht** enthalten: Firmenlogo und Rasterbilder (brauchen
- * Bildverarbeitung, die im Browser anders aussieht als in Node), PDF-Erzeugung,
- * Druckeransteuerung und die anbieterspezifischen Kartenzahlungsbloecke des
- * Vorbilds (GP Tom, Hobex, SumUp, myPOS, Stripe).
+ * 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.
  */
 /** Ausrichtung einer Zeile bzw. einer Spalte. */
 export type LayoutAlign = 'left' | 'center' | 'right';

package/dist/esm/receipt/layout.js

@@ -1,5 +1,5 @@
 import { VatRate, VoucherAction, VoucherType } from '../enums/index.js';
-import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, receiptSubSumCents, receiptSumCents, voucherIsValid, } from '../models/index.js';
+import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, voucherIsValid, } from '../models/index.js';
 import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
 import { KasseneckValidationError } from '../client/errors.js';
 export const AKTUELLES_REGELWERK = 2;
@@ -45,6 +45,50 @@ function belegZeit(timeStamp) {
  * `typeof null === 'object'` ist, ergab das beim Lesen von `.label` einen
  * nackten TypeError.
  */
+/**
+ * Kartenzahlungsblock fuer Hobex (HPS am Geraet wie Cloud-API): die Felder
+ * kommen aus `cardPaymentData` in der Form von [hobexReceiptToCardPaymentData]
+ * (models/hobex-receipt.ts) — Datum, TID, Genehmigungsnummer, Karte, PAN,
+ * 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');
+    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}`,
+    ];
+    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'));
+    }
+    zeilen.push({ kind: 'space', lines: 1 });
+    return zeilen;
+}
 function zahlungsartText(wert) {
     if (wert != null && typeof wert === 'object') {
         return wert.label;
@@ -143,21 +187,19 @@ function gutscheinText(voucher) {
     if (name != null && name.toLowerCase().includes(text.toLowerCase())) {
         return name;
     }
-    if (voucher.valueCents != null) {
-        text += ` ${gutscheinBetrag(voucher.valueCents)} €`;
+    // Der Betrag steht in derselben Zeile rechts in der Betragsspalte — ihn
+    // auch ins Label zu schreiben war doppelt und brach auf 58 mm haesslich
+    // um ("Wertgutschein 3 €" + Folgezeile "€"). Statt dessen der Code: er
+    // identifiziert den Gutschein (Mehrzweck: der Kunde will wissen, WELCHER
+    // eingeloest wurde).
+    if (voucher.code != null && voucher.code !== '') {
+        text += ` ${voucher.code}`;
     }
     if (name != null && name.length > 0) {
         text += ` - ${name}`;
     }
     return text;
 }
-/**
- * Ganze Betraege kurz (`"10"`), krumme mit zwei Nachkommastellen (`"1,50"`) —
- * Zwilling von `KeckVoucher.formatVoucherAmount`.
- */
-function gutscheinBetrag(cents) {
-    return cents % 100 === 0 ? String(cents / 100) : formatCents(cents);
-}
 // ----------------------------------------------------------------- Bauteile
 function textZeile(text, align = 'left', bold = false) {
     return { kind: 'text', text, align, bold };
@@ -185,6 +227,46 @@ function tabellenZeile(werte, paperSize) {
         })),
     };
 }
+/**
+ * Trinkgeld auf dem Bon: keine Menge, kein Einzelpreis — Bezeichnung und
+ * Summe. Eine Steuer-Kategorie steht hinter dem Betrag (D = Durchlaeufer,
+ * sonst Inhaber-Trinkgeld als Umsatz); bei mehreren steht die Aufteilung in
+ * einer zweiten, eingerueckten Zeile. Breite 8:4: „Trinkgeld Personal“ (18
+ * Zeichen) muss auf 58 mm in die Zeile passen, rechts reichen zehn Zeichen
+ * auch fuer „-123,45 D“.
+ */
+function trinkgeldZeilen(name, teile) {
+    const summe = teile.reduce((s, t) => s + t.cents, 0);
+    if (teile.length === 1) {
+        return [{
+                kind: 'columns',
+                columns: [
+                    { text: name, width: 8, align: 'left' },
+                    { text: `${formatCents(summe)} ${teile[0].satz.category}`, width: 4, align: 'right' },
+                ],
+            }];
+    }
+    const sortiert = [...teile].sort((a, b) => a.satz.category.localeCompare(b.satz.category));
+    return [
+        {
+            kind: 'columns',
+            columns: [
+                { text: name, width: 8, align: 'left' },
+                // Stern statt Kategorie-Buchstabe: fluchtet mit den Warenbetraegen
+                // (" B" ist zwei Zeichen, " *" auch) und verweist auf die
+                // Aufteilungszeile darunter — klassische Fussnote.
+                { text: `${formatCents(summe)} *`, width: 4, align: 'right' },
+            ],
+        },
+        { kind: 'text', text: `* davon ${sortiert.map((t) => `${formatCents(t.cents)} ${t.satz.category}`).join(', ')}`, align: 'left', bold: false },
+    ];
+}
+/**
+ * Rabatt auf dem Bon: dieselbe Form wie Trinkgeld — Summenzeile, bei einem
+ * Steuersatz mit Kategorie-Buchstaben, im Mischfall mit Stern und der
+ * Aufteilung als Fussnote darunter (siehe trinkgeldZeilen).
+ */
+const rabattZeilen = trinkgeldZeilen;
 /** Positionszeile: Menge, Bezeichnung, ab Menge 2 der Einzelpreis. */
 function positionsZeile(item, satz) {
     const menge = String(item.quantity);
@@ -443,10 +525,58 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         gruppen.set(satz.rate, neu);
         return neu;
     };
-    for (const item of receipt.items) {
-        const satz = steuersatz(item.vat);
-        gruppeVon(satz).bruttoCents += receiptItemTotalCents(item);
-        lines.push(positionsZeile(item, satz));
+    // Trinkgeld-Positionen gleichen Namens werden auf dem Bon zu EINER Zeile
+    // mit der Summe zusammengefasst (die Aufteilung des Inhaber-Trinkgelds auf
+    // mehrere Steuersaetze bzw. mehrere Empfaenger ist fiskalisch notwendig,
+    // fuer den Gast aber nur Rauschen); bei mehr als einer Steuer-Kategorie
+    // steht die Aufteilung darunter. USt-Tabelle und DEP bleiben positionsgenau.
+    // Rabatt-Positionen gleichen Namens werden wie Trinkgeld zu EINER Zeile mit
+    // der Summe zusammengefasst (die Aufteilung je Steuersatz ist fiskalisch
+    // notwendig, fuer den Gast aber Rauschen); vor dem ERSTEN Rabatt-Block steht
+    // einmalig die Zwischensumme der Waren — der Gast sieht vorher/nachher.
+    // USt-Tabelle und DEP bleiben positionsgenau.
+    const warenSummeCents = receipt.items
+        .filter((it) => !isTipItem(it) && !isDiscountItem(it))
+        .reduce((summe, it) => summe + receiptItemTotalCents(it), 0);
+    let zwischensummeGezeigt = false;
+    let i = 0;
+    while (i < receipt.items.length) {
+        const item = receipt.items[i];
+        if (!isTipItem(item) && !isDiscountItem(item)) {
+            const satz = steuersatz(item.vat);
+            gruppeVon(satz).bruttoCents += receiptItemTotalCents(item);
+            lines.push(positionsZeile(item, satz));
+            i += 1;
+            continue;
+        }
+        const artVon = (it) => (isTipItem(it) ? 'tip' : 'discount');
+        const art = artVon(item);
+        const gruppe = [];
+        while (i < receipt.items.length && artVon(receipt.items[i]) === art && !(!isTipItem(receipt.items[i]) && !isDiscountItem(receipt.items[i])) && receipt.items[i].name === item.name) {
+            gruppe.push(receipt.items[i]);
+            i += 1;
+        }
+        const teile = [];
+        for (const teil of gruppe) {
+            const satz = steuersatz(teil.vat);
+            gruppeVon(satz).bruttoCents += receiptItemTotalCents(teil);
+            const vorhanden = teile.find((t) => t.satz.category === satz.category);
+            if (vorhanden)
+                vorhanden.cents += receiptItemTotalCents(teil);
+            else
+                teile.push({ satz, cents: receiptItemTotalCents(teil) });
+        }
+        if (art === 'discount' && !zwischensummeGezeigt) {
+            // Trennlinie vor dem Rabatt-Block: die Warenzeilen enden sichtbar,
+            // darunter beginnt die Verrechnung (Zwischensumme, Rabatt).
+            lines.push({ kind: 'rule', char: '-' });
+            // Zwei Fuellzeichen, wo bei den Warenzeilen " B" steht — so fluchten
+            // ALLE Betraege (Waren, Zwischensumme, Rabatt, Trinkgeld) in einer
+            // Spalte; die letzten zwei Zeichen sind die Kategorie-/Stern-Spalte.
+            lines.push(paarZeile('Zwischensumme', `${formatCents(warenSummeCents)}  `, 8, 4));
+            zwischensummeGezeigt = true;
+        }
+        lines.push(...(art === 'discount' ? rabattZeilen(item.name, teile) : trinkgeldZeilen(item.name, teile)));
     }
     // --- Gutscheine: verkaufte Wertgutscheine sind Umsatz zu 0 %, eingeloeste
     //     Promotionsgutscheine mindern die Steuergruppen anteilig.
@@ -494,6 +624,24 @@ export function buildReceiptLayout(receipt, company, options = {}) {
             formatCents(bruttoCents),
         ], paperSize));
     }
+    // Mitarbeiter-Trinkgeld ist als Null-%-Umsatz erfasst (Erlass 2.4.2.1), aber
+    // kein Umsatz des Betriebs — die Klarstellung steht direkt unter der
+    // 0-%-Zeile, damit der Beleg (auch als Rechnung) nicht nach steuerfreiem
+    // Umsatz aussieht. Inhaber-Trinkgeld ist Umsatz und bekommt keine Zeile.
+    const durchlaufendesTrinkgeldCents = receipt.items
+        .filter((it) => isTipItem(it) && it.recipient?.owner !== true)
+        .reduce((summe, it) => summe + receiptItemTotalCents(it), 0);
+    // Nur wenn die 0-%-Gruppe MEHR enthaelt als das Trinkgeld (Wertgutschein-
+    // Verkauf ist ebenfalls Kategorie D, beim Kleinunternehmer ist alles 0 %):
+    // dann trennt diese Zeile den Durchlaeufer vom uebrigen Null-Prozent-Betrag.
+    // Besteht die 0-%-Gruppe ohnehin nur aus dem Trinkgeld, sagt die Position
+    // "Trinkgeld Personal" schon alles — die Wiederholung waere Rauschen.
+    const nullGruppeCents = gruppen.get(VatRate.vat0.rate)?.bruttoCents ?? 0;
+    if (durchlaufendesTrinkgeldCents !== 0 && nullGruppeCents !== durchlaufendesTrinkgeldCents) {
+        // Breite 9:3 — auf 58 mm (32 Zeichen) passt die Beschriftung so in eine
+        // Zeile; der Betrag braucht rechts hoechstens acht Zeichen.
+        lines.push(paarZeile('Trinkgeld, kein Umsatz:', formatCents(durchlaufendesTrinkgeldCents), 9, 3));
+    }
     lines.push({ kind: 'rule', char: '-' });
     // --- Summen
     const summeCents = receiptSumCents(receipt);
@@ -502,7 +650,9 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push(paarZeile('Zwischensumme', `${formatCents(zwischensummeCents)} €`));
         for (const voucher of receipt.vouchers) {
             if (voucher.action === VoucherAction.redeem && voucher.type === VoucherType.value) {
-                lines.push(paarZeile(gutscheinText(voucher), `-${formatCents(voucher.valueCents ?? 0)} €`));
+                // Breite 8:4 — "Wertgutschein GS-1" (Label + Code) passt so auf 58 mm
+                // in die Zeile, statt den Code in eine Folgezeile fliessen zu lassen.
+                lines.push(paarZeile(gutscheinText(voucher), `-${formatCents(voucher.valueCents ?? 0)} €`, 8, 4));
             }
         }
         lines.push({ kind: 'rule', char: '-' });
@@ -527,6 +677,8 @@ export function buildReceiptLayout(receipt, company, options = {}) {
     // --- RKSV-QR-Code
     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));
     // --- Dankestext und Fusszeilen
     if (company.thanksMessage.length > 0) {
         lines.push({ kind: 'space', lines: 1 });

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

@@ -47,5 +47,5 @@
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
-export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterGeraeteAngaben, pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
+export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterGeraeteAngaben, pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
 export { renewRegisterSession, endRegisterSession } from './session.js';

package/dist/esm/register/index.js

@@ -47,5 +47,5 @@
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
-export { pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
+export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
 export { renewRegisterSession, endRegisterSession } from './session.js';

package/dist/esm/register/pairing.d.ts

@@ -41,6 +41,11 @@ export interface RegisterGeraeteAngaben {
     geo?: RegisterGeo | null;
 }
 export interface PairRegisterDeviceOptions extends RegisterDeviceConnection, RegisterGeraeteAngaben {
+    /**
+     * Die Kasse ist schon auf einem anderen Geraet geoeffnet (BELEGT-Rueckfrage):
+     * `true` uebernimmt sie hierher und widerruft das alte Geraet.
+     */
+    takeover?: boolean;
     /**
      * Achtstelliger Kopplungs-Code aus dem Panel. Er ist 15 Minuten gueltig,
      * genau **einmal** verwendbar und gilt fuer eine bestimmte Kasse.
@@ -107,6 +112,16 @@ export interface RegisterDeviceUsers {
     loginMode: RegisterLoginMode;
     /** Der Betrieb verlangt die Ortung beim Login (Standortsperre an). */
     standortsperre: boolean;
+    /**
+     * Darf die gebundene Kasse ueberhaupt Belege erstellen? `bereit: false`
+     * nennt den Grund (ausser Betrieb, Schlussbeleg erstellt) — die Kasse
+     * sperrt das Kassieren VOR dem ersten Beleg statt an createReceipt zu
+     * scheitern. Fehlt das Feld (aelteres Backend), gilt bereit.
+     */
+    kasse?: {
+        bereit: boolean;
+        grund?: string | null;
+    } | null;
 }
 /**
  * Rechte eines Kassen-Benutzers (Backend: `perms`, Vorlagen `PERMS_KASSIER`
@@ -144,6 +159,8 @@ export interface RegisterUserPerms {
     tipAssign?: boolean;
     [weiteresRecht: string]: boolean | RegisterScope | undefined;
 }
+/** Alle Rechte-Schluessel, die dieses Paket kennt — die Zwillinge pruefen dagegen. */
+export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign"];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 export declare function cancelScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;
 export declare function receiptsScopeOf(perms: RegisterUserPerms | null | undefined): RegisterScope;