@kreiseck/kasseneck-api 0.6.9 → 0.6.44

package/dist/cjs/receipt/layout.js

@@ -56,6 +56,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;
@@ -154,21 +198,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 };
@@ -196,6 +238,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);
@@ -454,10 +536,58 @@ 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 += (0, index_js_2.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) => !(0, index_js_2.isTipItem)(it) && !(0, index_js_2.isDiscountItem)(it))
+        .reduce((summe, it) => summe + (0, index_js_2.receiptItemTotalCents)(it), 0);
+    let zwischensummeGezeigt = false;
+    let i = 0;
+    while (i < receipt.items.length) {
+        const item = receipt.items[i];
+        if (!(0, index_js_2.isTipItem)(item) && !(0, index_js_2.isDiscountItem)(item)) {
+            const satz = steuersatz(item.vat);
+            gruppeVon(satz).bruttoCents += (0, index_js_2.receiptItemTotalCents)(item);
+            lines.push(positionsZeile(item, satz));
+            i += 1;
+            continue;
+        }
+        const artVon = (it) => ((0, index_js_2.isTipItem)(it) ? 'tip' : 'discount');
+        const art = artVon(item);
+        const gruppe = [];
+        while (i < receipt.items.length && artVon(receipt.items[i]) === art && !(!(0, index_js_2.isTipItem)(receipt.items[i]) && !(0, index_js_2.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 += (0, index_js_2.receiptItemTotalCents)(teil);
+            const vorhanden = teile.find((t) => t.satz.category === satz.category);
+            if (vorhanden)
+                vorhanden.cents += (0, index_js_2.receiptItemTotalCents)(teil);
+            else
+                teile.push({ satz, cents: (0, index_js_2.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.
@@ -505,6 +635,24 @@ 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) => (0, index_js_2.isTipItem)(it) && it.recipient?.owner !== true)
+        .reduce((summe, it) => summe + (0, index_js_2.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(index_js_1.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 = (0, index_js_2.receiptSumCents)(receipt);
@@ -513,7 +661,9 @@ function buildReceiptLayout(receipt, company, options = {}) {
         lines.push(paarZeile('Zwischensumme', `${formatCents(zwischensummeCents)} €`));
         for (const voucher of receipt.vouchers) {
             if (voucher.action === index_js_1.VoucherAction.redeem && voucher.type === index_js_1.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: '-' });
@@ -538,6 +688,8 @@ 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/cjs/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`

package/dist/cjs/register/pairing.js

@@ -71,10 +71,10 @@ function receiptsScopeOf(perms) {
  * [PairedRegisterDevice]).
  */
 async function pairRegisterDevice(options) {
-    const { code, label, client, geo, ...verbindung } = options;
+    const { code, label, client, geo, takeover, ...verbindung } = options;
     pflicht('pairRegisterDevice', 'code', code);
     // Der Code ist das Geheimnis dieses Aufrufs — siehe Modulkommentar.
-    const daten = await transportFuer(verbindung)('pairRegisterDevice', { code, label, client, geo: geo ?? undefined }, undefined, [code]);
+    const daten = await transportFuer(verbindung)('pairRegisterDevice', { code, label, client, geo: geo ?? undefined, takeover: takeover === true ? true : undefined }, undefined, [code]);
     return {
         deviceId: pflichtfeld('pairRegisterDevice', daten, 'deviceId'),
         deviceSecret: pflichtfeld('pairRegisterDevice', daten, 'deviceSecret'),
@@ -135,7 +135,26 @@ async function listRegisterUsersForDevice(options) {
     };
     const bd = daten?.betriebsdaten;
     const betriebsdaten = bd && typeof bd === 'object' ? (0, receipt_company_js_1.fromReceiptCompanyPayload)(bd) : null;
-    return { users, policy: regel(daten?.policy), loginMode: daten?.loginMode === 'pin' ? 'pin' : 'auswahl', settings, betriebsdaten, standortsperre: daten?.standortsperre === true };
+    return {
+        users,
+        policy: regel(daten?.policy),
+        loginMode: daten?.loginMode === 'pin' ? 'pin' : 'auswahl',
+        settings,
+        betriebsdaten,
+        standortsperre: daten?.standortsperre === true,
+        // 0.6.27 ergaenzte nur den TYP — hier fiel das Feld beim Zusammenbau
+        // stumm weg, und die Kasse sah nie eine Sperre. Fehlt es (aelteres
+        // Backend), bleibt es undefined: dann gilt bereit.
+        kasse: kasseBereit(daten?.kasse),
+    };
+}
+function kasseBereit(wert) {
+    if (typeof wert !== 'object' || wert === null || Array.isArray(wert))
+        return undefined;
+    const roh = wert;
+    if (typeof roh['bereit'] !== 'boolean')
+        return undefined;
+    return { bereit: roh['bereit'], grund: typeof roh['grund'] === 'string' ? roh['grund'] : null };
 }
 /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
 function regel(wert) {

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

@@ -1,7 +1,7 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
 export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
-export { type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';
 export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
 export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';

package/dist/esm/client/receipts.d.ts

@@ -39,6 +39,25 @@ export interface ReceiptCommonOptions {
     customProjectId?: string;
     /** Rohdaten der Kartenzahlung (Terminal-/Anbieterantwort). */
     cardPaymentData?: Record<string, unknown>;
+    /**
+     * Trinkgeld in Cent — als Zahl (an den angemeldeten Kassen-Benutzer, Zahlart
+     * des Belegs) oder als [TipOptions]. Das Backend bucht daraus signierte
+     * Positionen `kind:'tip'` (Mitarbeiter 0 % als Durchlaeufer, Inhaber
+     * anteilig je Steuersatz). Nur auf `standard` und `training`.
+     */
+    tip?: number | TipOptions;
+}
+/** Trinkgeld mit eigener Zahlart und/oder Empfaengern (Kassen-Benutzer-IDs, Summe = cents). */
+export interface TipOptions {
+    cents: number;
+    /** Zahlart des Trinkgelds; ohne Angabe gilt die des Belegs. */
+    paymentMethod?: KeckPaymentMethod | KeckPaymentMethodKey;
+    /** Empfaenger; ohne Angabe der angemeldete Kassen-Benutzer. Summe der cents = cents. */
+    recipients?: TipRecipientShare[];
+}
+export interface TipRecipientShare {
+    registerUserId: string;
+    cents: number;
 }
 /** Belegtyp und Inhalt — die vollstaendige Eingabe von [createReceipt]. */
 export interface CreateReceiptOptions extends ReceiptCommonOptions {

package/dist/esm/client/receipts.js

@@ -73,6 +73,12 @@ function createReceiptParams(options) {
             }
         }
     }
+    if (options.tip != null) {
+        if (typ.value !== ReceiptType.standard.value && typ.value !== ReceiptType.training.value) {
+            throw eingabefehler(`Trinkgeld ist nur bei receiptType standard oder training moeglich, nicht bei "${typ.value}".`);
+        }
+        params['tip'] = gepruefterTip(options.tip);
+    }
     if (options.customProjectId != null) {
         params['customProjectId'] = options.customProjectId;
     }
@@ -358,6 +364,51 @@ function alsNutzlast(werte, wandeln) {
         throw eingabefehler(ursache instanceof Error ? ursache.message : 'Ungueltige Nutzlast uebergeben.');
     }
 }
+/** Positive ganze Cent? */
+function istCentBetrag(wert) {
+    return typeof wert === 'number' && Number.isInteger(wert) && wert > 0;
+}
+/**
+ * Trinkgeld pruefen und in die Nutzlast-Form bringen (Zahl bleibt Zahl; das
+ * Objekt geht mit geprueftem Zahlart-Wert und Empfaengern hinaus). Dieselben
+ * Regeln wie das Backend (tip-core.normalizeTip) — nur frueher.
+ */
+function gepruefterTip(tip) {
+    if (typeof tip === 'number') {
+        if (!istCentBetrag(tip))
+            throw eingabefehler('Trinkgeld: Betrag muss eine ganze Zahl in Cent > 0 sein.');
+        return tip;
+    }
+    if (tip == null || typeof tip !== 'object' || !istCentBetrag(tip.cents)) {
+        throw eingabefehler('Trinkgeld: Betrag muss eine ganze Zahl in Cent > 0 sein.');
+    }
+    const nutzlast = { cents: tip.cents };
+    if (tip.paymentMethod != null)
+        nutzlast['paymentMethod'] = gepruefteZahlungsart(tip.paymentMethod);
+    if (tip.recipients != null) {
+        if (!Array.isArray(tip.recipients) || tip.recipients.length === 0) {
+            throw eingabefehler('Trinkgeld: recipients darf nicht leer sein.');
+        }
+        let summe = 0;
+        const gesehen = new Set();
+        for (const r of tip.recipients) {
+            if (r == null || typeof r.registerUserId !== 'string' || r.registerUserId === '') {
+                throw eingabefehler('Trinkgeld: recipients[].registerUserId fehlt.');
+            }
+            if (!istCentBetrag(r.cents))
+                throw eingabefehler('Trinkgeld: recipients[].cents muss eine ganze Zahl > 0 sein.');
+            if (gesehen.has(r.registerUserId))
+                throw eingabefehler(`Trinkgeld: Kassen-Benutzer ${r.registerUserId} doppelt.`);
+            gesehen.add(r.registerUserId);
+            summe += r.cents;
+        }
+        if (summe !== tip.cents) {
+            throw eingabefehler(`Trinkgeld: Summe der Empfaenger (${summe}) entspricht nicht dem Betrag (${tip.cents}).`);
+        }
+        nutzlast['recipients'] = tip.recipients.map((r) => ({ registerUserId: r.registerUserId, cents: r.cents }));
+    }
+    return nutzlast;
+}
 /** Zahlungsart des Aufrufers pruefen — unbekannt wirft, bevor etwas rausgeht. */
 function gepruefteZahlungsart(wert) {
     if (typeof wert === 'object') {

package/dist/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, istZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, type ArticleGroup, type KasseArtikel, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

package/dist/esm/index.js

@@ -1,5 +1,5 @@
 export { ReceiptType, VatRate, KeckPaymentMethod, CreditCardProvider, VoucherType, VoucherAction, StripeLinkMode, } from './enums/index.js';
-export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
+export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, istZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
 export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, sellReceipt, sellReceiptWithCompany, cancelReceipt, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, downloadDailyReport, downloadMonthlyReport, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings, verteileRabatt, cancelScopeOf, receiptsScopeOf, } from './kasse/index.js';

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

@@ -20,8 +20,15 @@ export type KasseBelegAusgabe = 'qr' | 'druck' | 'mail' | 'sms' | 'fragen';
 export type KasseLayout = 'rechts' | 'links' | 'vollbild';
 export type KasseKatpos = 'oben' | 'links';
 export type KasseHoehe = 'S' | 'M' | 'L';
-/** `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt). */
-export type KasseDruckerArt = 'sdp' | 'netz' | 'bt' | 'usb';
+/**
+ * `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt).
+ * `connect` = Kasseneck Connect (lokaler Agent auf dem Kassen-Rechner druckt fuer die Browser-Kasse).
+ */
+export type KasseDruckerArt = 'sdp' | 'netz' | 'bt' | 'usb' | 'connect';
+/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
+export type KasseTerminalVia = 'direkt' | 'connect';
+/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
+export type KasseTerminalArt = 'keins' | 'hps';
 export type KassePapier = 'mm58' | 'mm80';
 export type KasseZeichensatz = 'CP1252' | 'CP437';
 export type KasseSchnitt = 'partial' | 'full' | 'none';
@@ -55,6 +62,20 @@ export interface KasseSettingsBetrieb {
     notiz: boolean;
     suche: boolean;
     rabatt: 'aus' | 'an';
+    /** Bild-Logo (Download-URL aus dem Kasse-Upload); '' = Kuerzel verwenden. */
+    logoBild: string;
+    /** Seite des Wasserzeichens — ALT: abgeloest von wzPos, bleibt fuers Mischen alter Staende. */
+    wzSeite: 'links' | 'mitte' | 'rechts';
+    /** Horizontale Lage der Wasserzeichen-MITTE in Prozent (-25 bis 125 — darf ueber den Rand hinaus). */
+    wzPos: number;
+    /** Vertikale Lage der Wasserzeichen-Mitte in Prozent (-25 bis 125). */
+    wzPosV: number;
+    /** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
+    wzStaerke: 3 | 6 | 10 | 16;
+    /** Groesse des Bild-Logos am BELEG (Ansicht, PDF, Kopfzeile). */
+    logoSkala: 'S' | 'M' | 'L' | 'XL';
+    /** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
+    wzSkala: 'S' | 'M' | 'L' | 'XL';
     zahlBar: boolean;
     zahlKarte: boolean;
     kartenanbieter: KasseKartenanbieter;
@@ -67,11 +88,17 @@ export interface KasseSettingsBetrieb {
     kassierenModus: KasseKassierenModus;
     /** Trinkgeld-Chips in Prozent (eine Nachkommastelle, max 5, eindeutig, Reihenfolge des Chefs). */
     tgChips: number[];
+    /** Rabatt-Chips in Prozent — dieselben Regeln wie tgChips, vom Chef einstellbar. */
+    rabattChips: number[];
     belegAusgabe: KasseBelegAusgabe;
     fertigSekunden: 0 | 3 | 5 | 10 | 15 | 30 | 60;
+    /** Glas-Optik: Kacheln und Korb leicht durchscheinend (Wasserzeichen schimmert). */
+    glas: boolean;
+    /** Hilfetexte in den Chef-Einstellungen anzeigen. */
+    hinweise: boolean;
 }
 /** Aktionen der Kasse, die eine Taste bekommen koennen. */
-export type KasseTastenAktion = 'kassieren' | 'abschliessen' | 'abbrechen' | 'frei' | 'bar' | 'karte' | 'passend' | 'belege' | 'letzteZurueck';
+export type KasseTastenAktion = 'kassieren' | 'abschliessen' | 'abbrechen' | 'frei' | 'bar' | 'karte' | 'passend' | 'belege' | 'letzteZurueck' | 'einstellungen' | 'abmelden' | 'trinkgeld' | 'vollbild' | 'gegebenLeeren' | 'korbLeeren';
 export declare const KASSE_TASTEN_AKTIONEN: readonly KasseTastenAktion[];
 /** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
 export type KasseTastenkarte = Record<KasseTastenAktion, string[]>;
@@ -93,6 +120,8 @@ export interface KasseSettingsGeraet {
     druckerId: string;
     /** ePOS Device-ID bei `druckerArt 'netz'` (Epson direkt per IP), Vorgabe `local_printer`. */
     druckerDevid: string;
+    /** Kennung des Druckers im lokalen Kasseneck-Connect-Agenten, bei `druckerArt 'connect'`. */
+    connectDruckerId: string;
     papier: KassePapier;
     zeichensatz: KasseZeichensatz;
     schnitt: KasseSchnitt;
@@ -100,6 +129,13 @@ export interface KasseSettingsGeraet {
     ladeAuto: KasseLadeAuto;
     terminalIp: string;
     terminalPort: number;
+    terminalVia: KasseTerminalVia;
+    /** Art des Terminals ('keins' = Kartenzahlung ohne Terminal-Anbindung gesperrt, sofern zahlKarte an). */
+    terminalArt: KasseTerminalArt;
+    /** Tastenmarken (die kleinen Kuerzel an den Knoepfen) anzeigen. */
+    tastenMarken: boolean;
+    /** Terminal-ID aus dem Hobex-Vertrag (ohne fuehrende Null); noetig fuer Diagnose und Zahlung. */
+    terminalTid: string;
 }
 export interface KasseSettings {
     betrieb: KasseSettingsBetrieb;

package/dist/esm/kasse/settings.js

@@ -8,14 +8,30 @@
  * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
  */
 export const KARTENANBIETER = ['keiner', 'extern', 'hobex', 'mypos', 'stripe'];
-export const KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck'];
+export const KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren'];
 export const KASSE_TASTEN_STANDARD = Object.freeze({
     kassieren: ['Enter'], abschliessen: ['Enter'], abbrechen: ['Escape'],
-    frei: ['Mod+F'], bar: ['Mod+B'], karte: ['Mod+K'], passend: ['Mod+P'],
-    belege: ['Mod+E'], letzteZurueck: ['Mod+Backspace'],
+    // Mod+F gehoert dem Vollbild; Betrag frei liegt auf D. Bar bleibt auf B,
+    // Belege auf E (Entscheidung vom 21.8., der Tausch von 0.6.25 ist zurueck).
+    frei: ['Mod+D'], bar: ['Mod+B'], karte: ['Mod+K'], passend: ['Mod+P'],
+    // NICHT Mod+E: das faengt Chrome auf dem Mac selbst ab („Auswahl fuer
+    // Suche verwenden") — am Geraet belegt. J wie Journal laesst er durch.
+    belege: ['Mod+J'], letzteZurueck: ['Mod+Backspace'],
+    // NICHT Mod+T: die Taste ist im Browser reserviert (neuer Tab) und kommt
+    // nie bei der Seite an. Mod+G laesst Chrome durch.
+    einstellungen: ['Mod+S'], abmelden: ['Mod+L'], trinkgeld: ['Mod+G'],
+    vollbild: ['Mod+F'],
+    // Mod+C = Kopieren des Browsers — im Kassieren-Schritt ist Kopieren fern,
+    // und die Bindung gilt nur dort (Bar + Rueckgeld-Rechner an).
+    gegebenLeeren: ['Mod+C'],
+    // Bewusst DIESELBE Taste wie gegebenLeeren: die beiden leben in
+    // verschiedenen Momenten (Korb vor dem Kassieren, Gegeben-Feld darin) —
+    // der Verteiler laesst die nicht zustaendige Aktion durchfallen.
+    korbLeeren: ['Mod+C'],
 });
 export const KASSE_BETRIEB_STANDARD = Object.freeze({
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#1B46F5',
+    // Kasseneck-Teal aus dem Branding-Guide — nicht mehr das alte Blau.
+    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#0F6B72',
     stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
     sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
     preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,
@@ -24,15 +40,21 @@ export const KASSE_BETRIEB_STANDARD = Object.freeze({
     zahlBar: true, zahlKarte: false, kartenanbieter: 'keiner', trinkgeld: false, tgModus: 'beides',
     tgStufen: { 5: true, 10: true, 15: false, 20: false }, tgChips: [5, 10], tgSplit: true, rueckgeld: true,
     schnellbar: false, kassierenModus: 'seite',
-    belegAusgabe: 'qr', fertigSekunden: 0,
+    // 'fragen' = Fertig-Seite bietet QR und Bon an — sicherster Standard.
+    logoBild: '', wzSeite: 'mitte', wzPos: 50, wzPosV: 50, wzStaerke: 6, logoSkala: 'M', wzSkala: 'M',
+    glas: true, hinweise: true,
+    rabattChips: [5, 10, 15, 20],
+    belegAusgabe: 'fragen', fertigSekunden: 0,
 });
 export const KASSE_GERAET_STANDARD = Object.freeze({
     layout: 'rechts', katpos: 'oben', spaltenExtra: 0, hoehe: 'M', touch: false,
     tasten: { ...KASSE_TASTEN_STANDARD },
     druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerId: '', druckerDevid: 'local_printer',
+    connectDruckerId: '',
     papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial',
     ladeAn: false, ladeAuto: 'bar',
-    terminalIp: '', terminalPort: 20008,
+    terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
+    terminalArt: 'keins', terminalTid: '', tastenMarken: true,
 });
 /**
  * Standard + gespeichert. Landkarten (`saetze`, `tgStufen`) werden je Schluessel

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

@@ -1,4 +1,4 @@
-export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, } from './receipt-item.js';
+export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { type Receipt, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
 export { type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';

package/dist/esm/models/index.js

@@ -1,4 +1,4 @@
-export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, } from './receipt-item.js';
+export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, isDiscountItem, } from './receipt-item.js';
 export { toVoucherPayload, fromVoucherPayload, voucherIsValid } from './voucher.js';
 export { toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, } from './receipt.js';
 export { CANCELLATION_REASONS, CANCELLATION_RESERVATION_MS, isCancellationReason, remainingQuantities, } from './cancellation.js';