@kreiseck/kasseneck-api 1.1.0 → 1.2.0

package/dist/cjs/pos/index.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
-exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
+exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
- * Rabattverteilung, Drucker, Trinkgeld-Empfaenger. Die Aufrufe heissen 1:1 wie
+ * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
+ * Standort der Kasse). Die Aufrufe heissen 1:1 wie
  * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
  * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
  */
@@ -79,6 +80,7 @@ Object.defineProperty(exports, "distributeDiscount", { enumerable: true, get: fu
 var pairing_js_1 = require("../register/pairing.js");
 Object.defineProperty(exports, "cancelScopeOf", { enumerable: true, get: function () { return pairing_js_1.cancelScopeOf; } });
 Object.defineProperty(exports, "receiptsScopeOf", { enumerable: true, get: function () { return pairing_js_1.receiptsScopeOf; } });
+Object.defineProperty(exports, "stockViewOf", { enumerable: true, get: function () { return pairing_js_1.stockViewOf; } });
 var drucker_js_1 = require("./drucker.js");
 Object.defineProperty(exports, "PRINT_JOB_STATUSES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_STATUSES; } });
 Object.defineProperty(exports, "PRINT_JOB_SOURCES", { enumerable: true, get: function () { return drucker_js_1.PRINT_JOB_SOURCES; } });
@@ -88,6 +90,15 @@ Object.defineProperty(exports, "createPrintJob", { enumerable: true, get: functi
 Object.defineProperty(exports, "getPrintJob", { enumerable: true, get: function () { return drucker_js_1.getPrintJob; } });
 var trinkgeld_js_1 = require("./trinkgeld.js");
 Object.defineProperty(exports, "listMyTipRecipients", { enumerable: true, get: function () { return trinkgeld_js_1.listMyTipRecipients; } });
+var lager_js_1 = require("./lager.js");
+Object.defineProperty(exports, "STOCK_LOCATION_TYPES", { enumerable: true, get: function () { return lager_js_1.STOCK_LOCATION_TYPES; } });
+Object.defineProperty(exports, "listMyStockLocations", { enumerable: true, get: function () { return lager_js_1.listMyStockLocations; } });
+Object.defineProperty(exports, "listMyStock", { enumerable: true, get: function () { return lager_js_1.listMyStock; } });
+Object.defineProperty(exports, "setMyCashregisterStockLocation", { enumerable: true, get: function () { return lager_js_1.setMyCashregisterStockLocation; } });
+// Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
+var cancellation_js_1 = require("../models/cancellation.js");
+Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
+Object.defineProperty(exports, "isReturnDisposition", { enumerable: true, get: function () { return cancellation_js_1.isReturnDisposition; } });
 // Was die Kasse selbst sagt: ein Katalog fuer Browser-Kasse und App.
 var texte_js_1 = require("./texte.js");
 Object.defineProperty(exports, "MESSAGES", { enumerable: true, get: function () { return texte_js_1.MESSAGES; } });

package/dist/cjs/pos/lager.d.ts

@@ -0,0 +1,95 @@
+import type { InternerTransport } from '../client/aufrufe.js';
+/**
+ * Lager an der Kasse (Lager-Kern Stufe 2, Backend lager-endpoints.js):
+ * Standorte, Bestand und der Standort der Kasse. Alle drei Aufrufe gibt es
+ * nur ueber den Kassenweg `/api/v3` (registerInternal); Rechte am Server:
+ * `stockView` (lesen), `stockCosts` (Werte), `stockLocation` (Standort setzen).
+ *
+ * **Ganzzahlen:** Mengen sind Tausendstel der Basiseinheit (`1000` = 1 Stueck,
+ * `250` = 0,250 kg), Werte ganze Cent bzw. Mikro-Euro. Nichts wird geteilt,
+ * gerundet oder geklemmt -- ein negativer Bestand (mehr verkauft als gebucht)
+ * ist eine Aussage des Servers und bleibt negativ. Eine Zahl, die keine
+ * Ganzzahl ist, oder eine fehlende Menge wird **nie** zu `0`: der Aufruf
+ * endet mit `KasseneckValidationError` (`scope: 'response'`), denn „kein
+ * Bestand“ und „Antwort kaputt“ sind verschiedene Aussagen.
+ */
+/** Standort-Typen (Katalog `STANDORT_TYP`), englisch wie am Draht. */
+export declare const STOCK_LOCATION_TYPES: readonly ["warehouse", "store", "vehicle", "other"];
+export type StockLocationType = (typeof STOCK_LOCATION_TYPES)[number];
+export interface StockLocationAddress {
+    street: string | null;
+    zip: string | null;
+    city: string | null;
+    country: string | null;
+}
+export interface StockLocation {
+    id: string;
+    name: string;
+    /** `null`: ein Typ, den dieses Paket nicht kennt. */
+    type: StockLocationType | null;
+    /** Fahrzeuge haben keine Adresse. */
+    address: StockLocationAddress | null;
+    /** Kennzeichen, nur bei `vehicle`. */
+    licensePlate: string | null;
+    /** `false` = aufgeloest; als Standort der Kasse abgewiesen (`location_inactive`). */
+    active: boolean;
+    /** `true` = Hauptstandort, den der Server ohne eigenes Dokument ergaenzt. */
+    virtual: boolean;
+}
+/** Bestand eines Artikels an einem Standort, in Tausendstel der Basiseinheit. */
+export interface StockLevel {
+    articleId: string;
+    locationId: string;
+    sellable: number;
+    defective: number;
+    reserved: number;
+    /** `sellable - reserved`, vom Server gerechnet. */
+    available: number;
+}
+/** Lagerwert eines Artikels -- nur mit dem Recht `stockCosts`. */
+export interface StockValue {
+    articleId: string;
+    stockValueCents: number;
+    /** Durchschnittlicher Einstandspreis je Basiseinheit in Mikro-Euro; `null` bei Menge 0. */
+    averageCostMicros: number | null;
+}
+export interface StockList {
+    stock: StockLevel[];
+    /**
+     * `null`, wenn der Aufrufer das Recht `stockCosts` nicht hat (der Server
+     * laesst das Feld weg); `[]`, wenn er es hat und nichts bewertet ist. Eine
+     * Oberflaeche zeigt bei `null` keinen Wert, nie „0,00 €“.
+     */
+    values: StockValue[] | null;
+}
+export interface ListMyStockOptions {
+    /** Nur dieser Standort; `''` gilt wie nicht angegeben. */
+    locationId?: string;
+    /** Nur dieser Artikel; `''` gilt wie nicht angegeben. */
+    articleId?: string;
+    /** Nur Zeilen unter dem Mindestbestand. */
+    belowMinimum?: boolean;
+}
+export interface SetMyCashregisterStockLocationOptions {
+    /** Standort-Kennung; `null` setzt auf den Standard-Standort des Betriebs zurueck. */
+    stockLocationId: string | null;
+    /** Ohne Angabe gilt die Kasse der Anmeldung (`registerUserAuth`). */
+    cashregisterId?: string;
+}
+export interface CashregisterStockLocation {
+    cashregisterId: string;
+    /** `null` = Standard-Standort des Betriebs. */
+    stockLocationId: string | null;
+}
+/** Standorte des Betriebs, samt aufgeloesten (`active: false`) und dem Hauptstandort. */
+export declare function listMyStockLocations(transport: InternerTransport): Promise<StockLocation[]>;
+/** Bestand je Artikel und Standort; Werte nur mit dem Recht `stockCosts`. */
+export declare function listMyStock(transport: InternerTransport, options?: ListMyStockOptions): Promise<StockList>;
+/**
+ * Standort der Kasse setzen -- von dort bucht der Server Verkauf und Storno
+ * ab. `stockLocationId: null` setzt zurueck (am Draht der leere Text).
+ * Fehler am Code: `location_not_found`, `location_inactive`,
+ * `cashregister_not_found`, `cashregister_not_assigned`, `not_permitted`,
+ * `module_inactive`.
+ */
+export declare function setMyCashregisterStockLocation(transport: InternerTransport, options: SetMyCashregisterStockLocationOptions): Promise<CashregisterStockLocation>;

package/dist/cjs/pos/lager.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STOCK_LOCATION_TYPES = void 0;
+exports.listMyStockLocations = listMyStockLocations;
+exports.listMyStock = listMyStock;
+exports.setMyCashregisterStockLocation = setMyCashregisterStockLocation;
+const errors_js_1 = require("../client/errors.js");
+const artikel_js_1 = require("./artikel.js");
+/**
+ * Lager an der Kasse (Lager-Kern Stufe 2, Backend lager-endpoints.js):
+ * Standorte, Bestand und der Standort der Kasse. Alle drei Aufrufe gibt es
+ * nur ueber den Kassenweg `/api/v3` (registerInternal); Rechte am Server:
+ * `stockView` (lesen), `stockCosts` (Werte), `stockLocation` (Standort setzen).
+ *
+ * **Ganzzahlen:** Mengen sind Tausendstel der Basiseinheit (`1000` = 1 Stueck,
+ * `250` = 0,250 kg), Werte ganze Cent bzw. Mikro-Euro. Nichts wird geteilt,
+ * gerundet oder geklemmt -- ein negativer Bestand (mehr verkauft als gebucht)
+ * ist eine Aussage des Servers und bleibt negativ. Eine Zahl, die keine
+ * Ganzzahl ist, oder eine fehlende Menge wird **nie** zu `0`: der Aufruf
+ * endet mit `KasseneckValidationError` (`scope: 'response'`), denn „kein
+ * Bestand“ und „Antwort kaputt“ sind verschiedene Aussagen.
+ */
+/** Standort-Typen (Katalog `STANDORT_TYP`), englisch wie am Draht. */
+exports.STOCK_LOCATION_TYPES = Object.freeze(['warehouse', 'store', 'vehicle', 'other']);
+const TYPEN = new Set(exports.STOCK_LOCATION_TYPES);
+function antwortfehler(name, grund) {
+    return new errors_js_1.KasseneckValidationError(name, grund, 'response');
+}
+const objekt = (w) => (w !== null && typeof w === 'object' && !Array.isArray(w) ? w : null);
+/** Freitext, der fehlen darf (Name, Adressteile, Kennzeichen): leer = `null`. */
+const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
+/**
+ * Eine Kennung, die da sein muss: ohne sie ist die Zeile nicht zuzuordnen,
+ * und ein leerer Text als `stockLocationId` setzte die Kasse zurueck.
+ */
+function kennung(name, pfad, w) {
+    if (typeof w !== 'string' || w === '')
+        throw antwortfehler(name, `Antwort enthaelt keine Kennung (data.${pfad} fehlt)`);
+    return w;
+}
+/** Eine Zahl des Servers: Ganzzahl oder Antwortfehler, nie ein Ersatzwert. */
+function ganzzahl(name, pfad, w) {
+    if (typeof w !== 'number' || !Number.isInteger(w)) {
+        throw antwortfehler(name, `Antwort enthaelt keine ganze Zahl (data.${pfad})`);
+    }
+    return w;
+}
+function standort(name, e, i) {
+    const s = objekt(e) ?? {};
+    const pfad = `locations[${i}]`;
+    const a = objekt(s.address);
+    const teile = a ? { street: textOderNull(a.street), zip: textOderNull(a.zip), city: textOderNull(a.city), country: textOderNull(a.country) } : null;
+    // Eine Adresse ohne einen einzigen Teil ist keine Adresse.
+    const address = teile && Object.values(teile).some((t) => t !== null) ? teile : null;
+    return {
+        id: kennung(name, `${pfad}.id`, s.id),
+        name: typeof s.name === 'string' ? s.name : '',
+        type: typeof s.type === 'string' && TYPEN.has(s.type) ? s.type : null,
+        address,
+        licensePlate: textOderNull(s.licensePlate),
+        active: s.active !== false,
+        virtual: s.virtual === true,
+    };
+}
+function bestand(name, e, i) {
+    const b = objekt(e) ?? {};
+    const pfad = `stock[${i}]`;
+    return {
+        articleId: kennung(name, `${pfad}.articleId`, b.articleId),
+        locationId: kennung(name, `${pfad}.locationId`, b.locationId),
+        sellable: ganzzahl(name, `${pfad}.sellable`, b.sellable),
+        defective: ganzzahl(name, `${pfad}.defective`, b.defective),
+        reserved: ganzzahl(name, `${pfad}.reserved`, b.reserved),
+        available: ganzzahl(name, `${pfad}.available`, b.available),
+    };
+}
+function wert(name, e, i) {
+    const w = objekt(e) ?? {};
+    const pfad = `values[${i}]`;
+    return {
+        articleId: kennung(name, `${pfad}.articleId`, w.articleId),
+        stockValueCents: ganzzahl(name, `${pfad}.stockValueCents`, w.stockValueCents),
+        // Fehlt der Durchschnitt oder ist er null, ist die Menge 0 -- eine
+        // vorhandene, aber unbrauchbare Zahl ist dagegen ein Antwortfehler.
+        averageCostMicros: w.averageCostMicros === undefined || w.averageCostMicros === null
+            ? null
+            : ganzzahl(name, `${pfad}.averageCostMicros`, w.averageCostMicros),
+    };
+}
+/** Standorte des Betriebs, samt aufgeloesten (`active: false`) und dem Hauptstandort. */
+async function listMyStockLocations(transport) {
+    const name = 'listMyStockLocations';
+    const daten = await transport(name);
+    return (0, artikel_js_1.liste)(daten, 'locations', name, (e, i) => standort(name, e, i));
+}
+/** Bestand je Artikel und Standort; Werte nur mit dem Recht `stockCosts`. */
+async function listMyStock(transport, options = {}) {
+    const name = 'listMyStock';
+    if (options === null || typeof options !== 'object')
+        throw new errors_js_1.KasseneckValidationError(name, 'options muss ein Objekt sein', 'request');
+    const params = {};
+    for (const feld of ['locationId', 'articleId']) {
+        const w = options[feld];
+        if (w === undefined || w === '')
+            continue;
+        if (typeof w !== 'string')
+            throw new errors_js_1.KasseneckValidationError(name, `${feld} muss Text sein`, 'request');
+        params[feld] = w;
+    }
+    if (options.belowMinimum !== undefined) {
+        if (typeof options.belowMinimum !== 'boolean')
+            throw new errors_js_1.KasseneckValidationError(name, 'belowMinimum muss true oder false sein', 'request');
+        // false filtert am Server nicht; gesendet wird nur der Filter selbst.
+        if (options.belowMinimum)
+            params.belowMinimum = true;
+    }
+    const daten = await transport(name, params);
+    const stock = (0, artikel_js_1.liste)(daten, 'stock', name, (e, i) => bestand(name, e, i));
+    const roh = objekt(daten)?.values;
+    // Fehlt `values`, fehlt dem Aufrufer das Recht `stockCosts`: `null`, nie `[]`.
+    // Etwas anderes als eine Liste ist dagegen kein „kein Recht“, sondern kaputt.
+    if (roh === undefined || roh === null)
+        return { stock, values: null };
+    return { stock, values: (0, artikel_js_1.liste)(daten, 'values', name, (e, i) => wert(name, e, i)) };
+}
+/**
+ * Standort der Kasse setzen -- von dort bucht der Server Verkauf und Storno
+ * ab. `stockLocationId: null` setzt zurueck (am Draht der leere Text).
+ * Fehler am Code: `location_not_found`, `location_inactive`,
+ * `cashregister_not_found`, `cashregister_not_assigned`, `not_permitted`,
+ * `module_inactive`.
+ */
+async function setMyCashregisterStockLocation(transport, options) {
+    const name = 'setMyCashregisterStockLocation';
+    const ziel = options?.stockLocationId;
+    if (ziel !== null && typeof ziel !== 'string') {
+        throw new errors_js_1.KasseneckValidationError(name, 'stockLocationId fehlt (Kennung, oder null zum Zuruecksetzen)', 'request');
+    }
+    // Leer setzt zurueck. Nur Leerraum wuerde der Server kuerzen und damit still
+    // auf den Standard-Standort zuruecksetzen: das ist kein Standort, sondern ein Fehler.
+    if (ziel !== null && ziel !== '' && ziel.trim() === '') {
+        throw new errors_js_1.KasseneckValidationError(name, 'stockLocationId ist nur Leerraum (Kennung angeben, oder null zum Zuruecksetzen)', 'request');
+    }
+    const params = { stockLocationId: ziel === null ? '' : ziel };
+    if (options.cashregisterId !== undefined) {
+        if (typeof options.cashregisterId !== 'string' || options.cashregisterId.trim() === '') {
+            throw new errors_js_1.KasseneckValidationError(name, 'cashregisterId ist leer', 'request');
+        }
+        params.cashregisterId = options.cashregisterId;
+    }
+    const daten = objekt(await transport(name, params));
+    if (!daten || typeof daten.cashregisterId !== 'string' || daten.cashregisterId === '') {
+        throw antwortfehler(name, 'Antwort enthaelt keine Kasse (data.cashregisterId fehlt)');
+    }
+    const stand = daten.stockLocationId;
+    if (stand !== null && stand !== undefined && typeof stand !== 'string') {
+        throw antwortfehler(name, 'Antwort enthaelt einen unbrauchbaren Standort (data.stockLocationId)');
+    }
+    return { cashregisterId: daten.cashregisterId, stockLocationId: textOderNull(stand) };
+}

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

@@ -470,10 +470,17 @@ declare const MELDUNGEN_ROH: {
         readonly text: "Nichts gespeichert.";
     };
     readonly 'codetable.question': {
-        readonly text: "Welche Zeile sieht auf dem Papier aus wie oben?";
+        readonly text: "In welcher Zeile steht kein falsches Zeichen?";
+    };
+    readonly 'codetable.question_hint': {
+        readonly text: "Lücken sind in Ordnung.";
     };
     readonly 'codetable.instruction': {
-        readonly text: "Die Nummer der ersten Zeile, die genau wie oben aussieht, in der Kasse antippen.";
+        readonly text: "Die Zeile, in der KEIN falsches Zeichen steht. Eine Lücke ist in Ordnung. Passen mehrere, die mit den wenigsten Lücken.";
+    };
+    readonly 'codetable.instruction_none': {
+        readonly text: "Passt keine: {number}.";
+        readonly placeholders: readonly ["number"];
     };
     readonly 'bluetooth.off': {
         readonly text: "Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.";
@@ -974,7 +981,7 @@ declare const BESCHRIFTUNGEN_ROH: {
         readonly text: "ZEICHENSATZ-TEST";
     };
     readonly 'codetable.reference': {
-        readonly text: "So muss jede Zeile aussehen:";
+        readonly text: "So sehen die Zeichen richtig aus";
     };
     readonly 'codetable.replacement_note': {
         readonly text: "(Ersatz, passt immer)";
@@ -996,6 +1003,18 @@ declare const BESCHRIFTUNGEN_ROH: {
         readonly text: "Zeichensatz: Nr. {number}";
         readonly placeholders: readonly ["number"];
     };
+    readonly 'codetable.instruction_title': {
+        readonly text: "Welche Zeile nehmen?";
+    };
+    readonly 'codetable.preview_title': {
+        readonly text: "So steht es dann am Bon:";
+    };
+    readonly 'codetable.apply': {
+        readonly text: "Übernehmen";
+    };
+    readonly 'codetable.other_row': {
+        readonly text: "Andere Zeile";
+    };
 };
 export type LabelKey = keyof typeof BESCHRIFTUNGEN_ROH;
 export declare const LABELS: Record<LabelKey, TextEntry>;

package/dist/cjs/pos/texte.js

@@ -256,9 +256,17 @@ const MELDUNGEN_ROH = {
     // damit niemand einen halb eingerichteten Drucker vermutet.
     'print.wizard_cancelled': { text: 'Nichts gespeichert.' },
     // Zeichensatz-Test im Drucker-Wizard: das Testblatt nennt die Anleitung,
-    // der Bildschirm stellt die Frage daneben.
-    'codetable.question': { text: 'Welche Zeile sieht auf dem Papier aus wie oben?' },
-    'codetable.instruction': { text: 'Die Nummer der ersten Zeile, die genau wie oben aussieht, in der Kasse antippen.' },
+    // der Bildschirm stellt die Frage daneben. Die Regel ist „kein falsches
+    // Zeichen“, nicht „erste Zeile“ und nicht „Umlaute richtig“: ein Drucker
+    // mit nur PC437 druckt Zeile 2 und 3 mit richtigen Umlauten, aber falschem
+    // € und § (╒, ⌡); richtig ist dort Zeile 4, mit Luecken fuer € und §.
+    // Am Papier steht „Lücke“ als „Luecke“ (Ersatzbuchstaben wie jeder Text
+    // ausserhalb der Testzeilen), am Bildschirm mit Umlaut.
+    'codetable.question': { text: 'In welcher Zeile steht kein falsches Zeichen?' },
+    'codetable.question_hint': { text: 'Lücken sind in Ordnung.' },
+    'codetable.instruction': { text: 'Die Zeile, in der KEIN falsches Zeichen steht. Eine Lücke ist in Ordnung. Passen mehrere, die mit den wenigsten Lücken.' },
+    // `{number}` ist die Ersatz-Zeile (6), die immer passt.
+    'codetable.instruction_none': { text: 'Passt keine: {number}.', placeholders: ['number'] },
     'bluetooth.off': { text: 'Bluetooth ist ausgeschaltet. Bitte einschalten und erneut suchen.', only: ['app'] },
     'bluetooth.permission_missing': { text: 'Bitte die Freigabe in den Geräte-Einstellungen erteilen.', only: ['app'] },
     'bluetooth.search_failed': { text: 'Die Suche ist fehlgeschlagen: {reason}', placeholders: ['reason'], only: ['app'] },
@@ -571,17 +579,25 @@ const BESCHRIFTUNGEN_ROH = {
     'cancellation.payment_remainder': { text: 'Rest {amount}', placeholders: ['amount'] },
     'cancellation.difference': { text: 'Differenz' },
     // --- Zeichensatz-Test (Testblatt und Drucker & Lade) ----------------------
-    // Das Testblatt druckt diese Texte; sie bleiben reines ASCII bis auf die
-    // Knoepfe am Bildschirm. `{chars}` sind die fehlenden Zeichen einer Zeile
+    // Das Testblatt druckt diese Texte mit Ersatzbuchstaben (reines ASCII);
+    // die Knoepfe stehen nur am Bildschirm. `{chars}` sind die fehlenden Zeichen einer Zeile
     // („€“ bzw. „€ §“), `{number}` die gewaehlte Zeile (1-6).
     'codetable.title': { text: 'ZEICHENSATZ-TEST' },
-    'codetable.reference': { text: 'So muss jede Zeile aussehen:' },
+    // Genau 32 Spalten: mit Doppelpunkt waeren es 33, die Ueberschrift braeche um.
+    'codetable.reference': { text: 'So sehen die Zeichen richtig aus' },
     'codetable.replacement_note': { text: '(Ersatz, passt immer)' },
     'codetable.missing': { text: 'ohne {chars}', placeholders: ['chars'] },
     'codetable.print_again': { text: 'Nochmal drucken' },
     'codetable.not_checked': { text: 'Umlaute noch nicht geprüft' },
     'codetable.check': { text: 'Umlaute prüfen' },
     'codetable.current': { text: 'Zeichensatz: Nr. {number}', placeholders: ['number'] },
+    // Ueberschrift der Anleitung am Testblatt.
+    'codetable.instruction_title': { text: 'Welche Zeile nehmen?' },
+    // Nach der Wahl: das Beispiel so, wie es mit der Zeile am Bon steht
+    // (`codeTablePreviewText`), dann uebernehmen oder zurueck zur Frage.
+    'codetable.preview_title': { text: 'So steht es dann am Bon:' },
+    'codetable.apply': { text: 'Übernehmen' },
+    'codetable.other_row': { text: 'Andere Zeile' },
 };
 exports.LABELS = BESCHRIFTUNGEN_ROH;
 /** Die Beschriftung zum Schluessel, Platzhalter ersetzt; fehlt ein Wert, wirft es wie `messageText`. */

package/dist/cjs/printing/code-table-preview.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Die Vorschau im Drucker-Wizard: nach der Wahl einer Zeile zeigt der
+ * Bildschirm ein Beispiel so, wie es mit dieser Tabelle am Bon steht. Wer
+ * Zeile 4 (PC437) waehlt, sieht „3,50 EUR“ statt „3,50 €“, bevor er
+ * uebernimmt. Gemeinsamer Prueffall mit dem Dart-Zwilling:
+ * `fixtures/code-table-preview.json`.
+ */
+import { type CodeTableId } from './code-tables.js';
+/**
+ * Das Beispiel mit den Ersetzungen der Tabelle, Zeilen durch `\n` getrennt:
+ * fehlt der Tabelle ein Zeichen, stehen seine Ersatzbuchstaben da
+ * (`pc437` -> „Käsekrainer 3,50 EUR“, `replacement` -> „Kaesekrainer 3,50 EUR“).
+ * Eine unbekannte Kennung wird gemeldet.
+ */
+export declare function codeTablePreviewText(table: CodeTableId): string;

package/dist/cjs/printing/code-table-preview.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeTablePreviewText = codeTablePreviewText;
+/**
+ * Die Vorschau im Drucker-Wizard: nach der Wahl einer Zeile zeigt der
+ * Bildschirm ein Beispiel so, wie es mit dieser Tabelle am Bon steht. Wer
+ * Zeile 4 (PC437) waehlt, sieht „3,50 EUR“ statt „3,50 €“, bevor er
+ * uebernimmt. Gemeinsamer Prueffall mit dem Dart-Zwilling:
+ * `fixtures/code-table-preview.json`.
+ */
+const code_tables_js_1 = require("./code-tables.js");
+const printable_js_1 = require("./printable.js");
+/** Das Beispiel: Umlaut, €, °. */
+const BEISPIEL = ['Käsekrainer 3,50 €', 'Tee 80°'];
+/**
+ * Das Beispiel mit den Ersetzungen der Tabelle, Zeilen durch `\n` getrennt:
+ * fehlt der Tabelle ein Zeichen, stehen seine Ersatzbuchstaben da
+ * (`pc437` -> „Käsekrainer 3,50 EUR“, `replacement` -> „Kaesekrainer 3,50 EUR“).
+ * Eine unbekannte Kennung wird gemeldet.
+ */
+function codeTablePreviewText(table) {
+    (0, code_tables_js_1.codeTableById)(table);
+    return BEISPIEL.map((zeile) => (0, printable_js_1.escPosPrintableText)(zeile, table)).join('\n');
+}

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

@@ -2,4 +2,5 @@ export { type PosPaperSize, type PosAlign, type PosFont, type PosCutMode, type P
 export { type CodeTableId, type CodeTable, CODE_TABLES, codeTableById, codeTableFromSetting, encodeForCodeTable, } from './code-tables.js';
 export { type QrModuleSize, type QrSizing, QR_MODULE_SIZE_CAP, QR_QUIET_ZONE_MODULES, QR_MIN_MODULE_DOTS, QR_EXCEPTION_MODULE_DOTS, QR_MAX_MODULE_DOTS, QR_PRINT_WIDTH_DOTS, qrModuleCount, qrFitsInVersion, computeQrSizing, qrSizingFor, } from './qr-groesse.js';
 export { escPosPrintableText } from './printable.js';
+export { codeTablePreviewText } from './code-table-preview.js';
 export { type UsbEndpointLike, type UsbAlternateLike, type UsbInterfaceLike, type UsbConfigurationLike, type UsbTransferOutResultLike, type UsbWriterLike, type UsbIdentityLike, type UsbDeviceLike, type UsbPrinterEndpoint, type UsbPrinterConnection, USB_VENDOR_EPSON, USB_CLASS_PRINTER, UsbTimeoutError, usbDeviceKey, usbFindPrinterEndpoint, usbWriteAll, usbConnectPrinter, usbPrint, usbDisconnect, } from './webusb.js';

package/dist/cjs/printing/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.escPosPrintableText = exports.qrSizingFor = exports.computeQrSizing = exports.qrFitsInVersion = exports.qrModuleCount = exports.QR_PRINT_WIDTH_DOTS = exports.QR_MAX_MODULE_DOTS = exports.QR_EXCEPTION_MODULE_DOTS = exports.QR_MIN_MODULE_DOTS = exports.QR_QUIET_ZONE_MODULES = exports.QR_MODULE_SIZE_CAP = exports.encodeForCodeTable = exports.codeTableFromSetting = exports.codeTableById = exports.CODE_TABLES = exports.wrapText = exports.escPosWrapLines = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.escPosRasterImage = exports.rasterRowsBase64 = exports.rasterRowsBytes = exports.qrRasterDots = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
+exports.usbDisconnect = exports.usbPrint = exports.usbConnectPrinter = exports.usbWriteAll = exports.usbFindPrinterEndpoint = exports.usbDeviceKey = exports.UsbTimeoutError = exports.USB_CLASS_PRINTER = exports.USB_VENDOR_EPSON = exports.codeTablePreviewText = exports.escPosPrintableText = exports.qrSizingFor = exports.computeQrSizing = exports.qrFitsInVersion = exports.qrModuleCount = exports.QR_PRINT_WIDTH_DOTS = exports.QR_MAX_MODULE_DOTS = exports.QR_EXCEPTION_MODULE_DOTS = exports.QR_MIN_MODULE_DOTS = exports.QR_QUIET_ZONE_MODULES = exports.QR_MODULE_SIZE_CAP = exports.encodeForCodeTable = exports.codeTableFromSetting = exports.codeTableById = exports.CODE_TABLES = exports.wrapText = exports.escPosWrapLines = exports.escPosMaxCharsPerLine = exports.qrCodeBytes = exports.encodeEscPosText = exports.escPosRasterImage = exports.rasterRowsBase64 = exports.rasterRowsBytes = exports.qrRasterDots = exports.escPosQrRaster = exports.escPosQrCode = exports.escPosRow = exports.escPosHr = exports.escPosCut = exports.escPosFeed = exports.escPosEmptyLines = exports.escPosText = exports.escPosSetStyles = exports.escPosSetGlobalFont = exports.escPosSetGlobalCodeTable = exports.escPosReset = exports.escPosBytes = exports.createEscPosDocument = void 0;
 var escpos_js_1 = require("./escpos.js");
 Object.defineProperty(exports, "createEscPosDocument", { enumerable: true, get: function () { return escpos_js_1.createEscPosDocument; } });
 Object.defineProperty(exports, "escPosBytes", { enumerable: true, get: function () { return escpos_js_1.escPosBytes; } });
@@ -43,6 +43,8 @@ Object.defineProperty(exports, "computeQrSizing", { enumerable: true, get: funct
 Object.defineProperty(exports, "qrSizingFor", { enumerable: true, get: function () { return qr_groesse_js_1.qrSizingFor; } });
 var printable_js_1 = require("./printable.js");
 Object.defineProperty(exports, "escPosPrintableText", { enumerable: true, get: function () { return printable_js_1.escPosPrintableText; } });
+var code_table_preview_js_1 = require("./code-table-preview.js");
+Object.defineProperty(exports, "codeTablePreviewText", { enumerable: true, get: function () { return code_table_preview_js_1.codeTablePreviewText; } });
 var webusb_js_1 = require("./webusb.js");
 Object.defineProperty(exports, "USB_VENDOR_EPSON", { enumerable: true, get: function () { return webusb_js_1.USB_VENDOR_EPSON; } });
 Object.defineProperty(exports, "USB_CLASS_PRINTER", { enumerable: true, get: function () { return webusb_js_1.USB_CLASS_PRINTER; } });

package/dist/cjs/receipt/code-table-test-sheet.d.ts

@@ -5,8 +5,14 @@
  * Oben steht die Vorlage-Zeile als Rasterbild -- ein Bild druckt jeder
  * Drucker gleich, egal welche Tabelle er gerade hat. Darunter je Tabelle des
  * Katalogs eine Zeile mit ihrer Nummer (gross), umgeschaltet mit `ESC t n`
- * und mit den Bytes dieser Tabelle. Die erste Zeile, die aussieht wie die
- * Vorlage, ist die richtige; Zeile 6 (Ersatzbuchstaben) passt immer.
+ * und mit den Bytes dieser Tabelle. Richtig ist die Zeile ohne falsches
+ * Zeichen; eine Luecke (Zeichen fehlt der Tabelle) ist in Ordnung, bei
+ * mehreren die mit den wenigsten Luecken, sonst Zeile 6 (Ersatzbuchstaben).
+ * Nicht „die erste Zeile mit richtigen Umlauten“: ein Drucker mit nur PC437
+ * druckt Zeile 2 und 3 mit richtigen Umlauten, aber falschem € und §.
+ *
+ * Alles ausserhalb der Testzeilen steht mit Ersatzbuchstaben (reines ASCII),
+ * auch die Anleitung: „Lücke“ aus dem Katalog steht am Blatt als „Luecke“.
  *
  * Bildschirm und Papier zeigen dasselbe Blatt: `codeTableTestSheet` liefert
  * es im Zeilenmodell des Beleg-Blatts (`ReceiptSheet`), `codeTableTestSheetBytes`

package/dist/cjs/receipt/code-table-test-sheet.js

@@ -93,7 +93,9 @@ function blattBauen(options) {
         bloecke.push(zeile(einzug + t));
     bloecke.push(zeile(einzug + nurAscii((0, texte_js_1.labelText)('codetable.replacement_note'))));
     bloecke.push(doppelt);
+    bloecke.push(...zeilen((0, texte_js_1.labelText)('codetable.instruction_title'), true));
     bloecke.push(...zeilen((0, texte_js_1.messageText)('codetable.instruction')));
+    bloecke.push(...zeilen((0, texte_js_1.messageText)('codetable.instruction_none', { number: ersatz.number })));
     bloecke.push(doppelt);
     return {
         blatt: {

package/dist/cjs/register/errors.d.ts

@@ -22,7 +22,7 @@ import { KasseneckApiError } from '../client/errors.js';
  * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
  * Rueckfallzweig.
  */
-export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "admin_required", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "admin_required", "api_not_approved", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
 export type RegisterErrorCode = typeof REGISTER_ERROR_CODES[number];
 export declare function isRegisterErrorCode(value: unknown): value is RegisterErrorCode;
 /** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */

package/dist/cjs/register/errors.js

@@ -34,6 +34,7 @@ const fehlercodes_js_1 = require("../client/fehlercodes.js");
 exports.REGISTER_ERROR_CODES = Object.freeze([
     'account_not_found',
     'admin_required',
+    'api_not_approved',
     'cashregister_in_use',
     'cashregister_not_assigned',
     'cashregister_not_found',

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

@@ -137,10 +137,12 @@ export interface RegisterDeviceUsers {
      * nennt den Grund als Menschentext (ausser Betrieb, keine Signaturkarte,
      * Startbeleg fehlt): die Kasse sperrt das Kassieren VOR dem ersten Beleg
      * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
+     * `stockLocationId`: Lager-Standort der Kasse, fehlt = Standard-Standort.
      */
     cashregister?: {
         ready: boolean;
         reason?: string | null;
+        stockLocationId?: string;
     };
     /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
     testEnvironment: boolean;
@@ -179,6 +181,24 @@ export interface RegisterUserPerms {
     discount?: boolean;
     /** Trinkgeld anderen zuweisen. */
     tipAssign?: boolean;
+    /**
+     * Lager: Standorte und Mengen sehen (listMyStockLocations, listMyStock).
+     * Fehlt das Recht, gilt es als erteilt – anders als alle anderen
+     * (siehe [stockViewOf]); ein ausdrueckliches `false` sperrt.
+     */
+    stockView?: boolean;
+    /** Lager: Einkaufswerte sehen (`values` in listMyStock); gibt nur der Inhaber frei. */
+    stockCosts?: boolean;
+    /** Lager: Wareneingang, Umbuchen. */
+    stockMove?: boolean;
+    /** Lager: Abgang, Zustand, Gegenbuchung. */
+    stockLoss?: boolean;
+    /** Inventur: zaehlen. */
+    stocktakeCount?: boolean;
+    /** Inventur: abschliessen. */
+    stocktakeClose?: boolean;
+    /** Standort der Kasse waehlen (setMyCashregisterStockLocation). */
+    stockLocation?: boolean;
     [weiteresRecht: string]: boolean | RegisterScope | undefined;
 }
 /**
@@ -189,10 +209,16 @@ export interface RegisterUserPerms {
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
  * Die Gegenrichtung schliesst [_RechteVollstaendig] direkt darunter.
  */
-export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign"];
+export declare const REGISTER_PERMS: readonly ["sell", "cancel", "articles", "layout", "reports", "takeover", "cancelScope", "receiptsScope", "drawer", "discount", "tipAssign", "stockView", "stockCosts", "stockMove", "stockLoss", "stocktakeCount", "stocktakeClose", "stockLocation"];
 /** 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;
+/**
+ * Darf der Benutzer Standorte und Mengen sehen? Wie im Backend (lager-core):
+ * ohne Schluessel gilt `stockView` als erteilt, ein ausdrueckliches `false`
+ * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
+ */
+export declare function stockViewOf(perms: RegisterUserPerms | null | undefined): boolean;
 /** Der angemeldete Kassen-Benutzer. */
 export interface RegisterUser {
     id: string;

package/dist/cjs/register/pairing.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.REGISTER_PERMS = void 0;
 exports.cancelScopeOf = cancelScopeOf;
 exports.receiptsScopeOf = receiptsScopeOf;
+exports.stockViewOf = stockViewOf;
 exports.pairRegisterDevice = pairRegisterDevice;
 exports.unpairRegisterDevice = unpairRegisterDevice;
 exports.listRegisterSessionsForDevice = listRegisterSessionsForDevice;
@@ -60,6 +61,7 @@ const ohneAnmeldung = () => ({ headers: {}, params: {} });
 exports.REGISTER_PERMS = [
     'sell', 'cancel', 'articles', 'layout', 'reports', 'takeover',
     'cancelScope', 'receiptsScope', 'drawer', 'discount', 'tipAssign',
+    'stockView', 'stockCosts', 'stockMove', 'stockLoss', 'stocktakeCount', 'stocktakeClose', 'stockLocation',
 ];
 /** Reichweite lesen, mit der Migration des Backends (register-auth.js). */
 function cancelScopeOf(perms) {
@@ -76,6 +78,16 @@ function receiptsScopeOf(perms) {
         return 'all';
     return ['none', 'own', 'all'].includes(perms.receiptsScope) ? perms.receiptsScope : 'none';
 }
+/**
+ * Darf der Benutzer Standorte und Mengen sehen? Wie im Backend (lager-core):
+ * ohne Schluessel gilt `stockView` als erteilt, ein ausdrueckliches `false`
+ * sperrt; alle anderen Lager-Rechte gelten ohne Schluessel als verweigert.
+ */
+function stockViewOf(perms) {
+    if (!perms)
+        return false;
+    return perms.stockView === undefined ? true : perms.stockView === true;
+}
 /**
  * Geraet koppeln: der Kopplungs-Code wird gegen den dauerhaften Ausweis dieses
  * Geraets getauscht. **Ohne Anmeldung** — der Code ist der Nachweis.
@@ -210,7 +222,12 @@ function kasseBereit(wert) {
     const roh = wert;
     if (typeof roh['ready'] !== 'boolean')
         return undefined;
-    return { ready: roh['ready'], reason: typeof roh['reason'] === 'string' ? roh['reason'] : null };
+    const standort = roh['stockLocationId'];
+    return {
+        ready: roh['ready'],
+        reason: typeof roh['reason'] === 'string' ? roh['reason'] : null,
+        ...(typeof standort === 'string' && standort !== '' ? { stockLocationId: standort } : {}),
+    };
 }
 /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
 function regel(wert) {